检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK概述 华为云提供了直播服务端SDK,您可以直接集成服务端SDK来调用直播的相关API,从而实现对直播服务的快速操作。目前视频直播提供了Java、Python、Go和PHP四种语言SDK供开发者使用,如表1所示。 SDK已知安全漏洞及修复版本、规避方案,请单击表1中的SDK对应语言的Github地址进行查看。
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名,每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 LIVE.100011001 Invalid request parameter. 请求参数非法。 可能缺少必要参数,或者参数值格式不正确,具体错误信息请查看错误描述
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 LIVE.100011001 Invalid request parameter. 请求参数非法。 可能缺少必要参数,或者参数值格式不正确,具体错误信息请查看错误描述
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型
客户端错误码 本章节介绍了低时延直播Web SDK的客户端错误码的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 HWLLS_OK 0 成功。 - HWLLS_ERROR_INVALID_URL 50000000 URL不合法。 检查URL是否正确。
客户端对象(HWFlvClient) 本章节介绍了低时延直播Web SDK的HWFlvClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放,客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
查询播放流量趋势接口 功能介绍 查询播放域名流量数据。 如果不传入域名,则查询租户下所有播放域名的流量数据。 当查询租户级别流量数据时,参数app、stream不生效。 最大查询跨度31天,最大查询周期一年。 指定起始时间和结束时间时,起始时间必须为时间粒度的整时刻点,结束时间为不包含整点时刻。
修改直播域名 功能介绍 修改直播播放、RTMP推流加速域名相关信息 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
开发前准备 前提条件 已下载SDK包。 环境要求 编译工具推荐安装Microsoft Visual Studio Code 1.43.2或以上版本。 如果客户端用Node.js开发,推荐安装14.19.1或以上版本。 支持的浏览器详情请参见浏览器适配详情。 如果客户端用TypeS
修改录制回调配置 功能介绍 修改录制回调配置接口 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/record/callbacks/{id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
删除指定域名的Key防盗链配置 功能介绍 删除指定域名的Key防盗链配置 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/guard/key-chain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
查询截图用量接口 功能介绍 查询直播域名每小时的截图数量。 最大查询跨度31天,最大查询周期1年。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。 URI GET /v2
查询直播拉流HTTP状态码接口 功能介绍 查询直播拉流HTTP状态码接口。 获取加速域名1分钟粒度的HTTP返回码。 最大查询跨度不能超过24小时,最大查询周期7天。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。
OBS桶授权及取消授权 功能介绍 OBS桶授权及取消授权 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/obs/authority 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对
客户端对象(HWHlsClient) 本章节介绍了低时延直播Web SDK的HWHlsClient接口详情。 表1 主入口接口 接口 描述 startPlay 开始播放,客户端根据输入的URL到服务端拉取对应的主播流。 switchPlay 快速切换下一路流播放。 stopPlay
查询播放画像信息接口 功能介绍 查询播放画像信息。 最大查询跨度1天,最大查询周期31天。 该接口仅支持查询FLV和RTMP流的在线人数。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。
查询推流码率数据接口 功能介绍 查询推流监控码率数据接口。 最大查询跨度1天,最大查询周期7天。 返回的码率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API。