视频云直播SDK for php 使用指南#
视频云直播 PHP SDK 概述
此 SDK 适用于PHP 5.5 及以上版本。基于金山云直播 API 构建。使用此 SDK 构建您的网络应用程序,能让您以非常便捷地方式调用金山云的视频云直播服务。SDK下载地址为:https://github.com/KscSDK。
###1.初始化###
1.1 ak/sk 配置
在金山云控制台获取到ak/sk后创建以下文件 (如有问题请联系商务或者技术支持):
```
mkdir ~/.ksyun && vim ~/.ksyun/config
```
config文件内容为:
```
{
"ak":"********************",
"sk":"****************************************"
}
```
1.2 composer安装
```
mkdir test && cd test
composer require kscsdk/ksyun_sdk
```
如果需要使用最新版本,安装完之后,修改composer.json为
```
{
"require": {
"kscsdk/ksyun_sdk": "dev-master"
}
}
```
然后再执行更新操作
```
composer update
```
1.3 调试demo
```
cp vendor/kscsdk/ksyun_sdk/examples/demo_Kls.php .
php demo_Kls.php GetBlacklist
```
1.4 调用示例
```
require('vendor/autoload.php');
use Ksyun\Service\Kls;
$response = Kls::getInstance()->request('GetBlacklist');
echo $response->getBody();
```
*注:接口的传递的参数及返回值请参考《云直播API文档》查看API的使用方式已经参数和返回内容 *
###2.Post 方法调用示例###
*Post 方法的调用均使用与下面示例相同的方式*
*文档中仅以禁止单路直播流推送的接口为例*
*调用示例*
```
require('vendor/autoload.php');
use Ksyun\Service\Kls;
$app = 'live'; // 频道名
$uniqname = 'test'; // 用户名
$pubdomain = 'test.ksyun.com'; //推流域名
$stream = 'test1234'; //流名
$forbidTillUnixTime = -1 //禁流时间
$forbid_stream_data = [
'App' => $app,
'UniqueName' => $uniqname,
'Pubdomain' => $pubdomain,
'Stream' => $stream,
'ForbidTillUnixTime' => $forbidTillUnixTime
];
$response = Ket::getInstance()->request('ForbidStream', 'json' => $forbid_stream_data]);
echo $response->getBody();
```
###3.Get 方法调用示例###
Get 方法的调用均使用与下面示例相同的方式
*文档中仅以查询录像任务状态的接口为例*
*调用示例*
```
require('vendor/autoload.php');
use Ksyun\Service\Kls;
$rec_id = 1; //录像任务ID
$response = Ket::getInstance()->request('GetRecordTask', 'json' => ['query' => ['RecID' => $rec_id]]);
echo $response->getBody();
```