检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK概述 华为云提供了直播服务端SDK,您可以直接集成服务端SDK来调用直播的相关API,从而实现对直播服务的快速操作。目前视频直播提供了Java、Python、Go和PHP四种语言SDK供开发者使用,如表1所示。
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。 Token认证:通过Token认证调用请求
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
删除直播域名 功能介绍 删除域名。只有在域名停用(off)状态时才能删除。 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
查询直播域名 功能介绍 查询直播域名 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数
修改域名HLS配置 功能介绍 修改域名HLS配置。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain/hls 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID
查询推流监控数据接口 功能介绍 查询推流监控数据接口,包括帧率码率断流情况。 最大查询跨度1天,最大查询周期7天。 返回的码率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法
您可以在华为云SSL证书管理中购买。 HTTPS证书格式满足HTTPS证书要求,若您的证书为非PEM格式,请参照HTTPS证书要求进行格式转换。 启用HTTPS 登录视频直播控制台。 在左侧导航栏中,选择“域名管理”,进入域名管理页面。
使用go get安装华为云Go SDK,执行如下命令安装华为云Go SDK库以及相关依赖库,具体的SDK版本号请参见SDK开发中心。
修改播放域名延时配置 功能介绍 修改播放域名延时配置。 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain/delay 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
修改直播截图配置 功能介绍 修改直播截图配置接口 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/stream/snapshot 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
示例1:创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用直播接口时进行认证鉴权。
配置录制回调 直播服务提供了录制文件生成状态回调设置,支持配置HTTP/HTTPS URL,向用户服务器发送POST请求、消息体JSON格式,将文件生成事件信息实时反馈到用户服务器。 前提条件 已添加推流域名。 已在域名DNS服务商处完成CNAME解析配置。 操作步骤 登录视频直播控制台
belongs Boolean 是否是华为云CDN节点。 true:是华为云CDN节点 false:不是华为云CDN节点 region String IP归属地省份。Unknown:表示未知归属地 isp String 运营商名称。如果IP归属地未知,该字段返回null。
创建直播域名 功能介绍 可单独创建直播播放域名或推流域名,每个租户最多可配置64条域名记录。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
查询域名HLS配置 功能介绍 查询域名HLS配置。 调用方法 请参见如何调用API。 URI GET /v1/{project_id}/domain/hls 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID
修改直播域名 功能介绍 修改直播播放、RTMP推流加速域名相关信息 调用方法 请参见如何调用API。 URI PUT /v1/{project_id}/domain 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目
查询推流帧率数据接口 功能介绍 查询推流帧率数据接口。 最大查询跨度1天,最大查询周期7天。 返回的帧率数据列表粒度为1秒钟。 接口约束 该接口暂只支持查询部署在新版视频直播服务上的域名的相关数据(不包含“华北-北京一”)。此约束条件仅适用于中国站。 调用方法 请参见如何调用API
已获取华为云账号对应的Access Key(AK)和Secret Access Key(SK)。请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见访问密钥。