检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
功能特性 华为云标准直播提供了直播推流、直播播放、直播转码、直播录制等功能,广泛地用于在线教育、互动文娱等场景。具体如表1所示。 HTTP协议存在安全风险,建议使用HTTPS协议。 表1 功能特性 类别 特性名称 特性说明 直播推流 推流协议 支持RTMP协议推流,也支持纯音频或纯视频推流。
API概览 视频直播服务对应的接口列表如下所示,在调用视频直播API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权,具体如何调用直播API请参考应用示例。 域名管理接口 表1 域名管理接口 接口 说明 POST /v1/{project_id}/domain
云直播限制 在使用云直播服务前,您需要了解本服务的使用限制信息。 使用限制 表1 使用限制说明 限制项 说明 并发直播流 对并发直播流未做相关限制,但若有超过100G的大规模并发需求,建议提交工单进一步咨询。 推流 视频直播服务不限制推流码率,支持常见分辨率以及对应码率,但为了保证推流顺畅,建议码率不超过4Mbps。
修订记录 表1 修订记录 发布日期 修改说明 2024-02-23 第五十一次发布: 本次变更如下: 修改创建录制规则和修改录制规则接口FLV、MP4格式的“record_cycle” 字段最大值。 2023-09-19 第五十次发布: 本次变更如下: 修改转码模板管理组接口。请
检查CNAME是否生效 由于视频直播服务默认开启直播下行加速服务,即播放加速,若您未配置CNAME解析,将由于无法解析播放域名,导致播放失败。请您参照如下方法,验证播放CNAME是否配置成功。 登录视频直播控制台。 在左侧导航树中,选择“域名管理”。 在域名列表中,获取播放域名的CNAME。 图2 域名管理
间隔,iFrameInterval字段不生效。 bitrate_adaptive String 自适应码率参数。 包含如下取值: off:关闭码率自适应,目标码率按设定的码率输出。 minimum:目标码率按设定码率和源文件码率最小值输出(即码率不上扬)。 adaptive:目标码率按源文件码率自适应输出。
参数配置说明,如表1所示。 图1 开停播通知配置 表1 参数配置 参数 说明 协议 推流通知地址支持HTTP/HTTPS协议。HTTP可能存在安全问题,推荐使用HTTPS。 推流通知地址 通知地址仅支持HTTP和HTTPS协议。 鉴权密钥(可选) 鉴权Key值。若需要使用通知鉴权功能,请配置鉴权密钥,否则,留空即可。
描述 error_code String 错误码 error_msg String 错误描述 请求示例 创建录制回调配置。 POST https://{endpoint}/v1/{project_id}/record/callbacks { "publish_domain"
”,则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可,如下所示。 1 2 3 POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type:
视频直播服务默认开启直播上行加速服务,即推流加速。若您的推流域名未配置CNAME解析,则会由于无法解析推流域名,从而导致推流失败。请您参照如下步骤,验证推流域名的CNAME是否配置成功。 登录视频直播控制台。 在左侧导航树中,选择“域名管理”。 在域名列表中,获取推流域名的CNAME。 图2
直播服务常用的消息通知方式为“短信”、“邮件”和“HTTP/HTTPS”。 短信协议 订阅的终端为手机,接收到的消息只包含消息内容。 邮件协议 订阅终端为邮箱,接收到的消息包含消息内容和取消订阅的链接。 HTTP/HTTPS协议 订阅终端为公网网址,消息通知服务向HTTP(S)终端
is not supported. The API only supports the HTTPS protocol. 协议不支持,当前API仅支持https协议,不支持http协议 请使用https协议 400 LIVE.100011006 This API is not supported
is not supported. The API only supports the HTTPS protocol. 协议不支持,当前API仅支持https协议,不支持http协议 请使用https协议 400 LIVE.100011006 This API is not supported
on:启用。 off:不启用。 call_back_url String 通知服务器地址,必须是合法的URL且携带协议,协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。 表6 ObsFileAddr 参数 参数类型 描述 bucket String OBS的bucket名称
on:启用。 off:不启用。 call_back_url 否 String 通知服务器地址,必须是合法的URL且携带协议,协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。 表4 ObsFileAddr 参数 是否必选 参数类型 描述 bucket 是 String
描述 error_code String 错误码 error_msg String 错误描述 请求示例 删除直播域名。 DELETE https://{endpoint}/v1/{project_id}/domain?domain=play.example.com 响应示例 状态码:
描述 error_code String 错误码 error_msg String 错误描述 请求示例 删除直播转码模板。 DELETE https://{endpoint}/v1/{project_id}/template/transcodings?domain=play.example
服务从URL拉流直接推流到源站。 如果媒资输入类型为“HLS_PULL”时,用户提供的音视频URL需注意: 拉流URL仅支持HTTP、HTTPS协议,暂不支持其他协议。 不支持加密流。 不支持纯音频。 不支持展示字幕。 默认不展示“HLS_PULL”,需提交工单申请使用。 SRT
描述 error_code String 错误码 error_msg String 错误描述 请求示例 查询播放域名延时配置。 GET https://{endpoint}/v1/{project_id}/domain/delay?play_domain=pull.example.test
响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 请求示例 GET https://{endpoint}/v1/{project_id}/realtime/streams?publish_domain=push.example