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