文档

前置准备

更新时间:

本文介绍如何在视频直播控制台配置AUI Kits依赖的推拉流域名、实时音视频应用、消息应用和SDK License。

说明

阅读本文前,请确保你已在视频直播控制台开通服务。

添加推流和拉流域名

AUI Kits封装了视频直播的推拉流功能,支持将主播端的流推到阿里云直播中心服务器,并提供一组拉流地址,观众端通过该拉流地址观看直播画面。

使用视频直播服务前,您需要分别添加和关联一对推流域名和播流域名,并开通RTS1.0。操作步骤如下:

说明

您可以观看视频讲解学习如何添加域名,详细说明请参见添加域名

  1. 登录视频直播控制台

  2. 在左侧导航栏选择域名管理,进入域名管理页面。

  3. 单击添加域名。

  4. 根据业务需求配置域名参数。需要确保您的待添加域名已完成工信部备案,否则将无法添加。

    参数

    参数分类

    说明

    加速域名

    输入您需要加速的域名。注意事项如下:

    • 加速域名一般使用子域名,例如: demo.aliyundoc.com。

    • 直播服务暂不支持添加泛域名,例如: *.aliyundoc.com。

    • 加速域名不允许重复添加,如果出现域名已添加的提示,请检查您的域名是否已经添加到其他云产品中,例如视频点播、全站加速和视频监控,您也可以提交工单处理。

    • 开通视频直播服务后,每个账户最多可添加20个域名,如果您域名的总带宽日均峰值大于50 Mbps,且业务无风险,可提交工单申请增加域名个数。

    • 加速内容必须合法且符合业务规范,详情请参见域名准入标准

    说明

    子域名必须在同一个账号下。您在添加域名时,直播服务会进行检查,如果子域名被添加到不同账号,系统会报错。如果您无法自行解决,请提交工单

    直播中心

    直播中心用来提供云上直播流的媒体处理服务,如截图、录制、转码、云导播等。

    说明

    需要关联的直播推流域名与播流域名的直播中心所在地域要保持一致,初次配置后不可更改。更多信息,请参见直播基础服务FAQ

    业务类型

    • 播流域名

    • 推流域名

    指域名的加速类型,推流域名与播流域名分别对应推流加速与播流加速。初次配置后不可更改。

    • 添加推流域名时,业务类型请选择推流域名;添加播流域名时请选择播流域名。

    • 您无法将同一域名既添加为推流域名,又添加为播流域名。

    CDN加速区域

    中国内地

    域名需要在工信部备案,推荐您进入阿里云ICP代备案管理系统进行备案。

    • 当主播在中国内地时,推流域名应选择中国内地。

    • 当观众在中国内地时,播流域名应选择中国内地。

    全球加速

    域名需要在工信部备案,推荐您进入阿里云ICP代备案管理系统进行备案。

    • 当主播在中国内地、中国香港、中国澳门、中国台湾以及其他国家和地区时,推流域名应选择全球加速。

    • 当观众在中国内地、中国香港、中国澳门、中国台湾以及其他国家和地区时,播流域名应选择全球加速。

    海外及港澳台加速

    如果选择海外及港澳台加速且直播中心在海外,则域名无需在工信部备案。如果选择海外及港澳台加速且直播中心在中国境内,则域名需要在工信部备案。推荐您进入阿里云ICP代备案管理系统进行备案。

    • 当主播在海外及中国香港、中国澳门、中国台湾时,推流域名应选择海外及港澳台加速。

    • 当观众在海外及中国香港、中国澳门、中国台湾时,播流域名应选择海外及港澳台加速。

  5. 分别添加完推流域名和播放域名后,需将推播放域名进行关联。找到目标播流域名并单击域名配置>基本配置>推流信息,单击未配置添加推流信息,选择要关联的推流域名,单击确定

    image.png

  6. 为推播流域名开通RTS1.0。

    1. 推流域名配置:找到目标推流域名并单击域名配置>基本配置>超低延时推流RTS,打开RTS推流开关,选择低延时推流(RTS 1.0),单击确定

      image.png

    2. 播放域名配置:找到目标播放域名并单击域名配置>基本配置>超低延时播放RTS,打开RTS播放开关,选择低延时推流(RTS 1.0),单击确定

      image.png

  7. 可选:配置HTTP消息头。

    说明

    如果使用Web端播放则需要设置跨域,详细操作请参见配置HTTP消息头

  8. 单击提交

添加推流和拉流鉴权Key

URL鉴权功能旨在保护用户站点的内容资源不被非法站点下载盗用。建议您保持默认开启状态,否则会出现直播被盗录、盗播的风险。

说明

