直播服务流监控场景示例（Python版本）

1. 简介

华为云提供了直播服务端SDK，您可以直接集成服务端SDK来调用直播的相关API，从而实现对直播服务的快速操作。该示例展示了如何通过Python版SDK对直播流进行监控。

2. 开发前准备

• 已 注册 华为云，并完成 实名认证 。
• 具备已备案的域名用于直播推流和播放，并在视频直播控制台 添加推流和播放域名 ，且已完成 域名关联 。
• 已具备开发环境 ，支持python3及以上版本。
• 已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK）。请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见 访问密钥 。
• 已获取直播服务对应区域的项目ID，请在华为云控制台“我的凭证 > API凭证”页面上查看项目ID。具体请参见 API凭证 。

3. 安装SDK

视频直播服务端SDK支持python3及以上版本。执行“ python --version” 检查当前python的版本信息。

使用服务端SDK前，您需要安装“huaweicloudsdkcore ”和 “huaweicloudsdklive”，具体的SDK版本号请参见 SDK开发中心 。

                    
                    Copied!
                
# 安装核心库
pip install huaweicloudsdkcore
# 安装Live服务库
pip install huaweicloudsdklive

4. 开始使用

4.1 导入依赖模块

                    
                    Copied!
                
from huaweicloudsdkcore.auth.credentials import BasicCredentials, GlobalCredentials
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcore.http.http_config import HttpConfig
# 导入指定Live的库
from huaweicloudsdklive.v2 import *
import os

4.2 初始化认证信息, 及客户端

                    
                    Copied!
                
# 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
# 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
ak = os.environ["HUAWEICLOUD_SDK_AK"]
sk = os.environ["HUAWEICLOUD_SDK_SK"]
def get_client(ak, sk, region):
    config = HttpConfig.get_default_config()
    config.timeout = 3

    return LiveClient.new_builder() \
        .with_http_config(config) \
        .with_credentials(BasicCredentials(ak, sk)) \
        .with_region(region) \
        .build()

相关参数说明如下所示：

• ak：华为云账号Access Key。

• sk：华为云账号Secret Access Key 。

• service region: 服务所在区域，当前支持北京一和北京四

  -- CN_NORTH_1 北京一

  -- CN_NORTH_4 北京四

4.4 配置请求参数

以获取实时在线人数接口为例：

                    
                    Copied!
                
request = ListLiveStreamsOnlineRequest()
request.publish_domain = "publish.example.huawei.com"
request.app = "live"
request.limit = 10
request.offset = 1
request.stream = "testStream"

相关demo说明见 5. SDK demo代码解析

4.5 发送请求

以获取实时在线人数接口为例：

                    
                    Copied!
                
response = client.list_live_streams_online(request)

##5. SDK demo代码解析

5.1 查询推流帧率数据接口

demo请见stream_monitor_demo.list_single_stream_framerate_demo()方法

5.1.1 构造请求参数

                    
                    Copied!
                
request = ListSingleStreamFramerateRequest()
request.domain = "publish.example.huawei.com"
request.start_time = "2020-08-18T07:20:40Z"
request.end_time = "2020-08-18T10:20:40Z"

5.1.2 发送请求

                    
                    Copied!
                
response = client.list_single_stream_framerate(request)

5.1.3 接口及参数说明

请见 查询推流帧率数据接口

5.2 查询推流码率数据接口

demo请见stream_monitor_demo.list_single_stream_bitrate_demo()方法

5.2.1 构造请求参数

                    
                    Copied!
                
request = ListSingleStreamBitrateRequest()
request.domain = "publish.example.huawei.com"
request.start_time = "2020-08-18T07:20:40Z"
request.end_time = "2020-08-18T10:20:40Z"
request.app = "live"

5.2.2 发送请求

                    
                    Copied!
                
response = client.list_single_stream_bitrate(request)

5.2.3 接口及参数说明

请见 查询推流码率数据接口

6. FAQ

暂无

7. 参考

更多信息请参考 直播服务文档

8. 修订记录