| 方法 | 描述 |
|---|---|
| create | 创建 GameRTCEngine 实例。 GameRTCEngine 实例成功创建后,你才可以使用 SDK 提供的其他能力。 |
| destroy | 销毁由 create 所创建引擎实例,并释放所有相关资源。 |
| getSdkVersion | 获取 SDK 当前的版本号。 |
| setRtcNativeLibraryLoader | 设置 native library 加载器,需要在其他所有静态方法调用之前被调用。 |
| 方法 | 描述 |
|---|---|
| joinRoom | 加入实时语音房间 在使用实时语音的通话功能时,必须先加入实时语音房间。 调用该方法后,会收到 onJoinRoomResult 回调通知。 |
| leaveRoom | 离开房间。 用户调用此方法离开房间,结束通话过程,释放所有通话相关的资源。 调用 joinRoom 方法加入房间后,在通话结束时必须调用此方法结束通话,并收到 onLeaveRoom 回调确认结束通话,否则无法开始下一次通话。 无论当前是否在房间中,都可以调用此方法。重复调用此方法不会有负面影响。 |
| updateToken | 更新进房 token。 在进房时如果收到错误码为 JOIN_ROOM_INVALID_TOKEN 的 onJoinRoomResult 回调,表示 token 过期导致进房失败。 此时,你应调用本接口,以新 token 进房。 |
| 方法 | 描述 |
|---|---|
| enableMicrophone | 控制本地音频采集和发布状态。 改变该状态后,房间内其他用户会收到 onMicrophoneEnabled 回调。 |
| enableAudioSend | 控制本地语音的发送状态:发送/不发送。 使用此方法后,房间中的其他用户会收到 onAudioSendEnabled 回调。 |
| enableSpeakerphone | 设置对来自远端的语音的接收状态。 使用此方法后,房间中的其他用户会收到 onSpeakerphoneEnabled 回调。 |
| enableAudioReceive | 设置对来自指定远端用户的语音的接收状态 |
| setRecordingVolume | 调节音频采集音量。 |
| setPlaybackVolume | 调节本地播放的所有远端用户混音后的音量。 |
| setRemoteAudioPlaybackVolume | 调节来自指定远端用户的音频播放音量 |
| setAudioScenario | 设置音频场景类型 |
| 方法 | 描述 |
|---|---|
| updateReceiveRange | 在世界房间中,使用范围语音功能时,设定语音的接收范围和衰减信息。 |
| updatePosition | 使用范围语音功能时,设置玩家的坐标。 |
| 方法 | 描述 |
|---|---|
| updateOrientation | 在使用空间语音功能时,必须通过此接口传入玩家的方位,sdk 内部会根据玩家坐标和方位实现空间效果 |
| 回调 | 描述 |
|---|---|
| onJoinRoomResult | 用户首次成功加入房间/重连进房后,收到此回调。此回调事件在用户调用 joinRoom 方法加入房间到用户调用 leaveRoom 方法离开房间期间可能回调多次。 |
| onLeaveRoom | 离开房间成功回调。 用户调用 leaveRoom 方法后,SDK 会停止所有的发布订阅流,并释放所有通话相关的音视频资源。SDK 完成所有的资源释放后通过此回调通知用户。 |
| onUserJoined | 远端用户加入房间回调。 以下情形下,本地用户会收到此回调: + 远端用户首次加入房间/重连加入房间; + 本地用户加入房间时,会收到回调,提示已在房间中的远端用户。 |
| onUserLeave | 远端用户离开房间回调。 房间中有用户主动调用 leaveRoom 方法离开房间或断线超时离开房间时,房间中其他用户都会收到此回调。 |
| 回调 | 描述 |
|---|---|
| onMicrophoneEnabled | 远端用户开关麦克风回调。 当用户调用 enableMicrophone 更改本地音频采集和发布状态时,房间内其他用户会收到此回调。 |
| onAudioSendEnabled | 远端用户启停音频数据发送的回调。 当用户调用 enableAudioSend 更改本地音频发送状态时,房间内其他用户会收到此回调。 |
| onSpeakerphoneEnabled | 远端用户启停音频数据接收的回调。 当用户调用 enableSpeakerphone 更改远端音频接收状态时,房间内其他用户会收到此回调。 |
| onAudioVolumeIndication | 提示本地采集的音量信息和在房间内订阅的远端用户的音量信息。 |
| 回调 | 描述 |
|---|---|
| onConnectionStateChanged | 用户与 RTC 服务器连接状态发生改变时,收到此回调。 |
| onNetworkQuality | 通话中用户的媒体流网络上下行质量报告回调。加入房间成功后,每隔 2 秒会触发此回调,通知房间内用户与媒体服务器之间数据交互的网络质量。 |
| onLogReport | 上报日志时回调该事件。 |
| 回调 | 描述 |
|---|---|
| onEngineWarning | SDK 运行时出现了引擎相关的警告时,收到此回调。 |
| 回调 | 描述 |
|---|---|
| onRoomWarning | SDK 运行时,出现房间相关警告,收到此回调。 |
| 回调 | 描述 |
|---|---|
| onRoomError | 房间相关错误回调。 |