クラス: QueueLoadRequestData

コンストラクタ

QueueLoadRequestData(キュー読み込みリクエスト データ)

新しい QueueLoadRequestData(items)

パラメータ

items

null 以外の cast.framework.messages.QueueItem の配列

キュー アイテムのリスト。商品アイテムの itemId フィールドは空にする必要があります。指定しない場合、リクエストは INVALID_PARAMS エラーで失敗します。並べ替えられます(最初の要素が最初に再生されます)。

値を null にすることはできません。

拡張
cast.framework.messages.RequestData

プロパティ

currentTime

(数値または未定義)

コンテンツの最初の時点から再生する最初のアイテムまでの秒数。指定すると、QueueItem レベルで指定した startTime 値よりも優先されますが、これは初めてアイテムが再生されたときだけです。これは、ユーザーがローカルで再生していたアイテムをキャストする場合に共通するケースです。そのため、QueueItem の startTime と同様に、currentTime がアイテムに永続的に適用されることはありません。startTime を動的にリセットする必要はありません(スマートフォンがスリープ状態になった場合はリセットできない可能性があります)。

カスタムデータ

(null 以外のオブジェクトや未定義)

このリクエストのアプリケーション固有のデータ。これによって、送信者と受信者は、カスタム メッセージで新しい名前空間を使用することなく、メディア プロトコルを簡単に拡張できます。

継承元
cast.framework.messages.RequestData#customData

items

非 null の cast.framework.messages.QueueItem の配列

キュー項目の配列。並べ替えられます(最初の要素が最初に再生されます)。

mediaSessionId

(数値または未定義)

リクエストが適用されるメディア セッションの ID。

継承元
cast.framework.messages.RequestData#mediaSessionId

リピートモード

cast.framework.messages.RepeatMode または未定義)

すべてのアイテムが再生されたときのキューの動作。

requestId

数値

リクエストの ID。リクエスト/レスポンスを関連付けるために使用されます。

継承元
cast.framework.messages.RequestData#requestId

シーケンス番号

(数値または未定義)

すべてのキューコマンドを同期する番号。キューコマンドに指定されている場合、SDK はキューの最新シーケンス番号がリクエストと一致することを確認します。現在のシーケンス番号は、送信キューの変更メッセージの一部として提供されます。

継承元
cast.framework.messages.RequestData#sequenceNumber

startIndex

(数値または未定義)

items 配列内のアイテムのインデックス。最初の currentItem(最初に再生されるアイテム)である必要があります。これは配列のインデックス(0 から始まります)であり、itemId ではありません(キューが作成されるまで不明なため)。repeatMode が REPEAT_OFF の場合、配列の最後の項目が再生されたときに終了します(startIndex の前の要素は再生されません)。これは、ユーザーがすでに送信側アプリを使用していて、途中でキャストすることを決定する場合に役立ちます。この方法で、送信者アプリはローカルとリモートのキュー位置間でマッピングしたり、追加の QUEUE_UPDATE リクエストを保存したりする必要はありません。