打断事件处理

---

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 处理音频打断

音频打断处理一般有两个步骤：

1. 音频打断发生时，暂停音频设备。
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 仅支持暂停/恢复音频设备，如果开发者想暂停视频，需直接调用停止推流、停止拉流接口，详见：快速集成-推流、快速集成-拉流