WebRTC Android 端 + iOS-Android 跨平台音频通话实战
内容提要
本文介绍用Claude Code开发Android WebRTC封装，实现iOS与Android跨平台1v1通话。重点解决Android端Camera2采集、前后摄切换、EGL上下文、权限及ProGuard等差异，提供Gradle配置、WebRTC客户端、信令协议对齐及完整通话流程，并列出跨平台互通检查清单与性能指标。
延伸解读
Android 与 iOS 的 WebRTC 差异是跨平台互通的关键
文章指出，Android 端 WebRTC 在摄像头采集、前后摄切换、音频管理、权限请求、EGL 上下文和 ProGuard 混淆等方面与 iOS 存在显著差异。这些差异是跨平台互通的主要障碍，开发者需要针对 Android 平台特性进行特殊处理，例如手动创建 EGL 上下文、动态请求权限、处理 Camera2 采集等。理解这些差异是成功实现跨平台通话的基础。
协议对齐是跨平台互通的必要条件
文章强调，要实现 iOS 与 Android 之间的互通，必须确保 SDP 语义、视频编码、音频编码、ICE 策略和信令协议等关键参数在两端保持一致。例如，SDP 语义统一为 Unified Plan，视频编码统一为 H.264 High Profile，音频编码默认 Opus，ICE 策略统一为 GATHER_ONCE。这些对齐项是跨平台通话能否成功的关键，开发者应仔细核对。
AI 辅助开发需注意审查与修正
文章展示了使用 Claude Code 生成 Android WebRTC 封装的过程，并记录了 AI 输出中存在的问题及修正，如未创建 EglBase、setRemoteDescription 未等待回调、SDP 语义不一致、前置摄像头未镜像等。这表明 AI 辅助开发虽然高效，但开发者仍需具备扎实的音视频知识，对 AI 生成的代码进行仔细审查和修正，以确保正确性和稳定性。
性能指标为跨平台通话提供参考基准
文章提供了跨平台通话的性能指标，如 iOS ↔ Android 首帧时间 1.2-2.0s，ICE 连接时间 0.8-2s，音频延迟 100-180ms，视频码率 1.5-2.5 Mbps。这些数据可作为开发者评估自身实现性能的参考基准，但实际效果可能因网络环境、设备性能等因素而有所差异，开发者应结合具体场景进行优化。
Q&A
Android WebRTC 与 iOS 在摄像头采集和前后摄切换上有什么主要差异？
iOS 使用 RTCCameraVideoCapturer 封装好的采集器，切换前后摄只需改变 camera.position；Android 需要自己处理 Camera2 API 或使用 CameraX，切换前后摄时需重新创建 captureSession。
Android WebRTC 中为什么需要手动创建 EGL 上下文？
因为 Android 的硬件编码（MediaCodec）依赖 EGL 上下文，而 iOS 是自动管理的。在 Android 上必须手动创建 EglBase 并传入 PeerConnectionFactory 和渲染器，否则会导致硬编无法工作或崩溃。
Android WebRTC 中如何实现前后摄像头切换？
通过调用 CameraVideoCapturer 的 switchCamera 方法，传入 null 表示自动切换前后摄。但需要注意，切换后可能需要重新创建 captureSession，具体实现取决于使用的采集器。
Android WebRTC 中如何设置音频为通信模式并切换扬声器？
通过 AudioManager 设置 mode 为 MODE_IN_COMMUNICATION，然后设置 isSpeakerphoneOn 为 true 或 false 来控制扬声器。
Android WebRTC 中如何请求摄像头和录音权限？
需要在运行时动态请求 CAMERA 和 RECORD_AUDIO 权限，因为 Android 6.0 以上需要动态权限请求，而 iOS 只需在 Info.plist 中声明。
Android WebRTC 中如何配置 ProGuard 以避免混淆问题？
需要在 ProGuard 规则中保留 WebRTC 的 JNI 类，因为 WebRTC 有大量 JNI 类不能被混淆，否则会导致运行时错误。
Android WebRTC 中如何实现跨平台信令协议对齐？
需要确保 SDP 语义统一为 Unified Plan，视频编码统一为 H.264 High Profile，音频编码默认 Opus，ICE 策略统一为 GATHER_ONCE，并且信令协议字段名对齐，如 offer/answer/candidate 消息的 JSON 结构一致。
Android WebRTC 中如何创建 PeerConnection 并设置 SDP 语义？
创建 PeerConnection 时，在 RTCConfiguration 中设置 sdpSemantics 为 UNIFIED_PLAN，并设置 continualGatheringPolicy 为 GATHER_ONCE，然后通过 factory.createPeerConnection 创建。
Android WebRTC 中如何实现本地视频渲染并设置镜像？
使用 SurfaceViewRenderer，先调用 init 方法传入 EGL 上下文，然后调用 setMirror(true) 实现前置摄像头镜像，最后将本地视频轨道 addSink 到渲染器。
Android WebRTC 中如何实现摄像头采集并启动？
首先创建 CameraVideoCapturer（使用 Camera2Enumerator），然后调用 initialize 方法传入 SurfaceTextureHelper 和 CapturerObserver，最后调用 startCapture 指定分辨率、帧率。
