實作自訂機會偵測器

您可以實作介面PlacementOpportunityDetector來實作自己的機會偵測器。

1. 建立自訂 AdvertisingFactory 執行個體和覆寫 createOpportunityDetector. 例如：

   new AdvertisingFactory() {
       ...
       @Override
       public PlacementOpportunityDetector createOpportunityDetector(MediaPlayerItem item) {
           return new CustomPlacementOpportunityDetector();
       }
       ...
   }
   

2. 將廣告使用者端工廠註冊至 MediaPlayer. 例如：

   // register the custom advertising factory with media player
   advertisingFactory = createCustomAdvertisingFactory();
   mediaPlayer.registerAdClientFactory(advertisingFactory);
   

3. 建立自訂機會偵測器類別，以擴充 PlacementOpportunityDetector 類別。

   1. 在自訂機會偵測器中，覆寫此函式：

      public List<PlacementOpportunity> process(List<TimedMetadata> timedMetadataList, Metadata metadata)
      

      此 timedMetadataList 包含可用清單 TimedMetadata，已排序。 中繼資料包含目標定位引數以及要傳送給廣告提供者的自訂引數。

   2. 針對每個 TimedMetadata，建立 List<PlacementOpportunity>. 清單可為空白，但不可以是Null。 PlacementOpportunity 應該具有下列屬性：

      PlacementOpportunity(
          String id,                                      // can be id from timedMetadata
          PlacementInformation placementInformation   // PlacementInformation object containing Type, time, duration
          Metadata metadata                           // ad metadata containing targeting params sent to the ad provider
      )
      

   3. 在為所有偵測到的定時中繼資料物件建立位置機會後，只要傳回 PlacementOpportunity 清單。

這是自訂位置機會偵測器的範例：

public class CustomPlacementOpportunityDetector implements PlacementOpportunityDetector {
    ...
    @Override
    public List<PlacementOpportunity> process(List<TimedMetadata> timedMetadataList, Metadata metadata) {
        ...
        List<PlacementOpportunity> opportunities = new ArrayList<PlacementOpportunity>();

        for (TimedMetadata timedMetadata : timedMetadataList) {

            if (isOpportunity(timedMetadata)) {        // check if given timedMetadata should be
                                                       // considered as an opportunity

                // create an object of PlacementOpportunity and add it to the opportunities list
                PlacementOpportunity opportunity =
                  createPlacementOpportunity(timedMetadata, airingId, metadata);
                Opportunities.add(opportunity);
            }
        }
        return opportunities;
    }
    ...
}