概要
キャスト レシーバーでのメディア再生のステータスを制御または表示するために使用される 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: |
| UIImageView を GCKUIImageHints インスタンスにバインドします。その他... | |
| (void) | - unbindView: |
| 指定したビューをバインド解除します。その他... | |
| (void) | - unbindAllViews |
| バインドされているすべてのビューをバインド解除します。その他... | |
| (GCKMediaRepeatMode) | - cycleRepeatMode |
| サイクルのキューの繰り返しモードを、次のモードに変更します: 展開... | |
| (void) | - selectTracks |
| メディア トラック選択 UI を表示する便利なメソッドです。その他... | |
プロパティの概要 | |
| id< GCKUIMediaControllerDelegate > | delegate |
| GCKUIMediaController から通知を受け取るデリゲート。その他... | |
| GCKSession * | session |
| このコントローラに関連付けられているセッション。その他... | |
| BOOL | mediaLoaded |
| レシーバに現在ロードされている（または読み込み中）メディアがあるかどうか。その他... | |
| BOOL | hasCurrentQueueItem |
| キューに現在のアイテムがあるかどうか。その他... | |
| BOOL | hasLoadingQueueItem |
| キューにプリロードされたアイテムがあるかどうか。その他... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| 最新の既知のメディア プレーヤーの状態。その他... | |
| NSTimeInterval | lastKnownStreamPosition |
| 最新の既知のメディア ストリーム位置。その他... | |
| UIButton * | playButton |
| 「再生」ボタン。その他... | |
| UIButton * | pauseButton |
| 「一時停止」ボタン。その他... | |
| GCKUIButton * | playPauseToggleButton |
| 「再生/一時停止」の切り替えボタン。その他... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| 「再生/一時停止」切り替えコントローラ。その他... | |
| UIButton * | stopButton |
| 「停止」ボタン。その他... | |
| GCKUIButton * | forward30SecondsButton |
| 現在再生中のメディア アイテムを 30 秒早送りするためのボタンです。その他... | |
| GCKUIButton * | rewind30SecondsButton |
| 現在再生中のメディア アイテムで 30 秒早送りするボタン。その他... | |
| UIButton * | pauseQueueButton |
| 現在の項目の再生が終了した後、キューの再生を一時停止するためのボタン。その他... | |
| UIButton * | nextButton |
| [次へ] ボタンその他... | |
| UIButton * | previousButton |
| 「前へ」ボタン。その他... | |
| GCKUIButton * | repeatModeButton |
| 使用可能なキューの繰り返しモードを繰り返すためのボタン。その他... | |
| UISlider * | streamPositionSlider |
| 現在のストリーム位置を表示および変更するためのスライダー。その他... | |
| UIProgressView * | streamProgressView |
| 現在の配信の進捗状況を表示するビュー。その他... | |
| UILabel * | streamPositionLabel |
| 現在のストリーム位置を分と秒で表示するラベル。その他... | |
| UILabel * | streamDurationLabel |
| 現在の配信時間を分と秒で表示するラベル。その他... | |
| UILabel * | streamTimeRemainingLabel |
| 残りの配信時間（継続時間を引いた位置）を分と秒単位で表示するラベルです。その他... | |
| GCKUIStreamPositionController * | streamPositionController |
| ストリーム ポジション コントローラ。その他... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| 残りのストリーミング時間を負の値で表示するかどうかを指定します（例: 「-1:23:45」）。その他... | |
| UIButton * | tracksButton |
| 音声トラックや字幕を選択するためのボタン。その他... | |
| UILabel * | smartSubtitleLabel |
| 現在読み込まれているメディアの字幕を表示するためのラベル。その他... | |
| UIActivityIndicatorView * | mediaLoadingIndicator |
| メディアが読み込み状態にあることを示すアクティビティ インジケーター ビュー。その他... | |
メソッドの詳細
| - (instancetype) init |
インスタンスを初期化します。
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
UILabel をメタデータキーにバインドします。
ビューには、対応するメタデータ フィールドの現在の値が表示されます。
定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。
- Parameters
-
label The UILabel that will display the value. key The metadata key.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
UILabel をメタデータキーにバインドします。
ビューには、対応するメタデータ フィールドの現在の値が表示されます。
定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。
- Parameters
-
label The UILabel that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
UITextView をメタデータキーにバインドします。
ビューには、対応するメタデータ フィールドの現在の値が表示されます。
定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。
- Parameters
-
textView The UITextView that will display the value. key The metadata key.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
UITextView をメタデータキーにバインドします。
ビューには、対応するメタデータ フィールドの現在の値が表示されます。
定義済みのメタデータキーのリストについては、GCKMediaMetadata をご覧ください。
- Parameters
-
textView The UITextView that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindImageView: | (UIImageView *) | imageView | |
| toImageHints: | (GCKUIImageHints *) | imageHints | |
UIImageView を GCKUIImageHints インスタンスにバインドします。
現在インストールされている UIImagePicker を使用して、ビューのメタデータから画像が選択されます。
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) unbindView: | (UIView *) | view |
指定したビューをバインド解除します。
- Parameters
-
view The view to unbind.
| - (void) unbindAllViews |
バインドされているすべてのビューをバインド解除します。
| - (GCKMediaRepeatMode) cycleRepeatMode |
キューの繰り返しモードを、サイクルの次のモードに変更します。
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- 戻り値
- 新しいリピートモード。
| - (void) selectTracks |
メディア トラック選択 UI を表示する便利なメソッドです。
プロパティの詳細
|
readwritenonatomicweak |
GCKUIMediaController から通知を受け取るデリゲート。
|
readnonatomicstrong |
このコントローラに関連付けられているセッション。
|
readnonatomicassign |
レシーバに現在ロードされている（または読み込み中）メディアがあるかどうか。
アクティブなキャスト セッションがない場合、これは NO になります。
|
readnonatomicassign |
キューに現在のアイテムがあるかどうか。
|
readnonatomicassign |
キューにプリロードされたアイテムがあるかどうか。
|
readnonatomicassign |
最新の既知のメディア プレーヤーの状態。
アクティブなキャスト セッションがない場合、最後のセッションが完了する直前にプレーヤーの状態になります。それまでのセッションがない場合、これは GCKMediaPlayerStateUnknown になります。
|
readnonatomicassign |
最新の既知のメディア ストリーム位置。
アクティブなキャスト セッションがない場合、これは最後のセッションの終了する直前にメディアのストリーム位置になります。それまでのセッションがない場合、これは kGCKInvalidTimeInterval になります。
|
readwritenonatomicweak |
「再生」ボタン。
ボタンをタップすると、現在読み込まれているメディアの再生がレシーバーで開始または再開されます。再生がすでに進行中の場合や、現在メディアが読み込まれていない場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
「一時停止」ボタン。
ボタンをタップすると、現在読み込まれているメディアの再生機能がレシーバーで一時停止します。現在読み込み中のメディアが一時停止をサポートしていない場合、再生が進行中でない場合、現在読み込まれていないメディアがある場合、または現在アクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
「再生/一時停止」の切り替えボタン。
呼び出し元は、ボタンの GCKUIControlStatePlay と GCKUIControlStatePause の状態に適したアイコンを設定する必要があります。つまり、再生状態の場合は「一時停止」アイコン、一時停止状態の場合は「再生」アイコンを設定する必要があります。ボタンの状態は、レシーバーの現在の再生状態を反映するように自動的に更新されます。ボタンをタップすると、レシーバーに現在読み込まれているメディアの再生が一時停止または再開されます。現在読み込まれているメディアが一時停止をサポートしていない場合、再生が進行中または一時停止していない場合、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicstrong |
「再生/一時停止」切り替えコントローラ。
アプリ指定のカスタムの再生/一時停止切り替え UI の代わりとして使用されます。詳細については、GCKUIPlayPauseToggleController をご覧ください。
- シンセ
- 3.4
|
readwritenonatomicweak |
「停止」ボタン。
ボタンをタップすると、現在読み込まれているメディアの再生機能がレシーバーで停止します。現在読み込まれていないメディアがある場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
現在再生中のメディア アイテムを 30 秒早送りするためのボタンです。
現在読み込まれていないメディアがある場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
現在再生中のメディア アイテムで 30 秒早送りするボタン。
現在読み込まれていないメディアがある場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
現在の項目の再生が終了した後、キューの再生を一時停止するためのボタン。
|
readwritenonatomicweak |
[次へ] ボタン
ボタンをタップすると、キュー内の次のメディア アイテムに移動します。操作がサポートされていない場合や、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
「前へ」ボタン。
ボタンをタップすると、キュー内の前のメディア アイテムに移動します。操作がサポートされていない場合や、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
使用可能なキューの繰り返しモードを繰り返すためのボタン。
（GCKMediaRepeatMode を参照）。呼び出し元は、ボタンの UIControlStateNormal（繰り返しオフ）、GCKUIControlStateRepeatSingle、GCKUIControlStateRepeatAll、GCKUIControlStateShuffle の状態に対して適切なアイコンを設定する必要があります。レシーバの現在のキューリピート モードを反映するように、ボタンの状態は自動的に更新されます。ボタンをタップすると、次の繰り返しモードに次の順序で循環します。
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
現在アクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
現在のストリーム位置を表示および変更するためのスライダー。
ユーザーがスライダーの値を変更すると、レシーバで現在読み込まれているメディアのストリーム位置が更新されます。レシーバーでメディアの再生が進行中の場合、スライダーの値が現在のストリーム位置を反映してリアルタイムで更新されます。現在読み込まれているメディアがシーク再生をサポートしていない場合、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、スライダーは無効になります。
|
readwritenonatomicweak |
現在の配信の進捗状況を表示するビュー。
レシーバーでメディアの再生が進行中のとき、ビューの値は、現在のストリーム位置を反映してリアルタイムで更新されます。現在読み込まれているメディアがライブ ストリームである場合、現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ビューは無効になります。
|
readwritenonatomicweak |
現在のストリーム位置を分と秒で表示するラベル。
現在読み込まれているメディアがない場合、またはアクティブなキャスト セッションがない場合、ラベルにはローカライズされた形式の「--:--」が表示されます。
|
readwritenonatomicweak |
現在の配信時間を分と秒で表示するラベル。
現在読み込まれているメディアに再生時間がない場合（ライブ ストリームの場合など）、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ラベルにはローカライズされた形式の「--:--」が表示されます。
|
readwritenonatomicweak |
残りの配信時間（継続時間を引いた位置）を分と秒単位で表示するラベルです。
現在読み込まれているメディアに再生時間がない場合（ライブ ストリームの場合など）、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ラベルにはローカライズされた形式の「--:--」が表示されます。
|
readwritenonatomicstrong |
ストリーム ポジション コントローラ。
アプリ指定のカスタム ストリーム位置やシーク UI の代わりとして使用されます。詳細については、GCKUIStreamPositionController をご覧ください。
- シンセ
- 3.4
|
readwritenonatomicassign |
残りのストリーミング時間を負の値で表示するかどうかを指定します（例: 「-1:23:45」）。
デフォルトでは、このプロパティは YES に設定されています。
|
readwritenonatomicweak |
音声トラックや字幕を選択するためのボタン。
ボタンをタップすると、メディア トラック選択 UI がユーザーに表示されます。現在読み込まれているメディアに選択可能なメディア トラックがない場合、現在読み込まれているメディアがない場合、現在アクティブなキャスト セッションがない場合、ボタンは無効になります。
|
readwritenonatomicweak |
現在読み込まれているメディアの字幕を表示するためのラベル。
メタデータに字幕フィールドを明示的に設定していない場合、メディアタイプ（映画のスタジオ名や音楽トラックのアーティスト名など）に基づいて、最適なメタデータ フィールドがラベルに表示されます。
|
readwritenonatomicweak |
メディアが読み込み状態にあることを示すアクティビティ インジケーター ビュー。