GCKRemoteDisplayConfiguration Class

GCKRemoteDisplayConfiguration Class Reference

Overview

Describes the configurable parameters of a Remote Display session.

New configuration objects come with a full set of default values that should work well for most apps. They can of course be customized if needed.

See also
GCKRemoteDisplayChannel

Inherits NSObject. Implements <NSCopying>.

Properties

GCKAudioStreamDescriptoraudioStreamDescriptor
 Descriptor for the audio stream. More...
 
GCKVideoStreamDescriptorvideoStreamDescriptor
 Descriptor for the video stream. More...
 
GCKRemoteDisplayTargetDelay targetDelay
 Used by the Cast device to delay the presentation of video and audio to give enough time to play video and audio without pausing. More...
 

Property Documentation

- (GCKAudioStreamDescriptor*) audioStreamDescriptor
readnonatomicassign

Descriptor for the audio stream.

Contains parameters such as bitrate and sample rate.

- (GCKVideoStreamDescriptor*) videoStreamDescriptor
readnonatomicassign

Descriptor for the video stream.

Contains parameters such as resolution and frame rate.

- (GCKRemoteDisplayTargetDelay) targetDelay
readwritenonatomicassign

Used by the Cast device to delay the presentation of video and audio to give enough time to play video and audio without pausing.

Exercise caution when changing this value since this can cause random pauses or drops. Default value is GCKRemoteDisplayTargetDelayNormal. This cannot be set to GCKRemoteDisplayTargetDelayUnknown.

The lower this value, the less time available to encode, transmit/retransmit, decode, and render frames on the Cast device, and a higher chance of pauses in the middle of casting. For example, if this is set to 100 msec, the Cast device will not show a frame sooner than 100 msec.

The higher this value, the more time available to encode, transmit/retransmit, decode and render frames on the Cast device, and a smoother video/audio experience. However, this could increase the latency between user interaction and seeing the result on the Cast device, and could increase memory usage.

This is also used to calculate the various limits of the number and size of in-flight buffers without dropping audio or video. For example, if the target delay is 25 msec and an app submits a 30 msec audio buffer, or a video frame with a timestamp 30 msec after the previous frame, that audio buffer or video frame will get dropped, resulting in an audio or video glitch.

This will be ignored while GCKRemoteDisplaySession::targetDelay is set.

See also
GCKRemoteDisplaySession.targetDelay

Google Cast iOS Sender API Reference v 2.10.1 4691