GCKMediaQueueItemBuilder Class

AI-generated Key Takeaways

• GCKMediaQueueItemBuilder is a builder object used to construct new or derived GCKMediaQueueItem instances.

• It can be used to create a new GCKMediaQueueItem from scratch or to modify an existing one.

• Key properties that can be set include media information, autoplay status, start time, playback duration, preload time, active track IDs, and custom data.

• The build method is used to create the GCKMediaQueueItem instance with the configured attributes.

Instance Methods | Properties

GCKMediaQueueItemBuilder Class Reference

Overview

A builder object for constructing new or derived GCKMediaQueueItem instances.

The builder may be used to derive a GCKMediaQueueItem from an existing one:

GCKMediaQueueItemBuilder *builder =

[[GCKMediaQueueItemBuilder alloc] initWithMediaQueueItem:originalItem];

builder.startTime = 10; // Change the start time.

builder.autoplay = NO; // Change the autoplay flag.

GCKMediaQueueItem *derivedItem = [builder build];

It can also be used to construct a new GCKMediaQueueItem from scratch:

GCKMediaQueueItemBuilder *builder = [[GCKMediaQueueItemBuilder alloc] init];

builder.mediaInformation = ...;

builder.autoplay = ...;

// Set all other desired propreties...

GCKMediaQueueItem *newItem = [builder build];

Inherits NSObject.

Instance Method Summary
(instancetype)	- init
	Constructs a new GCKMediaQueueItemBuilder with attributes initialized to default values. More...
(instancetype)	- initWithMediaQueueItem:
	Constructs a new GCKMediaQueueItemBuilder with attributes copied from the given GCKMediaQueueItem, including the item ID. More...
(GCKMediaQueueItem *)	- build
	Builds a GCKMediaQueueItem using the builder's current attributes. More...

Property Summary
GCKMediaInformation *	mediaInformation
	The media information associated with this item. More...
BOOL	autoplay
	Whether the item should automatically start playback when it becomes the current item in the queue. More...
NSTimeInterval	startTime
	The start time of the item, in seconds. More...
NSTimeInterval	playbackDuration
	The playback duration for the item, in seconds, or INFINITY if the stream's actual duration should be used. More...
NSTimeInterval	preloadTime
	How long before the previous item ends, in seconds, before the receiver should start preloading this item. More...
NSArray< NSNumber * > *	activeTrackIDs
	The active track IDs for this item. More...
id	customData
	The custom data associated with this item, if any. More...

Method Detail

- (instancetype) init

Constructs a new GCKMediaQueueItemBuilder with attributes initialized to default values.

- (instancetype) initWithMediaQueueItem:

(nullable GCKMediaQueueItem *)

item

Constructs a new GCKMediaQueueItemBuilder with attributes copied from the given GCKMediaQueueItem, including the item ID.

Parameters

item	The item to copy.

- (GCKMediaQueueItem *) build

Builds a GCKMediaQueueItem using the builder's current attributes.

Property Detail

- (GCKMediaInformation*) mediaInformation

readwritenonatomiccopy

The media information associated with this item.

- (BOOL) autoplay

readwritenonatomicassign

Whether the item should automatically start playback when it becomes the current item in the queue.

If NO, the queue will pause when it reaches this item. The default value is YES.

- (NSTimeInterval) startTime

readwritenonatomicassign

The start time of the item, in seconds.

The default value is kGCKInvalidTimeInterval, indicating that a start time does not apply (for example, for a live stream) or that the default start time should be used.

- (NSTimeInterval) playbackDuration

readwritenonatomicassign

The playback duration for the item, in seconds, or INFINITY if the stream's actual duration should be used.

- (NSTimeInterval) preloadTime

readwritenonatomicassign

How long before the previous item ends, in seconds, before the receiver should start preloading this item.

The default value is kGCKInvalidTimeInterval, indicating no preload time.

- (NSArray<NSNumber *>*) activeTrackIDs

readwritenonatomiccopy

The active track IDs for this item.

- (id) customData

readwritenonatomiccopy

The custom data associated with this item, if any.