GCKMediaQueueItemBuilder Class

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
itemThe 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.