uni-app 接入腾讯云音视频通话不能用纯H5方式，小程序端需TUICallKit插件，App端必须用原生插件+自定义调试基座；TRTC Web SDK因iOS/Android WebView限制无法在H5运行。
直接上结论：uni-app 接入腾讯云音视频通话，**不能用纯 H5 方式跑通 TRTC 核心功能**，必须走原生插件路径；小程序端可直接用 TUICallKit 或 TRTC SDK 插件，App 端则必须制作自定义调试基座，否则 enterRoom、startLocalPreview 等关键 API 会静默失败或报 undefined 错误。
为什么 uni-app 不能直接 npm install trtc-js-sdk？
因为 TRTC 官方 Web SDK（trtc-js-sdk-v4）依赖 WebRTC 原生能力，在 uni-app 的 WebView/H5 环境中受限严重：iOS WKWebView 不支持 getUserMedia（尤其 iOS 16.4+ 后更严格），Android 微信 X5 内核直接禁用摄像头权限请求。即使强行调用，createLocalVideoTrack 会返回空 track，publish 报错 permission_denied 或卡在 device_not_found。
所以实际可行路径只有两条：
- 小程序端：用腾讯云官方
TUICallKit小程序插件（要求基础库 ≥ 2.10.0） - App 端：必须使用
TencentCloud-TUICallKit原生插件 + 自定义调试基座（HBuilderX 打包）
App 端接入 TUICallKit 必须做的三件事
缺一不可，漏掉任意一项都会导致 login 成功但 call 无响应、onCallEvent 不触发、或进房后黑屏无声。
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
-
在
App.vue中注册插件：必须用uni.requireNativePlugin('TencentCloud-TUICallKit')，且必须赋值给uni.$TUICallKit（命名固定，改名就失效） -
配置
manifest.json → App 模块权限：勾选「录音」、「相机」、「后台运行」，Android 还需在nativeResources/android/AndroidManifest.xml补充android.permission.FOREGROUND_SERVICE - 制作自定义调试基座：HBuilderX → 运行 → 运行到手机或模拟器 → 制作自定义调试基座；注意 Android 包名必须和插件购买时绑定的包名一致，iOS 需开启「Camera & Microphone」权限并使用云端证书
小程序端调用 call 时常见黑屏/无声问题
现象是 UI 正常、onCallEvent 有日志，但对方看不到画面、听不到声音——本质是小程序生命周期与 TRTC 渲染上下文不匹配。
- 确保
video组件使用cover-view+cover-image包裹（不能用普通view），且id与trtcCloud.startLocalPreview({ view: 'local-video' })中的view值完全一致 - 不要在
onLoad里立即call，等onShow触发后再执行；小程序冷启动时onLoad阶段 canvas 上下文可能未就绪 - 检查
userSig有效期：过期会导致enterRoom返回ERR_INVALID_USERSIG(60004)，但插件默认不抛错，需监听onError事件捕获
SDKAppID 和 SecretKey 怎么配才不踩坑
这两个参数不是填进代码就完事。它们决定签名生成逻辑和权限范围，错一个字符都会导致 login 失败且错误码模糊（常见 ERR_INVALID_SDKAPPID(60001) 或静默失败）。
-
SDKAppID是数字，不是字符串：传123456789，别写成"123456789"（TUICallKit.login内部校验为 number 类型） -
SecretKey必须和控制台开通应用时生成的密钥完全一致（区分大小写、含特殊字符），建议从控制台复制后粘贴进debug/GenerateTestUserSig.js，不要手动输入 - 开发阶段用
genTestUserSig工具生成userSig，上线前必须切换为服务端生成（避免密钥泄露）
最易被忽略的一点：TUICallKit 的 call 方法默认走语音通话，如果要发起视频通话，必须显式传 callType: 'video' 参数，否则即使双方都开了摄像头，对方看到的仍是音频通话界面——这个参数没有默认值，不传就是 audio。
