操作步骤 登录MetaStudio控制台。 在“工作台”界面，单击“分身 视频直播 ”下方的“开始创建”。 进入分身数字人直播首页面，如图1所示。 图1 分身视频直播首页面 在“直播管理”页签，单击“创建直播间”，进入视频直播制作界面。 界面详情如视频直播界面说明所示，对应操作说明如下所示。详细操作说明，请参考视频直播素材操作详情。 在左侧的素材区域，除了系统预置的视频素材外，角色还可以自定义定制数字人；背景、贴图、视频还支持从本地导入使用；商品可以自主创建；文本可自主输入文字内容。 从素材区域添加到预览窗口中的贴图、视频和数字人支持进行图层管理，如：上移一层、下移一层、置顶、置底、应用到全局、删除等操作。还支持设置大小，拖动位置。 视频直播画面创作完成后，请根据实际情况，选择下述一种直播剧本驱动方式。 “剧本驱动”包含3种方式： 文本驱动 需要通过文本驱动数字人说话。支持下述2种方式，增加文本内容。 直接在各个场景的段落框中输入文本内容。可单击图标，新增更多的段落。 单击右上方的“导入”，从本地导入不少于200字的txt文件。如果多个段落，可通过换行来实现，平台会自动解析输入内容。 手工输入文本示例，如下所示： 请注意，当前仅为效果演示，实际需要满足单场景不少于200字，单段落不多于2000字的要求。 段落1.1：大家好，今天欢迎来到会议室，我们今天讨论的主题是：如何更好的学习和工作。 段落1.2：我们每个人都有自己的学习和工作，难免会遇到一些问题。当我们遇到问题的时候，应该如何解决的呢？ 图2 文本驱动 文本内容的操作说明如表1所示。 表1 操作说明 操作 说明 插入停顿 在段落的某个位置，插入换气或者停顿时间。 多音字 选中文字，设置多音字的正确读音。 全局语速 设置全局语速，取值范围[0.5X,2X]。设置为0.5X时，声音放慢至0.5倍速播放；设置为2X时，声音加速至2倍速播放。 助播 选中一段文字，设置为助播来播报这段内容。 全局声音（主播） 主播全局声音，适用于直播间所有场景。如果单场景有单独设置声音，优先使用单场景的声音播报。 有默认声音，用户也可以根据实际情况选择其他声音。 如果需要使用标注“第三方”的系统声音，请参考购买出门问问声音套餐进行操作。 全局声音（助播） 助播全局声音，适用于直播间所有场景。单场景不支持单独设置助播声音。 开播后的效果，如图3所示。如需进行互动，可单击图标，切换到助播声音。输入并发送互动内容，主播暂停播报，并使用助播声音插播发送成功的互动内容。 导入 支持从本地导入文本文件，解析生成段落内容。 导入文件需满足： 支持txt格式，且字数不低于200字。 文本内容根据换行，自动解析为段落。 试听 单击“试听”，可以试听当前直播间剧本。 默认使用全局主播声音播报，如果单场景有单独设置声音，优先使用单场景的声音播报。单独标注助播的内容，会使用全局助播的声音进行播报。 也可以单击段落区域的试听图标，试听当前段落。 场景操作 支持对场景，执行下述操作： ：修改场景名称，默认值为“场景1” ：设置当前场景播报的声音，直播时会优先使用此声音播报当前场景内容。 ：复制当前场景，新增一个相同场景。 ：删除当前场景。 ：调整场景的位置。 ：为当前场景新增1个空白段落。 段落操作 支持对段落，执行下述操作： ：修改段落名称，默认值为“段落1.1”。 ：试听当前段落的播报效果。 ：复制当前段落，新增一个相同段落。 ：删除段落。 ：调整段落在场景中的位置。 ：新增1个空白段落。 图3 开播界面 音频驱动 单击“上传音频”，从本地上传已录制好的音频，如图4所示。 每个音频不能超过100M，支持WAV、M4A和MP3格式，每个场景的音频总时长不能低于1分钟。 开播后会直接播放音频，声音是音频原有声音。用户也可以设置主播和助播的声音，用于开播后，使用主播或助播声音，播报发送的互动内容。 图4 音频驱动 音频上传完成后，单击“试听”，可试听音频。 开播后可单击如图5所示的图标，切换到全局主播或助播的声音，发送互动内容成功后，播报互动内容。 图5 开播页面 即兴直播 无需设置剧本，直接开播，界面如图6所示。开播后数字人保持静默，需要发送互动内容或者通过真人接管，驱动数字人说话。 图6 即兴直播 如果还需要制作多场景，可以单击直播画面预览窗口右侧“场景1”小窗口下方的“+”图标，新增场景，并参考前一个场景，设置生成下一个场景的画面布局和剧本内容。 图7 直播间界面 所有场景的画面布局和剧本设置完成后，单击界面右侧的“互动设置”页签，如图8所示。 互动设置包含4类设置：弹幕、用户入场、点赞和送礼。支持直接导入互动管理中设置好的互动库，也支持在当前直播间逐条设置互动规则。所有类型总计可添加100个互动规则。 这4类互动设置新增互动规则的操作基本相同，下面以弹幕为例，进行操作说明。 图8 互动设置 单击图8中的“添加规则”，展示如图9所示的界面。 界面下方新增1个规则设置。 先设置用户弹幕触发规则的关键词，如果有多个，请以“|”分隔，示例“链接|型号|优惠”。即服务扫描弹幕的时候，如果扫描到此关键词，自动回复当前规则内容。 在下方选择主播或助播回复用户问题，回复内容支持通过下述2种方式设置。 文本：通过文本方式设置回复内容，最多可增加5条回复。直播间开播后按照触发次数，从前往后依次命中答复，每次仅回复一条文本内容。 示例：关于产品的链接、型号和优惠等问题，请看界面上方的说明，按照说明操作，就可以详细了解了。 音频：从本地上传一个音频文件，支持MP4、WAV和M4A格式。当命中此规则后，使用此音频进行回复。 智能交互：通过智能交互的方式回复用户问题，相当于提供了一个第三方语言模型去答复用户问题。 回复问题的时候，支持同时在直播画面中展示图片或者视频信息，以加强回复效果。图片和视频的添加和设置方式完全相同，下面以图片为例，进行操作说明。 单击下方的“+”区域框，从本地选择图片或视频，添加到“+”区域框中。 添加成功后，区域框展示图片缩略图，如所示。 将鼠标放在区域框中，区域框变化为形式。 单击“预览”，图片被添加到直播画面预览窗口中，可根据实际情况拖动图片的展示位置或者调整图片大小。 图9 弹幕设置 单击“新增”，可参考6.a，添加更多的弹幕回复规则。 等所有弹幕规则增加完成后，支持单击“新增兜底”，新增新增一条兜底规则，设置方式与6.a相同。 其含义为：用户问题如果未匹配到已有规则，可触发兜底回复，仅支持设置1条兜底回复。 支持对已有规则，执行下述操作： 批量管理：支持批量设置所选规则使用的场景，或批量删除所选规则。 弹幕回显：开启“弹幕回显”后，在直播画面中可以看到一条文本信息：正在回复[用户名称]：[弹幕内容]。 全部启用：可以直接“全部启用”所有规则。 ：设置单规则使用的场景。 ：启用或关闭当前规则。 ：删除规则。 单击界面右侧的“直播配置”页签，如图10所示。 直播配置说明，如表2所示。 图10 我的视频 表2 直播配置 区域 参数 说明 开播设置 选择开播方式（二选一） 请根据实际情况，选择一种开播方式，并按照界面提示进行操作。 输出设置 直播画面 选择直播画面的清晰度。 包含如下选项： 流畅 高清 超清 默认值：高清。 播放次数 设置直播循环播放的次数，或“无限循环”。 默认播放1次。 直播窗口 直播窗口展示尺寸，不同方案均可调整为竖向。 包含如下选项： 竖屏 全屏：推荐用全屏，捕获的画面更大，需在直播伴侣中旋转使用。 默认为“竖屏”。 更多设置 事件回调地址 可在直播中返回场景、段落事件的字段，适用于接口调用或客户二次开发使用的场景。 直播间ID 无需设置，当前直播间保存后自动展示。 上述操作完成后，需要单击界面右上角的图标，保存直播内容。 单击界面右下方的“准备开播”，准备开播。 默认勾选“加载完自动直播”，单击“准备开播”加载完成后自动开播。 如果希望延迟开播，先取消勾选“加载完自动直播”，再单击“准备开播”。当需要开播时，在相同位置单击“开始直播”即可启动直播。 使用即兴直播方式开播，仅需单击“准备开播”即可启动直播。 文本驱动和音频驱动方式，还需确认风险提示。建议按照系统建议优化完成后，再启动直播。 弹出“风险提示”对话框，如图11所示。 用户需要参照风险提示项，逐一核查并优化直播内容。 图11 风险提示 用户可以等直播风险消除后再开播，也可以直接选择“承担风险开播”后，等待直播启动。 直播启动成功后，直播画面预览窗口中，会展示直播启动的进度。 开播后的效果如图12所示。界面右下方的操作说明，如表3所示。 图12 开播页面 表3 界面说明 界面元素 说明 00:01:20 直播计时，当前已直播1分20秒。 切换互动内容播报的声音。默认为主播声音，可切换为助播声音。 单击快捷图标，选择预置的互动内容发送播报。 请输入互动内容，回车发送内容 手工输入互动内容，发送成功后，主播或助播进行互动内容插播。插播结束后，继续播报原有内容。 真人接管 单击“真人接管”，开启真人接管功能。数字人停止发声，仅保留动作，改由真人发声。 真人发声结束后，单击“取消真人接管”，关闭真人接管功能，继续播报原有内容。 暂停 单击“暂停”，暂停播报。 单击“继续”，可恢复播报。 停止 单击“停止”，关闭当前直播。

