Implementare un sistema di risoluzione dei contenuti personalizzato

Puoi implementare dei resolver di contenuto personalizzati in base ai resolver predefiniti.

Quando TVSDK rileva una nuova opportunità, scorre attraverso i resolver di contenuti registrati alla ricerca di una che sia in grado di risolvere tale opportunità utilizzando canResolve metodo . Il primo che restituisce true viene selezionato per la risoluzione dell'opportunità. Se non è possibile utilizzare alcun risolutore contenuti, tale opportunità viene ignorata. Poiché il processo di risoluzione dei contenuti è in genere asincrono, il resolver dei contenuti è responsabile della notifica a TVSDK al termine del processo.

• Chiamate del resolver dei contenuti client.place per specificare quale operazione della timeline deve essere eseguita da TVSDK (in genere, un posizionamento di interruzione pubblicitaria).
• Chiamate del resolver dei contenuti client.notifyCompleted se il processo di risoluzione ha esito positivo, oppure client.notifyFailed se il processo non riesce.

1. Creare un risolutore 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 il factory dei contenuti personalizzato, che utilizza il risolutore 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 factory dei contenuti personalizzati 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