PythonSDK

最近更新时间:2018-12-18 21:22:44

视频云直播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)

```

金山云,开启您的云计算之旅

免费注册