public final class PlaybackParams
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.media.PlaybackParams |
普通播放参数的结构。 由AudioTrack
getPlaybackParams()
和setPlaybackParams(PlaybackParams)
用于控制播放行为。
音频后备模式:选择超出范围的参数处理。
AUDIO_FALLBACK_MODE_DEFAULT
: System will determine best handling. AUDIO_FALLBACK_MODE_MUTE
: Play silence for params normally out of range.AUDIO_FALLBACK_MODE_FAIL
: Return IllegalArgumentException
from AudioTrack.setPlaybackParams(PlaybackParams)
.音调:增加或减少音频内容的音调频率。 它表示为乘法因子,正常音高为1.0f。
速度:增加或减少播放一组音频或视频帧的时间。 它表示为乘法因子,正常速度为1.0f。
速度和音调的不同组合可用于音频播放; 一些常见的:
setPlaybackRate(int)
.Constants |
|
---|---|
int |
AUDIO_FALLBACK_MODE_DEFAULT |
int |
AUDIO_FALLBACK_MODE_FAIL |
int |
AUDIO_FALLBACK_MODE_MUTE |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<PlaybackParams> |
CREATOR |
Public constructors |
|
---|---|
PlaybackParams() |
Public methods |
|
---|---|
PlaybackParams |
allowDefaults() 允许为未设置的属性返回默认值。 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
int |
getAudioFallbackMode() 检索音频后备模式。 |
float |
getPitch() 检索音高因子。 |
float |
getSpeed() 检索速度因子。 |
PlaybackParams |
setAudioFallbackMode(int audioFallbackMode) 设置音频后备模式。 |
PlaybackParams |
setPitch(float pitch) 设置音高因子。 |
PlaybackParams |
setSpeed(float speed) 设置速度系数。 |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
PlaybackParams allowDefaults ()
允许为未设置的属性返回默认值。 否则,在获取那些具有默认值但从未设置的属性时会引发IllegalArgumentException
异常。
Returns | |
---|---|
PlaybackParams |
this PlaybackParams instance. |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
int getAudioFallbackMode ()
检索音频后备模式。
Returns | |
---|---|
int |
audio fallback mode |
Throws | |
---|---|
IllegalStateException |
if the audio fallback mode is not set. |
float getPitch ()
检索音高因子。
Returns | |
---|---|
float |
pitch |
Throws | |
---|---|
IllegalStateException |
if pitch is not set. |
float getSpeed ()
检索速度因子。
Returns | |
---|---|
float |
speed |
Throws | |
---|---|
IllegalStateException |
if speed is not set. |
PlaybackParams setAudioFallbackMode (int audioFallbackMode)
设置音频后备模式。
Returns | |
---|---|
PlaybackParams |
this PlaybackParams instance. |
PlaybackParams setPitch (float pitch)
设置音高因子。
Returns | |
---|---|
PlaybackParams |
this PlaybackParams instance. |
Throws | |
---|---|
|
if the pitch is negative |
PlaybackParams setSpeed (float speed)
设置速度系数。
Returns | |
---|---|
PlaybackParams |
this PlaybackParams instance. |
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
Parameters | |
---|---|
dest |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |