GCKUIMediaController クラス

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
GCKUIMediaController クラス リファレンス

概要

キャスト レシーバーでのメディア再生のステータスを制御または表示するために使用される UI ビューのコントローラ。

呼び出し元アプリは、適切なプロパティを設定して、メディア関連の UI コントロールをコントローラに登録します。コントローラは、コントロールにタッチイベントに応答して適切なメディア コマンドを受信機に発行し、レシーバーから受け取ったステータス情報とメディア メタデータに基づいてコントロールを更新します。コントローラは、現在のセッションとメディア プレーヤーの状態に応じて、UI コントロールを自動的に有効または無効にします。さらに、リクエストの処理中はすべてのコントロールが無効になります。

デリゲート プロトコルについては、GCKUIMediaControllerDelegate をご覧ください。

シンセ
3.0

NSObject を継承します。

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

(instancetype) - init
 インスタンスを初期化します。その他...
 
(void) - bindLabel:toMetadataKey:
 UILabel をメタデータキーにバインドします。その他...
 
(void) - bindLabel:toMetadataKey:withFormatter:
 UILabel をメタデータキーにバインドします。その他...
 
(void) - bindTextView:toMetadataKey:
 UITextView をメタデータキーにバインドします。その他...
 
(void) - bindTextView:toMetadataKey:withFormatter:
 UITextView をメタデータキーにバインドします。その他...
 
(void) - bindImageView:toImageHints:
 UIImageViewGCKUIImageHints インスタンスにバインドします。その他...
 
(void) - unbindView:
 指定したビューをバインド解除します。その他...
 
(void) - unbindAllViews
 バインドされているすべてのビューをバインド解除します。その他...
 
(GCKMediaRepeatMode- cycleRepeatMode
 サイクルのキューの繰り返しモードを、次のモードに変更します: 展開...
 
(void) - selectTracks
 メディア トラック選択 UI を表示する便利なメソッドです。その他...
 
(void) - skipAd
 スキップしたリクエストを送信し、モニタリングします。その他...
 

プロパティの概要

id< GCKUIMediaControllerDelegatedelegate
 GCKUIMediaController から通知を受け取るデリゲート。その他...
 
GCKSessionsession
 このコントローラに関連付けられているセッション。その他...
 
BOOL mediaLoaded
 レシーバに現在ロードされている(または読み込み中)メディアがあるかどうか。その他...
 
BOOL hasCurrentQueueItem
 キューに現在のアイテムがあるかどうか。その他...
 
BOOL hasLoadingQueueItem
 キューにプリロードされたアイテムがあるかどうか。その他...
 
GCKMediaPlayerState lastKnownPlayerState
 最新の既知のメディア プレーヤーの状態。その他...
 
NSTimeInterval lastKnownStreamPosition
 最新の既知のメディア ストリーム位置。その他...
 
UIButton * playButton
 「再生」ボタン。その他...
 
UIButton * pauseButton
 「一時停止」ボタン。その他...
 
GCKUIMultistateButtonplayPauseToggleButton
 「再生/一時停止」の切り替えボタン。その他...
 
GCKUIPlayPauseToggleControllerplayPauseToggleController
 「再生/一時停止」切り替えコントローラ。その他...
 
UIButton * stopButton
 「停止」ボタン。その他...
 
UIButton * forward30SecondsButton
 現在再生中のメディア アイテムを 30 秒早送りするためのボタンです。その他...
 
UIButton * rewind30SecondsButton
 現在再生中のメディア アイテムで 30 秒早送りするボタン。その他...
 
UIButton * pauseQueueButton
 現在の項目の再生が終了した後、キューの再生を一時停止するためのボタン。その他...
 
UIButton * nextButton
 [次へ] ボタンその他...
 
UIButton * previousButton
 「前へ」ボタン。その他...
 
GCKUIMultistateButtonrepeatModeButton
 使用可能なキューの繰り返しモードを繰り返すためのボタン。その他...
 
UISlider * streamPositionSlider
 現在のストリーム位置を表示および変更するためのスライダー。その他...
 
UIProgressView * streamProgressView
 現在の配信の進捗状況を表示するビュー。その他...
 
UILabel * streamPositionLabel
 現在のストリーム位置を分と秒で表示するラベル。その他...
 
UILabel * streamDurationLabel
 現在の配信時間を分と秒で表示するラベル。その他...
 
UILabel * streamTimeRemainingLabel
 残りの配信時間(継続時間を引いた位置)を分と秒単位で表示するラベルです。その他...
 
GCKUIStreamPositionControllerstreamPositionController
 ストリーム ポジション コントローラ。その他...
 
GCKUIPlaybackRateControllerplaybackRateController
 ストリーム再生レート コントローラ。その他...
 
BOOL displayTimeRemainingAsNegativeValue
 残りのストリーミング時間を負の値で表示するかどうかを指定します(例: 「-1:23:45」)。その他...
 
BOOL hideStreamPositionControlsForLiveContent
 ライブ コンテンツについて、ストリーム位置コントロール(ストリーム位置スライダー、ストリーム位置ラベル、ストリーム再生時間ラベル、ストリーム進行状況ビューなど)を非表示にするかどうか。その他...
 
UIButton * tracksButton
 音声トラックや字幕を選択するためのボタン。その他...
 
UILabel * smartSubtitleLabel
 現在読み込まれているメディアの字幕を表示するためのラベル。その他...
 
UIActivityIndicatorView * mediaLoadingIndicator
 メディアが読み込み状態にあることを示すアクティビティ インジケーター ビュー。その他...
 
UILabel * skipAdLabel
 広告がスキップ可能になるまでの残り時間を表示するラベル。その他...
 
UIButton * skipAdButton
 現在の広告をスキップするボタン。その他...
 

メソッドの詳細

- (instancetype) init

インスタンスを初期化します。

- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key 

UILabel をメタデータキーにバインドします。

ビューには、対応するメタデータ フィールドの現在の値が表示されます。

定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
- (void) bindLabel: (UILabel *)  label
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

UILabel をメタデータキーにバインドします。

ビューには、対応するメタデータ フィールドの現在の値が表示されます。

定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。

Parameters
labelThe UILabel that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key 

UITextView をメタデータキーにバインドします。

ビューには、対応するメタデータ フィールドの現在の値が表示されます。

定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
- (void) bindTextView: (UITextView *)  textView
toMetadataKey: (NSString *)  key
withFormatter: (GCKUIValueFormatter formatter 

UITextView をメタデータキーにバインドします。

ビューには、対応するメタデータ フィールドの現在の値が表示されます。

定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。

Parameters
textViewThe UITextView that will display the value.
keyThe metadata key.
formatterA block that will produce the desired string representation of the value.
- (void) bindImageView: (UIImageView *)  imageView
toImageHints: (GCKUIImageHints *)  imageHints 

UIImageViewGCKUIImageHints インスタンスにバインドします。

現在インストールされている GCKUIImagePicker は、ビューのメタデータから画像を選択するために使用されます。

Parameters
imageViewThe UIImageView that will display the selected image.
imageHintsThe image hints.
- (void) unbindView: (UIView *)  view

指定したビューをバインド解除します。

Parameters
viewThe view to unbind.
- (void) unbindAllViews

バインドされているすべてのビューをバインド解除します。

- (GCKMediaRepeatMode) cycleRepeatMode

キューの繰り返しモードを、サイクルの次のモードに変更します。

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

戻り値
新しいリピートモード。
- (void) selectTracks

メディア トラック選択 UI を表示する便利なメソッドです。

- (void) skipAd

スキップしたリクエストを送信し、モニタリングします。

シンセ
4.3

プロパティの詳細

- (id<GCKUIMediaControllerDelegate>) delegate
readwritenonatomicweak

GCKUIMediaController から通知を受け取るデリゲート。

- (GCKSession*) session
readnonatomicstrong

このコントローラに関連付けられているセッション。

- (BOOL) mediaLoaded
readnonatomicassign

レシーバに現在ロードされている(または読み込み中)メディアがあるかどうか。

アクティブなキャスト セッションがない場合、これは NO になります。

- (BOOL) hasCurrentQueueItem
readnonatomicassign

キューに現在のアイテムがあるかどうか。

- (BOOL) hasLoadingQueueItem
readnonatomicassign

キューにプリロードされたアイテムがあるかどうか。

- (GCKMediaPlayerState) lastKnownPlayerState
readnonatomicassign

最新の既知のメディア プレーヤーの状態。

アクティブなキャスト セッションがない場合、最後のセッションが完了する直前にプレーヤーの状態になります。それまでのセッションがない場合、これは GCKMediaPlayerStateUnknown になります。

- (NSTimeInterval) lastKnownStreamPosition
readnonatomicassign

最新の既知のメディア ストリーム位置。

アクティブなキャスト セッションがない場合、これは最後のセッションの終了する直前にメディアのストリーム位置になります。それまでのセッションがない場合、これは kGCKInvalidTimeInterval になります。

- (UIButton*) playButton
readwritenonatomicweak

「再生」ボタン。

ボタンをタップすると、現在読み込まれているメディアの再生がレシーバーで開始または再開されます。再生がすでに進行中の場合や、現在メディアが読み込まれていない場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UIButton*) pauseButton
readwritenonatomicweak

「一時停止」ボタン。

ボタンをタップすると、現在読み込まれているメディアの再生機能がレシーバーで一時停止します。現在読み込み中のメディアが一時停止をサポートしていない場合、再生が進行中でない場合、現在読み込まれていないメディアがある場合、または現在アクティブなキャスト セッションがない場合、ボタンは無効になります。

- (GCKUIMultistateButton*) playPauseToggleButton
readwritenonatomicweak

「再生/一時停止」の切り替えボタン。

呼び出し元は、ボタンの GCKUIButtonStatePlayGCKUIButtonStatePlayLiveGCKUIButtonStatePause の各ボタンの状態に適切なアイコンを設定する必要があります。つまり、再生状態の場合は「一時停止」アイコン、再生中状態の場合は「停止」アイコン、一時停止状態の場合は「再生」アイコンを設定する必要があります。ボタンの状態は、レシーバーの現在の再生状態を反映するように自動的に更新されます。ボタンをタップすると、レシーバーに現在読み込まれているメディアの再生が一時停止または再開されます。現在読み込まれているメディアが一時停止をサポートしていない場合、再生が進行中または一時停止していない場合、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ボタンは無効になります。

- (GCKUIPlayPauseToggleController*) playPauseToggleController
readwritenonatomicstrong

「再生/一時停止」切り替えコントローラ。

アプリ指定のカスタムの再生/一時停止切り替え UI の代わりとして使用されます。詳細については、GCKUIPlayPauseToggleController をご覧ください。

シンセ
3.4
- (UIButton*) stopButton
readwritenonatomicweak

「停止」ボタン。

ボタンをタップすると、現在読み込まれているメディアの再生機能がレシーバーで停止します。現在読み込まれていないメディアがある場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UIButton*) forward30SecondsButton
readwritenonatomicweak

