打断事件处理
1 简介
使用 ZegoLiveRoom SDK 直播过程中,可能会被来电、切后台等事件打断,此时开发者需要处理打断事件。
SDK 提供了与音频打断事件相关的API,如下所示:
/**
* 暂停设备模块。
* 用于需要暂停指定模块的场合,例如来电时暂定音频模块;
* 暂停指定模块后,注意在合适时机下恢复模块
*
* @param moduleType 设备类型, 参考 {@link ZegoConstants.ModuleType} 定义
*
* @see #resumeModule(int)
*/
public void pauseModule(int moduleType);
/**
* 恢复设备模块。
* 用于需要恢复指定模块的场合,例如来电结束后恢复音频模块。
*
* @param moduleType 设备类型, 参考 {@link ZegoConstants.ModuleType} 定义
*
* @see #pauseModule(int)
*/
public void resumeModule(int moduleType);
请注意,目前 moduleType 仅支持音频采集、播放设备,如果开发者想暂停视频,可直接调用停止推流、停止拉流接口,详见:初级功能指南-推流、初级功能指南-拉流
本文以来电为例,讲述如何处理打断事件。
2 来电
2.1 监听来电事件
开发者需要在合适的位置,注册来电监听事件,一般在发起音频通话页面的 onCreate(Bundle) 方法中(但不仅限于这种方式)。
示例代码片段如下:
/**
* 电话状态监听.
*/
private void regisgerPhoneCallingListener() {
mPhoneStateListener = new ZegoPhoneStateListener();
TelephonyManager tm = (TelephonyManager) getSystemService(Service.TELEPHONY_SERVICE);
tm.listen(mPhoneStateListener, PhoneStateListener.LISTEN_CALL_STATE);
}
2.2 处理音频打断
音频打断处理一般有两个步骤:
音频打断发生时,暂停音频设备。
音频打断恢复后,恢复音频设备。
示例代码片段如下:
private class ZegoPhoneStateListener extends PhoneStateListener {
@Override
public void onCallStateChanged(int state, String incomingNumber) {
super.onCallStateChanged(state, incomingNumber);
switch (state) {
case TelephonyManager.CALL_STATE_IDLE:
if (mHostHasBeenCalled) {
mHostHasBeenCalled = false;
recordLog(MY_SELF + ": call state idle");
// 结束通话,恢复音频模块
mZegoLiveRoom.resumeModule(ZegoConstants.ModuleType.AUDIO);
}
break;
case TelephonyManager.CALL_STATE_RINGING:
recordLog(MY_SELF + ": call state ringing");
mHostHasBeenCalled = true;
// 来电,暂停音频模块
mZegoLiveRoom.pauseModule(ZegoConstants.ModuleType.AUDIO);
break;
case TelephonyManager.CALL_STATE_OFFHOOK:
break;
}
}
}
2.3 移除来电事件监听
开发者在注册了来电监听事件后,切不要忘记在不需要的时候,把监听事件从系统中移除,否则会造成内存泄漏甚至引起未知错误。一般在发起音频通话页面的 onDestroy() 方法中(但不仅限于这种方式)。
/**
* 注销电话状态监听.
*/
private void unregisgerPhoneCallingListener() {
TelephonyManager tm = (TelephonyManager) getSystemService(Service.TELEPHONY_SERVICE);
tm.listen(mPhoneStateListener, PhoneStateListener.LISTEN_NONE);
mPhoneStateListener = null;
}
3 其它打断处理
除了上述来电打断事件外,开发者还需要考虑其它的打断事件,如微信语音通话等,此时开发者需要根据具体情况注册相应的系统监听/广播或者第三方应用的广播事件,以便在合适的时机暂停音频模块或恢复音频模块。因 Android 上此类事件较多,除了系统标准事件外,还有很多第三方 App 自定义的广播,无法一一描述处理方法,故请开发者结合自己 App 的特性,处理相应打断事件。
由于目前 SDK 仅支持暂停/恢复音频设备,如果开发者想暂停视频,需直接调用停止推流、停止拉流接口,详见:初级功能指南-推流、初级功能指南-拉流