為計時中繼資料通知新增監聽器

若要接收資訊清單中標籤的通知，請註冊適當的事件接聽程式。

您可以監聽下列事件來監控計時中繼資料，這些事件會通知您的應用程式相關活動：

  • MediaPlayerItemEvent.ITEM_CREATED:在建立對象 TimedMetadata 後，可以使用對象 MediaPlayerItem 的初始清單。

    發生此情況時，此事件會通知您的應用程式。

  • MediaPlayerItemEvent.ITEM_UPDATED:對於資訊清單／播放清單定期重新整理的即時／線性串流，更新的播放清單／資訊清單中可能會顯示其他自訂標籤， TimedMetadata 因此可能會將其他物件新增至 MediaPlayerItem.timedMetadata 屬性。

    發生此情況時，此事件會通知您的應用程式。

  • TimedMetadataEvent.TIMED_METADATA_AVAILABLE:每次建立新 TimedMetadata 物件時，MediaPlayer就會傳送此事件。

    對於在初始化階段建立的TimedMetadata對象，不會調度此事件。

  1. 實作適當的監聽器。

    private function onItemCreated(event:MediaPlayerItemEvent):void {
    var timedMetadataCollection:Vector.<TimedMetadata> = event.item.timedMetadata;
    // process the timed metadata collection
}

private function onItemUpdated(event:MediaPlayerItemEvent):void {
    var timedMetadataCollection:Vector.<TimedMetadata> = event.item.timedMetadata;
    // process the timed metadata collection
}

private function onTimedMetadataAvailable(event:TimedMetadataEvent):void {
    var timedMetadata:TimedMetadata = event.timedMetadata;
    // process timed metadata
}

  2. 註冊事件偵聽器。

    player.addEventListener(MediaPlayerItemEvent.ITEM_CREATED, onItemCreated);
player.addEventListener(MediaPlayerItemEvent.ITEM_UPDATED, onItemUpdated);
player.addEventListener(TimedMetadataEvent.TIMED_METADATA_AVAILABLE,
                        onTimedMetadataAvailable);

ID3中繼資料會透過相同的TimedMetadataEvent.TIMED_METADATA_AVAILABLE傳送。 但是，這不會造成任何混淆，因為您可以使用TimedMetadata物件的type屬性來區分TAG和ID3。 如需ID3標籤的詳細資訊，請參閱ID3標籤。

本頁內容