APSUnitManagerProtocol

Objective-C

@protocol APSUnitManagerProtocol <NSObject, KRAdapter>

Swift

protocol APSUnitManagerProtocol : KRAdapter
  • This protocol provides an interface for external objects that implement dynamic playback operations. Use this if you need to generate media URLs using timestamps or for implementing DRM support.

This protocol extends the KRAdapter protocol, so objects should also implement a type method, returning a unique string to register under.

To use:

  • Create a new class that implements this protocol

  • Register it with the player shared instance:

       [[APSMediaPlayer sharedInstance] registerUnitManager:[<YOURCLASS> new]];

  • Set up with the APSMediaUnit:

       unit.managerType = @"<YOURSTRINGCONSTANT>"

  • When an APSMediaUnit is loaded by the player, if it declares requiring a manager that matches the current object’s [KRAdapter type], this method will be invoked.

    This method should handle playback by calling [APSMediaPlayer setCurrentURL:] to effectively start media playback for a specific URL, or call another relevant method (like [APSMediaPlayer step]) and generate APSMediaPlayerErrorNotification notifications on error.

    Declaration

    Objective-C

    - (void)startForUnit:(APSMediaUnit *)unit;

    Swift

    func start(for unit: APSMediaUnit!)

    Parameters

    unit

    The currently loading unit.

  • When an APSMediaUnit ends playback, if it declares requiring a manager that matches the current object’s [KRAdapter type], this method will be invoked.

    Declaration

    Objective-C

    - (void)end;

    Swift

    func end()