软件包完整性校验 用户可对下载的SDK包进行完整性校验，判断下载过程中是否存在篡改和丢包现象。 详细操作如下所示： 在表1中下载SDK包及其完整性校验sha256包至本地。 打开本地命令提示符框，输入如下命令，在本地生成已下载SDK包的SHA256值。 其中，“D:\HWLLS_SDK_Web_2.6.0.tar.gz”为SDK包本地存放路径和SDK包名，请根据实际情况修改。 certutil -hashfile D:\HWLLS_SDK_Web_2.6.0.tar.gz SHA256 命令执行结果示例，如下所示： SHA256 的 D:\HWLLS_SDK_Web_2.6.0.tar.gz 哈希: 3ac83be852e8dcc9e90f236801fd4c494983073543e1ae66ee4d0c29043dccd1 CertUtil: -hashfile 命令成功完成。 比对查询出的SDK包SHA256值和下载后的SDK包SHA256值。 如果一致，说明下载过程中不存在篡改和丢包现象。

合规使用指南 华为云Live云直播低时延直播场景SDK开发者合规指南 《中华人民共和国个人信息保护法》自2021年11月1日起正式施行后，监管部门、各行业参与方和终端消费者越来越关注用户的隐私保护问题。为了有效治理App、SDK违规收集使用个人信息的现象，监管部门也陆续出台相关标准规范。 您作为开发者为最终用户提供服务，知悉并确认将遵守适用的法律法规和相关的标准规范，履行个人信息保护义务，并遵循合法、正当、必要和诚信的原则处理用户个人信息，包括但不限于《中华人民共和国个人信息保护法》、《中华人民共和国网络安全法》、《中华人民共和国数据安全法》以及其他适用的法律法规和相关的标准规范。 此文档用于帮助您更好地了解【华为云低时延直播SDK】并合规的使用【华为云低时延直播SDK】服务，仅适用于开发者的业务区域为中国大陆地区的场景。 一、基本要求 您的产品及服务需要尊重用户隐私，遵守国家的数据保护法律和法规。禁止参与任何干扰、干涉、损害、未授权访问任何终端设备、服务器、网络的活动。 1. 隐私政策要求 您需根据法律要求以自身名义发布隐私政策，并就个人信息的处理行为获取用户同意或取得其他合法性基础。隐私政策的要求包括不限于如下： 有独立文本，不能作为用户协议的一部分。 App首次运行收集处理个人信息前需要以醒目方式提示用户阅读隐私政策。隐私政策需方便用户查看，例如用户在App主功能界面中通过4次以内的点击或滑动操作可访问。 描述语言需要清晰通俗，符合通用语言习惯，避免使用有歧义的语言。 隐私政策内容要包含产品及服务收集个人信息的目的、方式和范围，个人信息处理者的名称和联系方式等。 您的产品及服务如涉及向第三方共享个人信息或集成了第三方的SDK时，需要在隐私政策中向用户进行披露和说明，获取用户的授权或同意。 2. 处理个人信息要求 您的产品及服务在处理用户个人信息时，需要遵守的要求包括不限于如下： 处理个人信息需要基于使用目的所必需，满足最小化原则。 实际收集和处理的个人信息范围、使用目的需要与隐私政策的范围保持一致。 收集个人信息的频率需与隐私政策保持一致，禁止超频次收集个人信息。 有明确的个人信息到期删除机制，个人信息的存留期与隐私政策保持一致，到期按时删除个人信息或对个人信息进行匿名化处理。 如涉及处理不满十四周岁未成年人个人信息前，应取得未成年人的父母或其他监护人的同意。 如涉及处理个人信息用于个性化推荐功能或大数据分析业务的，应告知并取得最终用户的授权同意情况下方可开展相关业务功能。 如涉及处理敏感个人信息前，应取得最终用户的单独同意。 如涉及跨境传输个人信息，需要按照国家网信部门会同国务院有关部门制定的办法和相关标准进行安全评估，并符合其要求。同时您还取得最终用户的单独同意。 支持用户方便的行使数据主体权利，例如查阅、复制、更正、删除个人信息等权利。 二、声明SDK处理的个人信息 在您接入、使用【华为云低时延直播SDK】服务前，我们要求您在隐私政策中向用户告知我们SDK的名称、SDK提供方名称、收集个人信息类型、使用目的、隐私政策链接，并获取用户的同意或取得其他合法性基础。您可以参考如下方式提供条款内容： 1. 以文字方式向用户告知 第三方SDK名称：华为云低时延直播SDK 第三方公司名称： 华为云计算 技术有限公司 收集个人信息类型： 音视频流、IP地址、运营商信息、WiFi状态、浏览器信息、操作系统信息、设备型号。 使用目的：为您提供音视频直播服务，向您提供低时延直播体验指标功能，以及方便问题定位。 隐私政策链接：隐私声明 2. 以表格方式向用户告知 第三方SDK名称 第三方公司名称 收集个人信息类型 使用目的 隐私政策链接 华为云低时延直播SDK 华为云计算技术有限公司 音视频流、IP地址、运营商信息、WiFi状态、浏览器信息、操作系统信息、设备型号 为您提供音视频直播服务，向您提供低时延直播体验指标功能，以及方便问题定位。 隐私声明 三、权限使用要求 我们SDK在提供服务时会最小化的使用系统权限，您需要根据实际使用的功能申请对应的系统权限并向用户告知征得其同意。 权限 权限描述 使用目的 无 无 无 四、延迟初始化要求 为了避免您的应用在未获取用户的同意前SDK提前处理用户的个人信息。我们提供了SDK初始化的接口 createClient(type: string)，请保证您的应用获取用户同意后才能调用此接口初始化SDK。 五、最小化使用功能要求 我们的SDK针对扩展功能和可选的个人信息的处理提供了配置能力，您可以基于业务诉求选择开启或关闭相关功能，低时延直播SDK提供开关上报日志的方法。 1. setReportConfig(reportConfig:ReportConfig)接口中reportConfig包含enable参数，设置为false时，不会进行日志上报，设置为true时，才会进行日志上报。 2. setLogLevel(level: string)接口中level设置为none，则关闭日志打印，设置为error、warn、info或者debug，则会输出对应日志打印。

