Android 原生接入 RTC

原生 Android SDK 使用设备上的 WebRTC 采集和渲染。你的 Activity 负责布局、按钮和系统授权；SDK 负责房间、媒体和状态。先用 viewer 票据完成只看入会，再给需要发布的成员签发相应能力票据。

flowchart LR
    A["Activity 创建 SDK"] --> B["joinWithAccessTicket"]
    B --> C["onJoined / onError"]
    C --> D["远端轨道绑定 Renderer"]
    D --> E["leave → close"]

接入同批依赖

使用交付的 AAR 或源码 :sdk 模块，并保留该包声明的 WebRTC、OkHttp 与原生依赖。不要只复制 AAR 然后删除依赖，也不要同时引入另一套不同版本的 WebRTC 库。当前 SDK 最低 Android API 26；Manifest 与运行时都要提供实际使用的相机、麦克风权限。

若以交付 AAR 接入，Gradle 还需与本次 SDK 构建匹配的外部依赖；当前源码使用：

dependencies {
    implementation(files("libs/AKStreamRtcSDK.aar"))
    implementation("io.github.webrtc-sdk:android:144.7559.09")
    implementation("com.squareup.okhttp3:okhttp:5.3.0")
}

使用源码 :sdk 模块时由模块声明这些依赖。下一批交付若升级依赖版本，应以那批 AAR 的说明为准，不把本例当作永久固定版本。

SDK 创建方式：

TransformSurfaceViewRenderer localView = new TransformSurfaceViewRenderer(this);
AkNativeRtcClient client = new AkNativeRtcClient(this, localView, listener);
client.setInitialMediaEnabled(false, false);
client.joinWithAccessTicket(serverUrl, roomId, accessTicket, passcode);

这段代码位于 Activity，listener 是宿主实现的 AkNativeRtcClient.Listener，入会信息来自业务后端。调用返回只表示已发起入会；以 onJoined、onError、媒体状态回调判断结果。SDK 已初始化本地渲染器，宿主不要再次 init()。

最少处理 onJoined、onRemoteVideo、onRemoteVideoRemoved、onError 和 onLeft；界面状态还要处理 onLocalMediaState 与 onMediaPermissionChanged。这些回调可能不在 UI 线程，更新 Android 视图时切回主线程。先看到远端真实帧并听到远端声音，再测试本机发布。

画面、声音和生命周期

远端 onRemoteVideo(publicationId, VideoTrack) 到达时，为这一路建立渲染视图并绑定轨道；onRemoteVideoRemoved 只移除对应发布。切换麦克风、相机或输出设备时用 SDK 返回的真实设备 ID，最后以状态回调确定是否生效。

屏幕共享依赖系统 MediaProjection 授权和前台服务；宿主按 SDK 控制器要求转交 Activity 生命周期与授权结果。选择附件等外部 Activity 期间应保留会议状态。正常离会调用 leave()，最终销毁调用 close()，不能只移除页面上的 video 控件。

后台恢复时分别核对成员是否仍在线、本机发送帧和接收端解码帧。某些 Android 设备可能限制后台相机或麦克风；前台服务和悬浮小窗出现，不代表媒体一定持续发送。用第二台设备看画面和听声音，必要时记录采集/发送统计。

onContinuousRecordingChanged 通知录制状态，主持人可调用 startContinuousRecording(RoomCallback) 与 stopContinuousRecording(recordingId, RoomCallback)；普通成员用 getContinuousRecording(RoomCallback) 查询。SDK 只给出数据，录制和回放按钮由宿主实现。这些接口已进入 匹配目标版本 对应源码和发布包，安装旧 APK 不会自动具备。全部公开函数的入参、回调和特殊情况见Android 函数参考。

完整依赖版本、线程与系统授权细节以交付包内 Android SDK README 和实际 AAR 为准。上线前按端侧验收清单安装真机包验证。

如果 App 一直显示重连，先确认配置的服务器地址是手机可到达的 HTTPS 地址，而不是开发电脑自己的 127.0.0.1；再分别检查证书、房间票据、WebSocket 和媒体端口。安装被系统取消应先解决安装确认，不能把旧安装包的行为当作新 SDK 的结果。