SynchroniserDelegate

@protocol SynchroniserDelegate <NSObject>

The callback interface for a Synchroniser’s delegate object.

  • Callback method to inform delegate about Synchroniser state changes

    Declaration

    Objective-C

    - (void)Synchroniser:(Synchroniser *)synchroniser
      DidChangeState:(SynchroniserState)state;

    Swift

    func synchroniser(_ synchroniser: Synchroniser!, didChangeState state: Any!)

    Parameters

    synchroniser

    the invoking Synchroniser instance
    state

    a SynchroniserState state

  • Callback method to inform delegate about jitter (difference between expected and actual video player time position) afte resynchronisation of a video player. This callback is invoked after each resynchronisation procedure that causes a playback readjustment.

    Declaration

    Objective-C

    - (void)VideoSyncController:(id)controller
               ReSyncStatus:(id)status
                     Jitter:(NSTimeInterval)jitter
                  WithError:(id)error;

    Swift

    func videoSyncController(_ controller: Any!, reSyncStatus status: Any!, jitter: Any!, withError error: Any!)

    Parameters

    controller

    VideoPlayerSyncController object synchronising a video player
    status

    one of VideoSyncControllerState enumerated states
    jitter

    synchronisation jitter for the video player the controller controls
    error

    error condition during synchronisation

  • Callback method to inform delegate about jitter (difference between expected and actual audio player time position) after resynchronisation of a audio player. This callback is invoked after each resynchronisation procedure that causes a playback readjustment.

    Declaration

    Objective-C

    - (void)AudioSyncController:(id)controller
               ReSyncStatus:(id)status
                     Jitter:(NSTimeInterval)jitter
                  WithError:(id)error;

    Swift

    func audioSyncController(_ controller: Any!, reSyncStatus status: Any!, jitter: Any!, withError error: Any!)

    Parameters

    controller

    AudioSyncController object synchronising an audio player
    status

    one of AudioSyncControllerState enumerated states
    jitter

    synchronisation jitter for the audio player the controller controls
    error

    error condition during synchronisation

  • Callback reporting time since the start of the TV programme.

    Declaration

    Objective-C

    - (void)Synchroniser:(Synchroniser *)synchroniser
         CurrentTime:(NSTimeInterval)time
               Error:(NSTimeInterval)error;

    Swift

    func synchroniser(_ synchroniser: Synchroniser!, currentTime time: Any!, error: Any!)

    Parameters

    synchroniser

    the synchroniser object carrying out DVB-CSS synchronisation
    time

    time in seconds since the start of the TV programme
    error

    error bounds on this time reading

  • Callback reporting the current synchronisation accuracy. This method is called back every 2 seconds. For the latest synchronisation accuracy reading, read this class’s error property.

    Declaration

    Objective-C

    - (void)Synchroniser:(Synchroniser *)synchroniser
        SyncAccuracy:(NSTimeInterval)error;

    Swift

    func synchroniser(_ synchroniser: Synchroniser!, syncAccuracy error: Any!)

    Parameters

    synchroniser

    the synchroniser object carrying out DVB-CSS synchronisation
    error

    error bounds from the synchronisation process

  • Reports new or updated Content Id Information from the TV when received through the CSS-CI protocol. The Content Id Information object contains a content identifier for the TV programme, the MRS URL, the CSS-WC server endpoint URL, the CSS-TS server endpoint URL, the presentation status of the TV and a list of timelines currently available at the TV for synchronisation.

    Declaration

    Objective-C

    - (void)Synchroniser:(Synchroniser *)synchroniser
    NewContentInfoAvailable:(id)cii
                 ChangeMask:(id)cii_change_mask;

    Swift

    func synchroniser(_ synchroniser: Synchroniser!, newContentInfoAvailable cii: Any!, changeMask cii_change_mask: Any!)

    Parameters

    synchroniser

    the synchroniser object overseeing DVB-CSS synchronisation
    cii

    an object encapsulating Content Id and Information (CII)
    cii_change_mask

    a bit mask showing which properties has changed.

  • A convenience method to report only ContentId changes.

    Declaration

    Objective-C

    - (void)Synchroniser:(Synchroniser *)synchroniser
    ContentIdDidChange:(NSString *)contentId;

    Swift

    func synchroniser(_ synchroniser: Synchroniser!, contentIdDidChange contentId: Any!)

    Parameters

    synchroniser

    the synchroniser object overseeing DVB-CSS synchronisation
    contentId

    a Content Identifier for the content played by the TV