计费公式 费用的计算公式为：费用=实际资源使用量*资源单价 按需计费模式下各计费项的具体价格，请参见产品价格详情。你可以通过视频直播提供的价格计算器，根据您的业务诉求，来快速计算出购买直播的参考价格。 如果需要计算每小时产生的费用，则需要将资源单价转换为以小时计费。如标准存储（单AZ）单价为0.0990元/GB/月，则每小时的单价为：0.0990元/GB/月*(1/24/30)=0.0001375元/GB/小时

操作步骤 登录MetaStudio控制台。 在“工作台”界面，单击“分身视频直播”下方的“开始创建”，进入分身数字人直播首页面。 单击“互动管理”，进入如图1所示的页面。 图1 互动管理页面 在左侧“互动库”区域，单击下方的“新增互动库”，上方新增一条横线，如图2所示。 输入互动库的名称。支持对互动库执行如下操作。 单击互动库右侧的，从下拉框中选择“重命名”，修改互动库名称。 单击互动库右侧的，从下拉框中选择“复制”，复制当前互动库，生成一个新互动库。 单击互动库右侧的，从下拉框中选择“删除”，删除当前互动库。 图2 互动库 选中左侧的互动库，单击界面右侧的“新建”，弹出“新建互动”对话框，如图3所示。 可以给当前互动库，新增1条互动规则。参数配置说明，如表1所示。 图3 互动规则 表1 互动规则配置说明 参数 说明 类型 互动类型。 包含如下选项： 弹幕 用户入场 点赞 送礼 互动名称（可选） 互动名称。 触发方式 触发关键词，多个关键词用“|”分割，示例“链接|型号|优惠”。 服务扫描弹幕的时候，如果扫描到此关键词，自动回复当前互动内容。 回复方式 选择主播或助播进行回复，具体回复内容支持通过下述方式设置。 文本：通过文本方式设置回复内容，最多可增加5条回复。直播间开播后按照触发次数，从前往后依次命中答复，每次仅回复一条文本内容。 示例：关于产品的链接、型号和优惠等问题，请看界面上方的说明，按照说明操作，就可以详细了解了。 音频：从本地上传一个音频文件，支持MP4、WAV和M4A格式。当命中此规则后，使用此音频进行回复。 智能交互：通过智能交互的方式回复用户问题，相当于提供了一个第三方语言模型去答复用户问题。 素材绑定（可选） 从本地选择图片或视频上传。当直播间命中当前互动内容进行答复时，同时会在直播画面展示这里上传的图片或视频。 单击“保存”，一条互动规则新增完成。 用户可以根据实际情况，为当前互动库增加更多的互动规则，或者增加更多的互动库。 支持对互动规则执行下述操作： 单击互动规则右侧的“编辑”，在弹出的“互动编辑”对话框中修改互动规则。 单击互动规则右侧的“复制”，复制当前互动规则，生成一条新的互动规则。 单击互动规则右侧的“删除”，删除当前互动规则。

