WebRTC Android 端 + iOS-Android 跨平台音频通话实战
内容提要
本文介绍用Claude Code开发Android WebRTC封装，实现iOS与Android 1v1通话。内容涵盖Android端摄像头采集、权限、EGL等特殊处理，提供WebRTC客户端、信令客户端及完整通话流程代码，并列出跨平台协议对齐清单，确保双端互通。
延伸解读
Android 端 WebRTC 的独特挑战
与 iOS 相比，Android 端 WebRTC 开发需要额外处理摄像头采集（Camera2/CameraX）、前后摄切换、音频模式管理、运行时权限请求、EGL 上下文创建以及 ProGuard 混淆规则等。这些差异要求开发者对 Android 系统有更深入的了解，并针对性地进行适配。
跨平台互通的关键：协议对齐
实现 iOS 与 Android 互通，必须确保 SDP 语义（Unified Plan）、视频编码（H.264 High Profile）、音频编码（Opus）、ICE 策略（GATHER_ONCE）以及信令协议（JSON over WebSocket）等关键参数完全一致。任何一项不一致都可能导致通话失败或质量下降。
AI 辅助开发的审查价值
使用 Claude Code 生成代码时，AI 可能会遗漏 Android 特有的细节，如 EGL 上下文初始化、setRemoteDescription 异步回调处理、前置摄像头镜像等。通过人工审查和测试，可以及时发现并修正这些问题，确保代码的健壮性和跨平台兼容性。
Q&A
Android WebRTC 开发中，摄像头采集和前后摄切换与 iOS 有什么不同？
Android 需要自己处理 Camera2 API 或 CameraX 进行采集，而 iOS 使用 RTCCameraVideoCapturer 封装好的。前后摄切换时，Android 的 Camera2 需要重新创建 captureSession，而 iOS 只需切换 capturer.camera.position。
在 Android WebRTC 中，为什么需要手动创建 EGL 上下文？
因为 Android 的 WebRTC 硬编解码依赖 EGL 上下文，而 iOS 是自动管理的。在 Android 中，需要手动创建 EglBase 并传入 PeerConnectionFactory 和渲染器，否则可能导致崩溃或无法硬编。
Android WebRTC 中如何实现前后摄像头切换？
在 WebRTCClient 中，通过调用 videoCapturer?.switchCamera(null) 实现自动切换前后摄像头。该方法是 CameraVideoCapturer 提供的，传入 null 表示自动切换。
Android WebRTC 中如何设置音频输出为扬声器？
通过 AudioManager 设置：将 mode 设为 MODE_IN_COMMUNICATION，并将 isSpeakerphoneOn 设为 true。代码示例：audioManager.mode = AudioManager.MODE_IN_COMMUNICATION; audioManager.isSpeakerphoneOn = enabled;
iOS 和 Android 跨平台 WebRTC 通话时，SDP 语义需要如何对齐？
双端必须使用相同的 SDP 语义，即 Unified Plan。iOS 默认使用 Unified Plan，Android 需要在 RTCConfiguration 中显式设置 sdpSemantics = PeerConnection.SdpSemantics.UNIFIED_PLAN。
Android WebRTC 中，信令客户端如何与 iOS 端协议对齐？
信令协议使用 JSON over WebSocket，消息类型包括 offer、answer、candidate，字段名如 sdp、sdpMLineIndex、sdpMid 必须与 iOS 端一一对应。Android 端使用 OkHttp WebSocket 实现，并定义了 SignalingEvent 来处理这些消息。
Android WebRTC 中，为什么需要设置 setMirror(true)？
对于前置摄像头，本地预览需要镜像显示，以符合用户习惯。在 attachLocalVideo 中，对本地视频渲染器调用 view.setMirror(true) 实现镜像；远端视频则不需要镜像，设为 false。
Android WebRTC 中，如何解决 setRemoteDescription 异步回调的问题？
生产环境应通过 CountDownLatch 或协程等待 onSetSuccess 回调，而不是像示例中那样直接 resume。示例代码中简化处理，但注释指出应使用回调或 CountDownLatch 等待。
