diff --git a/docs/华为云MetaStudio交互数字人配置指南.md b/docs/华为云MetaStudio交互数字人配置指南.md index 83ae9df..c741359 100644 --- a/docs/华为云MetaStudio交互数字人配置指南.md +++ b/docs/华为云MetaStudio交互数字人配置指南.md @@ -43,7 +43,7 @@ | 知识库 | 数字人回答问题的语料来源,支持文档上传、网页抓取等 | | 互动文档 | 数字人主动播报的脚本,可配置触发时机 | | 对话技能 | 控制数字人在特定场景下的对话逻辑 | -| 终端 | 数字人对外展示的渠道,如网页、H5、APP | +| 终端 | 数字人对外展示的渠道,如电脑端、手机端、大屏端 | | WebRTC | 实时音视频通信协议,用于数字人实时交互 | --- @@ -152,55 +152,55 @@ MetaStudio 提供多种预设形象,分为: | 虚拟背景 | 可上传图片或使用平台提供的场景模板 | | 分辨率 | 720P / 1080P / 4K | -> **建议**:如数字人部署在网页/H5 上,选择透明背景(WebGL 渲染模式),可叠加在任何网页内容上。 +> **建议**:如数字人需要叠加在任何背景内容上(如展厅大屏、网页侧边栏),选择透明背景(WebGL 渲染模式)。 --- ## 五、终端配置 -终端决定了数字人在哪里展示。华为 MetaStudio 支持多种终端类型。 +终端决定了数字人在哪里展示。华为 MetaStudio 支持电脑端、手机端和大屏端三种终端类型。 ### 5.1 支持的终端类型 | 终端类型 | 说明 | 适用场景 | |:---|:---|:---| -| **Web(网页端)** | 通过浏览器访问,支持 WebRTC | 官网、线上展厅 | -| **H5(移动端)** | 适配手机浏览器,无需下载 | 微信、小程序内嵌 | -| **APP(移动应用)** | 集成到企业自有 APP | APP 内嵌数字人 | -| **小程序** | 微信/支付宝小程序 | 微信生态内展示 | -| **线下大屏** | 支持 Linux/Windows 大屏终端 | 展厅、营业厅 | -| **API 接入** | 通过 WebSocket/API 调用 | 第三方平台集成 | +| **电脑端(PC Web)** | 通过浏览器访问,支持 WebRTC | 官网、线上展厅、办公系统 | +| **手机端(Mobile)** | 适配手机浏览器,含 H5 / 小程序 | 微信内嵌、企业微信、扫码体验 | +| **大屏端(Large Screen)** | 支持 Linux / Windows 大屏设备 | 展厅、营业厅、迎宾大屏、发布会 | -### 5.2 Web 终端配置 +### 5.2 电脑端(PC Web)配置 -#### 创建 Web 终端 +适用于 PC 浏览器访问的数字人终端场景,如官网客服、线上展厅等。 -1. 在项目页面,点击 **添加终端** → **Web 网页** +#### 创建电脑端终端 + +1. 在项目页面,点击 **添加终端** → **电脑端** 2. 配置以下参数: | 参数 | 说明 | |:---|:---| -| 终端名称 | 如:`官网网页端` | +| 终端名称 | 如:`官网电脑端` | +| 终端尺寸 | 固定尺寸(如 1280×720)或全屏自适应 | +| 分辨率 | 720P / 1080P,推荐 1080P | +| 默认语言 | 终端默认语言,如 `zh_CN` | | 域名白名单 | 允许嵌入数字人的域名,如:`*.example.com` | -| 是否启用 HTTPS | **必须启用**,生产环境必须配置 | -| 终端尺寸 | 固定尺寸 / 全屏自适应 | -| 默认语言 | 终端默认语言 | +| HTTPS | **必须启用**,生产环境必须配置 | 3. 点击 **生成嵌入代码**,获取 Iframe 或 Web SDK 代码 -**Iframe 嵌入示例:** +#### Iframe 嵌入 ```html ``` -**Web SDK 嵌入示例:** +#### Web SDK 嵌入 ```html @@ -215,8 +215,9 @@ MetaStudio 提供多种预设形象,分为: appId: 'your-app-id', token: 'your-auth-token', width: '100%', - height: '600px', + height: '720px', language: 'zh_CN', + autoStart: true, onReady: () => console.log('数字人已就绪'), onError: (err) => console.error('错误:', err), }); @@ -225,19 +226,88 @@ MetaStudio 提供多种预设形象,分为: ``` -### 5.3 H5 终端配置 +#### 电脑端尺寸参考 -适用于手机浏览器,无需安装 APP: +| 场景 | 推荐尺寸 | 说明 | +|:---|:---|:---| +| 官网侧边栏 | 320×580 px | 小尺寸,悬浮展示 | +| 官网全屏 | 1920×1080 px | 全屏沉浸式体验 | +| 线上展厅 | 1280×720 px | 兼顾清晰度与性能 | + +### 5.3 手机端(Mobile)配置 + +适用于手机浏览器、微信内嵌页、企业微信等移动端场景。 + +#### 创建手机端终端 + +1. 点击 **添加终端** → **手机端** +2. 配置以下参数: | 参数 | 说明 | |:---|:---| | 终端名称 | 如:`手机H5端` | +| 终端尺寸 | 自适应(撑满屏幕宽度) | | 授权域名 | 微信/浏览器安全域名配置 | -| 是否支持微信内嵌 | 开启后使用微信 JSSDK | +| 是否支持微信内嵌 | 开启后使用微信 JSSDK,支持微信分享 | +| 底部交互栏 | 是否显示输入框、快捷按钮等交互组件 | +| 键盘适配 | 移动端软键盘弹出时数字人画面自动上移 | -获取分享链接或二维码,扫码即可体验。 +3. 获取分享链接或二维码,扫码即可体验 -### 5.4 终端通用参数 +#### 手机端尺寸参考 + +| 场景 | 推荐尺寸 | 说明 | +|:---|:---|:---| +| 全屏沉浸 | 100vw × 100vh | 铺满整个手机屏幕 | +| 底部悬浮 | 100vw × 60vh | 底部固定,叠加在网页内容上 | +| 侧边栏 | 375×667(iPhone SE) | 小尺寸悬浮展示 | + +#### 微信内嵌注意事项 + +- 必须在华为云 MetaStudio 控制台将微信域名加入白名单 +- 微信内置浏览器需使用 HTTPS +- 如需调用微信 JSSDK(分享、录音等),需在微信公众平台配置 JS 安全域名 + +### 5.4 大屏端(Large Screen)配置 + +适用于展厅、营业厅、迎宾大屏、发布会等线下大尺寸展示场景,支持 Linux 和 Windows 系统。 + +#### 创建大屏端终端 + +1. 点击 **添加终端** → **大屏端** +2. 配置以下参数: + +| 参数 | 说明 | +|:---|:---| +| 终端名称 | 如:`展厅迎宾大屏` | +| 分辨率 | 1920×1080 / 2560×1440 / 3840×2160(4K) | +| 画面比例 | 16:9 / 16:10 / 4:3 | +| 数字人位置 | 左侧 / 右侧 / 底部,居中 | +| 数字人尺寸 | 占屏幕宽度比例,如 40% | +| 背景设置 | 支持透明背景叠加在任何内容上 | +| 待机画面 | 无交互时播放的内容(如品牌视频) | +| 自动唤醒 | 检测到人脸/人体时自动唤醒数字人 | + +#### 大屏端高级功能 + +| 功能 | 说明 | +|:---|:---| +| 人脸唤醒 | 通过摄像头检测用户靠近,自动启动数字人 | +| 手势识别 | 支持挥手、指屏幕等手势触发对应内容 | +| 多人识别 | 支持同时检测多名观众,数字人面向最近用户 | +| 静音模式 | 大屏无声时,数字人仅做唇形动画,不播放语音 | +| 定时播报 | 按设置时间自动播放欢迎语或宣传内容 | + +#### 大屏端尺寸参考 + +| 场景 | 分辨率 | 数字人推荐宽度 | +|:---|:---|:---| +| 企业展厅(55寸) | 1920×1080 | 屏幕宽度的 35-40% | +| 营业厅大堂(75寸) | 3840×2160(4K) | 屏幕宽度的 30-35% | +| 发布会主屏 | 1920×1080 | 屏幕宽度的 50-60% | +| 走廊导览屏 | 1080×1920(竖屏) | 屏幕宽度的 60% | + +### 5.5 终端通用参数 | 参数 | 说明 | 推荐值 | |:---|:---|:---| @@ -587,9 +657,9 @@ app_id = LANGUAGE_APP_MAP.get(lang, LANGUAGE_APP_MAP["zh_CN"]) | 终端 | 发布前检查项 | |:---|:---| -| Web | 域名已备案、HTTPS 证书有效、ICP 许可证(如需) | -| H5 | 微信/支付宝域名白名单已配置 | -| 小程序 | 小程序已在微信平台注册,AppID 填写正确 | +| 电脑端 | 域名已备案、HTTPS 证书有效、ICP 许可证(如需) | +| 手机端 | 微信/支付宝域名白名单已配置 | +| 大屏端 | 大屏设备已就绪,系统为 Windows 或 Linux,网络畅通 | | APP | APP 已上架或已添加测试设备 | #### 数字人内容审核