检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
智能交互客户端SDK 操作前提 SDK概述 SDK下载 Web SDK 父主题： 智能交互
父主题： 智能交互客户端SDK
表1 客户端SDK 客户端 集成SDK 接口参考 Web Web SDK 接口参考 父主题： 智能交互客户端SDK
SDK下载 下载SDK安装包 完整性校验 父主题： 智能交互客户端SDK
以文字方式向用户告知 第三方SDK名称：数字人智能交互Web SDK 第三方公司名称：华为云计算技术有限公司 收集个人信息类型：您或您的最终用户的音频数据或文本数据、应用信息（浏览器User Agent）、SDK接口调用记录。
前提条件 MetaStudio创建对话时，如果“第三方应用”选择“奇妙问”时，才需要执行创建智能交互数字人（奇妙问）操作，详情请参考表1。 父主题： 创建智能交互数字人（奇妙问）
错误码（ICSError） 本节介绍Web SDK客户端错误码IcsError的详细信息。
为了提供交互功能，SDK会通过您主动点击聊天按钮申请客户应用或浏览器的麦克风权限，在您同意客户应用使用麦克风之后，将您的音频数据或文本数据上传到客户指定的第三方系统或模型，用于识别语义并做出应答，给您提供交互功能。
Web SDK 快速入门 接口参考 常见问题 SDK隐私声明 SDK合规使用指南 修订记录 父主题： 智能交互客户端SDK
示例8：视频直播对接实时音视频客户端SDK 视频直播对接实时音视频客户端SDK应用示例代码，请参考MetaStudio数字人直播对接实时音视频客户端SDK。 父主题： 应用示例
修订记录 表1 修订记录 修改时间 修改说明 2025-01-14 本次变更如下： 新增发布3.0.2版本SDK，相比3.0.1版本，变更点如下所示： 语音唤醒能力支持设备切换实时生效。 2024-12-30 本次变更如下： 新增发布3.0.1版本SDK，相比2.2.0版本，变更点如下所示
快速入门 环境要求 Web SDK运行环境要求，如表1所示。 表1 环境要求 环境项 使用限制 开发工具 Microsoft Visual Studio Code、WebStorm或其他Web IDE开发工具。 语言 Javascript或Typescript。 编译环境 建议Node
接口参考 主入口（HwICSUiSdk） 事件通知（EventMap） 错误码（ICSError） 授权浏览器麦克风的访问权限 Web语音唤醒 父主题： Web SDK
完整性校验 操作说明 对下载的SDK安装包进行完整性校验，判断下载过程是否存在篡改和丢包现象。 操作步骤 参考下载SDK安装包，下载SDK安装包至本地。 打开本地命令运行程序，输入如下命令，在本地生成SDK安装包的SHA256值。 其中，“D:\HwICSUiSdk-1.0.0.zip
前提条件 MetaStudio创建对话时，如果“第三方应用”需要选择“科大讯飞AIUI通用语义模型”或“科大讯飞星火交互认知大模型”时，才需要执行创建智能交互数字人（科大讯飞）操作，详情请参考表1。 父主题： 创建智能交互数字人（科大讯飞）
X-App-UserId 否 String 第三方用户ID。不允许输入中文。 表3 请求Body参数 参数 是否必选 参数类型 描述 text 是 String 待合成文本。 tts_text 否 String 发送给tts的待合成文本。
事件通知（EventMap） 本节介绍Web SDK的EventMap事件。 表1 通知列表 接口 描述 三方驱动场景（是否支持） 非三方驱动场景（是否支持） error 错误事件。 √ √ enterActive 数字人激活事件。 × √ enterSleep 数字人自动休眠事件
常见问题 智能交互SDK安装包里为什么有图片资源？ SDK里面包含图片资源，是因为智能交互的动效、背景可能需要图片资源才能展示更好的效果。所以智能交互Web SDK为了方便用户集成使用，会同时包含UI相关资源。 speechRecognized和semanticRecognized
下载SDK安装包 表1 SDK下载 SDK名称 SDK包 开发者 个人信息处理规则 合规使用指南 HwICSUiSDK 参见表2下载链接 华为云计算技术有限公司 SDK如何处理个人信息请参见SDK隐私声明 您集成和使用我们的SDK时需要遵从个人信息保护基本要求，详情请参见SDK合规使用指南
Web语音唤醒 产品预置了唤醒能力，详见预制唤醒能力，如果用户需要更新唤醒词，需要参考定制唤醒能力处理。唤醒模型定制完成后，产品会提供给用户，用户需要参考更新唤醒模型，将模型更新至本地模型路径中。 使用要求 WebSDK版本为3.0.1及以上。 仅支持数字人平台配置或内置ASR（语音转文本
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
