Discoveryキュー

キューは、視聴者が好きなときにビデオ再生できるようにするためのビデオやライブストリームを集めたものです。

Discoveryキューは有効期限、再生位置(プレイヘッド、または最後に再生を止めた位置)、 その他の情報を持つアセットの一覧です。キューは、キューを表示、 操作することができる特定の視聴者が所有するものです。お客様はキューを作成する必要がありません。キューにアイテムを追加したり削除したりするだけです。
Note: Discoveryキューの必須条件は、OoyalaのRights Lockerにあります。視聴者は、キューを使用 するために、まず最初にRights Lockerから承認される必要があります。詳しくは、Rights Lockerをご覧ください。
視聴者はキューにアセットを追加できます。アイテムは次の条件のどれか一つに合うとキューに残ります。
  • 関連アセットが削除されるか、関連ライブイベントが終了して"再放送"(ライブストリームのVODバージョン)がない場合。
  • アセットのすべてを視聴できます。

視聴者のキューにアセットを追加

[PUT] /v2/discover/queue/[asset|live_asset]/asset_id 
{
        "expires_at" : "dateTimeInISO8601-UTCformat"
}    
   

キューを見る

[GET] /v2/discover/queue
   

キューからアイテムを削除

[DELETE] /v2/discover/queue/[asset|live_asset]/asset_id 
   

ルート属性

次の表はルートに表示されるすべて属性を示しています。

ルート属性 説明
[assets|live_assets] キューに追加されているアセットのタイプ

タイプ:文字列

デフォルト:なし

例:[PUT] /v2/discover/queue/viewers/54321/asset/2162e39c331d407d9176895f34e36af8

asset_id アセットID(embedコードまたはコンテンツID)キューの所有者(プロバイダー)である場合のみ、 アセットを視聴者のキューに追加(PUT)できます。

タイプ:文字列

デフォルト: なし

例: pxcm9lMzpfyOKKtj1LiplPwn3eqm67dM

クエリー文字列パラメータ

次の表はクエリー文字列のすべてのパラメータを説明しています。

パラメータ 説明 必須?
order_by

ソートするフィールド。

タイプ:文字列

デフォルト:なし

有効値:expires_at[-desc|-asc] | added_at[-desc|-asc] | now_playing | descascが昇順または降順のソートオーダーである last_watched_at[-desc|-asc]

例:[GET] /v2/discover/queue/viewers/091iut98ycbkdwp9y8fwjhk?orderby=expires_at-asc

いいえ

プロパティ

次の表はキューと関連付けることができるすべてのプロパティを示しています。

プロパティ 説明 必須?
expires_at

ISO-8601/UTC形式でアセットの有効期限日/時間

タイプ: dateTime

デフォルト:有効期限なし

例:"2014-04-15T21:00Z"

いいえ

この例は、アセット2162e39c331d407d9176895f34e36af8 を視聴者54321に関連付けられたキューに、有効期限日/時間のオプションを付けて追加します。
[PUT] /v2/discover/queue/viewers/54321/assets/54321/2162e39c331d407d9176895f34e36af8
{
  "expires_at": "2013-08-15T21:00Z",
}
    

Backlot は次のようなレスポンスを返します。

{
"added_at":1363617641
}

Sorting 試行する

この例は視聴者091iut98ycbkdwp9y8fwjhkのキューを取得します。
[GET] /v2/discover/queue/viewers/091iut98ycbkdwp9y8fwjhk
   

Backlot は次のようなレスポンスを返します。

["RsYmduMjpNE3RGHOTa6Chm-YoxArCqiw","ZoYmduMjpBbLj3QerkWScewtpPnvmOi2","pxcm9lMzpfyODDtj1LiplPwnxmqm5JdM"]

Sorting 試行 する

この記事はお役にたちましたか?