uni-app无法直接用h5+webrtc实现语音通话，因ios safari不支持音频采集、android需https+手势触发且缺乏回声消除，声网web sdk在ios上静音率高、延迟超5s；可靠方案是app端用原生插件接入agora sdk，h5端降级为文字提示。
uni-app 本身不支持原生语音通话能力，必须通过原生插件桥接声网 Agora SDK；直接用 uni-app 的 WebRTC 或 webSocket 模拟无法满足低延迟、高稳定性要求，真机上基本不可用。
为什么不能直接用 H5 + WebRTC 实现语音通话
uni-app 的 H5 端受限于浏览器策略：iOS Safari 不支持 getUserMedia 音频采集（仅部分支持视频），Android Chrome 虽支持但需 HTTPS + 用户手势触发，且无回声消除、降噪等关键处理；声网的 AgoraRTC Web SDK 在 H5 端虽可跑通基础流程，但 iOS 上静音率高、偶发崩溃，onUserPublished 延迟常超 5s，不适合生产环境语音通话。
真正可用的路径只有一条：App 端走原生 SDK，H5 端降级为文字/通知提示（或完全不启用语音功能）。
App 端接入 Agora SDK 的核心步骤（以 uni-app 3.0+ App 平台为例）
必须使用 uni-app 的「原生插件」机制，而非 npm 包或 JS SDK。官方插件市场已有审核通过的 Agora 插件（如 uni-app-agora），但更推荐自己封装以控制版本和权限。
- 在
nativePlugins目录下新建插件文件夹，按规范组织android和ios子目录 - Android 端引入
io.agora:agora-rtc-ng-sdk:4.4.0（注意用-ng新版 SDK，旧版agora-rtc-sdk已废弃）；iOS 端用CocoaPods引入AgoraRtcNgEngine（4.4.0+） - Android 必须在
AndroidManifest.xml中声明麦克风、网络权限：android.permission.RECORD_AUDIO、android.permission.INTERNET；iOS 需在Info.plist添加NSMicrophoneUsageDescription - 插件 JS 层调用统一入口，例如暴露
initAgora、joinChannel、leaveChannel、muteLocalAudio等方法，参数透传到原生层，避免在 JS 层做状态管理
常见报错与绕过方式
真机调试时最常遇到三类问题：
-
java.lang.UnsatisfiedLinkError: dlopen failed: library "libagora-rtc-sdk.so" not found：说明 so 库未正确打包进 APK，检查build.gradle中是否遗漏abiFilters 'arm64-v8a', 'armeabi-v7a'，uni-app 默认只打arm64-v8a，但部分低端 Android 设备仍需armeabi-v7a - iOS 上
RTC join channel failed with code -102：多因证书配置错误，确认App ID和App Certificate是否匹配，且enableLogUpload设为false（否则会因无网络权限失败） - 加入频道后听不到对方声音：先检查
setEnableSpeakerphone(true)是否调用，再确认远端用户是否已成功发布音频流（用onUserPublished回调判断，而非仅靠onJoinChannelSuccess）
uni-app 中如何安全调用原生语音方法
不要在页面 onLoad 就调用 joinChannel，必须等 onReady 后且用户明确点击“开始通话”按钮再触发；所有 Agora 方法调用前加防重逻辑，例如用 isInChannel 标记位防止重复进房。
示例片段（JS 层）：
const agora = uni.requireNativePlugin('AgoraPlugin');
agora.initAgora({
appId: 'YOUR_APP_ID',
channelProfile: 1 // 1=communication, 2=liveBroadcasting
}, () => {
console.log('Agora init success');
});
// 用户点击按钮后
function startCall() {
if (this.isInChannel) return;
agora.joinChannel({
token: '006xxx',
channelId: 'room123',
uid: 12345
}, () => {
this.isInChannel = true;
});
}
注意：token 必须服务端动态生成，前端硬编码 tempToken 仅用于测试，上线必须废弃。
最关键的细节是——Agora 的 uid 必须全局唯一且稳定，不要用时间戳或随机数；多人通话时若两个用户 uid 冲突，后进者会把前者踢出，且无明确错误提示，排查极其困难。
