Audio in Video Call(Android_M)

相关：

• InCallScreen中CallButton界面更新介绍(audioButton等)
• Android L上VideoCall中Audio的管理
• Android M上VideoCall中Audio的管理
• CallAudioManager是如何工作的

在前一篇中我简单介绍了在Android L 版本中Video Call中audio切换的一些信息，本篇以QCOM Release的Android M版本为基础看一下6.0上的Video Call中的audio相关变化。

文件变化

比较明显的变化是 M上InCallUI中新增了一个类InCallAudioManager.java，见名知意，这是一个专门管理通话中Audio状态的类。 先看一下这个类里有那些方法：

图1: 文件结构 从方法名上可以大致看出这是一个管理call在 upgrade、modify和merge时候去开启扬声器或听筒的类。 先声明一点，enableSpeaekr()和enableEarpiece()两个方法不是被调用了就一定会产生AudioMode的变化，具体的判断条件我们放到最后再讲。

我们先看一下两个方法的调用层级：

enableSpeaker() 的调用层级

图2： enableSpeaker()方法调用层级 上面这张图可解释为3个打开Speaker的场景：

1. 当点击合并通话时；
2. 当接受升级为视频电话是；
3. 当更改通话类型时。

其中第1种：当合并的两路通话中有一路是视频电话时打开Speaker：

    /**
     * Called when user clicks on merge calls from the UI. Route audio to speaker if one of the
     * calls being merged is a video call.
     */
    public void onMergeClicked() {
        Log.v(this, "onMergeClicked");
 
        if (CallUtils.isVideoCall(CallList.getInstance().getBackgroundCall()) ||
                CallUtils.isVideoCall(CallList.getInstance().getActiveCall())) {
            enableSpeaker();
        }
    }
 

ModifyCall有两种情况，我们放到下面跟enableEarpiece一起说。

enableEarpiece()的调用层级

图3: enableEarpiece()方法调用层级 可以看到打开听筒的唯一调用地方是ModifyCall，ModifyCallClicked()方法代码如下：

    /**
     * Called when user sends an upgrade/downgrade request. Route audio to speaker if the user
     * sends an upgrade request to Video (bidirectional, transmit or receive) otherwise route
     * audio to earpiece if it's a downgrade request.
     */
    public void onModifyCallClicked(final Call call,final int newVideoState) {
        Log.v(this, "onModifyCallClicked: Call = " + call + "new video state = " +
                newVideoState);
 
        if (!VideoProfile.isVideo(newVideoState)) {
            enableEarpiece();
        } else if (canEnableSpeaker(call.getVideoState(),newVideoState)) {
            enableSpeaker();
        }
    }
 

可解释为：升级为视频电话时打开Speaker，降级时打开Earpiece。

实际AudioMode是否变换？

前面我们说过及时调用了这两个方法也不会一定产生AudioMode的变化，enableSpeaker()方法前的注释里已经写得很清楚了。 当现在蓝牙和有线耳机没有连接，且当前audio不是通过Speaker传送的话，打开Speaker。听筒同理。 （我觉得QtiCallUtils.isEnabled()方法有点意思，可以打开看看）

    /**
     * Routes the call to the speaker if audio is not being already routed to Speaker and if
     * bluetooth or wired headset is not connected.
     */
    private static void enableSpeaker() {
        final TelecomAdapter telecomAdapter = TelecomAdapter.getInstance();
        if (telecomAdapter == null) {
            Log.e(LOG_TAG, "enableSpeaker: TelecomAdapter is null");
            return;
        }
 
        final int currentAudioMode = AudioModeProvider.getInstance().getAudioMode();
        Log.v(LOG_TAG, "enableSpeaker: Current audio mode is - " + currentAudioMode);
 
        if(!QtiCallUtils.isEnabled(CallAudioState.ROUTE_SPEAKER |
                CallAudioState.ROUTE_BLUETOOTH | CallAudioState.ROUTE_WIRED_HEADSET,
                currentAudioMode)) {
            Log.v(LOG_TAG, "enableSpeaker: Set audio route to speaker");
            telecomAdapter.setAudioRoute(CallAudioState.ROUTE_SPEAKER);
        }
    }

---

补充

到这就完了么？上面我们从代码中推出了一些场景以及实现，那么在实际使用中以现有的代码能满足用户需要么？ 这个问题先留在这，等后面如果项目上有报相关的bug的时候我再来更新。

1. 视频电话降级为语音电话关闭Speaker 这个我在前一篇博客中写到过，不过依现在M上的代码来看，只有发起降级的一端会关闭Speaker，接收端的AudioMode貌似不会更改。不过这种现象也可以理解，对方没有准备的情况下，扬声器突然关掉了的话，而假如用户又没有意识到的话，会听不到通话另一方的声音的。

---

2016.05.27 更新

看图 上图中可以看出，在正在拨号的界面Speaker的状态就已经是打开的了，而从上面的分析中却没有代码执行对应的动作，那么这个Speaker是在什么地方打开的呢？ CallsManager.java

    /**
     * Checks to see if the call should be on speakerphone and if so, set it.
     */
    private void maybeMoveToSpeakerPhone(Call call) {
        if (call.getStartWithSpeakerphoneOn()) {
            setAudioRoute(CallAudioState.ROUTE_SPEAKER);//打开Speaker
            call.setStartWithSpeakerphoneOn(false);
        }
    }

    private void maybeMoveToEarpiece(Call call) {
        if (!call.getStartWithSpeakerphoneOn() && !mWiredHeadsetManager.isPluggedIn() &&
                !mCallAudioManager.isBluetoothDeviceAvailable()) {
            setAudioRoute(CallAudioState.ROUTE_EARPIECE);//打开听筒
        }
    }

调用层级： 上面的代码解释了，在拨号界面Speaer就打开的原因。 在CallsManager.java中新增了多个方法，上面只是其中一部分，实现的功能也是控制Speaker和Earpiece的开关，里面用的值是在哪里设置的呢？

 /**
     * Attempts to issue/connect the specified call.
     *
     * @param handle Handle to connect the call with.
     * @param gatewayInfo Optional gateway information that can be used to route the call to the
     *        actual dialed handle via a gateway provider. May be null.
     * @param speakerphoneOn Whether or not to turn the speakerphone on once the call connects.
     * @param videoState The desired video state for the outgoing call.
     */
    void placeOutgoingCall(Call call, Uri handle, GatewayInfo gatewayInfo, boolean speakerphoneOn,
            int videoState) {
//...
        // Auto-enable speakerphone if the originating intent specified to do so, or if the call
        // is a video call or if the phone is docked.
        call.setStartWithSpeakerphoneOn(speakerphoneOn || isSpeakerphoneAutoEnabled(videoState)
                || mDockManager.isDocked());
        call.setVideoState(videoState);
//...
}

可以看到在placeOutgoingCall()中增加的这段代码自动打开了speakerphone 。

总结

回顾以前的代码，加上今天更新的内容，可以得到一个信息：在Android M上，通话中AudioRoute的控制，在InCallUI部分全新改写，跟enterVideoMode()和exitVideoMode()两个方法没有直接关系。同时不止存在于InCallUI层，Telecomm的CallsManager也牵扯进来了。