docs: 终端配置改为电脑、手机、大屏三类，并更新相关称谓
This commit is contained in:
@@ -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
|
||||
<iframe
|
||||
src="https://your-domain.com/digital-human-embed?token=xxx"
|
||||
src="https://your-domain.com/digital-human?token=xxx"
|
||||
width="100%"
|
||||
height="600px"
|
||||
height="720px"
|
||||
allow="camera; microphone"
|
||||
frameborder="0"
|
||||
></iframe>
|
||||
```
|
||||
|
||||
**Web SDK 嵌入示例：**
|
||||
#### Web SDK 嵌入
|
||||
|
||||
```html
|
||||
<!-- 引入 SDK -->
|
||||
@@ -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 提供多种预设形象，分为：
|
||||
</script>
|
||||
```
|
||||
|
||||
### 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 已上架或已添加测试设备 |
|
||||
|
||||
#### 数字人内容审核
|
||||
|
||||
Reference in New Issue
Block a user