media.helper

类 AudioFocusHelper

java.lang.Object

media.helper.AudioFocusHelper

public class AudioFocusHelper
extends java.lang.Object

用于帮助处理应用程序的音频焦点的获取与丢失。

使用方法：

1. 创建一个 AudioFocusHelper 对象。需提供以下两个参数：
1. 一个 Context 对象；
2. 一个 AudioFocusHelper.OnAudioFocusChangeListener 对象，该接口中的回调方法会在当前应用程序的音频焦点丢失与获取时被调用。
2. 调用 requestAudioFocus(int, int) 方法请求音频焦点。
3. 调用 abandonAudioFocus() 方法放弃音频焦点。

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	AudioFocusHelper.OnAudioFocusChangeListener 可用于监听当前应用程序的音频焦点的获取与丢失。

构造器概要

构造器

构造器和说明
AudioFocusHelper(android.content.Context context, AudioFocusHelper.OnAudioFocusChangeListener listener) 创建一个 AudioFocusHelper 对象。

方法概要

限定符和类型	方法和说明
void	abandonAudioFocus() （主动）放弃音频焦点。
int	requestAudioFocus(int streamType, int durationHint) 获取音频焦点。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

AudioFocusHelper

public AudioFocusHelper(@NonNull
                        android.content.Context context,
                        @NonNull
                        AudioFocusHelper.OnAudioFocusChangeListener listener)

创建一个 AudioFocusHelper 对象。

参数:

context - Context 对象，不能为 null

listener - 事件监听器，不能为 null

方法详细资料

requestAudioFocus

public int requestAudioFocus(int streamType,
                             int durationHint)

获取音频焦点。

参数:

streamType - 受焦点请求影响的主要音频流类型。该参数通常是 AudioManager.STREAM_MUSIC。更多音频 流类型，请查看 AudioManager 类中前缀为 STREAM_ 的整形常量。

durationHint - 可以是以下 4 个值之一：

1. AudioManager.AUDIOFOCUS_GAIN：表示获取未知时长的音频焦点；
2. AudioManager.AUDIOFOCUS_GAIN_TRANSIENT：表示短暂的获取音频焦点；
3. AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK：表示短暂的获取音频焦点，同时指示先前的焦点所有者可以通过降低音量（duck），并继续播放；
4. AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE：（API level 19）：表示短暂获取音频焦点，在此期间，其他任何应用程序或系统组件均不应播放任何内容。

更多内容，请查看 AudioManager 文档。

返回:

AudioManager.AUDIOFOCUS_REQUEST_GRANTED（申请成功）或者 AudioManager.AUDIOFOCUS_REQUEST_FAILED（申请失败）

abandonAudioFocus

public void abandonAudioFocus()

（主动）放弃音频焦点。