用户指南
文档版本 01
发布日期 2022-02-28
版权所有 © 华为技术有限公司 2022。 保留一切权利。
非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传 播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标,由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束,本文档中描述的全部或部分产品、服务或 特性可能不在您的购买或使用范围之内。除非合同另有约定,华为公司对本文档内容不做任何明示或暗示的声 明或保证。
由于产品版本升级或其他原因,本文档内容会不定期进行更新。除非另有约定,本文档仅作为使用指导,本文 档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
目 录
1 使用前必读... 1
2 功能介绍...4
3 IAM 权限管理... 8
3.1 创建用户并授权使用 Live... 8
4 域名管理...10
4.1 添加域名... 10
4.2 关联域名... 13
4.3 配置 CNAME...14
4.4 管理域名... 17
5 推流配置...20
5.1 拼接推流地址...20
5.2 直播转码... 21
5.3 直播录制至 OBS... 25
5.3.1 配置录制模板... 25
5.3.2 配置录制回调... 30
5.3.3 管理录制文件... 35
5.4 直播录制至 VOD... 37
5.4.1 直播录制... 37
5.4.2 配置消息通知... 41
5.5 直播截图... 48
5.6 开停播通知... 53
5.7 推流鉴权... 56
6 播流配置...57
6.1 拼接播放地址...57
6.2 直播延时... 59
6.3 直播拉流回源...60
6.4 HTTPS 安全加速管理... 62
6.4.1 配置方法... 62
6.4.2 HTTPS 证书要求...64
6.5 播放鉴权(新版)... 68
6.5.1 概述... 68
6.5.2 Referer 防盗链... 68
6.5.3 Key 防盗链... 70
6.5.4 IP 黑白名单... 77
6.6 播放鉴权(旧版)... 78
6.6.1 概述... 78
6.6.2 Referer 防盗链... 79
6.6.3 Key 防盗链... 81
7 直播流管理...87
8 统计分析(新版)... 89
8.1 直播统计... 89
8.2 增值服务统计...92
8.3 流播放画像... 94
8.4 HTTP 状态码统计... 95
9 统计分析...96
9.1 下行带宽... 96
9.2 下行流量... 97
9.3 上行带宽... 98
9.4 推流路数... 99
10 流监控... 101
10.1 历史推流列表...101
10.2 推流帧码率... 102
11 大屏监控(Beta)... 104
12 日志管理... 108
13 云导播... 111
13.1 功能简介... 111
13.2 导播台管理... 113
13.3 5G 背包设置...116
14 工具库... 118
14.1 防盗地址生成...118
15 附录... 120
15.1 配置 CNAME(非华为云)...120
1 使用前必读
新版视频直播服务在旧版的基础上进行了优化升级,提供了更多更强大的直播流处理 功能,当前新旧版视频直播的具体功能区别如表1-1所示。
说明
● 新版视频直播服务将会持续上线新的功能,在新版上线前添加的推流域名和播放域名后续仍 部署在旧版视频直播服务上,不能使用新版的相关功能。
● 若需要使用新版直播功能,您可以先删除旧版上的域名,然后重新添加。删除旧版上的域名 时,相关的配置也将一并删除,您需要在新版上重新进行配置。
表1-1 新旧版视频直播区别
功能列表 新版 旧版
域名管理 ● 支持添加域名。
● 支持启用、 停用和删除域名。
● 支持关联域名,可以关联部署 在旧版或新版上的推流域名。
● 支持启用、 停用和删除域 名。
● 支持关联域名,可以关联部署 在旧版或新版上的推流域名。
转码配置 支持 支持
录制配置 支持 支持
截图配置 支持 支持
开停播通知 支持 不支持
推流鉴权 ● 支持Key防盗链和IP黑白名单两 种推流鉴权,且Key防盗链支持 三种鉴权算法。
● 可以自行在控制台完成推流鉴 权配置。
支持Key防盗链,需要提交工单 申请后台配置。
延时配置 支持 不支持
拉流回源配 置
支持 不支持
功能列表 新版 旧版 HTTPS安全
加速
支持 不支持
播放鉴权 ● 支持Referer防盗链、Key防盗 链、IP黑白名单三种播放鉴 权,且Key防盗链支持三种鉴权 算法。
● 可以自行在控制台完成播放鉴 权的配置。
● 支持Referer防盗链、Key防盗 链。
● 控制台完成防盗链配置后,需 要提交工单申请后台审核处 理。
下行流量/
下行带宽
支持按域名、省份和运营商查询。 仅支持按域名查询。
上行带宽/
推流路数
支持 支持
在线观看人 数统计
支持 不支持
转码/录制/
截图用量统 计
支持 不支持
流播放画像 信息
支持 不支持
HTTP状态 码统计
支持 不支持
流监控 支持 不支持
大屏监控 支持对所有直播资源的用量及分布 情况进行实时监控。
不支持
日志管理 支持 不支持
跨域使用 支持跨域请求,无需后台配置。 支持跨域请求,需要提交工单申 请后台配置。
防盗地址生
成工具 支持自动生成推流和播放域名对应
的鉴权地址。 不支持
如何查询域名是新版还是旧版?
您可以在视频直播控制台的域名管理中查看现有的域名是否部署在新版视频直播服务 上,具体步骤如下所示:
1. 登录视频直播控制台,在左侧导航树中选择“域名管理”。
2. 在需要查看的域名行单击“管理”,进入基本信息页。
3. 您可以在基本信息页的上方查看到该域名是否部署在新版视频直播服务上。
图1-1 域名基本信息
2 功能介绍
在视频直播控制台,您可以快速进行直播域名的管理、直播流管理、转码、录制等基 础功能的配置。同时,视频直播控制台还提供了资源监控服务,方便您进行实时数据 分析。
概览
登录视频直播控制台,默认进入“概览”页面,您可以在该页面查看直播今日的下行 流量和带宽,查询近期的下行流量、下行带宽和上行带宽的使用趋势。您也可以单击 右上角的“快速上手”,查看视频直播入手指南。
图2-1 概览
● 今日数据:主要呈现本日视频直播的下行流量和下行带宽峰值用量情况。
表2-1 直播今日数据说明
统计项 说明
下行流量 今日所有播放域名使用播放加速产生的下行流量总和。
下行带宽峰值 今日所有播放域名使用播放加速产生的下行带宽峰值。
● 使用趋势:呈现今日、昨日、最近一周或一个月内的直播用量趋势,包括“下行 流量”、“下行带宽”和“上行带宽”。
表2-2 统计项说明
统计项 说明
下行流量 统计所有播放域名在查询的时间段内使用播放加速消耗 的总下行流量。
下行带宽 统计所有播放域名在查询的时间段内使用播放加速消耗 的总下行带宽峰值。
上行带宽 统计所选播放域名在查询的时间段内对应推流端产生的 总上行带宽。
说明
可将鼠标放置到图表上,查看每个所选域名的具体数值,滚动鼠标滚轮可针对某时间跨度 范围内的趋势图时间横轴进行拉大或缩小整体占比。
● 计费模式:呈现当前视频直播的“CDN计费方式”。您可以单击“变更”,变更 CDN计费方式;单击“购买套餐包”,进入视频直播套餐包购买页面,购买相关 套餐包。
说明
客户等级为V0和V1的账户暂不支持变更计费方式,只能按流量计费。
图2-2 计费模式
功能列表
您可以在视频直播控制台的左侧导航栏选择对应功能进行配置或使用。
表2-3 控制台功能介绍
分类 功能 功能介绍
直播管理 直播流管理 支持用户对直播在线流、历史流的管理,也可以
对直播流进行禁止和恢复推流等操作。
录制文件管理 支持用户获取录制文件基本信息。
分类 功能 功能介绍
域名管理 域名配置 支持用户添加并管理自有的加速域名,并对域名 进行CNAME配置,Key防盗链、Referer防盗链、
IP黑白名单配置,支持对直播视频进行录制、截 图、转码模板配置。
推流配置 转码模板配置 支持将推送的直播流转码成多种分辨率和码率规
格的,以满足不同网络环境的用户观看需求。
录制配置 支持为直播配置录制规则,直播流将按照录制规 则进行录制,并存储到OBS桶中。
截图模板配置 支持按配置截图模板在推流过程中截取直播画
面,并存储在OBS桶中。
直播推断流通知配 置
支持为推流域名配置回调地址,用于接收直播推 流和断流通知,从而实时获取直播状态。
推流鉴权配置 提供了Key防盗链和IP黑白名单鉴权机制,对访
问者的身份进行识别和过滤,符合规则的才可进 行直播推流。
播流配置 修改直播延时 支持RTMP、HTTP-FLV协议播放的延时配置。
直播拉流回源 支持用户将自建源站中的直播内容拉取到华为云
直播中心进行加速分发。
安全加速 支持对播放域名开启HTTPS安全加速,保障您的 直播数据在传输过程中受到加密保护。
鉴权机制配置(新 版)
提供了Referer防盗链、Key防盗链和IP黑白名单 鉴权机制,对访问者的身份进行识别和过滤,符 合规则的才可使用直播服务。
鉴权机制配置(旧
版) 提供了Referer防盗链和Key防盗链鉴权机制,对 访问者的身份进行识别和过滤,符合规则的才可 使用直播服务。
统计分析
(新版)
直播统计 支持根据播放域名查看其下行带宽、下行流量和 在线观看人数,以及对应推流域名的上行带宽和 推流路数统计信息,并支持将查看的下行带宽/流 量详情导出到本地。
说明:暂不支持“华北-北京一”区域。
增值服务统计 支持根据推流域名查看其转码时长、录制最大并
发数和截图数量统计信息。
说明:暂不支持“华北-北京一”区域。
流播放画像 支持根据播放域名查看其播放画像信息。
说明:暂不支持“华北-北京一”区域。
HTTP状态码统计 支持根据播放域名查看其请求响应返回的状态码 统计信息。
说明:暂不支持“华北-北京一”区域。
分类 功能 功能介绍 统计分析
(旧版)
下行带宽统计 支持查看所有播放域名的带宽使用量统计,并将
查看的带宽详情导出到本地。
下行流量统计 支持查看所有播放域名的流量使用量统计,并将
查看的流量详情导出到本地。
上行带宽统计 支持根据播放域名查看推流端产生的上行带宽统
计信息。
推流路数统计 支持根据播放域名查看推流端产生的总推流路
数。
流监控 历史推流列表 支持查看所选域名的历史推流信息。
说明:暂不支持“华北-北京一”区域。
推流帧码率 支持查看所选域名直播推流到源站的帧率和码率
变化数据。
说明:暂不支持“华北-北京一”区域。
大屏监控 大屏监控 支持对所有直播资源的用量及分布情况进行实时 监控。
日志管理 日志管理 支持查看播放域名被网络用户访问的详细日志,
可查询下载最近90天的日志文件。
说明:暂不支持“华北-北京一”区域。
工具库 防盗地址生成 支持使用该工具快速生成推流域名和播放域名的
鉴权URL。
说明:暂不支持“华北-北京一”区域。
3 IAM 权限管理
3.1 创建用户并授权使用Live
3.1 创建用户并授权使用 Live
如果您需要对所拥有的Live进行精细的权限管理,可以使用统一身份认证服务
(Identity and Access Management,简称IAM),通过IAM,您可以:
● 根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建 IAM用户,让员工拥有唯一安全凭证,并使用Live资源。
● 根据企业用户的职能,设置不同的访问权限,以达到用户之间的权限隔离。
● 将Live资源委托给更专业、高效的其他华为云账号或者云服务,这些账号或者云 服务可以根据权限进行代运维。
如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章 节,不影响您使用Live服务的其它功能。
本章节为您介绍对用户授权的方法,操作流程如图3-1所示。
注意事项
● 权限管理功能暂只支持“亚太-新加坡”区域使用。
● 2022年3月1日前在“亚太-新加坡”区域创建了直播域名的用户未做权限管理。若 需要使用权限管理功能,请提交工单进行申请。
前提条件
给用户组授权之前,请您了解用户组可以添加的Live系统权限,并结合实际需求进行选 择,Live支持的系统权限请参见Live系统权限。
示例流程
图3-1 给用户授权 Live 只读权限流程
1. 创建用户组并授权
在IAM控制台创建用户组,并授予Live只读权限“Live ReadOnlyAccess”。
2. 创建用户并加入用户组
在IAM控制台创建用户,并将其加入1中创建的用户组。
3. 用户登录并验证权限
新创建的用户登录控制台,切换至授权区域,验证权限:
在“服务列表”中选择视频直播服务,进入“域名管理”界面进行添加域名操 作,若提示权限不足,则表示“Live ReadOnlyAccess”已生效。
4 域名管理
4.1 添加域名 4.2 关联域名 4.3 配置CNAME 4.4 管理域名
4.1 添加域名
使用直播服务前,您需要将已备案的推流域名和播放域名添加到直播服务中。
域名准入流程
直播域名接入华为云视频直播服务的流程如图4-1所示。
图4-1 域名准入流程
1. 注册域名:若您还未有自有域名,您可以在华为云购买或注册域名,具体请参见 域名注册服务。
说明
一级域名不能直接作为推流域名或播放域名,若您的域名为“example.com”,则您可以 使用子域名“test-push.example.com”和“test-play.example.com”作为推流域名和播放 域名。
2. 备案域名:自有域名需要在工信部完成备案,您可以在华为云备案中心完成。备 案时长大概需要几个工作日,建议您提前进行备案,待能在工信部备案查询网站 上查询到您的备案域名后,再到直播控制台添加已备案的域名。
3. 添加域名:将已备案的直播域名添加到视频直播服务中,用于直播推流和视频播
放,您需要分别添加推流域名和播放域名。
4. 关联域名:推流域名和播放域名添加成功后,需要将域名完成关联,才能进行直
播推流和播放。
5. 配置CNAME:需要在域名DNS服务商处完成推流域名和播放域名的CNAME解析
配置,将您的域名指向视频直播分配的CNAME。
添加域名
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“域名管理”,进入域名管理页面。
步骤3 单击“添加域名”。在弹出的“添加域名”页面输入已申请的播放或推流域名。
注意:若您的域名未备案,将添加失败,并提示“添加域名失败:ICP编号不存在”。
图4-2 添加域名
表4-1 域名参数说明
参数名 描述
域名 输入二级推流域名或播放域名,域名长度需要在42个字符以内。
注意:推流域名与播放域名不能相同,不支持添加泛域名。
示例:“test-push.example.com”。
域名类型 若“域名”中输入的是推流域名则选择推流域名,否则,选择播放 域名。
步骤4 单击“确定”。
在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5 分钟时间,当“状态”为“正常”时,域名添加成功。
图4-3 域名添加成功
步骤5 播放域名添加后,需要关联添加的推流域名才可使用直播服务,具体请参见4.2 关联域 名。
步骤6 域名添加完成后,您需要在播放域名和推流域名的DNS服务商处配置CNAME,将您的 域名指向CDN配置的CNAME地址。具体操作请见配置CNAME,配置完成后,对应的 域名会自动启用直播加速服务。
----结束
后续操作
域名添加配置后,可以分别在推流域名或播放域名进行相关配置,具体如下所示:
● 推流域名:您可以配置直播流处理模板,包括直播录制、5.2 直播转码和5.5 直播 截图。
● 播放域名:您可以配置直播鉴权。
常见问题
● 直播域名添加失败
● 添加域名时,提示“ICP编号不存在”怎么办?
● 没有已备案的域名,是否可以体验直播服务?
4.2 关联域名
推流域名和播放域名添加后,需要进行域名的关联才能进行直播推流和播放。
注意事项
● 一个播放域名仅支持同时关联一个推流域名。
● 若播放域名配置了客户源站(域名或IP地址)拉流回源,则不支持关联推流域 名。
前提条件
已完成推流域名和播放域名的添加,若未添加请参见添加域名处理。
操作步骤
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“域名管理”,进入域名管理页面。
步骤3 在添加的播放域名行单击“管理”,进入基本信息页面。
步骤4 在“推流信息”板块单击“关联推流域名”,选择已添加的推流域名。
图4-4 关联域名
步骤5 单击“确定”,完成关联。
关联后,即可在基本信息页面查看到对应推流信息。
----结束
4.3 配置 CNAME
域名添加后,系统将会为您自动分配一个CNAME值。您需要在域名DNS服务商处完成 CNAME解析配置,配置生效后,即可启用加速服务。
注意事项
● 若您添加的域名是在华为云域名注册服务申请的,请参考操作步骤配置CNAME解 析。
● 若您添加的域名不是在华为云域名注册服务申请的,请参考配置CNAME解析(非 华为云),在对应域名DNS服务提供商处完成CNAME解析配置,如指导与实际配 置不符,请以各自域名DNS服务提供商的指导信息为准。
● 您需要分别对推流域名和播放域名进行CNAME配置。
前提条件
已添加推流域名和播放域名,且已完成域名关联。
操作步骤
下面以播放域名为例,推流域名的CNAME配置步骤相同。
步骤1 获取域名对应的CNAME值。
1. 登录视频直播控制台,在左侧导航树中选择“域名管理 ”,进入域名管理页面。
2. 在所需域名行获取对应的CNAME。
图4-5 获取 CNAME 值
步骤2 登录云解析服务控制台。
步骤3 在左侧导航中,选择“域名解析 > 公网解析”,进入域名列表页面。
步骤4 在需要配置解析的域名行,单击“域名”列的域名名称。
以域名“example.com”为例,找到对应的"example.com"域名行。
图4-6 域名列表
步骤5 在页面右上角单击“添加记录集”。
图4-7 添加记录集
根据界面提示填写参数配置,参数信息如表4-2所示。
表4-2 参数说明
参数名 描述 如何配置
主机记录 输入域名的二级域名(后缀无需用户手
动填写)。 以播放域名“play-
test.example.com”为 例,此处输入“play- test”。
类型 记录集的类型,此处为CNAME类型。 选择“CNAME-将域名指 向另外一个域名”。
别名 用于是否将此记录集关联至云服务资源 实例。
● 是:为此记录集关联云服务资源实 例,详细说明请参见设置记录集别 名。
● 否:不为此记录集关联云服务资源 实例。
否
线路类型 用于DNS服务器在解析域名时,根据访 问者的来源,返回对应的服务器IP地 址,具体请参见解析线路。
默认值为“全网默认”。
仅支持为公网域名的记录集配置此参 数。
选择“全网默认”。
TTL(秒) 记录集的有效缓存时间,以秒为单位。
数值越小,修改记录各地生效时间越 快。
默认为“5分钟”,若无特 殊需求,可直接保持默认 选择。
值 需指向的域名,即步骤1获取的
CNAME。 以播放域名“play-
test.example.com”为 例,此处输入“play- test.example.com.c.cdnhw c3.com”。
权重 可选参数,解析记录的权重,当域名有 多条某一类型的解析记录时,根据权重 数值选择解析记录,权重数值越高,优 先级越高。默认值为1。
仅支持为公网域名的记录集配置此参 数。
取值范围:0~100。
1
标签 可选参数,当“其他配置”开关打开时 显示。记录集的标识,包括键和值,每 个记录集可以创建10个标签。
example_key1 example_value1
描述 可选参数,当“其他配置”开关打开时 显示。对域名的描述,主要起到提示作 用。
长度不超过255个字符。
-
步骤6 单击“确定”,完成添加。
您可以在域名对应的记录集列表中查看添加的记录集。当记录集的状态显示为“正 常”时,表示记录集添加成功。
步骤7 执行步骤1-步骤6,完成对推流域名的CNAME配置。
----结束
验证 CNAME 是否生效
您可以通过“nslookup”命令来查询CNAME是否生效。打开Windows操作系统中的 cmd程序,输入如下命令:
nslookup -qt=cname 加速域名
如果回显CNAME,则表示CNAME配置已经生效,如图4-8所示。
图4-8 CNAME 生效验证
4.4 管理域名
推流域名或播放域名添加后,您可以在域名管理页面,查看已添加域名的基本信息。
您也可以根据实际需求停用、启动或删除已添加的域名,还可以解除域名的关联。
操作步骤
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“域名管理”,进入域名管理页面。
步骤3 请根据实际需求选择以下操作。
● 查看域名信息
在域名列表中,可查看已添加域名的CNAME值、域名类型、状态及创建时间等信 息。
图4-9 域名状态
单击右侧操作列的“管理”,可查看目标域名的详细基本信息。
图4-10 域名信息
● 停用域名
若您需要停用某个域名,可以在需要停用的域名行单击“停用”。当“状态”变 为“停用”时,表示域名停用成功。
图4-11 域名停用
● 启用域名
若您需要将某个已停用的直播域名重新启用,可以在需要启用的域名行单击“启 用”。当“状态”变为“正常”时,表示域名启用成功。
图4-12 域名启用
● 删除域名
注意:仅在“停用”状态下的域名才能删除。因此,您需要先停用不需要的域 名,再在需要删除的域名行单击“删除”即可。
图4-13 域名删除
● 解除域名关联
若您需要解除某个已关联的域名,可以在需要解除关联的播放域名行单击“管 理”。在“推流信息”区域,单击 即可。
图4-14 关联解除
----结束
5 推流配置
5.1 拼接推流地址 5.2 直播转码 5.3 直播录制至OBS 5.4 直播录制至VOD 5.5 直播截图 5.6 开停播通知 5.7 推流鉴权
5.1 拼接推流地址
直播域名配置完成后,您可以根据实际情况手动拼接对应的推流地址,然后再使用该 地址进行直播推流。若您的推流域名部署在新版视频直播服务下,则还可以使用防盗 链地址生成工具快速生成推流域名的鉴权地址。
前提条件
● 已添加推流域名。
● 已在域名DNS服务商处完成CNAME解析配置。
● 为保障推流地址不被非法盗用,华为云直播服务提供了防盗链功能,对推流地址 进行加密鉴权。若有需要,请先配置Key防盗链,然后使用鉴权地址进行推流。
操作步骤
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“域名管理”,进入域名管理页面。
步骤3 在添加的推流域名行单击“管理”,进入基本信息页面,即可查看推流信息。
图5-1 推流地址
● 您需要根据实际情况自定义“StreamName”,生成对应的原始推流地址,具体 请参见原始推流地址。
● 若配置了Key防盗链,您可以在原始推流地址后加上鉴权串生成对应的鉴权推流地 址,具体请参见鉴权推流地址。
----结束
原始推流地址
拼接规则 推流地址格式:
rtmp://推流域名/AppName/StreamName
● 推流域名:在视频直播控制台添加的推流域名。
● AppName:应用名,默认为“live”,您也可以根据实际需求进行自定义,支持 大小写字母、数字、下划线(_)中划线(-)。
● StreamName:直播流名,每个应用可创建多个直播流,您可以根据实际需求进 行自定义,不支持中文字符。
拼接示例
若添加的推流域名为“test-push.example.com”,“StreamName”为
“huawei1”,“AppName”为“livetest”,则推流地址如下所示:
rtmp://test-push.example.com/livetest/huawei1
鉴权推流地址
若您的推流域名开启了Key防盗链功能,那么您需要根据获取的鉴权信息拼接鉴权推流 地址,然后再使用该鉴权地址进行直播推流。
其中,鉴权推流地址根据您的推流域名是否部署在新版或旧版视频直播服务下所使用 的鉴权算法有所不同,生成的鉴权推流地址也会不同。
● 域名部署在新版视频直播服务下,请参见播放Key防盗链(新版)生成对应的鉴权 推流地址。
● 域名部署在旧版视频直播服务下,请参见播放Key防盗链(旧版)生成对应的鉴权 推流地址。
5.2 直播转码
视频直播支持直播转码功能,支持将推送的直播流转码成多种分辨率和码率规格的视 频流,以满足不同网络环境的用户观看需求。系统提供了预置转码模板和自定义转码 模板两种模板类型,配置转码后,当开始推流时,启动直播转码功能。
图5-2 直播转码架构图
功能介绍
转码功能可以帮助您处理如下问题:
● 适配不同播放终端:您可以将原始音视频转码为更适应于各终端播放的格式。
● 适配不同网络环境:您可以根据不同的网络带宽设置转码输出的码率,以适应不 同的网络播放环境。
● 降低分发成本:支持压缩率更高的H.265编码格式,您也可以在转码时开启高清低 码功能,在分辨率不变的情况下,码率下降20%左右,从而降低直播流的分发成 本。
视频直播服务提供预置转码和自定义转码两种转码模板。两种模板均支持开启高清低 码。
● 预置转码模板:支持选择视频画质,视频画质内置了常用的流畅、标清、高清和 超清四种视频清晰度的标准模板和高清低码模板。
● 自定义转码模板:支持自定义配置模板ID、分辨率、码率和帧率。若系统预置转 码模板无法满足您的实际需求,您可以选择自定义转码模板。
注意事项
● 一个域名可以配置多个转码模板,当直播推流启动后,与推流地址中的AppName 一致的转码模板生效,开始进行转码,若不需要转码,请在直播推流前删除转码 模板。
● 转码模板中的高清低码默认是关闭的,若您开启,直播转码将按高清低码标准计 费,价格详情请参见产品价格详情。
● 暂不支持上采样转码,若转码模板中设置的分辨率高于推流分辨率,对应分辨率 的播放地址可以成功播放,但播放视频的分辨率为原始分辨率。
前提条件
● 已添加推流域名。
● 已在域名DNS服务商处完成CNAME解析配置。
费用说明
直播转码功能为计费项,按实际使用的编码标准、转码分辨率和转码时长收取费用。
其中,标准转码和高清低码转码产生的费用不同,具体的计费转码分辨率请以产品价 格详情中的转码输出分辨率为准。若您比较常使用直播转码功能,建议您优先选择购 买直播转码套餐包。
新增转码模板
支持通过直播控制台或直播API配置预置转码模板和自定义转码模板。配置后,您若需 要播放转码直播流,请先获取转码播放地址,具体请参见转码播放地址。
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“域名管理”,进入域名管理页面。
步骤3 在需要配置转码模板的推流域名行单击“管理”。
步骤4 在左侧导航树中选择“模板配置 > 转码配置”,您可以查看目前推流域名下的转码模 板信息。
步骤5 单击“新建转码”,弹出如图5-3所示的新建转码页面。
图5-3 新建转码
步骤6 配置转码参数,参数说明如表5-1。
表5-1 转码模板参数说明
区域 参数名 描述
基本信息 App Name 应用名称,默认为“live”,可以根据实际需求 进行自定义,支持大小写字母、数字、下划线
(_)中划线(-)。
视频编码 支持H.264和H.265两种标准的视频编码格式。
高清低码 高清低码是指画质不变的情况下,码率更低。开 启后,将按高清低码标准计费。价格详情请参见 产品价格详情。
预置转码模 板
画质 支持选择流畅、标清、高清和超清四种视频画 质,四种画质的分辨率和码率如表5-2所示。
自定义转码
模板 模板ID 拼接转码播放地址的参数,具体参数拼接规则请 参见播放地址。
分辨率(宽*高) 视频的宽度和高度,单位为像素,若宽和高都设 置为0,则按原始分辨率输出;若只设置了宽或 高,则另一边会根据设置的一边自适应。
取值范围:
● 宽度:32-3840,设置的数值必须为2的倍数 或为0。
● 高度:32-3840,设置的数值必须为2的倍数 或为0。
码率(单位:
Kbps) 输出直播流的平均码率。
取值范围:40-30000。
区域 参数名 描述 帧率(单位:
fps) 输出直播流的帧率。
取值范围:0-60,若设置的数值为0,则表示自 适应。
表5-2 预置转码模板的分辨率和码率
视频画质 分辨率 码率(Kbps)
流畅 640*360 400
标清 854*480 600
高清 1280*720 1000
超清 1920*1080 2000
步骤7 配置完转码模板参数后,单击“添加”。
如图5-4所示,转码模板列表中新增转码模板信息。
图5-4 新增转码模板
步骤8 配置转码模板后,若您需要使用转码播放地址进行视频的播放,请参考转码播放地址 获取转码播放地址。
----结束
管理转码
转码模板配置完成后,您还可以根据实际需要进行如下操作。
● 修改转码模板
转码模板创建完成后,若您需要修改部分参数,可以通过单击操作列的“修 改”,修改转码模板中的相关参数。其中,AppName不支持修改。
图5-5 修改转码模板信息
● 删除转码模板
转码模板创建完成后,若您需要删除转码模板,可以通过单击操作列的“删 除”,删除该转码模板。
图5-6 删除转码模板信息
5.3 直播录制至 OBS
5.3.1 配置录制模板
直播服务支持将直播内容进行录制并将录制的视频存储到OBS桶中,您可以在OBS中 对录制的直播视频进行下载、分享等处理。
直播录制至OBS的相关操作流程,如图5-7所示。
图5-7 直播录制至 OBS 流程图
1. 创建桶(可选):创建用于存储直播录制文件的OBS桶,若已有OBS桶,请直接
执行2。
2. 云资源授权:在直播服务中对存储录制文件的OBS桶进行授权,允许直播服务将 录制文件存储在对应的OBS桶中。还可以授权给点播服务,将存储在OBS桶中的 录制文件托管给点播服务,在点播服务中处理录制文件。
说明
目前仅支持通过主账号进行云资源授权,IAM子账号暂不支持使用。
3. 配置录制模板:为直播配置录制规则,配置完成后,与推流地址中的AppName和
StreamName相同的录制模板生效,录制视频按录制设置存储至OBS中。还可以 通过设置回调地址获取录制状态通知。
4. 推流:录制规则配置完成后,获取推流地址进行直播推流,直播服务会根据配置 的录制规则对正在直播的视频进行录制。
5. 管理录制文件:直播录制完成后,可以在直播服务中获取录制文件基本信息,也
可以在OBS中管理录制文件,如下载、分享、删除等,还可以通过授权点播服 务,将OBS桶中的录制文件托管至点播服务,在点播服务中管理录制文件,如预 览、发布、转码和播放等。
说明
录制文件的分辨率与推流分辨率相关,按推流原分辨率进行录制。
注意事项
● 录制规则配置支持域名级、应用级和流级,优先生效细粒度配置(即流级别最优 先),同级配置不支持多种录制类型。
● 直播服务不支持清理录制内容,仅记录直播录制事件,且直播录制事件的数据只 保留30天。您可根据业务的实际需求,在OBS中手动清理录制文件或通过OBS生 命周期管理功能实现录制文件的存留期限和策略。
● 直播录制过程中,若直播推流因网络抖动等问题中断,则直播服务将中止录制。
当推流重新启动时,直播服务将重新开启新的录制任务。
● 配置录制后,启动推流即开始录制,结束推流才可停止录制,暂无法按需停启;
若在推流过程中删除录制规则,录制仍然会继续,直到推流结束 。
● OBS服务会因欠费停服,从而导致直播录制失败,建议您购买OBS存储包。
● 仅支持对接收到的源直播流进行录制,暂不支持录制直播转码流。
前提条件
● 已添加推流域名。
● 已在域名DNS服务商处完成CNAME解析配置。
● 因直播录制生成的视频文件是存储在对象存储服务中的,因此,您需要先开通对 象存储服务,具体请参见OBS快速入门。
● 若您需要将存储在OBS桶中的录制文件托管至点播服务,在点播服务中管理录制 文件,则需要先开通点播服务,并添加点播加速域名,具体请参见VOD快速入 门。
费用说明
● 直播录制生成的视频文件及托管给点播服务后进行转码或转封装后的视频文件最 终是存储在OBS中的,因此,产生的存储费用由OBS单独收取,具体价格详情请 参见OBS-产品价格详情。
● OBS桶授权给点播服务后,在点播服务侧对托管的录制文件进行转码或转封装处 理所产生的相关费用由点播单独收取,具体价格详情请参见视频点播-产品价格详 情。
步骤一:创建桶(可选)
若您还未在OBS服务中创建用于存储录制文件的桶,或者您需要新创建桶用于存储直 播录制文件,请参见OBS帮助中心创建桶。否则,请直接执行步骤二:云资源授权。
说明
创建的OBS桶需要与使用的直播服务在同一区域。
步骤二:云资源授权
OBS桶授权直播服务,允许直播录制文件存储在OBS桶中,若您需要对存储的录制文 件进行转码或转封装处理,可选择授权点播服务,将存储在OBS桶中的录制文件托管 至点播服务进行管理。
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“云资源授权”,进入桶授权页面。
步骤3 请您根据实际需求选择以下操作。
● 授权直播服务:
在“直播授权”页签中,找到需要存储直播录制文件的OBS桶,在右侧“操作”
列,单击“授权”即可。
● 授权点播服务:
在“点播授权”页签中,找到需要存储直播录制文件的OBS桶,在右侧“操作”
列,单击“授权”即可。
----结束
步骤三:配置录制模板
若您需要对直播流进行录制回看,请配置直播录制规则。配置完成后,与推流地址中 的AppName和StreamName相同的录制模板生效。
1. 登录视频直播控制台。
2. 在左侧导航树中选择“域名管理”,进入域名管理页面。
3. 在需要创建录制规则的推流域名行单击“管理”。
4. 在左侧导航树中选择“模板配置 > 录制配置(新版)”,进入录制配置页面。
5. 单击“新建录制”。
6. 请您按照实际需求配置录制参数,参数说明如表5-3所示。
表5-3 录制参数说明
参数名 描述
录制类型 ● 自动录制:录制模板配置完成后,只要有满足该录制规则 的直播流推送即开始录制。
● 手动录制:录制模板配置完成后,在有满足该录制规则的 直播流推送后,您可以通过调用提交录制控制命令接口控 制该直播流录制的启动与停止。
说明
● 录制模板配置完成后不支持修改录制类型。
● 手动录制需要直播流已推送的情况下才能成功调用接口启动录 制。
● 手动录制仅支持流级别的启停控制,即使创建的录制规则为域名 级别,下发启停控制命令也需要指定具体流名。
● 手动录制任务的停止方式包含直接调用接口停止和直播断流(若 设置了最大断流合并时长,则会在断流后等待配置的最大断流合 并时长结束后才停止任务)。
● 手动下发停止录制命令后,录制任务仍需要一定的时间进行资源 清理操作,若短时间内对该直播流继续发送启动命令,接口可能 会提示录制任务未完成。
AppName 应用名称,默认为“live”,可以根据实际需求进行自定义,
支持大小写字母、数字、下划线(_)中划线(-)。若填写 为“*”,则录制规则适用于该域名下的所有应用。
流名 直播流名称。若填写为“*”,则录制规则适用于该 AppName下的所有直播流。
存储位置 录制文件转存储的位置。
存储-桶 存储录制文件的OBS桶。
存储-路径 OBS桶存储录制文件的路径。
若后续您需要更改录制文件的存储路径,可以在录制模板列 表中通过单击操作列的“修改”进行更改。
托管点播 将存储至OBS的录制文件托管到点播服务,在点播服务中管 理录制文件,如预览、发布、转码和播放等。
录制格式 录制文件的格式,支持将直播视频录制为HLS、FLV和MP4三 种文件格式。
HLS规则 m3u8命名规则:录制m3u8文件的存储路径和文件的前缀。
Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}
{file_start_time}/{stream}{file_start_time}
TS命名规则:录制ts文件名的前缀。
{file_start_time_unix}_{file_end_time_unix}_{ts_sequence_number}
录制周期:录制时长支持15-720分钟,最大录制周期为12小 时,超过12小时,系统将按照命名规则生成新文件。
参数名 描述
最大断流合并时长:
● 断流后生成新文件:是指录制的直播流中断后,会立即生 成新的录制文件。
● 断流后不生成新文件:是指录制的直播流中断后,重新推 流,会和之前录制的文件合并为一个文件。
● 其他数值:是指录制的直播流中断时间在设置范围内,则 和之前录制的文件合并为一个文件,否则,生成新的录制 文件。最大断流合并时长为300秒。
FLV规则 命名规则:录制flv文件的存储路径和文件的前缀。
Record/{publish_domain}/{app}/{record_type}/{record_format}/
{stream}_{file_start_time}/{stream}_{file_start_time}
录制周期:录制时长支持15-180分钟,最大录制周期为3小 时,超过3小时,系统将按照命名规则生成新文件。
最大断流合并时长:
● 断流后生成新文件:是指录制的直播流中断后,会立即生 成新的录制文件。
● 其他数值:是指录制的直播流中断时间在设置范围内,则 和之前录制的文件合并为一个文件,否则,生成新的录制 文件。
MP4规则 命名规则:录制mp4文件的存储路径和文件的前缀。
Record/{publish_domain}/{app}/{record_type}/{record_format}/
{stream}_{file_start_time}/{stream}_{file_start_time}
录制周期:录制时长支持15-180分钟,最大录制周期为3小 时,超过3小时,系统将按照命名规则生成新文件。
最大断流合并时长
● 断流后生成新文件:是指录制的直播流中断后,会立即生 成新的录制文件。
● 其他数值:是指录制的直播流中断时间在设置范围内,则 和之前录制的文件合并为一个文件,否则,生成新的录制 文件。
说明
直播推流正常的情况下,HLS格式的录制文件在OBS中生成的时间跟推流端的GOP相关,
默认在3个GOP(6秒)后生成第一个录制文件。FLV和MP4格式则在一个录制周期完成后 才生成一个录制文件。
“最大断流合并时长”的配置影响录制回调中RECORD_FILE_COMPLETE回调的生成,具 体如下:
● 断流后不生成新文件:需要等到录制时长达到录制周期时才生成录制文件,并收到该录 制回调。
● 断流后生成新文件:每次断流后都会生成新的录制文件,并收到该录制回调。
● 其他数值:根据断流设定的时间,断流超过设定时间或者录制时间达到录制周期时生成 录制文件,并收到该录制回调。
7. 单击“确定”,在录制列表中增加一条录制规则。
您可以创建多条录制规则,直播录制时,与推流地址中的AppName和 StreamName相同的录制规则生效。
8. 录制规则配置完成后,您可以获取推流地址开始直播推流。推流相关操作请参见 快速入门。
直播服务会根据配置的录制规则对正在直播的视频进行录制,生成的原始录制文 件的分辨率及码率与直播源流保持一致。
直播录制完成后,您可以在直播、OBS或点播服务中管理录制文件,如预览、下载、
分享、发布、转码和播放等。
修改/删除录制模板
录制模板配置完成后,您还可以根据实际需要进行如下操作。
● 修改录制模板
录制模板创建完成后,若您需要修改部分参数,可以在录制模板列表中通过单击 操作列的“修改”,修改录制模板中的相关参数。
说明:录制类型不支持修改。
图5-8 修改录制模板信息
● 删除录制模板
录制模板创建完成后,若您需要删除录制模板,可以在录制模板列表中通过单击 操作列的“删除”,删除该录制模板。
图5-9 删除录制模板信息
相关链接
● 直播录制的中断机制是什么?
● 已经删除录制规则,为什么还会生成录制文件?
● 配置了录制规则,为什么在录制管理中无录制文件?
● 直播录制后,为什么在控制台和回调信息中无播放地址?
5.3.2 配置录制回调
直播服务提供了录制文件生成状态回调设置,支持配置HTTP/HTTPS URL,向用户服 务器发送POST请求、消息体JSON格式,将文件生成事件信息实时反馈到用户服务 器。
前提条件
● 已添加推流域名。
● 已在域名DNS服务商处完成CNAME解析配置。
操作步骤
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“域名管理”,进入域名管理页面。
步骤3 在需要创建录制回调的推流域名行单击“管理”。
步骤4 在左侧导航树中选择“模板配置 > 录制配置(新版)”,进入录制配置页面。
步骤5 单击“新建回调配置”设置回调地址,如图5-10所示,回调参数说明请参见表5-4。
图5-10 添加录制回调 URL
表5-4 录制回调参数说明
参数 说明
回调地址 回调地址中不能携带消息头和参数,仅支持HTTP/HTTPS协议。
回调类型 回调消息的类型,包含如下分类:
● 录制文件生成完成
● 录制开始
● 创建新的录制文件
● 录制结束
● 录制失败
各回调类型的详细说明请参见表5-5。
鉴权方式 回调消息中的加密内容会根据选择的不同鉴权方式而有所不同。
● MD5方式:MD5(key + auth_timestamp)
● HMACSHA256方式:HMACSHA256(auth_timestamp + event_type + publish_domain + app + stream + download_url + play_url,key)
鉴权密钥 鉴权key值。支持自定义设置,由32位的字母和数字组成。
----结束
修改/删除录制回调配置
录制回调配置完成后,您还可以根据实际需要进行如下操作。
● 修改录制回调配置
录制回调配置完成后,若您需要修改部分参数,可以在录制模板回调配置列表中 通过单击操作列的“修改”,修改录制回调配置中的相关参数。
图5-11 修改录制回调信息
● 删除录制回调配置
录制回调配置完成后,若您需要删除录制回调配置,可以在录制回调配置列表中 通过单击操作列的“删除”,删除该录制回调配置。
图5-12 删除录制回调信息
回调示例
录制文件生成事件回调示例如下。回调消息体字段如表5-5所示。
{ "project_id" : "70b76xxxxxx34253880af501cdxxxxxx", "job_id":"dc0a1773-0cef-xxxx-xxxx-9a38fdb095d2", "event_type" : "RECORD_FILE_COMPLETE", "publish_domain" : "push.example.com", "app" : "live",
"stream" : "mystream", "record_format" : "HLS",
"download_url" : "https://obs.cn-north-4.myhuaweicloud.com/live/record-xxxx-mystream-1589967495/
record-push.example.com-live-mystream-1589967495.m3u8", "asset_id" : "1a0d8e9bfaexxxxxxbe5021e62aa1e96",
"play_url" : "https://2-cn-north-4.cdn-vod.huaweicloud.com/asset/
1a0d8e9bfae388cxxxxxx21e62aa1e96/55c634374750cexxxxxxc035a26ecfac.m3u8", "file_size" : 3957964,
"record_duration" : 120,
"start_time" : "2020-03-08T14:10:25Z", "end_time" : "2020-03-08T14:12:25Z", "width" : 1280,
"height" : 720,
"obs_location" : "https://obs.cn-north-4.myhuaweicloud.com", "obs_bucket" : "mybucket",
"obs_object" : "live/record-xxxx-mystream-1589967495/record-hwpublish.myun.tv-live- mystream-1589967495.m3u8"
"auth_sign" : "4f97f46759axxxxxx7ad21e9935dc175", "auth_timestamp" : "1583676745"
}
表5-5 消息体字段说明
字段 描述
project_id 项目ID。
job_id 用于标识同一个文件。当“event_type”为
“RECORD_NEW_FILE_START”或
“RECORD_FILE_COMPLETE”时,携带该字段。
event_type 消息类型。
取值如下:
● RECORD_START:表示录制开始。若配置了录制模 板和录制回调,则直播推流开始时,开始录制,触 发该事件。
● RECORD_NEW_FILE_START:表示开始创建新的 录制文件。以下情况会触发该事件:
– 直播推流开始,开始创建第一个录制文件。
– 直播断流恢复后,若“最大断流合并时长”配 置为“断流后生成新文件”,则开始创建新的 录制文件。
– 当前录制时长超过了配置的录制周期,则开始 新的录制文件生成。
● RECORD_FILE_COMPLETE:表示录制文件生成完 成。以下情况会触发该事件:
– 录制时长达到配置的录制周期,则当前录制文 件生成完成,并开始新的录制生成。
– 直播断流后,若“最大断流合并时长”配置为
“断流后生成新文件”,则当前录制文件生成 完成,若断流恢复,将开始新的录制文件生 成。
● RECORD_OVER:表示录制结束,直播断流时长超 过了最大断流合并时长,当前录制任务结束,触发 该事件。
● RECORD_FAILED:表示录制失败,当拉流失败、
录制文件上传OBS失败等因素导致录制失败时,触 发该事件。
publish_domain 直播推流域名。
app 应用名。
stream 录制的流名。
record_format 录制格式,支持HLS、FLV和MP4格式。
字段 描述
download_url 录制文件的下载地址。当“event_type”为
“RECORD_FILE_COMPLETE”时,携带该字段。
说明
使用该下载地址用于视频播放无法保证播放效果。建议您在 配置直播录制时,将存储录制文件的OBS桶授权给点播服 务,且当“event_type”为“RECORD_FILE_COMPLETE”
时,您可以通过获取“play_url”中的地址进行视频播放。
asset_id 媒资ID。若配置直播录制时,将存储录制文件的OBS 桶授权给点播服务,则为点播的媒资ID。当
“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
play_url 录制文件播放地址,可以直接播放。当配置直播录制 时,将存储在OBS桶中的录制文件托管至点播服务,
且仅“event_type”为
“RECORD_FILE_COMPLETE”时,携带该字段。
file_size 文件大小。
单位:Byte。
record_duration 录制文件的时长。
单位:秒。
start_time 录制文件的开始时间,即接收到第一帧数据的时间,
格式为yyyy-mm-ddThh:mm:ssZ。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
end_time 录制文件的结束时间,格式为yyyy-mm- ddThh:mm:ssZ。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
width 录制文件分辨率的宽。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
height 录制文件分辨率的高。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
obs_location 存储录制文件的OBS桶所在区域。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
obs_bucket 存储录制文件的OBS桶。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
字段 描述
obs_object OBS桶存储录制文件的路径。
当“event_type”为“RECORD_FILE_COMPLETE”
时,携带该字段。
auth_sign 事件通知签名。
● MD5方式:auth_sign=MD5(key + auth_timestamp)
● HMACSHA256方式:
HMACSHA256(auth_timestamp + event_type + publish_domain + app + stream + download_url + play_url,key)
其中,key为鉴权密钥值。
auth_timestamp 事件通知签名过期UNIX时间戳。
格式为十进制的UNIX时间戳,即从1970年1月1日
(UTC/GMT的午夜)开始所经过的秒数。
若消息通知中的auth_timestamp值所指定的时间已经 过期,则此消息通知无效,进而防止网络重放攻击。
error_message 录制失败的描述信息。
当“event_type”为“RECORD_FAILED”时,携带该 字段。
5.3.3 管理录制文件
直播录制完成后,您可以在直播控制台和OBS控制台中查看录制文件,若设置了点播 授权,还可以在点播控制台查看录制文件或通过点播API获取录制文件列表进行查看。
通过直播服务管理录制文件
步骤1 登录视频直播控制台。
步骤2 在左侧导航树中选择“直播管理 > 录制管理”,进入录制管理页面。
步骤3 选择您需要查看的日期、推流域名、AppName,并单击“确定”。
列表中显示您查看的录制文件的相关信息。
图5-13 查看录制文件信息
步骤4 若您需要查看录制文件的详细信息,可单击对应录制文件行的 。
可查看ID、录制类型、时长等信息,若设置了点播授权,还可以查看播放地址,如图 5-14所示。
图5-14 查看录制文件详细信息
----结束
通过 OBS 服务管理录制文件
步骤1 在OBS管理控制台左侧导航栏选择“对象存储”。
步骤2 在桶列表单击存储录制文件的桶,进入“概览”页面。
步骤3 在左侧导航栏,单击“对象”。
您可对录制文件进行下载、分享等操作。
----结束
通过点播服务管理录制文件
● 通过控制台查看
a. 在视频点播控制台的“音视频管理”页面单击右上角的“高级搜索”,按照 录制日期或名称关键字查询录制好的文件。
图5-15 在控制台中查看录制文件
b. 单击对应录制文件行的“管理”,您可在详情页面对已录制的视频文件进行 转码、分类、添加封面、上传字幕等操作。具体操作指导请参见视频点播用 户指南。
● 调用点播API获取录制文件列表
调用查询媒资列表接口,将请求参数“query_string”设置为“Record_”,即可 获取所有录制文件的详细信息。
5.4 直播录制至 VOD
5.4.1 直播录制
直播服务支持将直播内容进行录制并将录制的视频存储到VOD中,您可以在VOD中对 录制的直播视频进行转码、音频提取等处理。暂只支持在“华北-北京一”区域使用。
说明
公测功能,后续不再做功能演进,仅做基础维护,建议您使用新版的商用录制功能直播录制至 OBS。
录制流程
直播录制管理相关操作流程,如图5-16所示。
图5-16 直播录制至 VOD 流程图
1. 配置消息通知(可选):若您需要实时了解录制的状态,可以在直播开始录制
前,配置录制通知。若您不需要消息通知,可直接跳转到2。
2. 配置录制模板:为直播配置录制规则,配置完成后,与推流地址中的AppName相 同的录制规则生效。
3. 推流:录制规则配置完成后,获取推流地址进行直播推流,直播服务会根据配置
的录制规则对正在直播的视频进行录制。
4. 管理录制文件:直播录制完成后,可以在直播服务中获取录制文件基本信息并预
览,也可以在点播服务中管理录制文件,如预览、发布、转码和播放等。
注意事项
● 暂不支持对编码格式为H.265的原始直播流进行录制。
● 直播录制过程中,若直播推流因网络抖动等问题中断,则直播服务将中止录制。
当推流重新启动时,直播服务将重新开启新的录制任务。
● 配置录制后,启动推流即开始录制,结束推流才可停止录制,暂无法按需停启;
若在推流过程中删除录制规则,录制仍然会继续,直到推流结束 。
● 点播服务会因欠费停服,从而导致直播录制失败,建议您购买点播存储套餐包。
前提条件
● 已添加推流域名。
● 已在域名DNS服务商处完成CNAME解析配置。
● 因直播录制生成的视频文件是存储在视频点播服务中的,因此,您需要先开通视 频点播服务,具体请参见快速使用点播服务。
费用说明
● 直播的消息通知将用到消息通知服务,实际使用的消息通知费用由消息通知服务 单独收取,具体价格详情请参见SMN价格详情。
● 直播录制生成的视频文件是存储在点播服务中,因此,产生的相关费用是按点播 的价格进行计费收取的,具体价格详情请参见VOD价格详情。
– 录制文件存储费用
按录制文件的实际大小收费,若配置了录制转码,原始录制文件和转码录制 文件都将产生存储费用。
– 录制文件转封装费用
仅在勾选了“录制转码格式”时才产生该项费用。录制文件上传点播系统 后,点播将使用转封装模板对录制文件的格式进行转换,将产生转封装费 用。若勾选多种格式,则产生多份转封装费用。
步骤一:配置消息通知
若您需要了解直播录制的状态,请参考配置直播消息通知在直播录制前配置录制通 知,配置后,直播录制完成后会通知用户相应的结果以及录制状态。
步骤二:配置录制模板
若您需要对直播流进行录制回看,请配置直播录制规则。配置完成后,与推流地址中 的AppName相同的录制模板生效。
1. 登录视频直播控制台。
2. 在左侧导航树中选择“域名管理”,进入域名管理页面。
3. 在需要创建录制规则的推流域名行单击“管理”。
4. 在左侧导航树中选择“模板配置 > 录制配置”。
5. 单击“新建录制”,进入录制配置页面。
6. 请您按照实际需求配置录制参数。
图5-17 配置录制规则
– AppName:应用名称,默认为“live”,您也可以根据实际需求进行自定 义,支持大小写字母、数字、下划线(_)中划线(-)。
– 录制格式:录制文件的格式,暂只支持“flv”格式。
– 录制转码格式:录制文件上传到点播系统后,点播将使用转封装模板进行格 式转换,生成的录制文件将包含录制格式和转换后的格式。该项选择是属于 收费项,按点播转封装计费项进行收费。
– 存储位置:录制文件转存储的位置,暂只支持录制到视频点播系统中。
– 录制周期:时长支持15-360分钟,最大支持录制6小时。超过6小时,系统将 按照录制命名规则生成新文件。
7. 单击“确定”,在录制列表中增加一条录制规则。
您可以创建多条录制规则,直播录制时,与推流地址中的AppName相同的录制规 则生效。
8. 录制规则配置完成后,您可以开始直播推流。
生成的原始录制文件的分辨率及码率与直播源流保持一致。
步骤三:推流
录制规则配置完成后,获取推流地址进行直播推流,直播服务会根据配置的录制规则 对正在直播的视频进行录制。此步骤的详细操作本节内容不做介绍,具体请参见快速 入门中推流的相关操作。
步骤四:管理录制文件
您可以在直播控制台和点播控制台中查看录制文件,也可以通过点播API获取录制文件 列表进行查看。
若您有配置“录制通知”,录制完成后订阅终端将收到消息通知。您可在消息内容的
“download_url”字段中获取录制文件的播放地址。
● 通过控制台管理录制文件 a. 登录视频直播控制台。
b. 在左侧导航树中选择“直播管理 > 录制管理”,进入录制管理页面。
c. 选择您需要查看的日期、播放域名、AppName,并单击“确定”。
列表中显示您查看的录制文件的相关信息。
图5-18 录制文件信息
录制文件命名规则:Record_推流域名_AppName_StreamName_录制开始时 间_录制结束时间
示例:Record_live.huaweitest.com_live/
huawei_201808151856_201808151926
d. 单击操作列的 图标,可以对录制文件进行预览。
须知
录制文件是存储在视频点播服务中的,因此,预览录制文件将会产生点播下 行流量费用,具体价格详情请参见VOD价格详情。
e. 若您需要查看录制文件的详细信息,可单击对应录制文件行的 。 可查看ID、录制类型、时长,播放地址等信息。
图5-19 录制文件详细信息
● 通过点播服务管理录制文件
a. 在视频点播控制台的“音视频管理”页面单击右上角的“高级搜索”,按照 录制日期或名称关键字查询录制好的文件。
图5-20 在点播控制台查看录制文件
b. 单击对应录制文件行的“管理”,您可在详情页面对已录制的视频文件进行 转码、分类、添加封面、上传字幕等操作。具体操作指导请参见视频点播用 户指南。
● 调用点播API获取录制文件列表
调用查询媒资列表接口,将请求参数“query_string”设置为“Record_”,即可 获取所有录制文件的详细信息。
5.4.2 配置消息通知
直播服务使用消息通知服务对直播录制状态进行实时通知,如需使用该功能,需要先 配置消息通知服务。由于消息通知由消息通知服务(SMN)完成,所以SMN将对发送 的消息通知进行单独计费,具体的计费标准请参考SMN价格详情。
背景介绍
● 主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知 的信道,为发布者和订阅者提供一个可以相互交流的通道。在配置直播消息订阅 前必须定制主题。
● 消息订阅是客户将订阅者注册到主题的操作,客户可以拥有多个主题,每个主题 有多个订阅者。
● 消息订阅暂以项目ID进行区分,即同一个项目ID的域名暂只能使用同一个消息订 阅,消息订阅配置对同一个项目ID的所有域名生效。
配置流程
消息订阅的配置流程,如图5-21所示。
图5-21 消息订阅配置流程图
1. 创建消息主题:在消息通知服务控制台新建消息主题,用于消息发送和订阅通
知。
2. 添加订阅:将消息主题添加到订阅中接收发布至主题的消息,在订阅主题且确认
订阅后,终端节点能够接收到向该主题发布的所有消息。
3. 设置主题策略:授权直播服务可对该主题发布消息。
4. 配置直播消息订阅:在直播控制台配置消息订阅,在直播推流开始和结束,以及
录制时收到对应的消息通知。
前提条件
● 已添加推流域名。
● 已在域名DNS服务商处完成CNAME解析配置。
步骤一:创建消息主题
步骤1 登录消息通知服务控制台。
步骤2 在左侧导航树中选择“主题管理 > 主题”,进入主题页面。
步骤3 单击“创建主题”,设置主题名称等参数。
图5-22 创建主题
步骤4 单击“确定”,消息主题创建成功。
----结束
步骤二:添加订阅
步骤1 在消息通知服务控制台的左侧导航树中,选择“主题管理 > 主题”,进入主题页面。
步骤2 在已创建的主题行单击“操作”列的“添加订阅”,进入添加订阅页面。
步骤3 配置消息通知的类型和对象。
图5-23 添加订阅
参数说明如表5-6所示。
表5-6 添加订阅参数说明
参数名 描述
主题名称 待添加订阅的主题名称,不需要修改。
协议 消息通知的方式。在下拉框中选择需要订阅终端支持的协议。
直播服务常用的消息通知方式为“短信”、“邮件”和“HTTP/
HTTPS”。
● 短信协议
订阅的终端为手机,接收到的消息只包含消息内容。
● 邮件协议
订阅终端为邮箱,接收到的消息包含消息内容和取消订阅的链 接。
● HTTP/HTTPS协议
订阅终端为公网网址,消息通知服务向HTTP(S)终端发送的通知 消息包括HTTP头部信息与HTTP Content部分。Content部分是 JSON格式的字符串。具体详情请参见HTTP(S)消息格式。
参数名 描述
订阅终端 订阅的终端地址,短信、邮件、HTTP以及HTTPS终端支持批量输 入,批量添加时,每个终端地址占一行。最多可输入10个终端。
● 选择“短信”,请输入有效手机号码。
输入规则为[+] [国家码][手机号码]。国内手机号码可省略[+]或 [+] [国家码]。
例如:
+8600000000000 +8600000000001
● 选择“邮件”,请输入有效电子邮件地址。
例如:
[email protected] [email protected]
● 选择“HTTP”或“HTTPS”,请输入公网网址。
例如:
http://example.com/notification/action http://example2.com/notification/action
步骤4 添加订阅后,配置的订阅终端将收到确认订阅消息。若订阅终端为邮件,如图5-24所 示。确认后,设置的订阅终端才能收到该主题发布的消息。
图5-24 消息订阅确认
----结束
步骤三:设置主题策略
步骤1 在消息通知服务控制台的左侧导航树中,选择“主题管理 > 主题”,进入主题页面。
步骤2 在创建的主题行单击“操作”列的“更多 > 设置主题策略”,弹出主题策略设置页 面。
步骤3 配置主题策略的参数。