public abstract class VolumeProvider
extends Object
java.lang.Object | |
↳ | android.media.VolumeProvider |
处理请求以调整或设置会话的音量。 这也用于将卷更新推回到会话。 每当提供的卷发生更改时,提供者都必须致电setCurrentVolume(int)
。
您可以通过调用 setPlaybackToRemote(VolumeProvider)
来设置会话的卷提供程序。
Constants |
|
---|---|
int |
VOLUME_CONTROL_ABSOLUTE 音量控制使用绝对值。 |
int |
VOLUME_CONTROL_FIXED 音量是固定的,不能修改。 |
int |
VOLUME_CONTROL_RELATIVE 音量控制通过 |
Public constructors |
|
---|---|
VolumeProvider(int volumeControl, int maxVolume, int currentVolume) 创建一个新的卷提供程序来处理卷事件。 |
Public methods |
|
---|---|
final int |
getCurrentVolume() 获取当前音量。 |
final int |
getMaxVolume() 获得该提供商允许的最大音量。 |
final int |
getVolumeControl() 获取此卷供应商使用的音量控制类型。 |
void |
onAdjustVolume(int direction) 重写以处理请求以调整当前输出的音量。 |
void |
onSetVolumeTo(int volume) 重写以处理请求以设置当前输出的音量。 |
final void |
setCurrentVolume(int currentVolume) 通知系统当前音量已更改。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
int VOLUME_CONTROL_ABSOLUTE
音量控制使用绝对值。 可以使用onAdjustVolume(int)
进行调整,也可以直接使用onSetVolumeTo(int)
设置。
常量值:2(0x00000002)
int VOLUME_CONTROL_FIXED
音量是固定的,不能修改。 应该忽略改变音量的请求。
常量值:0(0x00000000)
int VOLUME_CONTROL_RELATIVE
音量控制通过onAdjustVolume(int)
使用相对调整。 尝试将音量设置为特定值应该被忽略。
常数值:1(0x00000001)
VolumeProvider (int volumeControl, int maxVolume, int currentVolume)
创建一个新的卷提供程序来处理卷事件。 您必须指定音量控制的类型,可以使用的最大音量以及输出上的当前音量。
Parameters | |
---|---|
volumeControl |
int : The method for controlling volume that is used by this provider. |
maxVolume |
int : The maximum allowed volume. |
currentVolume |
int : The current volume on the output. |
int getCurrentVolume ()
获取当前音量。 这将是由setCurrentVolume(int)
设置的最后一个值。
Returns | |
---|---|
int |
The current volume. |
int getMaxVolume ()
获得该提供商允许的最大音量。
Returns | |
---|---|
int |
The max allowed volume. |
int getVolumeControl ()
获取此卷供应商使用的音量控制类型。
Returns | |
---|---|
int |
The volume control type for this volume provider |
void onAdjustVolume (int direction)
重写以处理请求以调整当前输出的音量。 方向将是一个ADJUST_LOWER
, ADJUST_RAISE
, ADJUST_SAME
。 在卷被修改setCurrentVolume(int)
必须调用setCurrentVolume(int)
来通知系统。
Parameters | |
---|---|
direction |
int : The direction to change the volume in. |
void onSetVolumeTo (int volume)
重写以处理请求以设置当前输出的音量。 卷被修改setCurrentVolume(int)
必须调用setCurrentVolume(int)
来通知系统。
Parameters | |
---|---|
volume |
int : The volume to set the output to. |
void setCurrentVolume (int currentVolume)
通知系统当前音量已更改。 每次卷更改时都必须调用它以确保正确显示。
Parameters | |
---|---|
currentVolume |
int : The current volume on the output. |