賃貸システムの概要
Playback API Webページやモバイルアプリからビデオやプレイリストのデータを取得する際のクライアントサイドの使用を目的とした低遅延APIです。 それは Studio上ではサポートされていません。 統合に使用する一般的なメディア管理API Video Cloud あなたのCMSや他のシステムでは、 CMS API.
Playback API 結果はフィルタリングされ、再生可能な動画のみが返されます(state = ACTIVE、取り込み完了フラグ= true、スケジュールされている場合は正しいデータ/時間)。 これは、 player 他のレンディションがまだ処理中である場合でも、XNUMXつのレンディションが存在するとすぐにビデオを再生できます。 現在再生できない動画を取得する必要がある場合は、もう一度 CMS API を代わりにお使いください。
パフォーマンスを最大化するために、アクセスするビデオデータは Playback API 短時間キャッシュされます。 特定のデータセットIDがキャッシュされる期間は異なりますが、最大20分かかる場合があります。
また、 APIリファレンス.
ユースケース
Brightcove Player と Brightcove SDK players の方法と同じカタログ方法を含む Playback API実行時に再生するためにビデオやプレイリストを取得するだけであれば、ほとんどの場合、それらを使用することができます。
ただし、プレーヤーを表示していないモバイルアプリの画面で動画や再生リストを表示したい場合があります。
さらに、動画や再生リストを取得して、それらに関する情報を表示したい場合があります。 player たとえば、ビデオポータルのランディングページとして。
Playback API はこれらの場合に有用です。
一般情報
ベースURL
そのベースURL Playback API 次のとおりです。
https://edge.api.brightcove.com/playback/v1
アカウントパス
すべての場合において、要求は特定の Video Cloud アカウント。 だから、あなたはいつもその言葉を追加するでしょう accounts
アカウントIDをベースURLに続けて入力します。
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}
認証
リクエストはポリシーキーによって認証され、次の3つの方法のいずれかで渡されます。
- の議論では、
Accept
ヘッダ:Accept: application/json;pk={policy_key}
これは、ブラウザベースのクライアントに推奨される方法です。これは、ブラウザのCORSの「フライト前」チェックの一環として、最初に余分な要求を行わずに要求を進めることができるためです。 これにより、ブラウザーの要求が初めて行われたときに待ち時間が節約されます。
- で
Authorization
realmキーワードを使用したヘッダーBCOV-Policy
:Authorization: BCOV-Policy {policy_key}
- で
BCOV-Policy
ヘッダ:BCOV-Policy: {policy_key}
ポリシーキーの取得
ポリシーキーを取得するには、次の3つの方法があります。
- あらゆる Brightcove player 自動的に割り当てられます。 を取得するための手順を見つけることができます playerのポリシーキー この文書。 ポリシーキーはアカウント全体で有効であるため、それが使用されているかどうかに関係なく使用できます。 player ページに埋め込まれています。
- 基本ポリシーキーを生成するには、 ポリシーキーのクイックスタート
- あなたは、 Policy API
トークン認証
HLSおよびDASHコンテンツのトークン認証がサポートされています。 トークン認証が必要な場合は、アカウントマネージャーに連絡してアカウントで有効にしてください。
ハードコードされたURLを避ける
サムネイル、ポスター、ビデオファイル、およびその他のメディアのURLは、ページやアプリケーションにハードコードされてはなりません。 ザ Playback API メディアファイルの最新のキャッシュバージョンのURLが返されますが、URL自体は変更される可能性があります。 あなたは CMS API (または Playback API )リクエストがページが読み込まれるたびにこれらのURLを取得するか、6時間を超えてキャッシュしません。
動画URLと画像URLのキャッシュ
動画や画像のURLをキャッシュしてページのパフォーマンスを向上させることはできますが、キャッシュは定期的に更新する必要があります。 ページのパフォーマンスを向上させるために取得したURLをキャッシュする場合は、少なくとも6時間に1度はAPI呼び出しを繰り返すことでキャッシュを更新してください。
メソッド
APIは、次のタイプのGETリクエストのみをサポートしています。
ビデオリクエスト
1つのビデオオブジェクトは、ビデオIDまたは参照IDのいずれかを使用して取得できます。
IDでビデオを取得する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}
例
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/38467382999
サンプルレスポンス
{
"account_id": "107767373999",
"ad_keys": null,
"created_at": "2010-07-12T22:37:34.760Z",
"description": "Avatar_MakingAScene_Featurette",
"duration": 595560,
"id": "38467382999",
"long_description": null,
"name": "Avatar_MakingAScene_Featurette",
"published_at": "2010-07-12T22:37:34.760Z",
"reference_id": "AvatarMakingShort",
"text_tracks": [],
"updated_at": "2010-07-12T22:54:29.666Z",
"cue_points": [
{
"id": "111637107001",
"name": "Pre-roll",
"type": "AD",
"time": 0,
"metadata": null,
"force_stop": false
}
],
"custom_fields": {
"moretext": "this is the first video uploaded",
"mylist": "abc"
},
"link": {
"text": "Full Dvd at Amazon",
"url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
},
"tags": [
"copied"
],
"poster_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"thumbnail_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"sources": [
{
"avg_bitrate": 379000,
"width": 320,
"duration": 595560,
"size": 28196307,
"stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728840001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 379000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 28196307,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728840001"
}, ... 6 more sources ...
]
}
参照IDでビデオを取得する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}
例
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos/ref:nature_2010-07-12
サンプルレスポンス
{
"account_id": "107767373999",
"ad_keys": null,
"created_at": "2010-07-12T22:37:34.760Z",
"description": "Avatar_MakingAScene_Featurette",
"duration": 595560,
"id": "38467382999",
"long_description": null,
"name": "Avatar_MakingAScene_Featurette",
"published_at": "2010-07-12T22:37:34.760Z",
"reference_id": "nature_2010-07-12",
"text_tracks": [],
"updated_at": "2010-07-12T22:54:29.666Z",
"cue_points": [
{
"id": "111637107001",
"name": "Pre-roll",
"type": "AD",
"time": 0,
"metadata": null,
"force_stop": false
}
],
"custom_fields": {
"moretext": "this is the first video uploaded",
"mylist": "abc"
},
"link": {
"text": "Full Dvd at Amazon",
"url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
},
"tags": [
"copied"
],
"poster_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"thumbnail_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"sources": [
{
"avg_bitrate": 379000,
"width": 320,
"duration": 595560,
"size": 28196307,
"stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728840001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 379000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 28196307,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728840001"
}, ... 6 more sources ...
]
}
動画の検索
あなたは 検索可能なポリシーキー、を使用して動画を検索するとき Playback API。 詳細については、 Playback APIリファレンス の資料をご参照ください。
パラメーター
すべてのパラメータは 任意。 彼らはに適用されます GET Videos
リクエストのみ。
パラメーター | 説明 |
---|---|
q |
検索のクエリ文字列 - 詳細は、 検索ガイド |
limit |
返されるビデオの数 - 1と100の間の整数でなければなりません。 デフォルト:20 |
offset |
スキップするビデオの数(ページング結果用)。 正の整数でなければなりません。 デフォルト:0 |
sort |
並べ替えるフィールドを指定する文字列。 で始まる - 降順をソートする。値の場合 q が提供されている場合、デフォルトのソートは「スコア」(検索結果と元のクエリの関連性)です。値がない場合 q が提供されている場合、デフォルトのソートは updated_at 降順。ソートには次のフィールドが有効です。 name , reference_id , created_at , published_at , updated_at , schedule_starts_at , schedule_ends_at , state , plays_total & plays_trailing_week 詳細については、 ビデオを入手する のセクション Playback API 参照 |
検索パラメータの使用
ブライトコーブ Playback API プログラム内で動画を検索する方法を提供します Video Cloud としょうかん。
ビデオデータの基本的な検索や複雑な検索を行うには、 q
パラメータ を使用します。
https://edge.api.brightcove.com/playback/v1/accounts/1752604051111/videos?q={search terms}
動画の検索方法の詳細については、 検索動画 の資料をご参照ください。
ページング結果
使用 limit
100までのリクエストで返すアイテムの数を指定するパラメータ。 その後、 offset
パラメータよりも大きい結果セットをページする limit
として指定することができます。 offset
スキップする項目の数です。
たとえば、次の検索では、合計結果セットに少なくとも51ビデオがあると仮定して、合計結果セットのビデオ75-75が返されます。
/videos?q=updated_at:2014-01-01..2014-06-30&limit=25&offset=50
limit
および offset
パラメータは動画にのみ使用できます。
ページングのベストプラクティス
結果セットをページングするとき Playback API次の手順を実行することをお勧めします。
- 使用
limit
およびoffset
結果セットからデータのグループを戻すためのパラメーター。/accounts/578380111111/videos?q=tags:nature&limit=20&offset=50
- それぞれの応答で、あなたは
count
フィールドには、結果セットの動画の最大数が常に表示されます。{"count": 171, "videos": [ ... ] }
- コーヒー豆の水への溶解度は平均して
count
最初のリクエストの動画を使用して、リクエストする必要のあるページ数を判断できます。
あるいは、count
それぞれのレスポンスでcount
ページサイズのlimit
.count <= page-number * limit
動画の結果を並べ替える
パラメータを使用する sort=field_name
結果をソートする方法を指定します。 次のビデオフィールドを並べ替えることができます:[1-1]
- 名
- reference_id
- created_at
- published_at
- updated_at
- schedule_starts_at(注:これは sort フィールド - 検索フィールドは
schedule.starts_at
) - schedule_ends_at(注:これは sort フィールド - 検索フィールドは
schedule.ends_at
) - 状態
- plays_total[1-2]
- plays_trailing_week[1-2]
ノート
- [1-1] ビデオ検索呼び出しにソート値を指定しないと、結果は関連性によってソートされます。 ソート値を指定しないと
GET
ビデオが呼び出されると、結果はupdated_at
降順。 - [1-2] 並べ替えることができます
plays_total
orplays_trailing_week
これらのフィールドは結果に含まれません
すべての動画と大きなデータセット
アカウント内のすべての動画や多数の動画を取得する場合は、次の点に注意する必要があります。
- 許可されている最大のものを使用するように誘惑されるかもしれません
limit
(100)ですが、25以下のバッチで動画を取得する方が、APIリクエストがタイムアウトする可能性を最小限に抑えることができます - 大量のデータセットをページングしているとき、操作中にビデオデータが更新される可能性があります。そのため、アイテムのレスポンスが変化する可能性があります。
- 連続したページで項目が繰り返されることがあります
- 前の応答セットに移動したため、アイテムが見逃されることがあります
最初の可能性を考慮すると、動画の取得が完了した後に、アプリは完全なアイテムリストを重複排除する必要があります。 2つ目の可能性を処理するには、取得した項目の総数(期待していた数)を比較し、次にリクエストを再実行し、結果をlast_modified_date(降順)でソートする必要があります。 1つ以上のバッチを取り出して欠落したアイテムを取り出す。
- 返された結果を適切にソートすることで、前の項目のシナリオの可能性を減らすことができます。 デフォルトのソート順は 関連性 キーワード、タグ、およびカスタムフィールド値の組み合わせを探す複雑なアルゴリズムに基づいています。 複数のキーワード、タグ、および/またはカスタムフィールドに基づいて動画を検索している場合、関連性によるソートはまさにあなたが望むものです。 ただし、すべての動画や大量の動画を取得しようとしているだけの場合は、
sort
パラメータを明示的に指定すると、返される項目の順序をより詳細に制御できます。
ビデオを入手する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos
例
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/videos?q=tags:nature,name:nature
サンプルレスポンス
{
"count": 123,
"videos":
[
{<video1 fields>},
{<video2 fields>},
...
]
}
エラー応答
検索キーではないポリシーキーを使用してビデオを取得しようとすると、次のエラーメッセージが表示されます。 Playback API:
[
{
"api_call": "search",
"error_subcode": "API",
"error_code": "ACCESS_DENIED",
"message": "Access to this resource is forbidden by access policy."
}
]
関連動画を探す
Playback API 指定した動画に関連する動画をアカウントで検索できます。 に基づく name
および short description
APIは指定された動画の次のフィールドで部分一致を検索します:
name
short description
long description
tags
地域制限が有効な場合、結果の全ページを受け取ることはできません。
パラメーター
GET関連の動画リクエストには、次のURLパラメータを使用できます。
パラメーター | 説明 |
---|---|
limit |
返す動画の数(デフォルト= 20、最大= 100) |
ad_config_id |
返品するad_config_idを追加する SSAIの動画 |
デフォルトでは、レスポンスには20までの動画が含まれます。 あなたは limit
パラメータを使用して、最大100の動画に戻すことができます。また、レイテンシが増加します。
注目すべきは、 offset
パラメータを使用すると、関連する動画を見つけることができます。そのため、動画の検索結果を表示することはできません。
動画IDを使用して関連動画を取得する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}/related
例
https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001/related
参照IDを使用して関連動画を取得する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/ref:{reference_id}/related
例
https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/ref:nature/related
サンプルレスポンス
以下のレスポンスでは、 count
フィールドとは異なり、 動画を検索 応答。
{
"videos":
[
{<video1 fields>},
{<video2 fields>},
...
]
}
エラー応答
検索に関連しないポリシーキーを使用して関連エンドポイントを検索しようとすると、次のエラーメッセージが表示されます。 Playback API:
[
{
"api_call": "search",
"error_subcode": "API",
"error_code": "ACCESS_DENIED",
"message": "Access to this resource is forbidden by access policy."
}
]
SSAIによるビデオリクエスト
Brightcove Webを使用していない場合でも player またはアプリケーションでBrightcove Native SDKを使用している場合でも、独自のサーバーサイド広告挿入(SSAI)を使用できます。 player.
SSAIでビデオを入手する
SSAIで動画を返信するには、広告設定IDをURLパラメータとして Playback API 要求。 このリクエストでは、動画IDまたは動画参照IDのいずれかを使用できます。
エンドポイントURLパラメータ
追加する ad_config_id
の終わりまで Playback API リクエスト:
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/videos/{video_id}?ad_config_id={ad_config_id}
例
https://edge.api.brightcove.com/playback/v1/accounts/1752604059001/videos/5565662146001?ad_config_id=1234abcd
以下のサンプルレスポンスでは、次のことに気づくでしょう:
- この応答は、広告の設定IDを含めなかった場合と同様です。
- の要素
sources
配列には、vmap
. - コンテンツ内の広告の場所を知りたい場合は、リンク先のVMAPファイルを読むことができます。
vmap
プロパティ。 -
src
内のプロパティsources
配列には、HLSまたはDASHソースへのURLが含まれます。 これは、広告設定IDが使用されていない場合の応答と同じですが、src
メインコンテンツにスティッチされた広告が表示されます。
サンプルレスポンス
{
"description": "The story of a giant rabbit with a heart bigger than himself. ",
"poster_sources": [
{
"src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/3723496277001/dd5bd69c-e962-4a43-9dbd-94faaaba1785/main/1280x720/5m17s130ms/match/image.jpg"
}
],
"tags": [],
"cue_points": [],
"custom_fields": {},
"account_id": "3723496277001",
"sources": [
{
"ext_x_version": "4",
"vmap": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/vmap/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/content.vmap?bc_token=NTllMTMxYjNfMTdkOTY2YThhNjU5MDk5ZTQ3NDBkNmUxOTYyOGRkNzM0ZjBiM2RjMGEwOThjOGFkYjk1MWQxMzFmNGYzMjA5YQ%3D%3D",
"type": "application/x-mpegURL",
"src": "http://ssaiplayback.prod.boltdns.net/playback/once/v1/hls/v4/clear/3723496277001/7a3316d9-1b06-4d62-bec8-3919b43fffbb/dd5bd69c-e962-4a43-9dbd-94faaaba1785/master.m3u8?bc_token=NTllMTMxYjNfZGM5ZDg0NGM2ZGJjZDcxZTFjOGYyODBlMzM2NmNmMmJkMWNhZDczNWViNzRiMjIwNjg5MjkzZGM0ZmJlMTc1Yw%3D%3D"
},
...
],
"created_at": "2017-05-15T17:09:11.171Z"
}
ad_config_idを要求する
使い方 Policy APIポリシーキーを作成すると、 ad_config_id
リクエストを行う際のURLパラメータ Playback API。 この機能の設定の詳細については、 Policy API 参照 の資料をご参照ください。
ポリシーキーが要求するように設定されている場合 ad_config_id
、あなたはそれを Playback API 次のエラーが表示されます。
[
{
"error_subcode": "AD_CONFIG",
"error_code": "ACCESS_DENIED",
"message": "Missing required ad_config_id parameter"
}
]
プレイリストリクエスト
プレイリストビデオオブジェクトは、プレイリストIDまたはその参照IDのいずれかを使用して取得できます。
パラメーター
次のURLパラメータは、プレイリスト要求に使用できます
パラメーター | 説明 |
---|---|
制限 | 返す動画の数(デフォルト= 20、最大= 100) |
オフセット | スキップする動画の数(プレイリストの先頭から、デフォルト= 0) |
たとえば、リクエストに追加されたこれらのパラメータ(?limit = 40&offset = 20)は、プレイリストに21〜60本の動画を返します(その数が多いと仮定します)。
IDで再生リストを取得する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/{playlist_id}
例
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/38467382999
サンプルレスポンス
{
"account_id": "107767373999",
"created_at": "2010-07-12T22:43:30.290Z",
"description": null,
"id": "111592530001",
"name": "Play One",
"reference_id": null,
"type": "EXPLICIT",
"updated_at": "2010-07-12T22:51:25.055Z",
"videos": [
{
"description": "Avatar_MakingAScene_Featurette",
"poster_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"tags": [
"copied"
],
"cue_points": [
{
"id": "111637107001",
"name": "Pre-roll",
"type": "AD",
"time": 0,
"metadata": null,
"force_stop": false
}
],
"custom_fields": {
"moretext": "this is the first video uploaded",
"mylist": "abc"
},
"account_id": "107767373999",
"sources": [
{
"avg_bitrate": 379000,
"width": 320,
"duration": 595560,
"size": 28196307,
"stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728840001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 379000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 28196307,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728840001"
},
{
"avg_bitrate": 267000,
"width": 320,
"duration": 595560,
"size": 19894997,
"stream_name": "mp4:107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728852001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 267000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 19894997,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728852001"
},
{
"avg_bitrate": 549000,
"width": 480,
"duration": 595567,
"size": 40889436,
"stream_name": "mp4:107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728860001",
"container": "MP4",
"height": 268,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 549000,
"width": 480,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 40889436,
"height": 268,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111728860001"
},
{
"avg_bitrate": 835000,
"width": 640,
"duration": 595567,
"size": 62142992,
"stream_name": "mp4:107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728865001",
"container": "MP4",
"height": 360,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 835000,
"width": 640,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 62142992,
"height": 360,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111728865001"
},
{
"avg_bitrate": 1744000,
"width": 640,
"duration": 595567,
"size": 129836869,
"stream_name": "mp4:107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111735357001",
"container": "MP4",
"height": 360,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 1744000,
"width": 640,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 129836869,
"height": 360,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111735357001"
},
{
"avg_bitrate": 1249000,
"width": 640,
"duration": 595567,
"size": 92994065,
"stream_name": "mp4:107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111735369001",
"container": "MP4",
"height": 360,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 1249000,
"width": 640,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 92994065,
"height": 360,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111735369001"
}
],
"name": "Avatar_MakingAScene_Featurette",
"reference_id": "AvatarMakingShort",
"long_description": null,
"duration": 595560,
"published_at": "2010-07-12T22:37:34.760Z",
"text_tracks": [],
"updated_at": "2010-07-12T22:54:29.666Z",
"thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"link": {
"text": "Full Dvd at Amazon",
"url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
},
"id": "38467382999",
"ad_keys": null,
"thumbnail_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"created_at": "2010-07-12T22:37:34.760Z"
}
],
}
参照IDでプレイリストを取得する
エンドポイント
https://edge.api.brightcove.com/playback/v1/accounts/{account_id}/playlists/ref:{reference_id}
例
https://edge.api.brightcove.com/playback/v1/accounts/57838016001/playlists/ref:nature_2010-07-12
サンプルレスポンス
{
"account_id": "107767373999",
"created_at": "2010-07-12T22:43:30.290Z",
"description": null,
"id": "111592530001",
"name": "Play One",
"reference_id": nature_2010-07-12,
"type": "EXPLICIT",
"updated_at": "2010-07-12T22:51:25.055Z",
"videos": [
{
"description": "Avatar_MakingAScene_Featurette",
"poster_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"tags": [
"copied"
],
"cue_points": [
{
"id": "111637107001",
"name": "Pre-roll",
"type": "AD",
"time": 0,
"metadata": null,
"force_stop": false
}
],
"custom_fields": {
"moretext": "this is the first video uploaded",
"mylist": "abc"
},
"account_id": "107767373999",
"sources": [
{
"avg_bitrate": 379000,
"width": 320,
"duration": 595560,
"size": 28196307,
"stream_name": "mp4:107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728840001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 379000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728840001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 28196307,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728840001"
},
{
"avg_bitrate": 267000,
"width": 320,
"duration": 595560,
"size": 19894997,
"stream_name": "mp4:107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728852001",
"container": "MP4",
"height": 180,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 267000,
"width": 320,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728852001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 19894997,
"height": 180,
"duration": 595560,
"container": "MP4",
"codec": "H264",
"asset_id": "111728852001"
},
{
"avg_bitrate": 549000,
"width": 480,
"duration": 595567,
"size": 40889436,
"stream_name": "mp4:107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728860001",
"container": "MP4",
"height": 268,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 549000,
"width": 480,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728860001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 40889436,
"height": 268,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111728860001"
},
{
"avg_bitrate": 835000,
"width": 640,
"duration": 595567,
"size": 62142992,
"stream_name": "mp4:107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111728865001",
"container": "MP4",
"height": 360,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 835000,
"width": 640,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111728865001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 62142992,
"height": 360,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111728865001"
},
{
"avg_bitrate": 1744000,
"width": 640,
"duration": 595567,
"size": 129836869,
"stream_name": "mp4:107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111735357001",
"container": "MP4",
"height": 360,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 1744000,
"width": 640,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735357001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 129836869,
"height": 360,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111735357001"
},
{
"avg_bitrate": 1249000,
"width": 640,
"duration": 595567,
"size": 92994065,
"stream_name": "mp4:107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?__nn__=1497926354001&slist=107767373999/&auth=daEciavcicRbhbtdSaBdBdVbXd0aUdTcMaX-bvRrSa-hca-slyCzrux_zJAq_HFCB_EvE&aifp=bcosuds",
"codec": "H264",
"asset_id": "111735369001",
"container": "MP4",
"height": 360,
"app_name": "rtmp://cp150446.edgefcs.net/ondemand"
},
{
"avg_bitrate": 1249000,
"width": 640,
"src": "http://uds.ak.o.brightcove.com/107767373999/107767373999_111735369001_Avatar-MakingAScene-Featurette.mp4?pubId=107767373999&videoId=38467382999",
"size": 92994065,
"height": 360,
"duration": 595567,
"container": "MP4",
"codec": "H264",
"asset_id": "111735369001"
}
],
"name": "Avatar_MakingAScene_Featurette",
"reference_id": "AvatarMakingShort",
"long_description": null,
"duration": 595560,
"published_at": "2010-07-12T22:37:34.760Z",
"text_tracks": [],
"updated_at": "2010-07-12T22:54:29.666Z",
"thumbnail": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"poster": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728861001_vs-111727994001.jpg?pubId=107767373999&videoId=38467382999",
"link": {
"text": "Full Dvd at Amazon",
"url": "http://www.amazon.com/Avatar-Sam-Worthington/dp/B002VPE1AW"
},
"id": "38467382999",
"ad_keys": null,
"thumbnail_sources": [
{
"src": "http://brightcove04.o.brightcove.com/107767373999/107767373999_111728862001_th-111727994001.jpg?pubId=107767373999&videoId=38467382999"
}
],
"created_at": "2010-07-12T22:37:34.760Z"
}
],
}
キャプション機能は
クローズドキャプションは、ビデオにアクセスしたい人のために、ビデオに関する追加情報を提供します。 キャプションは、あなたのビデオのオーディオ部分にアクセスするために聴覚障害者や聴覚障害者にとって必要です。 キャプションが初めての方は、 概要:ビデオにキャプションを追加する の資料をご参照ください。
外部WebVTT
外部WebVTTキャプションは、ビデオとは別のテキストファイルです。 次のようにキャプションファイルをビデオに関連付けることができます。
サンプルレスポンス
以下は、 Playback API WebVTTキャプションファイルがMediaモジュールを使用してビデオに追加されています。 テキストトラック src
プロパティは外部キャプションファイルをポイントします。
{
"text_tracks": [
{
"mime_type": null,
"account_id": "20318290001",
"default": true,
"sources": [
{
"src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856"
}
],
"src": "https://static.3playmedia.com/p/files/2240988/threeplay_transcripts/6418302.vtt?project_id=10127&format_id=51&refresh=1515241856",
"asset_id": null,
"label": "English",
"id": "13d66def-d004-4e75-b160-4ac693eff7d7",
"kind": "captions",
"srclang": "en"
}
],
}
インマニフェストWebVTT
マニフェスト内のWebVTTキャプションは、あなたのビデオと共に取り込まれます。 これは、動画を最初に取り込んだとき、または動画が取り込まれた後に行うことができます。 次のように、マニフェスト内のキャプションを作成できます。
サンプルレスポンス
以下は、 Playback API ここで、WebVTTキャプションファイルがDynamic IngestAPIを使用してビデオに追加されています。 テキストトラックに注意してください src
プロパティは内部のBrightcoveファイルを指します。
{
"text_tracks": [
{
"mime_type": "text/webvtt",
"account_id": "1752604059001",
"default": false,
"sources": [
{
"src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
},
{
"src": "https://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173"
}
],
"src": "http://bcboltbde696aa-a.akamaihd.net/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt?akamai_token=exp=1518032480~acl=/media/v1/text/vtt/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/text.vtt*~hmac=5aa9f206a8e970efb4cab95278e2e9b16a29b3ccf82951a91245352d9149b173",
"asset_id": null,
"label": "EN",
"id": "92cb36a7-c836-4506-a87f-f649316c0cdf",
"kind": "captions",
"in_band_metadata_track_dispatch_type": "",
"srclang": "en"
}
],
}
マニフェスト
HLSまたはDASHビデオファイルのマニフェストには、WebVTTキャプションを含めるために必要な情報も含まれています。
HLS
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="audio-0",NAME="en (Main)",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/8b12c808-c5ea-47f3-abfa-c23b023db297/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfNzAwNTczOWM4MWQ4Mzk2NjFkYjVjYmFhYjQwNzY2MWUzM2MyNDM5ZDA5ZGExYTFkMzRmYzA0MDdhOTlmZWJhMw%3D%3D"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subtitles-0",NAME="EN",DEFAULT=YES,AUTOSELECT=YES,LANGUAGE="en",URI="https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf/rendition.m3u8?fastly_token=NWE3YjU3ZThfNDYzOThkZGJiZTU1NTlhOTdkYzA5OTA3M2UzZGRlYTgzMmRkZmUxMGIxYTJkY2Y5ZDQ1ODFiNTEyMmNiZDVhMw%3D%3D"
#EXT-X-STREAM-INF:PROGRAM-ID=0,BANDWIDTH=519200,CODECS="mp4a.40.2,avc1.420015",RESOLUTION=480x270,AUDIO="audio-0",CLOSED-CAPTIONS=NONE,SUBTITLES="subtitles-0"
https://manifest.prod.boltdns.net/manifest/v1/hls/v4/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/5f7850d9-9a65-4eee-8810-86a1e18e05fb/10s/rendition.m3u8?fastly_token=NWE3YjU3ZThfY2Q5YmE2ODc2OWFiNTgyZjUxMjc1MzRhNmQxMzA0ZmJmY2RlMGU4ZjBiNDExZGRmNjc3YjQ0OGQ5N2RiOTVmMA%3D%3D
ダッシュ
<AdaptationSet mimeType="text/vtt" lang="en">
<Representation bandwidth="256" id="92cb36a7-c836-4506-a87f-f649316c0cdf">
<BaseURL>http://bcboltbde696aa-a.akamaihd.net/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a/92cb36a7-c836-4506-a87f-f649316c0cdf.vtt?akamai_token=exp=1518032494~acl=/media/v1/dash/live/clear/1752604059001/3585c49a-5a95-4783-8625-e3af727d094a*~hmac=3e2edc412c273f1255f2c18bbbcee7afc6a2edb74573f9295b0f05feda69f0e2</BaseURL>
</Representation>
</AdaptationSet>