GCKMediaQueueItem クラス

GCKMediaQueueItem クラス リファレンス

概要

メディアキュー アイテムを表すクラスです。

このオブジェクトのインスタンスは変更できません。

このクラスは、送信側アプリケーションと受信側アプリケーションの間の双方向通信で使用されます。センダーは、レシーバー アプリケーションでメディア アイテムのリストを読み込んだり挿入するために、メディア アイテムのリストを構築します。レシーバーの GCKMediaStatus には、このクラスのインスタンスとして表されるアイテムのリストも含まれています。

読み込みが完了すると、レシーバーは同じメディアが複数回読み込まれた場合でも、各 GCKMediaQueueItem に一意のアイテム ID を割り当てます。

NSObject を継承します。<NSCopying> を実装します。

インスタンス メソッドの概要

(instancetype) - initWithMediaInformation:autoplay:startTime:preloadTime:activeTrackIDs:customData:
 指定された属性で新しい GCKMediaQueueItem を作成します。その他...
 
(instancetype) - initWithMediaInformation:autoplay:startTime:playbackDuration:preloadTime:activeTrackIDs:customData:
 指定のイニシャライザ。その他...
 
(void) - clearItemID
 商品アイテム ID を消去(割り当て解除)します。その他...
 
(instancetype) - mediaQueueItemModifiedWithBlock:
 指定されたブロックによって変更されたこの GCKMediaQueueItem のコピーを返します。その他...
 

プロパティの概要

GCKMediaInformationmediaInformation
 このアイテムに関連付けられているメディア情報です。その他...
 
GCKMediaQueueItemID itemID
 商品アイテム ID、まだ割り当てられていない場合は kGCKMediaQueueInvalidItemIDその他...
 
BOOL autoplay
 そのアイテムがキューの現在のアイテムになったときに、自動的に再生を開始するかどうかを指定します。その他...
 
NSTimeInterval startTime
 アイテムの開始時間(秒単位)。その他...
 
NSTimeInterval playbackDuration
 アイテムの再生時間(秒)。実際のストリーム時間を使用する場合は INFINITYその他...
 
NSTimeInterval preloadTime
 前のアイテムが終了する前に、レシーバーがこのアイテムのプリロードを開始するまでの時間(秒)。その他...
 
NSArray< NSNumber * > * activeTrackIDs
 このアイテムの有効なトラック ID。その他...
 
id customData
 このアイテムに関連付けられているカスタムデータ(ある場合)。その他...
 

メソッドの詳細

- (instancetype) initWithMediaInformation: (GCKMediaInformation *)  mediaInformation
autoplay: (BOOL)  autoplay
startTime: (NSTimeInterval)  startTime
preloadTime: (NSTimeInterval)  preloadTime
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

指定された属性で新しい GCKMediaQueueItem を作成します。

詳細については、対応するプロパティのドキュメントをご覧ください。

Parameters
mediaInformationThe media information for the item.
autoplayThe autoplay state for this item.
startTimeThe start time of the item, in seconds. May be kGCKInvalidTimeInterval if this item refers to a live stream or if the default start time should be used.
preloadTimeThe preload time for the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time.
activeTrackIDsThe active track IDs for the item. May be nil.
customDataAny custom data to associate with the item. May be nil.
- (instancetype) initWithMediaInformation: (GCKMediaInformation *)  mediaInformation
autoplay: (BOOL)  autoplay
startTime: (NSTimeInterval)  startTime
playbackDuration: (NSTimeInterval)  playbackDuration
preloadTime: (NSTimeInterval)  preloadTime
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

指定のイニシャライザ。

指定された属性で新しい GCKMediaQueueItem を作成します。詳細については、対応するプロパティのドキュメントをご覧ください。

Parameters
mediaInformationThe media information for the item.
autoplayThe autoplay state for this item.
startTimeThe start time of the item, in seconds. May be kGCKInvalidTimeInterval if this item refers to a live stream or if the default start time should be used.
playbackDurationThe playback duration of the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time.
preloadTimeThe preload time for the item, in seconds.
activeTrackIDsThe active track IDs for the item. May be nil.
customDataAny custom data to associate with the item. May be nil.
- (void) clearItemID

商品アイテム ID を消去(割り当て解除)します。

既存のインスタンスを再利用する場合(たとえば、キューに再び追加する場合)に呼び出す必要があります。

- (instancetype) mediaQueueItemModifiedWithBlock: (void(^)(GCKMediaQueueItemBuilder *builder))  block

指定されたブロックによって変更されたこの GCKMediaQueueItem のコピーを返します。

Parameters
blockA block that receives a GCKMediaQueueItemBuilder which can be used to modify attributes of the copy. It is not necessary to call the builder's build (GCKMediaQueueItemBuilder) method within the block, as this method will do that automatically when the block completes.
戻り値
このアイテムの改変されたコピー。

物件の詳細

- (GCKMediaInformation*) mediaInformation
readnonatomicstrong

このアイテムに関連付けられているメディア情報です。

- (GCKMediaQueueItemID) itemID
readnonatomicassign

商品アイテム ID、まだ割り当てられていない場合は kGCKMediaQueueInvalidItemID

- (BOOL) autoplay
readnonatomicassign

そのアイテムがキューの現在のアイテムになったときに、自動的に再生を開始するかどうかを指定します。

NO の場合、このアイテムに到達した時点でキューが一時停止します。デフォルト値は YES です。このアイテムを使用して GCKMediaLoadRequestData のメディアキューを読み込む場合、GCKMediaLoadRequestDataautoplay が nil の場合にのみ、最初のアイテムのこのプロパティが有効になります。

- (NSTimeInterval) startTime
readnonatomicassign

アイテムの開始時間(秒単位)。

デフォルト値は kGCKInvalidTimeInterval で、開始時間が設定されていないことを示します。

- (NSTimeInterval) playbackDuration
readnonatomicassign

アイテムの再生時間(秒)。実際のストリーム時間を使用する場合は INFINITY

- (NSTimeInterval) preloadTime
readnonatomicassign

前のアイテムが終了する前に、レシーバーがこのアイテムのプリロードを開始するまでの時間(秒)。

デフォルト値は kGCKInvalidTimeInterval で、プリロード時間が設定されていないことを示します。

- (NSArray<NSNumber *>*) activeTrackIDs
readnonatomicstrong

このアイテムの有効なトラック ID。

- (id) customData
readnonatomicstrong

このアイテムに関連付けられているカスタムデータ(ある場合)。