百度一镜数字人如何通过插件增强直播功能

必须通过最新认证插件扩展功能，开通后不可降级且仅绑定当前主体千帆API密钥；插件兼容性取决于数字人模型版本；商品弹窗支持语音触发自动弹出；投票插件需JSON配置并校验；API调用需Token鉴权及Webhook接收结果。

要在百度一镜数字人直播中实时接入商品弹窗、观众投票、抽奖倒计时等动态交互能力，必须通过最新认证插件扩展基础功能，而非依赖第三方JS注入或网页端手动添加。

确认插件兼容性与启用权限

登录百度一镜控制台 → 进入【我的直播间】→ 点击目标直播间右侧「设置」→ 在「高级功能」页签中查看「插件中心」是否显示为“已开通”。未开通状态需联系客户经理或提交工单申请，【开通后不可降级，且仅支持绑定当前主体名下的千帆API密钥】。

插件列表中灰色置灰项表示当前数字人模型版本不支持（例如：v3.2以下不支持「实时语音情绪反馈插件」），点击插件卡片右上角「i」图标可查看最低模型版本要求。

安装并配置互动类插件

方法一：一键式商品弹窗插件

在插件中心搜索「商品浮层」→ 点击「立即启用」→ 选择已上架的百度电商商品库中对应SKU → 设置弹出触发条件（如：数字人说出“这款拖把现在下单立减30”时自动弹出）→ 保存后该插件即嵌入直播流底层协议，无需重启推流。

方法二：自定义投票插件（需JSON Schema配置）

下载插件模板JSON文件 → 用VS Code打开 → 修改"options"数组内选项文案（最多6项，单个选项不超过12字）→ 调整"duration_sec"字段设定投票时长（有效值30～300秒）→ 将修改后文件拖入插件后台「上传配置」区域 → 系统校验通过后自动生效。注意：若JSON格式错误，插件将处于「待重试」状态且不占用资源配额。

调用API实现深度集成

第一步：获取插件调用凭证

进入「开发者中心」→ 「插件管理」→ 找到已启用插件 → 点击「生成Token」→ 设置有效期（最长7天）→ 复制返回的Bearer Token。

第二步：构造HTTP请求体

使用curl或Postman向https://plugin-api.yijing.baidu.com/v2/trigger发起POST请求，Headers中加入Authorization: Bearer 【刚复制的Token】，Body中传入{"plugin_id":"vote_2026","params":{"option_id":"2","audience_count":1583}}——此操作将强制触发已配置好的投票插件，并同步更新直播间右下角实时参与人数。

第三步：监听Webhook回调

在插件配置页填写企业自有服务器地址（需HTTPS且响应超时≤3秒）→ 勾选「接收投票结果事件」→ 百度一镜将在用户提交后300ms内推送原始JSON数据，含用户设备指纹、投票时间戳及选项ID。未配置有效Webhook地址时，数据仅保留在平台侧72小时。