はじめに
アカウントのすべての取り込みプロファイルを取得するのは簡単です。APIを呼び出すだけです。それほど単純ではないのは、それらを使って何をするかです。ある種のアプリでユーザーにプロファイルを表示して、ユーザーが動画を取り込むときに選択する場合は、注意して対処する必要のある潜在的な問題がいくつかあります。これらの問題は、Brightcoveがすべてのアカウントをから移行しているという事実を中心に展開しています従来の取り込みシステム新しいに動的配信。ダイナミックデリバリーシステムの利点についてのすべてを読むことができますこの概要 ;ここで重要なのは、古いアカウントへの影響です。
- 2017年11月より前に作成されたアカウントの場合、アカウントは元々従来の取り込みシステム
- アカウントの場合していませんまだ動的配信に変換されていますが、動的配信プロファイルはアカウントに設定されており、Ingest ProfilesAPIがそれらを返します。Dynamic Ingest APIを使用しているときにユーザーがこれらのプロファイルを使用しようとすると、エラーが返されます。
- アカウントの場合持っている動的配信に変換されましたが、レガシー取り込みは無効にされていません。レガシー取り込みプロファイルは引き続き返されます。これらは通常使用すべきではなく、できません動的配信に変換されたビデオの操作に使用されます。
- 現在のプロファイルに加えて、レガシーの取り込みプロファイルを取得すると、いくつかのプロファイルが取得されます。廃止一部の顧客がまだそれらを使用しているためにシステムに保持されたプロファイル。これらはすべきです決して利用される。
- レガシープロファイルには、ライブストリーミング用に最大3つのプロファイルが含まれる場合があります。これらのプロファイルは、通常、VODコンテンツの取り込みには使用しないでください。
- 最後に、動的配信専用に構成されているアカウントの場合、返される可能性のある動的配信プロファイルには次の2種類があります。
- 「静的」プロファイル-固定されたレンディションのセットを持つ通常の種類
- を使用する「動的」プロファイルコンテキストアウェアエンコーディング(CAE)プロファイルに設定された制約内で作成するレンディションの最適なセットを自動的に決定します。
このサンプルの目的は、アカウントプロファイルを取得して、さまざまなタイプの結果をフィルタリングする方法と、アカウントで作成されたカスタムプロファイルの両方を示すことです。
資格情報を取得する
Ingest Profiles API を使用するには、適切な認証情報が必要です。
ほとんどの場合、資格情報を取得する最も簡単な方法は、Studioの管理API認証セクションを使用することです(アカウントに対する管理者権限が必要です)。詳細については、「 API 認証資格情報の管理」を参照してください。ほとんどの場合、すべての取り込みプロファイル API 操作のアクセス許可を取得したいだけです。

必要な権限が Studio で使用できない場合、または OAuth API から直接取得する場合は、以下に示す [ クライアント認証情報の取得 ] ドキュメントを選択します。どちらのオプションを選択しても、正しい操作権限を要求する必要があります。以下を cURL または Postman で使用して、取り込みプロファイル API のすべての権限を取得できます。
"operations": [
"video-cloud/ingest-profiles/profile/read",
"video-cloud/ingest-profiles/profile/write",
"video-cloud/ingest-profiles/account/read",
"video-cloud/ingest-profiles/account/write"
]
アプリ
ソースコード
このサンプルに関連付けられているすべてのコードを、この GitHub リポジトリで検索します。
サンプルアプリ
ペン取り込みプロファイル API のサンプルを参照してください。アカウントのすべてのプロファイルを取得する Brightcove Learning Services( @ rcrooks1969) オンCodePen。
CodePen を使用する
上記のCodePenを効果的に使用するためのヒントは次のとおりです。
- [ 結果 ] ボタンをクリックして、プレーヤーの実際の表示を切り替えます。
- HTML/CSS/JS ボタンをクリックして、コードタイプの 1 つを表示します。
- 右上隅にある CodePen の編集をクリックして、この CodePen を自分のアカウントにフォークします。
- このサンプルに関連付けられているすべてのコードを、この GitHub リポジトリで検索します。
プロキシコード
このページのサンプルアプリを独自のバージョンで作成するには、独自のプロキシを作成してホストする必要があります。(Brightcove ブラーニングサービスで使用されるプロキシは、Brightcove ブのドメインからのリクエストのみを受け付けます)。サンプルプロキシは、私たちが使用しているものと非常に似ていますが、BrightCove 以外のドメインからのリクエストをブロックするチェックがないサンプルプロキシは、この GitHub リポジトリにあります。また、そこで使用するための基本的な手順と、 REST API の使用で説明されているプロキシの周りにアプリを構築するためのより精巧なガイドがあります。