BCOVTVPlayerViewDelegate Protocol Reference

Conforms to NSObject
Declared in BCOVTVPlayerView.h

Overview

Conform to this protocol to receive information about the BCOVTVPlayerView.

– playerView:controlsFadingViewWillFadeOut:

Called just before the playerView controls fade out.

- (void)playerView:(BCOVTVPlayerView *)playerView controlsFadingViewWillFadeOut:(UIView *)controlsFadingView

Parameters

playerView

The player view that manages the controls.

controlsFadingView

The controls fading view that will fade out.

Discussion

Called just before the playerView controls fade out.

Declared In

BCOVTVPlayerView.h

– playerView:controlsFadingViewWillFadeIn:

Called just before the playerView controls fade in.

- (void)playerView:(BCOVTVPlayerView *)playerView controlsFadingViewWillFadeIn:(UIView *)controlsFadingView

Parameters

playerView

The player view that manages the controls.

controlsFadingView

The controls fading view that will fade in.

Discussion

Called just before the playerView controls fade in.

Declared In

BCOVTVPlayerView.h

– playerView:controlsFadingViewDidFadeOut:

Called when the playerView controls have faded out.

- (void)playerView:(BCOVTVPlayerView *)playerView controlsFadingViewDidFadeOut:(UIView *)controlsFadingView

Parameters

playerView

The player view that manages the controls.

controlsFadingView

The controls fading view that faded out.

Discussion

Called when the playerView controls have faded out.

Declared In

BCOVTVPlayerView.h

– playerView:controlsFadingViewDidFadeIn:

Called when the playerView controls have faded in.

- (void)playerView:(BCOVTVPlayerView *)playerView controlsFadingViewDidFadeIn:(UIView *)controlsFadingView

Parameters

playerView

The player view that manages the controls.

controlsFadingView

The controls fading view that faded in.

Discussion

Called when the playerView controls have faded in.

Declared In

BCOVTVPlayerView.h

– playerViewShouldRequireLinearPlayback:

Called when the user is attempting to seek or skip over video content. Return YES to prevent seeking and skipping. Return NO to permit seeking and skipping. The default behavior is to allow seeking. Analogous to the requireLinearPlayback property of AVPlayerViewController.

- (BOOL)playerViewShouldRequireLinearPlayback:(BCOVTVPlayerView *)playerView

Discussion

Called when the user is attempting to seek or skip over video content. Return YES to prevent seeking and skipping. Return NO to permit seeking and skipping. The default behavior is to allow seeking. Analogous to the requireLinearPlayback property of AVPlayerViewController.

Declared In

BCOVTVPlayerView.h

– playerViewShouldDisplayThumbnailPreviewWithSize:

Called just before the thumbnail preview is set up.

- (CGSize)playerViewShouldDisplayThumbnailPreviewWithSize:(BCOVTVPlayerView *)playerView

Parameters

playerView

The player view that will display the thumbnail preview.

Return Value

The width and height the thumbnail should be displayed.

Discussion

Called just before the thumbnail preview is set up.

You can implement this to customize the thumbnail preview size.

If this delegate method is not implemented the size of the thumbnail preview will be 1/5 the size of the playerView.

Declared In

BCOVTVPlayerView.h

– progressViewPanGestureStateBegan:

Called when a progressView panning gesture (seek) begins.

- (void)progressViewPanGestureStateBegan:(NSTimeInterval)progressValue

Parameters

progressValue

The progress value represented by the pan gesture, passed as a parameter because the progress property of the BCOVTVProgressView does not update until playback resumes.

This method is called on the main thread and should not be blocked.

Discussion

Called when a progressView panning gesture (seek) begins.

Declared In

BCOVTVPlayerView.h

– progressViewPanGestureStateChanged:

Called when a progressView panning gesture (seek) changes state (playhead position).

- (void)progressViewPanGestureStateChanged:(NSTimeInterval)progressValue

