安卓手机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应该连接它的音量控制到如下表的播放器中的合适的方法：

播放器的使用方法列表

播放器	使用方法
AudioTrack	AudioTrack.setVolume()
MediaPlayer	MediaPlayer.setVolume()
ExoPlayer	SimpleExoPlayer.setVolume()

不要很大声的噪音

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

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

用户通常期望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)
    }
}