检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
智能交互客户端SDK 操作前提 SDK概述 SDK下载 Web SDK 父主题： 智能交互
WebSDK使用限制 由于浏览器的安全策略限制，仅支持通过“https://域名”方式访问，否则无法正常加载运行智能交互WebSDK。 父主题： 智能交互客户端SDK
SDK提供的接口，即可实现使用数字人智能交互业务能力的目的。 智能交互提供了如下主流平台SDK供开发者使用。 表1 客户端SDK 客户端 集成SDK 接口参考 Web Web SDK 接口参考 父主题： 智能交互客户端SDK
SDK下载 下载SDK安装包 完整性校验 父主题： 智能交互客户端SDK
Web SDK 快速入门 接口参考 常见问题 SDK隐私声明 SDK合规使用指南 修订记录 父主题： 智能交互客户端SDK
接口参考 主入口（HwICSUiSdk） 事件通知（EventMap） 错误码（ICSError） 授权浏览器麦克风的访问权限 父主题： Web SDK
快速入门 环境要求 Web SDK运行环境要求，如表1所示。 表1 环境要求 环境项 使用限制 开发工具 Microsoft Visual Studio Code、WebStorm或其他Web IDE开发工具。 语言 Javascript或Typescript。 编译环境 建议Node
常见问题 智能交互SDK安装包里为什么有图片资源？ SDK里面包含图片资源，是因为智能交互的动效、背景可能需要图片资源才能展示更好的效果。所以智能交互Web SDK为了方便用户集成使用，会同时包含UI相关资源。 speechRecognized和semanticRecognized通知的流式返回有什么差异？
修订记录 表1 修订记录 修改时间 修改说明 2024-11-13 本次变更如下： 新增发布2.1.0版本SDK，相比2.0.3版本，变更点如下所示： 支持文本问答。 startChat新增入参，参考表14，用来设置交互模式（语音问答/文本问答）。 新增接口activeInter
SDK隐私声明 数字人智能交互Web SDK是由华为云计算技术有限公司（以下简称“我们”或“华为云”）面向华为云客户（以下简称“客户”）提供的数字人智能交互开放能力及服务。 客户根据数字人智能交互Web SDK的开发文档和指南在其应用中集成了数字人智能交互Web SDK后，我们将通过被集成的数字人智能交互Web
示例7：视频直播对接实时音视频客户端SDK 视频直播对接实时音视频客户端SDK应用示例代码，请参考MetaStudio数字人直播对接实时音视频客户端SDK。 父主题： 应用示例
完整性校验 操作说明 对下载的SDK安装包进行完整性校验，判断下载过程是否存在篡改和丢包现象。 操作步骤 参考下载SDK安装包，下载SDK安装包至本地。 打开本地命令运行程序，输入如下命令，在本地生成SDK安装包的SHA256值。 其中，“D:\HwICSUiSdk-1.0.0.
SDK合规使用指南 《中华人民共和国个人信息保护法》自2021年11月1日起正式施行后，监管部门、各行业参与方和终端消费者越来越关注用户的隐私保护问题。为了有效治理App、SDK违规收集使用个人信息的现象，监管部门也陆续出台相关标准规范。 您作为华为云客户为最终用户提供服务，知悉
下载SDK安装包 表1 SDK下载 SDK名称 SDK包 开发者 个人信息处理规则 合规使用指南 HwICSUiSDK 参见表2下载链接 华为云计算技术有限公司 SDK如何处理个人信息请参见SDK隐私声明 您集成和使用我们的SDK时需要遵从个人信息保护基本要求，详情请参见SDK合规使用指南。
主入口（HwICSUiSdk） 本节介绍Web SDK的接口详情。 表1 接口 接口 描述 activeInteractionMode 获取当前生效的交互模式（语音问答/文本问答）。 addEventListeners 回调注册。 checkBrowserSupport 检查浏览器是否支持。
事件通知（EventMap） 本节介绍Web SDK的EventMap事件。 表1 通知列表 接口 描述 error 错误事件。 enterSleep 数字人自动休眠事件。 jobInfoChange 交互任务信息变更事件。 speakingStart 数字人开始讲话事件。 speakingStop
错误码（ICSError） 本节介绍Web SDK客户端错误码IcsError的详细信息。 表1 错误码说明 错误码 错误描述 错误原因或建议处理方式 20010001 name include invalid symbol 请修改名称中的非法字符 20010010 query asset
授权浏览器麦克风的访问权限 支持对Chrome浏览器和Mac系统的浏览器，授权麦克风的访问权限。 谷歌浏览器 打开Chrome浏览器，单击浏览器右上方的图标，从下拉框中选择“设置”。 进入“设置”页面。 在左侧导航栏中，选择“隐私设置和安全性”。 在右侧界面中，单击“网络设置”，进入“网络设置”页面。
分身数字人直播业务使用SparkRTC方式收流，其信令和媒体访问方式为“IP+端口”或“域名+端口”，防火墙需要放开如下限制： 解除所有IP访问的限制。 在客户端防火墙配置SparkRTC端口和域名白名单。 配置SparkRTC端口的防火墙白名单，如表1所示。 表1 防火墙端口白名单 端口类型 端口
400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
