官方原始接入文档
按接入阶段查阅微信、腾讯 TRTC 和各客户端平台的官方说明,并对照云蝠交付边界。
先区分两类文档
先按云蝠指南完成入口、智能体和服务配置,再按下列官方原文配置宿主权限或供应商资源。外部文档说明对应平台能力,不代表云蝠已开放其中全部接口;腾讯 SecretKey、签名密钥和管理 API Key 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。
谁需要完成哪些配置
| 负责方 | 负责内容 | 核对结果 |
|---|---|---|
| 企业管理员 | 开通语音、启用渠道入口、绑定已发布智能体并准备可用额度 | 入口配置与服务资源可用;未开通时不显示可开始语音的入口 |
| 宿主开发者 | 按官方说明配置微信类目/域名/隐私或 App 权限,安装对应接入包 | 实际宿主允许录音、播放和退出清理;系统授权与网页授权分别核对 |
| 部署维护者 | 在服务端配置腾讯应用、签名、AI 对话资源与回收任务 | 进房和 AI 任务结果可核对,挂断后任务及计费正确结束 |
| 联调人员 | 用同一入口完成首条消息、实际语音、打断、拒绝和账号切换 | 云端返回成功、页面显示成功与实际音频结果分别留证 |
Uni-app 微信小程序与 H5 客服
- DCloud · CLI 创建与构建 ↗:核对 Vue2 Vue CLI / webpack 与 Vue3 Vite 的不同构建入口、编译目标和输出目录;编译不等于平台发布。
- DCloud · web-view 原版网页承载 ↗:核对微信业务域名、全屏展示及宿主导航;原版页面和原生文本模式使用不同域名类别。
- DCloud · 页面与生命周期 ↗:合并页面与应用事件,防止隐藏路由继续轮询。
- DCloud · 小程序开发注意事项 ↗:区分 Vue 组件与原生微信组件注册,核对目标能力。
微信小程序:网络与域名
- 微信开放文档 · 小程序网络与合法域名 ↗:原生请求需配置 request、uploadFile、downloadFile 合法域名;WebView 另需业务域名,关闭校验不能代替正式配置。
微信小程序:隐私与录音
- 微信开放文档 · 隐私授权开发指引 ↗:接入宿主隐私告知和同意流程;隐私同意、系统麦克风授权与实际收音分别验收。
- 微信开放文档 · wx.authorize 授权接口 ↗:核对 scope.record 与拒绝后的处理;进入聊天页或点击普通按钮不等于已完成录音授权。
- 微信开放文档 · live-pusher 原生推流组件 ↗:核对原生推流组件、主体及类目权限;与腾讯 SDK 配置配套,在真机验证音频事件。
腾讯 TRTC:实时语音与 AI 对话
- 腾讯云 · 原生小程序快速接入 ↗:先核对企业主体、允许类目、推拉流权限、TRTC 套餐和 SDK 域名,再完成进房、发布音频与退房;开发工具不能代替真机。
- 腾讯云 · 实现 AI 对话 ↗:理解 RTC、识别、LLM、TTS、转录和打断的职责;具体参数与频率以对应接口的当前版本为准。
- 腾讯云 · 开始 AI 对话任务 · StartAIConversation ↗:服务端适配时核对地域、SdkAppId、房间、目标用户与模型配置,保留 TaskId/RequestId;返回成功还需核对手机是否实际出声。
- 腾讯云 · 控制 AI 对话 · ControlAIConversation ↗:核对供应商支持的播报和模型触发命令;仅供服务端适配参考,不可直接当作云蝠公开操作调用。
- 腾讯云 · 停止 AI 对话 · StopAIConversation ↗:结束服务端 AI 对话任务并核对原 TaskId 的回收结果;退出客户端页面不应被当作云端任务已停止的证明。
- 腾讯云 · 高级权限控制 ↗:评估服务端 UserSig、PrivateMapKey 与房间隔离;通用平台表不证明小程序和 AI bot 已兼容,启用前须在实际应用核对入房。
Web / H5:网页麦克风与嵌入权限
- MDN · getUserMedia 麦克风采集 ↗:核对 HTTPS、用户授权、设备和浏览器兼容性;打开页面不等于麦克风可用。
- MDN · Permissions-Policy: microphone ↗:配置父站点允许的客服来源并配合 iframe allow;响应头限制仍生效,不能用放开 CORS 解决麦克风拒绝。
iOS:系统用途说明与 WebKit 授权
- Apple · NSMicrophoneUsageDescription ↗:将真实录音用途写入宿主 Info.plist;只复制 Swift 容器不足以完成权限接入。
- Apple · WKUIDelegate 媒体采集权限 ↗:按可信 origin、frame 与媒体类型处理网页请求;系统录音权限和网页媒体授权需要分别处理。
Android:系统录音与 WebView 媒体权限
- Android Developers · 请求运行时权限 ↗:声明并请求 RECORD_AUDIO;处理拒绝、永久拒绝及恢复,不把权限请求回调当作全部获准。
- Android Developers · WebView PermissionRequest ↗:在 UI 线程仅授予当前可信来源的音频资源,处理取消请求;不直接 grant(getResources()) 放行未知媒体权限。
Harmony:ArkWeb 事件与权限声明
- OpenHarmony · ArkWeb onPermissionRequest ↗:核对网页音频授权事件与 grant/deny;文档主干会更新,本包 API12+ 示例仍须用目标 SDK 编译并真机验收。
- OpenHarmony · 声明应用权限 · 5.0 Release ↗:合并 MICROPHONE、用途字符串与实际 Ability 的 usedScene;清单声明不能代替运行时授权。
Uniapp:选择目标与基座权限
- DCloud · uni-app web-view 组件 ↗:区分 App-vue、H5 iframe 和微信目标;不同内核不能复用同一套原生权限假设。
- DCloud · manifest.json 配置 ↗:合并 Android 录音权限和 iOS 麦克风用途说明,并重新制作实际使用的自定义基座。
- DCloud · plus.android.requestPermissions ↗:分别检查 granted、deniedPresent、deniedAlways;系统授权成功不等于远端 WebView 已收音,需基座验收。
API 契约:OpenAPI 标准
- OpenAPI Initiative · OpenAPI Specification 3.1.0 ↗:理解本站 OpenAPI 文件的 schema、安全方案与导入格式;实际云蝠接口、字段和权限仍以本站接口参考为准。
实现依据 · 仓库内路径
lib/developer-docs/developer-official-references.ts
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。