- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 产品彩页
- 计费说明
- 云直播
- 媒体直播
- 最佳实践
- 云直播API参考
- 媒体直播API参考
- 云直播服务端SDK参考
- 低时延客户端SDK参考
- 场景代码示例
-
常见问题
- 高频问题导航
- 产品咨询
-
计费购买
- 点播的流量包直播服务能用吗?
- 如何查看直播套餐包的使用详情?
- 直播套餐包是否支持退订?
- 直播套餐包使用完之后会被停服吗?
- 购买了直播CDN出流包,为什么还会从账户余额扣费?
- 购买云直播转码套餐后,产生的转码费用未从套餐包中抵扣?
- 如何估算视频直播的流量消耗?
- 云直播录制需要收取哪些费用?
- 视频直播有哪些计费项?如何知道自己需要支付哪些费用?
- 如何查看直播按需资源的使用量和消费金额?
- 如何修改直播服务的计费方式?
- 不使用时是否需要停用或删除直播服务?
- 直播流量计费是按下行流量还是上行流量?
- 为什么账户欠费后仍一直产生直播费用?
- 视频直播服务的Key防盗链功能是否收费?
- 云直播转码是如何计费的?
- 如何知道账户是否欠费?
- 日峰值带宽是指上行带宽还是下行带宽?
- 为什么每月1号都会扣除一笔录制费用?
-
域名管理
- 什么是ICP备案?
- ICP备案是否是必须的?
- 如何进行ICP备案?
- 为什么要进行资质审核?审核未通过有什么影响?
- 域名已备案,如何在直播中添加域名?
- 直播服务许可证是否是必须的?如何办理?
- 添加域名时,提示“ICP编号不存在”怎么办?
- 域名管理中的消息订阅界面为什么操作不了?
- 一个租户最多可以添加多少个直播域名?
- 添加的播放域名和推流域名有什么要求?
- 域名管理界面的CNAME的作用是什么?
- 添加域名时,提示“添加失败,用户处于删除状态”怎么办?
- 为什么域名状态会从“正常”变为“配置中”?
- 配置CNAME域名解析,提示冲突?
- 播放域名和推流域名可以为二级域名吗?
- 一个域名是否可以同时添加在多个区域的直播服务中?
- 如何验证直播域名是否启动加速?
- 欠费后,域名是否会被清除掉?
- 更改了推拉流配置后,需要断流多长时间才能重新推流生效?
- 为什么直播控制台创建域名后,我的资源中未展示?
- 为什么直播控制台删除域名后,我的资源中仍展示?
- 如何查看我的资源?
-
直播录制
- 直播录制支持什么录制格式和播放格式?
- 直播录制后,为什么在控制台和回调信息中无播放地址?
- 是否支持直播录制存储至OBS桶中?
- 直播录制周期最多支持录制多长时间?
- 是否支持为每个直播流配置录制模板?
- 直播录制是否会录制转码流?
- 直播录制支持的ts分片大小是多少?
- 一次直播录制会生成几个录制文件?
- 已经删除录制规则,为什么还会生成录制文件?
- 为什么直播推流未中断,录制文件分成了两个?
- 直播录制后,如何获取录制文件地址?
- 是否支持通过调用API进行直播录制?
- 配置了录制至OBS模板,为什么未生成录制文件?
- 录制至OBS模板中,流名称是否支持通配符?
- 如何删除录制文件?
- 直播录制是否支持按需启停?
- 直播录制为什么无法收到RECORD_FILE_COMPLETE回调?
- 直播录制流名StreamName是否支持正则表达式的配置?
- 为什么直播录制生成的download_url无法下载视频?
- 修改了录制规则及文件存储路径,为什么没有生效?
- 直播中断流多次,可以录制成一个文件吗?
- 直播转码
- 直播截图
- 直播安全
- 直播推流
- 直播播放
- 直播回调
- API使用
- 统计分析
- 第三方工具使用
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
配置消息通知
直播服务使用消息通知服务对直播录制状态进行实时通知,如需使用该功能,需要先配置消息通知服务。由于消息通知由消息通知服务(SMN)完成,所以SMN将对发送的消息通知进行单独计费,具体的计费标准请参考SMN价格详情。
背景介绍
- 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道,为发布者和订阅者提供一个可以相互交流的通道。在配置直播消息订阅前必须定制主题。
- 消息订阅是客户将订阅者注册到主题的操作,客户可以拥有多个主题,每个主题有多个订阅者。
- 消息订阅暂以项目ID进行区分,即同一个项目ID的域名暂只能使用同一个消息订阅,消息订阅配置对同一个项目ID的所有域名生效。
配置流程
消息订阅的配置流程,如图1所示。
步骤一:创建消息主题
- 登录管理控制台。
- 单击“服务列表 > 消息通知服务”。
- 在左侧导航树中,选择“主题管理 > 主题”,进入主题页面。
- 单击“创建主题”,设置主题名称等参数。
参数配置说明,详见创建主题。图2 创建主题
- 单击“确定”,消息主题创建成功。
步骤二:添加订阅
- 在消息通知服务的左侧导航树中,选择“主题管理 > 主题”,进入主题页面。
- 在已创建的主题行单击“操作”列的“添加订阅”,右侧弹出“添加订阅”页面。
- 配置消息通知的类型和对象。
图3 添加订阅
表1 添加订阅参数说明 参数名
描述
主题名称
待添加订阅的主题名称,不需要修改。
协议
消息通知的方式。在下拉框中选择需要订阅终端支持的协议。
直播服务常用的消息通知方式为“短信”、“邮件”和“HTTP/HTTPS”。
- 短信协议
- 邮件协议
- HTTP/HTTPS协议
订阅终端为公网网址,消息通知服务向HTTP(S)终端发送的通知消息包括HTTP头部信息与HTTP Content部分。Content部分是JSON格式的字符串。具体详情请参见HTTP(S)消息格式。
订阅终端
订阅的终端地址,短信、邮件、HTTP以及HTTPS终端支持批量输入,批量添加时,每个终端地址占一行。最多可输入10个终端。
- 添加订阅后,配置的订阅终端将收到确认订阅消息。若订阅终端为邮件,如图4所示。确认后,设置的订阅终端才能收到该主题发布的消息。
步骤三:设置主题策略
- 在消息通知控制台的左侧导航树中,选择“主题管理 > 主题”,进入主题页面。
- 在创建的主题行单击“操作”列的“更多 > 设置主题策略”,弹出“设置主题策略”页面。
- 配置主题策略的参数
图5 主题策略设置
访问策略分为基本模式和高级模式,其中基本模式只可对用户和服务设置发布消息的操作权限,如表2所示。也可直接参考设置主题策略。
表2 基本模式说明 策略对象
参数名
描述
可发布消息的用户
仅自己(主题创建者)
仅主题创建者有权限向该主题发布消息。
所有人
所有用户均有权限向该主题发布消息。
仅如下用户
设置可向该主题发布消息的用户。
格式为urn:csp:iam::domainId:root
其中,domainId即为用户的账号ID。多个用户时,以英文逗号隔开,可输入的用户数量没有限制,但生成的策略总长度不超过30KB。说明:- 您只需填写用户的“账号ID”,输入完成后,单击“确定”。其余内容由系统自动补全。
- “账号ID”的获取方式:登录消息通知服务控制台,单击右上角用户名下的“我的凭证”,可查看“账号ID”。
可发布消息的服务
设置项如上图所示。
勾选“LIVE”,表示授权该云服务可对该主题进行操作。
录制通知消息模板
录制通知的消息模板如下所示,消息中各字段说明如表3所示。
Live Record Notify, domain: {domain}, app_name: {app_name}, stream_name: {stream_name}, download_url: {download_url}, filename: {filename},asset_id: {asset_id}, duration: {duration}, event: {event}, timestamp: {timestamp}
字段 |
描述 |
---|---|
domain |
推流域名。 |
app_name |
应用名称,与推流地址中的AppName保持一致。 |
stream_name |
直播流名称。 |
download_url |
录制文件的下载地址,当event的值不为RECORD_NEW_FILE时,该字段为空。 |
filename |
录制文件的名称,当event的值不为RECORD_NEW_FILE时,该字段为空。 |
asset_id |
录制文件的媒资ID,点播服务分配给该录制文件的唯一标识,当event的值不为RECORD_NEW_FILE时,该字段为空。 |
duration |
录制文件的时长,当event的值不为RECORD_NEW_FILE时,该字段为0。 |
event |
录制事件,包括:
|
timestamp |
录制时间戳。 |