com.adobe.mediacore.timeline.advertising
Class ContentResolver

java.lang.Object
  extended by AdProvider
      extended by com.adobe.mediacore.timeline.advertising.ContentResolver
Direct Known Subclasses:
AuditudeResolver

public abstract class ContentResolver
extends AdProvider


Constructor Summary
protected ContentResolver()
           
 
Method Summary
protected abstract  ContentTracker doProvideAdTracker()
           
protected abstract  void doResolveAds(Metadata metadata, PlacementOpportunity placementOpportunity)
           
 ContentTracker getAdTracker()
           
protected  void notifyResolveComplete(List<TimelineOperation> proposals)
           
protected  void notifyResolveError(MediaPlayerNotification.Error error)
           
 void registerOnCompleteListener(OnCompleteListener listener)
          Registers a class which will receive callbacks when the ad resolving process is complete.
 void resolveAds(Metadata metadata)
          Resolves ads using the provided metadata.
 void resolveAds(Metadata metadata, PlacementOpportunity placementOpportunity)
           
 void unregisterOnCompleteListener(OnCompleteListener listener)
          Removes a listener which was previously registered with registerOnCompleteListener(OnCompleteListener).
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ContentResolver

protected ContentResolver()
Method Detail

resolveAds

public final void resolveAds(Metadata metadata)
Resolves ads using the provided metadata.

The process of resolving ads may be synchronous or asynchronous as the ad provider may need to communicate with external services. Once the process is complete, the ad provider will notify its clients trough OnCompletionListener callbacks.

Parameters:
metadata - application provided metadata used for obtaining ads

resolveAds

public final void resolveAds(Metadata metadata,
                             PlacementOpportunity placementOpportunity)

doResolveAds

protected abstract void doResolveAds(Metadata metadata,
                                     PlacementOpportunity placementOpportunity)

registerOnCompleteListener

public final void registerOnCompleteListener(OnCompleteListener listener)
Registers a class which will receive callbacks when the ad resolving process is complete.

Only one class can be registered at a time so in order to register another listener, the current one must be unregistered first - otherwise an IllegalStateException will be thrown.

Parameters:
listener - the object on which the callback will be called. If null is passed then an IllegalArgumentException will be thrown.

unregisterOnCompleteListener

public final void unregisterOnCompleteListener(OnCompleteListener listener)
Removes a listener which was previously registered with registerOnCompleteListener(OnCompleteListener).

Parameters:
listener - the object which was previously registered. If the listener provided is not the one previously registered, then an IllegalArgumentException will be thrown.

notifyResolveComplete

protected final void notifyResolveComplete(List<TimelineOperation> proposals)

notifyResolveError

protected final void notifyResolveError(MediaPlayerNotification.Error error)

getAdTracker

public final ContentTracker getAdTracker()

doProvideAdTracker

protected abstract ContentTracker doProvideAdTracker()