Parameters

progressValue

The progress value represented by the pan gesture, passed as a parameter because the progress property of the BCOVTVProgressView does not update until playback resumes.

This method is called on the main thread and should not be blocked.

Discussion

Called when a progressView panning gesture (seek) changes state (playhead position).

Declared In

BCOVTVPlayerView.h

– progressViewPanGestureStateEnded:

Called when a panning gesture (seek) ends.

- (void)progressViewPanGestureStateEnded:(NSTimeInterval)progressValue

Parameters

progressValue

The progress value represented by the pan gesture, passed as a parameter because the progress property of the BCOVTVProgressView does not update until playback resumes.

This method is called on the main thread and should not be blocked.

Discussion

Called when a panning gesture (seek) ends.

Declared In

BCOVTVPlayerView.h

– playerDidBeginFastForward

Called when fast-forwarding on the player begins.

- (void)playerDidBeginFastForward

Discussion

Called when fast-forwarding on the player begins.

Declared In

BCOVTVPlayerView.h

– playerDidEndFastForward

Called when fast-forwarding on the player ends.

- (void)playerDidEndFastForward

Discussion

Called when fast-forwarding on the player ends.

Declared In

BCOVTVPlayerView.h

– playerDidBeginFastRewind

Called when fast-rewinding on the player begins.

- (void)playerDidBeginFastRewind

Discussion

Called when fast-rewinding on the player begins.

Declared In

BCOVTVPlayerView.h

– playerDidEndFastRewind

Called when fast-rewinding on the player ends.

- (void)playerDidEndFastRewind

Discussion

Called when fast-rewinding on the player ends.

Declared In

BCOVTVPlayerView.h

– liveIndicatorViewForIsPlaying:atLiveEdge:

Called during video playback.

- (UIView *)liveIndicatorViewForIsPlaying:(BOOL)playing atLiveEdge:(BOOL)atLiveEdge

Parameters

playing

Wether or not the video is currently playing

atLiveEdge

Wether or not the video is at the live edge

This method is called on the main thread and should not be blocked.

Discussion

Called during video playback.

Use this optional delegate method to provide a custom view to indicate to users wether a video is at the live edge or not. If this method is not implemented by your delegate, a default behavior of showing “Live” at the top left of the BCOVTVPlayerView will be displayed, with the “L” tinted green if the video is at the live edge.

The view will be added to as a subview inside BCOVTVPlayerView and will be relative to it. A frame with an x, y value of 0 will be positioned at the top left of the view as expected. You may position the view however you like.

Declared In

BCOVTVPlayerView.h

– willDisplayIconType:withImageView:

Called prior to displaying an icon for certain UI behaviors.

- (BOOL)willDisplayIconType:(BCOVTVIconType)iconType withImageView:(UIImageView *)imageView

Parameters

iconType

The type of icon tha should be displayed

imageView

The image view that the icon will be displayed in

Return Value

A boolean indicating if the default icon should be overriden.

Discussion

Called prior to displaying an icon for certain UI behaviors.

These currently include icons for ‘jump-back’, ‘jump-forward’, ‘fast-forward’ and ‘rewind’.

You can set your own icon image using this delegate method. You will also need to set the frame of the image and note that its superview is 40x40. You can position the imageView however you’d like inside of the superview while keeping a maximum height and width of 40. Return YES if you are overriding the icon, ottherwise return NO

Declared In

BCOVTVPlayerView.h

– titleForInfoViewForVideo:

Called when populating the info tab view for a video.

- (NSString *)titleForInfoViewForVideo:(BCOVVideo *)video

Parameters

video

The video that the info tab view will be populated for.

Return Value

A string that will populate the title label of the info tab view.

Discussion

Called when populating the info tab view for a video.

By default the BCOVVideo.PropertyKeyName value from the BCOVVideo’s property dictionary will be used.

Declared In

BCOVTVPlayerView.h