隐私声明 华为云低时延直播SDK是由华为云计算有限公司（以下简称“我们”或“华为云”）面向华为云客户提供，方便用户接入低时延直播。华为云客户根据开发文档和用户指南，在其应用中集成低时延直播SDK后，我们将通过被集成的低时延直播SDK向华为云客户面向的最终用户（以下简称“您”或“用户”）提供相关服务，处理华为云客户的应用相关的数据，相关数据中可能包含您的个人信息。华为云非常重视您的个人信息和隐私保护，我们将会按照法律要求和业界成熟的安全标准，为您的个人信息提供安全保护措施。 我们将通过本声明向您说明我们如何收集、使用、披露、保护、存储及传输您的个人信息。 请注意，我们要求集成华为云低时延直播SDK的所有华为云客户，必须做到严格遵循法律法规、开发者协议去处理您的个人信息。在接入、使用各开放能力前，华为云客户必须在其产品应用的隐私政策中，向您告知其集成SDK处理个人信息的基本情况，并获取您的同意或取得其他合法性基础。但我们无法控制华为云客户及其开发的应用如何处理华为云客户所控制的个人信息，也不对其行为负责。我们建议您认真阅读华为云客户的应用相关用户协议及隐私政策。在确认充分了解并同意，华为云客户如何处理您的个人信息后，再使用华为云客户的应用。 一、我们如何收集和使用您的个人信息 华为云仅会根据本声明以下所述目的和方式收集和使用您的个人信息。如果我们要将收集的个人信息用于本声明未载明的其他目的，我们会以合理的方式自行或通过华为云客户明确向您告知，并再次获取您的同意或取得其他合法性基础。如果SDK存在扩展功能，或收集和使用了您的可选个人信息，我们会在下文特别说明。 低时延直播的功能 为了向您提供低时延直播的功能，我们会处理您的音视频流，用于低时延直播的播放。这些内容数据不会被存储，仅在服务器内存中缓存，直播结束后自动清除。 低时延直播体验指标及问题定位的功能 为了向您提供低时延直播体验指标功能以及问题定位的功能，我们会处理您的IP地址、运营商信息、WiFi状态、浏览器信息、操作系统信息、设备型号等数据，用于对低时延直播的首屏时长、播放帧率、网络码率、成功率、观看人数、卡顿率等指标进行统计，以及用于协助您进行业务功能的问题定位和分析。您的上述数据将在中华人民共和国境内处理，这些内容数据的存储期限默认为90天。此为可选功能，可通过SDK接口打开关闭。 您的上述数据在中华人民共和国境内处理，我们不会将上述数据用作其他用途。 二、设备权限调用 当您使用相应功能及服务时，我们会通过华为云客户的应用向系统申请您设备的相应权限。您可以在设备的设置功能或“隐私设置”中，查看权限状态，并选择开启或关闭部分或全部权限。华为云客户在集成使用相应开放能力时，可自行决定权限的调用范围，华为云客户向您说明权限调用的用途。您根据华为云客户的应用请求，开启任一权限，即代表授权我们处理相关个人信息来为您提供相应服务；一旦您关闭任一权限即代表您取消了授权，我们将不再基于对应权限继续处理相关个人信息，可能无法继续为您提供该权限所对应的功能。请注意，您关闭权限的决定，不会影响此前基于您授权所进行的个人信息处理活动的效力。当前华为云低时延直播SDK暂不涉及申请设备权限，无需向您申请授权。 三、对未成年人的保护 在您开始使用本服务时，须承诺您是成年人。若您是未成年人，须您的父母或监护人同意您使用本服务及相关服务条款。 如果未成年人在未经父母或监护人同意的情况下，向我们提供了个人信息，父母或监护人可以联系我们，停止收集、使用或披露其个人信息。 如果我们发现在未事先获得可证实的父母或监护人同意的情况下，收集了未成年人的个人信息，会设法尽快删除相关数据。 如果华为云客户使用本服务用于教育用途，且您的最终用户可能是未成年人，请确保您的最终用户使用本服务前已获得其父母或监护人的明确同意。 四、管理您的个人信息 华为云非常尊重您对个人信息的关注，我们将遵照相关法律法规的要求，协调、支持并保障您行使访问、复制、更正或删除个人信息操作的主体权利。 由于您是通过华为云客户的应用使用华为云低时延直播SDK和服务，如果您希望访问、复制或更正与华为云低时延直播SDK的个人信息，您应通过华为云客户的应用提供的路径实现您的个人信息主体权利。 为保障您访问、复制、更正或删除个人信息的权利实现，我们在与华为云客户的协议中，明确要求华为云客户承诺根据法律法规要求，向您提供便捷的权利实现方式。同时，我们的开放能力也向华为云客户提供了相关的接口，支持华为云客户通过接口调用方式来执行您关于个人信息的访问、复制、更正、删除的权利请求。您也可以通过本声明中“如何联系我们”所述联系方式与我们取得联系，我们将尽力协调、支持并保障您的上述权利实现。 当您直接向我们提出个人信息主体权利时，为了保障您的数据安全和其他合法权益，我们可能会对您的身份进行验证并要求您提供验证身份所必要的个人信息，同时我们也可能会向华为云客户提供收集的身份验证信息以核实您的身份。在验证确认您的身份后，我们会根据法律法规要求及时响应您的相关请求。 如您对您的数据主体权利有进一步要求或存在任何疑问、意见或建议，可通过本声明中“如何联系我们”所述方式与我们取得联系，并行使您的相关权利。 五、信息存储地点及期限 存储地 上述信息将会传输并保存至中华人民共和国境内的服务器。 存储期限 音视频数据在拉流结束后，会立即删除。其他数据会在使用结束90天后删除。 我们仅在实现本声明所述目的所必需的时间内，保留您的个人信息。并在超出保留时间后，删除或匿名化处理您的个人信息，除非法律法规另有要求。 六、如何联系我们 我们设立了个人信息保护专职部门。当您有任何疑问、建议、投诉、请求，请通过访问隐私问题页面与我们联系。我们将尽快处理您提交的问题，并在15个工作日或法律法规规定的期限内，答复您的问题。 如果您对我们的回复不满意，特别是认为我们的个人信息处理行为损害了您的合法权益，您还可以向有管辖权的个人信息保护机构或其他监管部门进行投诉或举报。 一般情况下，我们会尽最大努力响应和处理您的请求。结合您的请求或问题的复杂程度，我们可能会有所延迟，但我们会告知您延迟的理由。

