public class MediaSyncEvent
extends Object
| java.lang.Object | |
| android.media.MediaSyncEvent | |
MediaSyncEvent类定义可用于在不同播放器和录像机之间同步播放或捕捉操作的事件。
例如， startRecording(MediaSyncEvent)仅用于在特定音频会话的播放完成时才开始捕捉。 音频会话ID被从播放器（例如检索MediaPlayer ， AudioTrack或ToneGenerator通过使用getAudioSessionId（）方法的）。
常量(Constants) |
|
|---|---|
int |
SYNC_EVENT_NONE 没有指定同步事件。 |
int |
SYNC_EVENT_PRESENTATION_COMPLETE 只有当演示完成时（意味着媒体已呈现给用户），指定会话才会触发相应的操作。 |
公共方法(Public methods) |
|
|---|---|
static MediaSyncEvent |
createEvent(int eventType) 创建一个确定类型的同步事件。 |
int |
getAudioSessionId() 获取同步事件音频会话标识。 |
int |
getType() 获取同步事件类型。 |
MediaSyncEvent |
setAudioSessionId(int audioSessionId) 设置事件源音频会话ID。 |
继承方法(Inherited methods) |
|
|---|---|
 From class java.lang.Object
|
|
int SYNC_EVENT_NONE
没有指定同步事件。 与同步播放或捕捉方法一起使用时，该行为等同于调用相应的非同步方法。
常量值：0（0x00000000）
int SYNC_EVENT_PRESENTATION_COMPLETE
只有当演示完成时（意味着媒体已呈现给用户），指定会话才会触发相应的操作。 此类型的同步需要通过{@link #setAudioSessionId（int）方法设置源音频会话ID。
常数值：1（0x00000001）
MediaSyncEvent createEvent (int eventType)
创建一个确定类型的同步事件。
该类型指定监视哪种事件。 例如，事件SYNC_EVENT_PRESENTATION_COMPLETE对应于在特定音频会话上呈现给用户的音频。
| 参数(Parameters) | |
|---|---|
eventType |
int: the synchronization event type. |
| 返回(Returns) | |
|---|---|
MediaSyncEvent |
the MediaSyncEvent created. |
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
|
int getAudioSessionId ()
获取同步事件音频会话标识。
| 返回(Returns) | |
|---|---|
int |
the synchronization audio session ID. The returned audio session ID is 0 if it has not been set. |
int getType ()
获取同步事件类型。
| 返回(Returns) | |
|---|---|
int |
the synchronization event type. |
MediaSyncEvent setAudioSessionId (int audioSessionId)
设置事件源音频会话ID。
音频会话ID指定应在哪个音频会话中监视同步事件。 对某些事件类型是强制性的（例如SYNC_EVENT_PRESENTATION_COMPLETE ）。 例如，在监视特定MediaPlayer上的事件时，可以通过getAudioSessionId()检索音频会话ID。
| 参数(Parameters) | |
|---|---|
audioSessionId |
int: the audio session ID of the event source being monitored. |
| 返回(Returns) | |
|---|---|
MediaSyncEvent |
the MediaSyncEvent the method is called on. |
| 抛出异常(Throws) | |
|---|---|
IllegalArgumentException |
|
Android开发手册