SVSAdManager

@interface SVSAdManager : NSObject

The ad manager is the class responsible of loading ads and displaying them into the ad player.

This class is instantiated with a placement, a set of ad rules, an ad player configuration and is started with a play head object (a protocol representing the state of the content player) and an ad container view which is the view that will be used as superview by the ad player view.

  • Initialize a new instance of SVSAdManager.

    Declaration

    Objective-C

    - (nonnull instancetype)
    initWithDelegate:(nullable id<SVSAdManagerDelegate>)delegate
           placement:(nonnull SVSAdPlacement *)placement
               rules:(nullable SVSAdRules *)rules
       configuration:(nullable SVSAdPlayerConfiguration *)configuration
         contentData:(nullable SVSContentData *)contentData;

    Parameters

    delegate

    The delegate of the ad manager.

    placement

    The placement that should be used to retrieve the ads.

    rules

    Ad rules object used to describe the type of ad the ad manager is allowed to load (and the loading timing for midrolls).

    configuration

    The ad player configuration.

    contentData

    An SVSContentData instance containing informations about the content video.

    Return Value

    An initialized instance of SVSAdManager.

  • Starts the ad manager.

    This will allow the ad manager to load and display ads for the content described by the play head protocol.

    Declaration

    Objective-C

    - (void)startWithPlayHead:(nonnull id<SVSContentPlayerPlayHead>)playHead
              adContainerView:(nonnull UIView *)adContainerView;

    Parameters

    playHead

    A protocol representing the state of the content player.

    adContainerView

    The container view in which the ad player view will be displayed.

  • Stops the ad manager. Use this method only if your content is stopped by an user action such as clicking on a STOP button on your content player UI. Calling this method can trigger a PostRoll advertisement if defined in your AdRules. Calling this method has no effect if an Ad break is already being played.

    If the content finishes without being interrupted by an user interaction, the Ad Manager will automatically trigger the appropriate PostRoll advertisement based on the content player current time, it is not necessary to call this method.

    Declaration

    Objective-C

    - (void)stopAndTriggerPostrollIfAny:(BOOL)triggerPostroll;

    Parameters

    triggerPostroll

    Whether or not the Ad Manager should trigger a postroll ad if any in your SVSAdRule.

  • Tells the ad manager that your content is being replayed (after being completed). You should make sure your content player seeks to the begining of the content video before calling this method.

    This will reset the status of PreRoll and PostRoll advertisements so they can be served again if your AdPlayerConfiguration.publisherOptions.replayAds is YES.

    Note

    This method has no impact on MidRoll advertisements. They will continue playing according to the appropriate AdRule and playHead status.

    Declaration

    Objective-C

    - (void)replay;
  • Tells the ad manager that your content player entered / exited fullscreen mode.

    The AdPlayer view will always stick to your container view even when you resize or rotate it. However, the AdManager needs to know about your fullscreen status to keep the Fullscreen button status up to date when playing Ad breaks. This is particularly important if your application responds to orientation changes by entering / exiting fullscreen.

    Declaration

    Objective-C

    - (void)contentPlayerIsFullscreen:(BOOL)isFullscreen;

    Parameters

    isFullscreen

    Whether or not the content player is in fullscreen mode.

  • The delegate of the ad manager.

    Declaration

    Objective-C

    @property (readwrite, nonatomic) id<SVSAdManagerDelegate> _Nullable delegate;
  • Tells whether or not the SVSAdManager is started. Use this method in your integration to know if you already started your SVSAdManager instance or not.

    Declaration

    Objective-C

    - (BOOL)isStarted;

    Return Value

    whether or not the SVSAdManager instance has been started.