SDKsAndroid
音视频通话概览
了解 Android SDK 的音视频通话信令、房间信息和事件边界。
Android SDK 的 SignalingManager 提供发起邀请、接受、拒绝、取消、挂断、查询房间和同步通话状态所需的信令 API。它负责协调通话参与者、房间信息和通话生命周期，不负责采集摄像头画面、播放远端媒体流或渲染通话界面。
应用需要把 SDK 返回的 roomID、token 和 liveURL 交给所选的实时音视频媒体引擎，并自行处理 Android 权限、音视频设备、媒体轨道、弱网策略和界面状态。信令 API 不是一套完整的实时音视频媒体 SDK。
通话流程
- 调用
signalingInvite()发起单聊通话，或调用signalingInviteInGroup()发起群聊通话。 - 被邀请方从
onReceiveNewInvitation获取SignalingInfo，选择接受或拒绝。 - 接受方调用
signalingAccept()，双方使用返回的房间凭据接入媒体引擎。 - 通话过程中根据参与者、媒体流和自定义信令回调更新本地状态。
- 发起方可以取消尚未接通的邀请；任一通话参与者都可以挂断已经建立的通话。
核心数据
| 数据 | 说明 |
|---|---|
SignalingInvitationInfo | 邀请人、被邀请人、群组、房间、媒体类型、超时时间、会话类型和业务扩展数据。 |
SignalingInfo | 当前操作用户、原始邀请、参与者资料和可选的离线推送信息。 |
SignalingCertificate | OpenIMServer 返回的 roomID、token、liveURL 和忙线用户列表。 |
RoomCallingInfo | 按群组查询到的房间、邀请、参与者、群组和入会凭据快照。 |
customData 和自定义信令只适合传递业务协商信息。长期凭据、管理员密钥和其他敏感数据不应写入这些字段。
状态更新与事件归属
发起、接受、拒绝、取消和挂断等写操作需要分别处理 API 回调与通话 listener。API 成功回调表示当前信令请求已经完成；listener 反映邀请方、被邀请方、其他设备或房间参与者看到的增量状态，两者不是同一个完成信号。
邀请生命周期、参与者进出房间、挂断和媒体流变化的完整 listener 统一见处理通话事件；自定义信令见发送自定义信令。房间、凭据和待处理邀请查询只返回调用时的状态快照。
概览页不设置 listener。通话状态以 roomID 为主键；参与者状态还需要结合用户 ID。需要恢复或校准当前房间状态时，再调用对应查询 API。
按任务查找页面
这个页面有帮助吗？