音频类AudioManager接口使用中的7大坑

6520211

01

setRingerMode错误使用会使得与铃声相关音频全部被静音

问题描述：某些APP会调用该接口实现静音铃声播放或将手机切换为振铃模式的功能，用户在使用此类APP进行上述两种操作中任意一种后，会导致手机系统中所有与铃声相关音频都会被静音，用户接收不到铃声、手机提示音等，严重影响用户使用体验。

建议：非声音设置类型的应用不调用setRingerMode接口，交由手机系统控制。





02

setSpeakerphoneOn可能会导致语音和通话被强制从扬声器输出

问题描述：语音社交类APP为满足用户语音外放的需求，会调用此接口，但若未在播放结束后，将该接口参数设置为false，会导致之后语音和通话音频流会一直被强制从扬声器输出，影响用户使用其他APP。

建议：一旦APP调用了setSpeakerphoneOn(此时参数为true)，

在播放音频流结束后，需要设置setSpeakerphoneOn参数为false，把音频通路还原。





03

setStreamMute这个接口即将废除，建议使用其他接口

问题描述：该接口会使得用户在使用APP时，静音了某个音频流后，手机中已安装的其他APP，其相应类型的音频流都会被设置为静音。

建议：setStreamMute接口即将被废除，建议开发者使用相应音频实例对应的调节音量参数来实现静音APP自身播放的音频流的功能，例如：AudioTrack实例中的setVolume；MediaPlayer实例中的setVolume；mPlayer.setVolume(0)。





04

setStreamVolume设置错误的音频流类型，会使用户无法正常调节手机音量

问题描述：在不同的使用场景，用户会有调节不同音频流音量的需求，APP可以调用接口setStreamVolume（int streamType, int index, int flags）来满足这一需求，但往往开发者并没有将streamType参数与当前场景正在播放的音频流类型设置一致，并且该接口可以截获系统的音量按键，导致用户使用APP时，按音量键调节音量后，当前的声音音量大小却没有变化。

建议：

（1）当前vivo手机系统已经可以实现智能识别用户调节音量的场景，并且精准定位用户需要调节的音频流类型，因此建议音量按键交由手机系统来控制。

（2）如若开发者需要调节特定音量，要使用setStreamVolume接口，请设置好符合用户需求场景的正确音频流类型。





05

如若错误使用setMode，会导致音频输出到错误的设备上

问题描述：当前很多APP（常见于社交类）使用这个接口来设置手机通话模式，改变手机声音的输出设备。用户在使用APP时，使用“语音通话模式”（AudioManager.MODE_IN_COMMUNICATION）后，手机会默认从听筒输出音频，导致用户听不见手机提示音、来电铃声等音频。

建议：开发过程中，需要注意在播放音频流结束后,调用接口setMode (AudioManager. MODE_NORMAL)，把手机模式还原为正常模式。





06

setBluetoothScoOn使用不当，会导致蓝牙无声音输出

问题描述：当用户需要声音从蓝牙输出时，某些APP会使用蓝牙Sco-link通路来传送语音数据到蓝牙耳机。如果开发者没有使用startBluetoothSco成功建立 sco-link连接通路后就直接调用setBluetoothScoOn（true

），会使得蓝牙耳机无声音输出。

建议：开发者应使用startBluetoothSco和stopBluetoothSco接口来建立/断开sco-link连接通路，在建立sco-link连接后，有场景需要将音频从蓝牙切换到手机上时候，调用setBluetoothScoOn（false），再次将音频切换回蓝牙播放时，使用setBluetoothScoOn（true）。







07

setMicrophoneMute没有配对使用，可能导致手机录音或语音发送功能失效

问题描述：某些社交/直播类APP会调用该接口实现语音静音发送的功能，但有些开发者在APP退出的时候没有设置接口为unmute，导致后续其他APP使用手机麦克风录制出来的音频都是静音状态的，影响用户的使用。

建议：由于这个接口直接作用在手机的底层麦克风数据通路，影响范围很大，不建议使用这个接口来实现语音静音发送的需求。开发者可以通过将APP获取到的音频数据直接替换为值=0（静音）的方式，或采取把录制上来的数据直接丢弃不处理的方式来实现这种需求。