TVIVideoView Class Reference

Inherits from	UIView
Conforms to	TVIVideoRenderer
Declared in	TVIVideoView.h

Overview

A TVIVideoView draws video frames from a TVIVideoTrack. TVIVideoView should only be used on the application’s main thread. Subclassing TVIVideoView is not supported. UIViewContentModeScaleToFill, UIViewContentModeScaleAspectFill and UIViewContentModeScaleAspectFit are the supported content modes.

When TVIVideoView is contained within a UIWindowScene on iOS 13.0+, it registers for lifecycle notifications from the scene. When the view is used on earlier versions of iOS or added to a UIWindow without a UIWindowScene, it registers for UIApplication lifecycle notifications instead.

`– initWithFrame:delegate:`

Creates a video view with a frame and delegate.

@discussuion The default video rendering type is determined based upon your device model. For 64-bit devices the Metal APIs will be used otherwise OpenGL ES video rendering APIs will be used.

- (null_unspecified instancetype)initWithFrame:(CGRect)frame delegate:(nullable id<TVIVideoViewDelegate>)delegate

Parameters

`frame`	The frame rectangle for the view.
`delegate`	An object implementing the `TVIVideoViewDelegate` protocol (often a UIViewController).

Return Value

A renderer which is appropriate for your device and OS combination.

Declared In

TVIVideoView.h

`– initWithFrame:delegate:renderingType:`

Creates a video view with a frame, delegate and rendering type.

- (null_unspecified instancetype)initWithFrame:(CGRect)frame delegate:(nullable id<TVIVideoViewDelegate>)delegate renderingType:(TVIVideoRenderingType)renderingType

Parameters

`frame`	The frame rectangle for the view.
`delegate`	An object implementing the `TVIVideoViewDelegate` protocol (often a UIViewController).
`renderingType`	The rendering type.

Return Value

A renderer which uses a specific TVIVideoRenderingType. OpenGL rendering will be used if the rendering type is not supported on the current device.

Discussion

The rendering type, OpenGL ES supports zero copy rendering of NV12 sources. However, it currently fails to create textures when the input is an NV12 CVPixelBuffer without kCVPixelBufferOpenGLTextureCacheCompatibilityKey set to true. This is only an issue for custom capturers which produce NV12 buffers without this flag set.

Declared In

TVIVideoView.h

`delegate`

A delegate which receives callbacks when important view rendering events occur.

@property (nonatomic, weak, nullable) id<TVIVideoViewDelegate> delegate

Discussion

Note: The delegate is always called on the main thread in order to synchronize with UIKit.

Declared In

TVIVideoView.h

`viewShouldRotateContent`

Specify if the video view or the application will handle rotated video content.

@property (nonatomic, assign) BOOL viewShouldRotateContent

Discussion

Handling rotations at the application level is more complex, but allows you to smoothly animate transitions. By default, video frame rotation is performed by TVIVideoView. Set this property to NO if you want to handle rotations in your own layout using `[TVIVideoViewDelegate videoView:videoOrientationDidChange:].