現在再生中のメディア アイテムを 30 秒早送りするためのボタンです。

現在読み込まれていないメディアがある場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UIButton*) rewind30SecondsButton
readwritenonatomicweak

現在再生中のメディア アイテムで 30 秒早送りするボタン。

現在読み込まれていないメディアがある場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UIButton*) pauseQueueButton
readwritenonatomicweak

現在の項目の再生が終了した後、キューの再生を一時停止するためのボタン。

- (UIButton*) nextButton
readwritenonatomicweak

[次へ] ボタン

ボタンをタップすると、キュー内の次のメディア アイテムに移動します。操作がサポートされていない場合や、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UIButton*) previousButton
readwritenonatomicweak

「前へ」ボタン。

ボタンをタップすると、キュー内の前のメディア アイテムに移動します。操作がサポートされていない場合や、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。

- (GCKUIMultistateButton*) repeatModeButton
readwritenonatomicweak

使用可能なキューの繰り返しモードを繰り返すためのボタン。

GCKMediaRepeatMode を参照)。呼び出し元は、ボタンの GCKUIButtonStateRepeatOffGCKUIButtonStateRepeatSingleGCKUIButtonStateRepeatAllGCKUIButtonStateShuffle ボタンの状態に適切なアイコンを設定する必要があります。レシーバの現在のキューリピート モードを反映するように、ボタンの状態が自動的に更新されます。ボタンをタップすると、次の繰り返しモードに次の順序で循環します。

