必须通过官方认证插件扩展功能，开通后不可降级且仅绑定当前主体千帆api密钥；插件兼容性取决于数字人模型版本；商品弹窗支持语音触发自动弹出；投票插件需json配置并校验；api调用需token鉴权及webhook接收结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在百度一镜数字人直播中实时接入商品弹窗、观众投票、抽奖倒计时等动态交互能力，必须通过官方认证插件扩展基础功能，而非依赖第三方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小时。
