检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 媒体直播为广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 您可以使用本文档提供API对媒体直播进行相关操作,如媒体直播转码模板管理、创建频道等。支持的全部操作请参见API概览。 在调用媒体直播API之前,请确保已经充分了解媒体直播相关概念,详细信息请参见《媒体直播用户指南》。
HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的
无法连接服务端。 检查网络状态是否正常或联系华为工程师。 HWLLS_ERROR_SERVER_NO_RESPONSE 50000003 服务器无响应。 联系华为工程师。 HWLLS_ERROR_AUTH_FAIL 50000004 鉴权失败。 请检查服务侧Referer防盗链以及key防盗链的配置是否正确。
添加域名 使用媒体直播服务前,您需要将已备案的推流域名和播放域名添加到媒体直播服务中。 在接入媒体直播服务前,您可以先了解下直播加速域名的接入条件及限制,避免因域名涉及违规内容而造成损失,具体请参见域名准入标准。 域名接入流程 使用自有域名进行视频直播加速的流程,如图1所示。 图1
API概览 媒体直播服务对应的接口列表如下所示,在调用媒体直播API前,您需要先获取用户Token,Token可以用于调用其他API时鉴权,具体如何调用媒体直播API请参考应用示例。 OTT频道管理接口 表1 OTT频道管理接口 接口 说明 POST /v1/{project_id}/ott/channels
媒体直播限制 在使用媒体直播服务前,您需要了解本服务的使用限制信息。 频道入流约束 表1 频道入流约束 限制项 说明 转码帧率 转码帧率不支持配置高于源流。 转码分辨率 转码分辨率不支持配置高于入流分辨率。 音视频编码器 视频支持H.264、H.265。 音频支持AAC、MP1、MP2和MP3。
使用限制 在使用媒体直播服务前,您需要了解本服务的使用限制信息。 频道入流约束 表1 频道入流约束 限制项 说明 转码帧率 转码帧率不支持配置高于源流。 转码分辨率 转码分辨率不支持配置高于入流分辨率。 音视频编码器 视频支持H.264、H.265。 音频支持AAC、MP1、MP2和MP3。
此字段携带请求ID号,以便任务跟踪。格式为:request_id-timestamp-hostname(request_id在服务器端生成UUID,timestamp为当前时间戳,hostname为处理当前接口的服务器名称) 状态码: 400 表4 响应Header参数 参数 参数类型 描述 X-request-id
com”为例,此处输入“play-test”。 线路类型 用于DNS服务器在解析域名时,根据访问者的来源,返回对应的服务器IP地址,具体请参见解析线路。 仅支持为公网域名的记录集配置此参数。 选择“全网默认”。 TTL (秒) 解析记录在本地DNS服务器的缓存时间,以秒为单位。 数值越小,修改记录各地生效时间越快。
在左侧菜单栏选择“直播”,输入步骤1获取的直播推流URL。 图4 直播设置 推流地址分两部分输入“URL”和“流名称”中。具体填写规则如下: “服务器”:填写包含AppName前的地址,如"rtmp://livepush-test.huaweicloud.com/live/"。 “推流码
com”为例,此处输入“play-test”。 线路类型 用于DNS服务器在解析域名时,根据访问者的来源,返回对应的服务器IP地址,具体请参见解析线路。 仅支持为公网域名的记录集配置此参数。 选择“全网默认”。 TTL (秒) 解析记录在本地DNS服务器的缓存时间,以秒为单位。 数值越小,修改记录各地生效时间越快。
此字段携带请求ID号,以便任务跟踪。格式为:request_id-timestamp-hostname(request_id在服务器端生成UUID,timestamp为当前时间戳,hostname为处理当前接口的服务器名称) 状态码: 400 表6 响应Header参数 参数 参数类型 描述 X-request-id
概述 媒体直播面向广电、运营商、互联网OTT服务商等PGC用户为主,依托华为云全球部署的众多可用区计算资源,结合深耕多年的音视频技术,致力于为全球用户提供专业、稳定、高质量的7*24小时广播级媒体直播服务体验。 开通视频直播控制台即开通云直播服务,开通指南请参见快速入门。 产品架构
在左侧菜单栏选择“直播”,输入步骤1获取的直播推流URL。 图4 直播设置 推流地址分两部分输入“URL”和“流名称”中。具体填写规则如下: “服务器”:填写包含AppName前的地址,如"rtmp://livepush-test.huaweicloud.com/live/"。 “推流码
100011000 Internal communication error. 内部服务器通信异常 提交工单,申请技术客服协助解决问题 500 LIVE.100011005 Internal server error. 服务器内部出现错误 请稍后重试或者联系客服人员帮忙解决 500 LIVE.100011007
100011000 Internal communication error. 内部服务器通信异常 提交工单,申请技术客服协助解决问题 500 LIVE.100011005 Internal server error. 服务器内部出现错误 请稍后重试或者联系客服人员帮忙解决 500 LIVE.100011007
HttpConfig::getDefaultConfig(); (可选操作)配置代理。 1 2 3 4 5 6 7 8 // 使用代理服务器(可选) // 代理服务器的password直接写入代码,会有很大安全风险。建议密文形式存储在配置文件或者环境变量中,待使用时再解密,以确保安全。 //
视频直播提供了直播流开停播通知功能,您可以在直播控制台中为推流域名添加接收直播推流或断流通知的地址,通过HTTP接口向用户服务器发送POST请求,将直播流推送成功或中断的状态实时反馈到用户服务器,用户服务器通过200响应返回接口结果。 华北-北京一、华北-北京四、亚太-新加坡区域已发布 如何配置开停播通知?
视频直播提供了直播流开停播通知功能,您可以在直播控制台中为推流域名添加接收直播推流或断流通知的地址,通过HTTP接口向用户服务器发送POST请求,将直播流推送成功或中断的状态实时反馈到用户服务器,用户服务器通过200响应返回接口结果。 华北-北京一、华北-北京四、亚太-新加坡区域已发布 如何配置开停播通知?
HttpConfig.get_default_config() (可选操作)配置代理。 1 2 3 4 5 6 7 8 # 使用代理服务器(可选) # 代理服务器的password直接写入代码,会有很大安全风险。建议密文形式存储在配置文件或者环境变量中,待使用时再解密,以确保安全。 #