Implementa un risolutore di contenuti personalizzato

È possibile implementare i propri risolutori di contenuti in base ai risolutori predefiniti.

Quando TVSDK rileva una nuova opportunità, esegue un’iterazione attraverso i risolutori di contenuti registrati alla ricerca di una che sia in grado di risolvere tale opportunità utilizzando il metodo canResolve . Il primo che restituisce true viene selezionato per risolvere l'opportunità. Se nessun risolutore di contenuti è in grado di farlo, questa opportunità viene ignorata. Poiché il processo di risoluzione dei contenuti è in genere asincrono, il risolutore dei contenuti è responsabile della notifica a TVSDK al termine del processo.

• Il risolutore dei contenuti chiama client.place per specificare quale operazione timeline deve essere eseguita da TVSDK (in genere un posizionamento di interruzione annuncio).
• Il risolutore dei contenuti chiama client.notifyCompleted se il processo di risoluzione ha esito positivo oppure client.notifyFailed se il processo non riesce.

1. Crea un risolutore di opportunità personalizzato.

   public class CustomResolver extends ContentResolver {
   
       /**
        * Default constructor.
        */
       public function CustomResolver() {
       }
   
       override protected function doConfigure(item:MediaPlayerItem):void {
           // here you can read any media stream characteristics which
           // might help configure your content resolver like
           // - the media player item configuration through the item.config
           // - the media resource metadata through item.resource.metadata
       }
   
       /**
        * @inheritDoc
        */
       override protected function doCanResolve(opportunity:Opportunity):Boolean {
           // check if the opportunity can be resolved by this resolver
           // if yes return true, otherwise return false
   
           return true;
       }
   
       /**
        * @inheritDoc
        */
       override protected function doResolve(opportunity:Opportunity):void {
           // start the resolving process
           // communicate with your custom ad server
   
           // in this example we assume that:
           // - if successful, onResolveCompleted method will be invoked
           // - if failed, onResolveFailed method will be invoked
       }
   
       private function onResolveCompleted(response:*):void {
           try {
               var proposals:Vector.<TimelineOperation> = new Vector.<TimelineOperation>();
   
               // extract the timeline ad placement from the response
               // and add them to the proposal vector
               // - extract the ad break
               // - calculate the placement ( can reuse the opportunity.placement )
               // var timelineOperation:AdBreakPlacement = new AdBreakPlacement(placement, adBreak);
               // proposals.push(timelineOperation);
   
               client.process(proposals);
               client.notifyCompleted(_opportunity);
           } catch (error:Error) {
               onResolveFailed(error);
           }
       }
   
       private function onResolveFailed(error:Error):void {
   
           var errorMetadata:Metadata = new Metadata();
           MetadataUtils.serializeError(error, errorMetadata);
   
           var mediaError:MediaError = new MediaError(NotificationCode.CONTENT_RESOLVING_ERROR, errorMetadata);
           client.notifyFailed(_opportunity, mediaError);
       }
   
       ...
   }
   

2. Crea la content factory personalizzata che utilizza il risolutore di contenuti personalizzato.

   Ad esempio:

   public class CustomContentFactory extends DefaultContentFactory {
           ...
   
           /**
            * @inheritDoc
            */
           override protected function
             doRetrieveResolvers(item:MediaPlayerItem):Vector.<ContentResolver> {
               var result:Vector.<ContentResolver> = new Vector.<ContentResolver>();
   
               var resource:MediaResource = item.resource;
   
               if (resource.metadata != null) {
                   if (resource.metadata.containsKey(DefaultMetadataKeys.AUDITUDE_METADATA_KEY)) {
                       result.push(new AuditudeAdResolver());
                   } else if (resource.metadata.containsKey("custom-opportunity-detector")) {
                       result.push(new CustomResolver());
                   }
               }
               return result;
           }
   }
   

3. Registra il content factory personalizzato per il flusso multimediale da riprodurre.

   Ad esempio:

   var mediaPlayerItemConfig:MediaPlayerItemConfig = new DefaultMediaPlayerItemConfig();
   mediaPlayerItemConfig.advertisingFactory = new CustomContentFactory();
   ...
   
   var advertisingMetadata:AdvertisingMetadata = new AdvertisingMetadata();
   // set any parameter you need for custom ad resolver
   // advertisingMetadata.setValue("customparam", "customvalue");
   
   var metadata:Metadata = new Metadata();
   metadata.setMetadata("custom-opportunity-detector", advertisingMetadata);
   var mediaResource:MediaResource = MediaResource.createFromUrl(url, metadata);
   
   player.replaceCurrentResource(mediaResource, mediaPlayerItemConfig);
   

Risorse Business.Adobe.com