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 |
|---|
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) |
|
|---|---|
java.lang.Object
|
|
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. |