您可以观看视频讲解学习如何配置URL鉴权,详情请参见配置URL鉴权

  1. 在视频直播控制台域名管理页面,选择您要配置的播流域名,单击操作列的域名配置。

  2. 选择直播管理 > 访问控制,进入访问控制页面。

  3. 单击URL鉴权页签,开启URL鉴权开关。

  4. 配置URL鉴权信息。

    配置项

    说明

    鉴权类型

    视频直播播流域名仅支持使用鉴权A,来实现对源站资源的有效保护。

    URL鉴权错误,都会返回403报错,请重新计算。

    • MD5计算类错误例如:X-Tengine-Error:denied by req auth: invalid md5hash=de7bfdc915ced05e17380a149bd760be

    • 时间类报错例如:X-Tengine-Error:denied by req auth: expired timestamp=1439469547

    主Key

    当您添加域名时,控制台会随机生成一个主用密码。您可以通过在直播控制台左侧的导航栏选择域名管理,选择您需要配置的域名,单击域名配置 > 访问控制 > URL鉴权,在URL鉴权页面查看主用密码。您还可以重新输入自定义的鉴权方式对应的主密码。

    备Key

    输入自定义的鉴权方式对应的备用密码。

    有效时长

    有效时长是指该URL鉴权仅在有效期内可用来发起推流或者播放。直播推流和播放都是长链接行为,在有效期内已经发起的直播推流或者播放行为,不会因为有效期过期而中止,但新发起的推流和播放请求会因为有效时长过期会失败。

    初始化时,默认为30分钟。你可以自定义输入鉴权方式的默认有效时长,单位:分钟。

  5. (可选)完成域名配置和鉴权Key的获取之后,您可以使用视频直播控制台工具箱 > 地址生成器生成推流、拉流URL进行验证。

后续操作

  1. 域名管理中将配置好的推、拉(播)流域名填入服务端集成的AppServer配置中。

    image.png

  2. 在访问控制中URL鉴权页签下将配置好的推、拉(播)流域名鉴权主Key填入服务端集成的AppServer配置中。

    image.png

创建实时音视频应用(可选)

实时音视频依托阿里云直播推拉流SDK,为您的直播App或者平台新增实时音视频能力。

说明
  • 若您的直播App不需要实时音视频特性,则可跳过此步骤。

  • 若您直接使用AppServer且未创建实时音视频应用,则在配置AppServer的“实时音视频应用ID”与“实时音视频AppKey”填入任意值以跳过部署检验,届时会生成无效的实时音视频地址,不影响直播功能的使用。

  1. 在视频直播控制台左侧导航栏,单击场景服务 > 实时音视频 > 应用管理

  2. 单击创建实时音视频应用,完成开通步骤后返回视频直播控制台。

    1. 填写自定义的实例名称。

    2. 仔细阅读并勾选《实时音视频服务服务协议》。

    3. 单击立即购买。

    说明

    实时音视频为后付费计费,开通实时音视频应用时无需付费。后续使用期间会产生费用,计费详情,请参见互动直播费用

  3. 在实时音视频应用管理页面应用列表中操作列,您可以查询实时音视频应用ID和AppKey。

    说明

    详细配置说明请参见:应用管理

如何配置实时音视频

  1. 配置旁路转推,将旁路转推中的播放域名指向在添加推流和拉流域名步骤中已配置的播放域名。此时如果要配置录制或截图,则需要在该域名下进行配置。

    image.png

  2. 然后推流/播流端基于固定域名live.aliyun.com来推拉,请求参数带上实时音视频应用ID即可。

    说明

    详细配置说明请参见:实时音视频地址规则

创建应用

  1. 登录视频直播控制台

  2. 在左侧导航栏选择场景服务 > 互动消息 > 应用管理,进入应用管理页面。

  3. 单击创建应用

  4. 创建应用对话框中,根据实际需求配置参数。

    参数

    说明

    区域

    选择创建应用区域:华东2(上海)、新加坡。

    应用名称

    应用名,长度2~16个字符。

    回调设置

    回调设置开关默认关闭,如果您开启回调设置开关,在回调地址输入框中输入内容。回调地址内容格式请参见创建互动消息应用

    回调地址

    安全审核

    安全审核开关默认关闭,开启安全审核开关后可选择安全审核方式。

    审核方式

  5. 单击创建。应用列表会新增创建的应用,并自动生成AppId、AppKey、AppSign、创建时间等信息。

创建SDK License

