视频云直播SDK for Python 使用指南

视频云直播 Python SDK 概述

适用于2.6、2.7的Python版本。使用此 SDK 构建您的网络应用程序，能让您以非常便捷地方式调用金山云的视频云直播服务。SDK下载地址为：https://github.com/KscSDK。

1.安装python sdk

1.1 git 安装

从GitHub上获取SDK并安装

```

git clone https://github.com/KscSDK/ksc-sdk-python.git

cd ksc-sdk-python

python setup.py install

```

1.2 pip 安装

```

pip install ksc-sdk-python

```

2.配置管理秘钥

2.1 通过文件配置秘钥

-1.所在位置: '/etc/kscore.cfg' 或 './.kscore.cfg'

-2.注意: 使用相对路径时，需与运行目录保持一致

-3.ks_access_key_id和ks_secret_access_key是金山云控制台身份与管理里面生成密钥对(如有问题请联系商务或者技术支持)

```

[Credentials]

ks_access_key_id='xxxxxxxxxxxxxxxxxxxx'

ks_secret_access_key='xxxxxxxxxxxxxxxxxxxxxxx'

```

2.2 在代码中配置秘钥

```

from kscore.kls import getKlsClient

// 若使用文件配置过秘钥请使用这种方式：

client = getKetClient("kls", "cn‐beijing‐6",use_ssl=False)

//参数说明：

service_name: 服务名，填写"kls"

region_name: 区域名，填写"cn‐beijing‐6"

use_ssl: 是否https访问，填写False

// 若准备使用代码中配置秘钥，请使用这种方式：

ks_access_key_id='xxxxxxxxxxxxxxxxxxxx'

ks_secret_access_key='xxxxxxxxxxxxxxxxxxxxxxx'

//参数：服务service_name,大区region_name

client = getKetClient("kls", "cn-beijing-6",use_ssl=False,ks_access_key_id=ks_access_key_id,ks_secret_access_key=ks_secret_access_key)

```

注：接口的传递的参数及返回值请参考《云直播API文档》查看API的使用方式已经参数和返回内容

3.Post 方法调用示例

*Post 方法的调用均使用与下面示例相同的方式*

*文档中仅以禁止单路直播流推送的接口为例*

*调用示例*

```

#!/usr/bin/python

# -*- coding: UTF-8 -*-

from kscore.kls import getKlsClient

import json

if __name__ == "__main__":

#ks_access_key_id='xxxxxxxxxxxxxxxxxxxxxxxxxx'

#ks_secret_access_key='xxxxxxxxxxxxxxxxxxxxxxxxxx'

client = getKlsClient("kls", "cn-beijing-6",use_ssl=False,ks_access_key_id=ks_access_key_id,ks_secret_access_key=ks_secret_access_key)

param = {

"UniqueName" : "YOUR UNIQUENAME",

"App" : "YOUR APP",

"Pubdomain" : "YOUR PUBLISH DOMAIN",

"Stream" : "YOUR STREAM NAME",

"ForbidTillUnixTime" : -1

}

#禁止单路直播流推送 : ForbidStream

res = client.ForbidStream(param)

print json.dumps(res)

```

4.Get 方法调用示例

Get 方法的调用均使用与下面示例相同的方式

*文档中仅以查询录像任务状态的接口为例*

*调用示例*

```

#!/usr/bin/python

# -*- coding: UTF-8 -*-

from kscore.kls import getKlsClient

import json

if __name__ == "__main__":

#ks_access_key_id='xxxxxxxxxxxxxxxxxxxxxxxxxx'

#ks_secret_access_key='xxxxxxxxxxxxxxxxxxxxxxxxxx'

client = getKlsClient("kls", "cn-beijing-6",use_ssl=False,ks_access_key_id=ks_access_key_id,ks_secret_access_key=ks_secret_access_key)

#查询录像任务状态接口(GetRecordTask)

res = client.GetRecordTask(RecID = 2017)

print json.dumps(res)

```