on on(event: string, handler: function, withTimeout?: boolean): void 【功能说明】 注册客户端对象事件回调接口。 【请求参数】 event：必选，string类型，事件名称。具体请参见HWLLSClientEvent。 handler：必选，function类型，事件处理方法。 withTimeout：选填，boolean类型，是否超时报错 【返回参数】 无

enableStreamStateDetection enableStreamStateDetection(enable: boolean, interval: number, interruptRetry:StreamInterruptRetry): boolean 【功能说明】 开启/关闭音、视频码流状态探测功能，开启后可探测推流侧是否处于断流的状态。 【请求参数】 enable：必选，boolean类型，true表示开启音视频码流状态探测，false表示关闭音视频码流状态探测。默认值为false。 interval：必选，number类型，单位为秒，取值范围为[1,60]。音视频无码流状态的判断时间。默认值为3，推荐设置为3。 interruptRetry：可选，StreamInterruptRetry类型。断流重试播放配置参数，StreamInterruptRetry定义为：{ enable：boolean类型，开启断流后尝试自动恢复播放。默认值为false，即不开启自动重试。 retryInterval：number类型，拉流播放的重试周期，单位为秒。最小值10，最大值建议不超过60，默认值为30。 retryTimes：number类型，尝试重新恢复播放的最大重试次数。最小值1，默认值为30。 } 【返回参数】 boolean：是否成功，true表示成功，false表示失败。

