数字人互动集成步骤指引
更新时间:2025-05-07
构建数字人互动实例
前置条件:
- 在曦灵管理平台创建数字人应用, 购买云渲染交互组件, 并绑定云渲染交互组件。
https://xiling.cloud.baidu.com/open/widgetStore/list
- 获得曦灵数字人的AppID 和AppKey后使用如下的 Token 生成工具生成Token(根据业务需要选择token有效期,建议为900000小时):
https://open.xiling.baidu.com/token-gen-tool.html
配置数字人示例
数字人互动实例是一类特别互动实例。
音频互动示例配置请参考“互动智能体指引”一节。
改变cfg和必要的参数,就可以配置数字人互动实例了, 具体说明如下:
Plain Text
1// H5 上创建数字人互动示例代码
2var cfg = {
3 xiling_auth: 'xiling-token-XXX',
4 xiling_bgimg: '',
5 fid: 'A2A_V2-muqing', // 数字人形象, 可选形象 https://cloud.baidu.com/doc/AI_DH/s/2lyzilgsg
6 tts_url:'s?per=5132', // 数字人音色, 可选音色 https://cloud.baidu.com/doc/AI_DH/s/Slywt3fxy
7 tts: 'DHV2', // 固定值,指定数字人服务类别为DHV2
8 };
9 Agent.Start({
10 instance_type: 'DigitalHuman', // 固定值,指明是数字人智能体
11 appid: 'AppIdxxx',
12 cfg: cfg,
13 remotevideoviewid: 'therevideo',
14 localvideoviewid: 'herevideo',
15 success: function () {
16 },
17 error: function (error) {
18 },
19 onmessage: function (msg) {
20 console.log('onmessage id: ' + msg.id + ' data: ' + msg.data);
21 }
22 });
参数详解
参数 | 类型 | 描述 | 默认值 |
---|---|---|---|
instance_type | string | 互动智能体实例类别 | 固定值'DigitalHuman' 为数字人智能体 |
appid | string | 百度 派发的数字 ID, 开发者的唯一标识 | |
cfg.xiling_auth | string | 曦灵数字人的token字符串 | |
cfg.xiling_bgimg | string | 数字人的背景图 | |
cfg.fid | string | 数字人的形象id | 可选形象 https://cloud.baidu.com/doc/AI_DH/s/2lyzilgsg |
cfg.tts_url | string | 数字人音色配置, 格式是:'s?per=5132' | 可选音色 https://cloud.baidu.com/doc/AI_DH/s/Slywt3fxy |
cfg.tts | string | 固定只配置为数字人用 | 强制设置为: 'DHV2' |
error | function(error) | Start()失败,或运行过程中出现了错误 | |
destroyed | function(error) | 运行过程中出现错误被销毁的回调 |