检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
on:启用。 off:不启用。 call_back_url String 通知服务器地址,必须是合法的URL且携带协议,协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。 表6 ObsFileAddr 参数 参数类型 描述 bucket String OBS的bucket名称
工具库 防盗地址生成
通过以下方式获取推流鉴权地址。 Key防盗链配置成功后,原始地址将无法使用,您需要获取对应的推流鉴权地址。 自动生成:使用防盗链地址生成工具快速生成鉴权地址,具体生成方法请参见防盗链地址生成。 手动拼接:根据配置的鉴权类型拼接对应的鉴权地址,具体拼接示例请参见Key防盗链。 鉴权方式A 鉴权URL格式
on:启用。 off:不启用。 call_back_url 否 String 通知服务器地址,必须是合法的URL且携带协议,协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。 表4 ObsFileAddr 参数 是否必选 参数类型 描述 bucket 是 String
播放域名和推流域名可以为二级域名吗? 为什么域名状态会从“正常”变为“配置中”? 直播录制 已经删除录制规则,为什么还会生成录制文件? 是否支持通过调用API进行直播录制? 配置了录制至OBS模板,为什么未生成录制文件? 录制至OBS模板中,流名称是否支持通配符? 直播推流 视频直播服务支持哪些推流协议?
record_max_duration_to_merge_file 否 Integer 录制HLS文件拼接时长,如果流中断超过该时间,则生成新文件。 单位:秒 默认值:0 0:表示流中断就生成新文件。 -1:表示相同的流中断恢复后,继续在30天内的前一个文件保存。 表7 FLVRecordConfig 参数
record_max_duration_to_merge_file 否 Integer 录制HLS文件拼接时长,如果流中断超过该时间,则生成新文件。 单位:秒 默认值:0 0:表示流中断就生成新文件。 -1:表示相同的流中断恢复后,继续在30天内的前一个文件保存。 表7 FLVRecordConfig 参数
描述 error_code String 错误码 error_msg String 错误描述 请求示例 修改禁止直播推流属性。 POST https://{endpoint}/v1/{project_id}/stream/blocks { "domain" : "publish
设置Referer防盗链黑白名单 删除Referer防盗链黑白名单 查询Referer防盗链黑白名单 查询IP黑/白名单 修改IP黑/白名单 生成URL鉴权串 查询播放域名的地域限制列表 修改播放域名的地域限制配置 查询指定域名的Key防盗链配置 更新指定域名的Key防盗链配置 删除指定域名的Key防盗链配置
ShowTraffic 查询直播加速的流量数据 showOnlineUsers show_online_users ShowOnlineUsers 查询直播播放在线人数 listBandwidthDetail list_bandwidth_detail ListBandwidthDetail 查询播放带宽趋势接口
描述 error_code String 错误码 error_msg String 错误描述 请求示例 修改域名HLS配置。 PUT https://{endpoint}/v1/{project_id}/domain/hls { "push_domain" : "push.example
me”自定义即可,如,huawei1。具体请参见原始推流地址。 若您域名配置后,还配置了key防盗链,则需要使用鉴权地址推流。具体鉴权地址生成示例请参见推流Key防盗链。 鉴权方式A的鉴权地址为:原始URL?auth_key={timestamp}-{rand}-{uid}-{md5hash}
响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 请求示例 PUT https://{endpoint}/v1/{project_id}/guard/referer-chain { "domain" : "play
要提前开启FunctionGraph资源委托授权。授权成功后,媒体直播服务才能查询用户的函数、工作流、触发器,并调用函数。 回看和时移地址生成 支持获取频道回看和时移地址,回看频道历史播放内容。
String 此字段携带请求ID号,以便任务跟踪。格式为:request_id-timestamp-hostname(request_id在服务器端生成UUID,timestamp为当前时间戳,hostname为处理当前接口的服务器名称) 状态码: 400 表4 响应Header参数 参数
查询的时间跨度最长为7天,若需要下载的日志时间跨度超过7天,则需要按照实际情况分多次查询后进行下载。 日志说明 日志命名规则:播放域名_日志时间.log.gz 日志生成规则:日志默认按5分钟粒度进行分割,若域名无请求,则不会产生日志数据包。正在进行拉流的直播日志一般4个小时后才能获取到最完整的日志文件。 日志格式:
订阅录制通知消息。消息类型。RECORD_NEW_FILE_START开始创建新的录制文件。RECORD_FILE_COMPLETE录制文件生成完成。RECORD_OVER录制结束。RECORD_FAILED表示录制失败。如果不填写,默认订阅RECORD_FILE_COMPLETE
String 此字段携带请求ID号,以便任务跟踪。格式为:request_id-timestamp-hostname(request_id在服务器端生成UUID,timestamp为当前时间戳,hostname为处理当前接口的服务器名称) 状态码: 400 表6 响应Header参数 参数
用直播服务前完成注册并备案。配置完播放域名后,直播服务会生成对应的播放地址,拼接规则请参见播放URL。 推流域名 指用于推送直播流的域名,必选配置,该域名必须在使用直播服务前完成注册并备案。配置完推流域名后,直播服务会生成对应的推流地址,拼接规则请参见推流URL。 播放CNAME
您可以在直播域名配置列表中单击“管理”获取直播推流URL,如图1所示。 图1 直播推流URL 以仅配置了播放域名场景的直播推流URL为例,推流URL的生成规则请参见查看推流URL。 按照软件安装向导安装好OBS软件。 配置OBS的关键参数。 单击右下角的“设置”,如图2所示。 图2 设置OBS参数