MediaPlayerItem.timedMetadata屬性可讓您存取從播放清單/資訊清單標籤或從媒體串流內的ID3標籤建立的所有TimedMetadata物件。 MediaPlayerItem.hasTimedMetadata屬性可指出目前媒體中是否有已訂閱的自訂標籤。
您可以監聽下列事件來監控計時中繼資料,這些事件會通知您的應用程式相關活動:
MediaPlayerItemEvent.ITEM_CREATED
:在建立對象 TimedMetadata
後,可以使用對象 MediaPlayerItem
的初始清單。發生此情況時,此事件會通知您的應用程式。
MediaPlayerItemEvent.ITEM_UPDATED
:對於資訊清單/播放清單定期重新整理的即時/線性串流,更新的播放清單/資訊清單中可能會顯示其他自訂標籤,因此可能會將其他TimedMetadata物件新增至 MediaPlayerItem.timedMetadata
屬性。發生此情況時,此事件會通知您的應用程式。
TimedMetadataEvent.TIMED_METADATA_AVAILABLE
:每次建立新對 TimedMetadata
像時,都會由調度此事件 MediaPlayer
。對於在初始化階段建立的TimedMetadata
對象,不會調度此事件。