安卓手机APP开发__媒体开发部分__处理在声音输出中的变化

安卓手机APP开发__媒体开发部分__处理在声音输出中的变化

目录

概述

使用音量控制

程序化地控制流的音量

在固定音量的设备上工作

不要很大声的噪音

概述

用户期望能够控制一个音频APP的音量大小。标准的行为包括
使用音量控制的能力（在设备上的按钮或者是用户界面上的滑动条）
还有如果当耳机断开连接时，要避免突然间的播放很大的声音。

使用音量控制

当一个用户在一个游戏或者是音乐APP中使用一个音量键时，音量应该被改变，
甚至当播放器在歌曲之间的暂停时，还有当前的游戏位置没有音乐时也是有效的。

安卓使用单独的声音流来播放音乐，报警，通知，打进来的电话的铃声，系统声音，
呼入的声音等。这允许用户来控制每个单独的声音流的音量。

默认情况下，进行音量控制改变的是当前的活动的声音流的音量。
如果你的APP当前没有播放任何内容，按了音量键，调整的是音乐的音量
（在安卓9之前是铃声的音量）。

如果你的APP不是一个闹钟的话，你应该播放声音，使用的是
AudioAttributes.USAGE_MEDIA.

为了确保音量控制调整的是正确的流，你应该调用setVolumeControlStream()
来传递流的类型，来匹配从AudioAttributes.getVolumeControlStream中检索
到的属性。

Kotlin

setVolumeControlStream(AudioManager.STREAM_MUSIC)

在你的APP的生命周期中，做这个调用,一般是从活动或者是片段的onResume()方法中调用,
进而来控制你的媒体。这连接着音乐流的音量控制。

程序化地控制流的音量

在很少的情况下，你能程序化地设置一个音频流的音量。例如，当你的APP替换了一个已存在的
用户界面。这是不被推荐的，因为安卓的音频管理器混合了同一类型的所有的音频流。
这些方法改变了每一个APP的音量。避免使用它们：

    adjustStreamVolume()
    adjustSuggestedStreamVolume()
    adjustVolume()
    setStreamVolume() setStreamVolume()
    setStreamSolo()
    setStreamMute()

在固定音量的设备上工作

一些设备有音量控制，但是不允许APP使用音频管理器的方法来修改一个音频流的等级。
这叫做固定音量的设备。你能发现你的APP是否运行在一个固定音量的设备上。使用的方法
是调用isVolumeFixed()。

一个音频APP应该提供与可能在同一个流上播放声音的其它的APP的输出的音量上的协调能力。
在固定音量的设备上，APP应该连接它的音量控制到如下表的播放器中的合适的方法：

不要很大声的噪音

当用户从他们的安卓设备上享受音乐时，用户有许多的选择。绝大多数的设备有一个内嵌的
扬声器，有线的耳机，还有蓝牙特性的设备。

当一个耳机被拔出或者是蓝牙设备断开时，音频流自动地被重路由到内嵌的扬声器上。
如果你听音乐的音量很高，这能产生很大的噪音。

用户通常期望APP包括一个音乐播放器，就是在屏幕上进行播放控制的那一种，在产生
很大噪音的情况下，能够自动地暂停播放。其它的APP，例如不包括音量控制的游戏，
应该保持播放。用户能使用设备的硬件控制来调整音量。

当音频输出从后端到内嵌的扬声器，系统广播一个ACTION_AUDIO_BECOMING_NOISY的通知。
当你播放音频时，你应该创建一个广播接收器来接收这个通知。你的接收器应该有如下的代码：

Kotlin

private class BecomingNoisyReceiver : BroadcastReceiver() {

    override fun onReceive(context: Context, intent: Intent) {
        if (intent.action == AudioManager.ACTION_AUDIO_BECOMING_NOISY) {
            // Pause the playback
        }
    }
}

当你开始播放时，注册你的接收器，当你停止时注销这个接收器。如果你设计你的APP
符合了这里的指导建议，这些调用应该出现在媒体会话回调方法 onPlay()和 onStop()中。

Kotlin

private val intentFilter = IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY)
private val myNoisyAudioStreamReceiver = BecomingNoisyReceiver()

private val callback = object : MediaSessionCompat.Callback() {

    override fun onPlay() {
        registerReceiver(myNoisyAudioStreamReceiver, intentFilter)
    }

    override fun onStop() {
        unregisterReceiver(myNoisyAudioStreamReceiver)
    }
}