AUI Kits依赖的MediaBox音视频SDK需要license授权,为了在Android、iOS等平台的移动设备上顺利运行AUI Kits项目,建议您申请播放器、推流、美颜特效3个模块的授权。集成方可以根据业务需求创建必要的SDK License。

  1. 在视频直播控制台左侧导航栏,选择SDK管理 > 我的授权。

  2. 单击创建应用并绑定License授权。

  3. 按照实际业务需求填写应用信息,参数说明见下表。配置完成后单击下一步。

    参数

    说明

    应用标题

    在文本框中输入应用标题。支持中英文、数字或下划线(_),不支持空格等特殊字符,最大长度128字符。

    平台

    应用平台,支持Android、iOS。

    Package Name

    Android应用包名,支持英文、数字、下划线(_)或句点(.),不支持空格等特殊字符,最大长度128字符。

    说明

    如果平台选择了Android则此项必填。

    Signature (MD5)

    Android应用证书的print指纹,非必填,您可以通过命令keytool -v -list -keystore your.keystore查看相应签名的MD5值。仅支持英文(小写)和数字,不支持空格等特殊字符,字符长度32位。

    说明
    • 绑定签名后会提高安全性,可以避免License被盗用。

    • 支持免校验签名MD5的版本有:MediaBox音视频SDK V1.7.0及以上版本、播放器SDK V5.5.2及以上版本、推流SDK V4.4.9及其以上版本。

    Bundle ID

    iOS应用Bundle ID。仅支持英文、数字、句点(.)或下划线(_)组成,不支持空格等特殊字符,最大长度128字符。

    说明

    如果平台选择了iOS则此项必填。

  4. 选择需要的功能模块,选择完成后单击下一步。

    说明
    • 所有功能模块均可在可选版本中选择使用试用版(有效期1个月)或正式版(有效期1年),每个App可以针对每个功能模块申请一次试用版。

    • 美颜特效模块提供不同版本,默认为短视频基础版、美颜特效基础版,您可根据实际业务需要在下拉列表中切换版本。

    • 播放器、直播推流不支持切换版本,默认为标准版。

  1. 确认您的应用信息,确认无误后单击创建完成应用创建。如需修改信息,可单击上一步返回配置界面。

    说明

    详细配置说明请参见:我的授权

后续操作

创建成功后,返回我的授权页面,可下载License文件、查看LicenseKey,或对App的License进行续费、换绑等其他操作。更多说明,请参见接入License

(建议)配置转码模板

直播观看

AUI Kits提供Windows与macOS的主播客户端《开播小助手》,推流使用的音频格式是Opus,建议设置转码以确保直播观看的兼容性。

普通直播

操作步骤如下:

  1. 登录视频直播控制台

  2. 在视频直播控制台左侧导航栏,单击域名管理,进入域名管理页面。

  3. 选择您要配置的播流域名,单击操作列域名配置。image.png

  4. 单击模板配置 > 转码模板配置。

  5. 在通用转码页签下,单击添加。

  6. 在配置转码模板页面,选择原画-仅转音频模板,并将编码格式设置为AAC。image.png

  7. 单击确定,完成配置,并将对应转码后的播流地址在直播间详情接口中返回。

超低延时直播(RTS)2.0

操作步骤如下:

  1. 配置4个域名,两对推拉流域名,其中一对推拉流域名需要开通RTS2.0服务,另一对不要开通RTS2.0服务。需要开通RTS2.0服务配置见下所示:

    • 推流域名

      image.png

      重要

      这里要注意下,此时要配置转推接收域名,这个域名就是另外一组推流域名地址。

    • 拉流域名

  2. 如果要配置录制/截图等,需要在另外一组拉流域名上面配置

    image.png

录制回放

AUI Kits提供Windows与macOS的主播客户端《开播小助手》,推流使用的音频格式是Opus。如需直播回看,需要添加录制配置以确保录制回放的兼容性。

录制到VOD(视频点播,推荐)

以普通直播录制为例,操作步骤如下:

  1. 登录到视频直播控制台。

  2. 在视频直播控制台左侧导航栏,单击域名管理,进入域名管理页面。

  3. 选择您要配置的播流域名,单击操作列域名配置。image.png

  4. 单击录制配置。

  5. 在存储至VOD的页签下,点击添加。

  6. 在弹窗中选择对应的转码模板,点击确定即可。image.png

    说明

    建议在转码模板中将音频转码为AAC格式以确保兼容性。

    若未在视频点播中配置转码模板,请移步视频点播控制台进行配置。

    详细操作说明参见:录制存储至VOD

录制到OSS

以普通直播录制为例,操作步骤如下:

  1. 登录到视频直播控制台。

  2. 在视频直播控制台左侧导航栏,单击域名管理,进入域名管理页面。

  3. 选择您要配置的播流域名,单击操作列域名配置。image.png

  4. 单击录制配置。

  5. 在存储至OSS的页签下,点击添加。

  6. 在弹窗中开启录制转码流 ,而转码模板ID选择oriaac,点击确定即可。image.png

    说明

    详细配置说明请参见:录制存储至OSS

  • 本页导读 (1)