GCKMediaRepeatModeOffGCKMediaRepeatModeAllGCKMediaRepeatModeSingleGCKMediaRepeatModeAllAndShuffle

現在アクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UISlider*) streamPositionSlider
readwritenonatomicweak

現在のストリーム位置を表示および変更するためのスライダー。

ユーザーがスライダーの値を変更すると、レシーバで現在読み込まれているメディアのストリーム位置が更新されます。レシーバーでメディアの再生が進行中の場合、スライダーの値が現在のストリーム位置を反映してリアルタイムで更新されます。現在読み込まれているメディアがシーク再生をサポートしていない場合、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、スライダーは無効になります。

- (UIProgressView*) streamProgressView
readwritenonatomicweak

現在の配信の進捗状況を表示するビュー。

レシーバーでメディアの再生が進行中のとき、ビューの値は、現在のストリーム位置を反映してリアルタイムで更新されます。現在読み込まれているメディアがライブ ストリームである場合、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ビューは無効になります。

- (UILabel*) streamPositionLabel
readwritenonatomicweak

現在のストリーム位置を分と秒で表示するラベル。

現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ラベルにはローカライズされた形式の「--:--」が表示されます。

- (UILabel*) streamDurationLabel
readwritenonatomicweak

現在の配信時間を分と秒で表示するラベル。

現在読み込まれているメディアに再生時間がない場合(ライブ ストリームの場合など)、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ラベルにはローカライズされた形式の「--:--」が表示されます。

- (UILabel*) streamTimeRemainingLabel
readwritenonatomicweak

残りの配信時間(継続時間を引いた位置)を分と秒単位で表示するラベルです。

現在読み込まれているメディアに再生時間がない場合(ライブ ストリームの場合など)、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ラベルにはローカライズされた形式の「--:--」が表示されます。

- (GCKUIStreamPositionController*) streamPositionController
readwritenonatomicstrong

ストリーム ポジション コントローラ。

アプリ指定のカスタム ストリーム位置やシーク UI の代わりとして使用されます。詳細については、GCKUIStreamPositionController をご覧ください。

シンセ
3.4
- (GCKUIPlaybackRateController*) playbackRateController
readwritenonatomicstrong

ストリーム再生レート コントローラ。

詳細については、GCKUIPlaybackRateController をご覧ください。

シンセ
4.0
- (BOOL) displayTimeRemainingAsNegativeValue
readwritenonatomicassign

残りのストリーミング時間を負の値で表示するかどうかを指定します(例: 「-1:23:45」)。

デフォルトでは、このプロパティは YES に設定されています。

- (BOOL) hideStreamPositionControlsForLiveContent
readwritenonatomicassign

ライブ コンテンツについて、ストリーム位置コントロール(ストリーム位置スライダー、ストリーム位置ラベル、ストリーム再生時間ラベル、ストリーム進行状況ビューなど)を非表示にするかどうか。

デフォルト値は NO です。

シンセ
4.0
- (UIButton*) tracksButton
readwritenonatomicweak

音声トラックや字幕を選択するためのボタン。

ボタンをタップすると、メディア トラック選択 UI がユーザーに表示されます。現在読み込まれているメディアに選択可能なメディア トラックがない場合、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ボタンは無効になります。

- (UILabel*) smartSubtitleLabel
readwritenonatomicweak

現在読み込まれているメディアの字幕を表示するためのラベル。

メタデータに字幕フィールドを明示的に設定していない場合、メディアタイプ(映画のスタジオ名や音楽トラックのアーティスト名など)に基づいて、最適なメタデータ フィールドがラベルに表示されます。

- (UIActivityIndicatorView*) mediaLoadingIndicator
readwritenonatomicweak

メディアが読み込み状態にあることを示すアクティビティ インジケーター ビュー。

- (UILabel*) skipAdLabel
readwritenonatomicweak

広告がスキップ可能になるまでの残り時間を表示するラベル。

シンセ
4.3
- (UIButton*) skipAdButton
readwritenonatomicweak

現在の広告をスキップするボタン。

シンセ
4.3