streamStatistic streamStatistic(enable: boolean, interval: number): void 【功能说明】 设置是否开启流信息统计。 【请求参数】 enable：必选，boolean类型，是否开启流信息统计，true表示开启统计。 interval：必选，number类型，设置统计间隔，单位为秒，取值范围为[1, 60]，默认值为1。 【返回参数】 无

视频直播服务支持哪些直播流播放协议？ 华为云视频直播服务支持RTMP、HTTP-FLV和HLS三种播放协议。 RTMP协议比较全能，既可以用来推流，又可以用来播放直播流。其工作方式是将较大块的视频帧和音频帧“剁碎”，然后以小数据包的形式在互联网上进行传输，且支持加密，因此安全隐秘性比较理想，但拆包组包的过程比较复杂，所以在请求海量并发时易出现一些不可预期的稳定性问题。RTMP基于flash无法在iOS的浏览器中播放，但是实时性比HLS好。 HTTP-FLV协议工作方式是在大块的视频帧和音视频头部加入一些标记头信息，由于工作方式简洁，因此请求海量并发时比较稳定，延时小；用作手机端APP直播协议很合适，但是在手机浏览器上的支持却很有限。 HLS协议工作方式是将视频流分成5-10秒的多个小的基于HTTP的小分片文件来下载，然后用m3u8索引表进行管理。由于客户端下载到的视频都是5-10秒的完整数据，故视频的流畅性很好，但同样引入了很大延迟（HLS的一般延迟在10-30s左右）。相比于FLV，HLS对浏览器兼容较好，支持跨终端，因此常用于社交软件的URL分享。 表1 RTMP、HTTP-FLV、HLS协议对比 播放协议 协议 原理 延时 优缺点 RTMP TCP长连接 每个时刻受到的数据即刻发送。 与推流端GOP相关： 当GOP为1S时，播放延时1S~3S。 当GOP为2S时，播放延时2S~4S。 优点：延时低。 缺点：高并发下不稳定；iOS平台要开发支持相关协议的播放器；使用非标准TCP端口。 HTTP-FLV TCP长连接 数据头部添加标记，通过HTML5解封包播放。 优点：延时低。 缺点：需要集成SDK才能播放。 HLS HTTP短连接 集合一段时间数据生成ts切片文件，更新m3u8文件。 10S~30S。 优点：跨平台。 缺点：延时高。 父主题： 直播播放

