检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 媒体直播为广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 您可以使用本文档提供API对媒体直播进行相关操作,如媒体直播转码模板管理、创建频道等。支持的全部操作请参见API概览。 在调用媒体直播API之前,请确保已经充分了解媒体直播相关概念,详细信息请参见
OTT频道管理 新建OTT频道 查询频道信息 删除频道信息 修改频道打包信息 修改频道入流信息 修改频道录制信息 修改频道通用信息 修改频道状态 修改频道转码模板信息
使用前必读 视频直播服务(Live)是在华为云提供的可信,开放,全球服务直播内容接入与分发网络的基础上,将华为公司在视频领域的多年技术积累和电信级运营和运维能力开放出来,构建了便捷接入、高清流畅、低延迟、高并发的一站式视频直播解决方案。 您可以使用本文档提供API对视频直播进行相关操作
域名管理 创建直播域名 删除直播域名 修改直播域名 查询直播域名 域名映射 删除直播域名映射关系 配置域名IPV6开关 查询IP归属信息 修改播放域名延时配置 查询播放域名延时配置 修改域名HLS配置 查询域名HLS配置 修改直播拉流回源配置 查询直播拉流回源配置
日志管理 获取直播播放日志
禁推恢复 功能介绍 恢复直播推流接口 调用方法 请参见如何调用API。 URI DELETE /v1/{project_id}/stream/blocks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。
示例1:创建转码模板 本节通过调用一系列直播的API来创建转码模板。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用直播接口时进行认证鉴权。
修订记录 表1 修订记录 发布日期 修改说明 2023-12-30 第一次正式发布。
截图管理 创建直播截图配置 修改直播截图配置 查询直播截图配置 删除直播截图配置
地区名称缩写 表1 地区名称缩写 地区 英文缩写 其他 OT 北京 BJ 天津 TJ 重庆 CQ 上海 SH 广东 GD 海南 HI 广西 GX 云南 YN 山西 SX 河北 HE 内蒙古 NM 宁夏 NX 辽宁 LN 吉林 JL 黑龙江 HL 江苏 JS 浙江 ZJ 江西 JX
国家名称缩写 表1 国家名称缩写 国家 英文缩写 阿富汗 AF 奥兰群岛 AX 阿尔巴尼亚 AL 阿尔及利亚 DZ 美属萨摩亚 AS 安道尔 AD 安哥拉 AO 安圭拉 AI 安提瓜和巴布达 AG 阿根廷 AR 亚美尼亚 AM 阿鲁巴 AW 澳大利亚 AU 奥地利 AT 阿塞拜疆
示例1:创建频道 本节通过调用一系列媒体直播的API来创建频道。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 操作步骤 获取用户Token,用于调用媒体直播接口时进行认证鉴权。
状态码 调用视频直播API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体
状态码 调用视频直播API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体
OBS桶管理 OBS桶授权及取消授权
HTTPS证书管理 修改指定域名的https证书配置 查询指定域名的https证书配置 删除指定域名的https证书配置
修改频道录制信息 功能介绍 修改频道录制信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI PUT /v1/{project_id}/ott/channels/record-settings
修改频道打包信息 功能介绍 修改频道打包信息。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI PUT /v1/{project_id}/ott/channels/endpoints
提交录制控制命令 功能介绍 对单条流的实时录制控制接口。 接口约束 在录制规则类型为COMMAND_RECORD的时候有效。 调用方法 请参见如何调用API。 URI POST /v1/{project_id}/record/control 表1 路径参数 参数 是否必选 参数类型
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录