操作步骤 登录视频直播控制台。 在左侧导航栏中，选择“ 域名 管理”，进入域名管理页面。 单击“添加域名”。在右侧弹出的“添加域名”页面输入已申请的播放或推流域名。 注意：若您的域名未备案，将添加失败，并提示“添加域名失败：ICP编号不存在”。 图2 添加域名 表1 域名参数说明 参数名 描述 域名 输入二级推流域名或播放域名。示例：“test-push.example.com”。 说明： 域名长度限制为64个字符，暂不支持大写的域名。 推流域名与播放域名不能相同，不支持添加泛域名。 默认每个账号下最多可创建64个域名。如需增加域名，请提交工单处理。 企业项目 将域名加入到企业项目中统一管理。 在企业项目页面创建企业项目，默认为default企业项目，然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明： 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名，否则，选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项： 云直播：流式直播服务，提供灵活易用，功能丰富的直播加速能力，适用娱乐、电商、教育等场景。 媒体直播：广播级直播服务，支持频道管理、内容加密等特性，适用于媒资，广电等场景。 请选择“云直播”。 直播源站 直播源站所在地域，可参考如何选择直播源站和加速区域？选择。直播源站配置后不可更改，建议您选择业务就近的源站。 目前支持如下区域： 中国站北京四入口，支持区域：华北-北京四、亚太-新加坡。 国际站新加坡入口，支持区域：亚太-新加坡、拉美-圣保罗一、华北-北京四。 欧洲站都柏林入口，支持区域：欧洲-都柏林。 说明： 推流域名的源站必须选择主播所在区域，不支持主播跨区域推流。比如主播需要同时在中国大陆和马来西亚直播，则需要创建两套推拉流域名，直播源站分别为中国大陆和新加坡。 需要关联的推流域名与播放域名的源站所在区域要保持一致。 用于存储直播录制、截图等的OBS桶必须与直播源站在同一区域，当您的存储已经在某个区域时，对应的直播源站必须选择为相同区域（region）。 加速区域 播放域名可执行加速的地域，可参考如何选择直播源站和加速区域？选择。仅对播放域名有效，推流域名不支持设置。设置完成后，不支持修改。 如果在所选加速区域之外播放，将无法保证功能和质量，请您根据实际业务，选择有效的加速区域。 包含如下选项： 中国大陆 当观众在中国大陆时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时，应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间，当“状态”为“正常”时，域名添加成功。 播放域名添加后，需要关联推流域名才可使用直播服务。关联的推流域名必须与播放域名归属同一个直播源站，详情请参见关联域名。 域名添加完成后，您需要在播放域名和推流域名的DNS服务商处配置CNAME，将您的域名指向CDN配置的CNAME地址。具体操作请见配置CNAME，配置完成后，对应的域名会自动启用直播加速服务。

注意事项 海外直播价格和国内直播价格不同，计费详情请参见价格详情。 在所选加速区域之外使用此播放地址，无法保证功能和播放质量。 如果播放域名的加速区域为“中国大陆”或“全球加速”，而推流域名的直播源站为中国大陆境内时，域名均需要完成中国大陆的域名备案。 如果新增、修改或删除域名，同步至我的资源中会有最长24小时的数据延迟，请稍候再查看。 如果添加播放域名时涉及HLS播放业务，需要先提交工单申请开通业务，请勿直接使用已创建的默认域名播放HLS。

注意事项 海外直播价格和国内直播价格不同，计费详情请参见价格详情。 在所选加速区域之外使用此播放地址，无法保证功能和播放质量。 如果播放域名的加速区域为“中国大陆”或“全球加速”，而推流域名的直播源站为中国大陆境内时，域名均需要完成中国大陆的域名备案。 如果新增、修改或删除域名，同步至我的资源中会有最长24小时的数据延迟，请稍候再查看。 如果添加播放域名时涉及HLS播放业务，需要先提交工单申请开通业务，请勿直接使用已创建的默认域名播放HLS。

添加域名 您需要将自有的已备案的推流域名、播放域名分别添加到视频直播服务中。下面以添加推流域名为例，播放域名的添加步骤与此相同。 登录视频直播控制台。 在左侧导航树中，选择“域名管理”，进入域名管理页面。 单击“添加域名”。在弹出的“添加域名”页面输入已申请的推流域名。 注意：若您的域名未备案，将添加失败，并提示“添加域名失败：ICP编号不存在”。 表1 域名参数说明 参数名 描述 域名 输入二级推流域名或播放域名。示例：“test-push.example.com”。 说明： 域名长度限制为64个字符，暂不支持大写的域名。 推流域名与播放域名不能相同，不支持添加泛域名。 默认每个账号下最多可创建64个域名。如需增加域名，请提交工单处理。 企业项目 将域名加入到企业项目中统一管理。 在企业项目页面创建企业项目，默认为default企业项目，然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明： 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名，否则，选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项： 云直播：流式直播服务，提供灵活易用，功能丰富的直播加速能力，适用娱乐、电商、教育等场景。 媒体直播：广播级直播服务，支持频道管理、内容加密等特性，适用于媒资，广电等场景。 请选择“云直播”。 直播源站 直播源站所在地域，可参考如何选择直播源站和加速区域？选择。直播源站配置后不可更改，建议您选择业务就近的源站。 目前支持如下区域： 中国站北京四入口，支持区域：华北-北京四、亚太-新加坡。 国际站新加坡入口，支持区域：亚太-新加坡、拉美-圣保罗一、华北-北京四。 欧洲站都柏林入口，支持区域：欧洲-都柏林。 说明： 推流域名的源站必须选择主播所在区域，不支持主播跨区域推流。比如主播需要同时在中国大陆和马来西亚直播，则需要创建两套推拉流域名，直播源站分别为中国大陆和新加坡。 需要关联的推流域名与播放域名的源站所在区域要保持一致。 用于存储直播录制、截图等的OBS桶必须与直播源站在同一区域，当您的存储已经在某个区域时，对应的直播源站必须选择为相同区域（region）。 加速区域 播放域名可执行加速的地域，可参考如何选择直播源站和加速区域？选择。仅对播放域名有效，推流域名不支持设置。设置完成后，不支持修改。 如果在所选加速区域之外播放，将无法保证功能和质量，请您根据实际业务，选择有效的加速区域。 包含如下选项： 中国大陆 当观众在中国大陆时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时，应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间，当“状态”为“正常”时，域名添加成功。 执行步骤1-步骤4，完成对播放域名的添加。 播放域名添加后，需要关联添加的推流域名才可使用直播服务。关联的推流域名必须与播放域名归属同一个直播源站，具体请参见关联域名。

操作步骤 登录视频直播控制台。 在左侧导航栏中，选择“域名管理”，进入域名管理页面。 请根据实际需求选择以下操作。 查看域名信息 在域名列表中，可查看已添加域名的CNAME值、域名类型、状态及创建时间等信息。 图1 域名管理 单击右侧操作列的“管理”，可查看目标域名的详细基本信息。 图2 域名信息 停用域名 若您需要停用某个域名，可以在需要停用的域名行单击“停用”。当“状态”变为“停用”时，表示域名停用成功。 启用域名 若您需要将某个已停用的直播域名重新启用，可以在需要启用的域名行单击“启用”。当“状态”变为“正常”时，表示域名启用成功。 删除域名 注意：仅在“停用”状态下的域名才能删除。因此，您需要先停用不需要的域名，再在需要删除的域名行单击“删除”即可。 解除域名关联 若您需要解除某个已关联的域名，可以在需要解除关联的播放域名行单击“管理”。在“推流信息”区域，单击即可。 图3 推流信息