メディアファイルをアップロードまたは処理した後、コンソールまたは API を使用してメディアアセット情報を取得できます。このトピックでは、コンソール、API、および SDK を使用してメディアアセット情報を取得する方法について説明します。
シナリオ 1: API を使用した取得と更新
メディアアセット情報は、メディアファイルを記述する構造化データのコレクションです。さまざまなビジネスシナリオのニーズを満たすため、ApsaraVideo VOD (VOD) はメディアアセット情報を次のタイプに分類します。各タイプは、異なる API を使用して個別に取得および更新できます。
情報タイプ | 情報取得用 API | 情報更新用 API | シナリオ |
基本情報 | アプリケーション表示のために基本的なメディアアセット情報 (タイトル、期間、ステータス) を取得します。コンテンツ管理を改善するために、メディアアセットプロパティ (タイトル、説明、サムネイル、カテゴリ ID、タグ) を更新します。 | ||
ソースファイル情報 | ソースファイル情報は、ファイル自体から抽出されたメタデータであり、更新をサポートしていません。 | アップロードされたオリジナルファイルのパスとパラメーターを取得します。これは、アーカイブ、二次処理、またはトラブルシューティングによく使用されます。 | |
再生情報 | 再生情報は更新をサポートしていません。ただし、新しいオーディオ/ビデオストリームを転送するためにトランスコードします。メディアトランスコーディングジョブを送信をご参照ください。 | 再生アドレス (認証を含む) を取得します。これはビデオ再生機能のコアです。 |
サーバーサイド SDK を使用して API を呼び出し、メディアアセット情報を取得および更新できます。詳細については、「VOD SDK ユーザーガイド」をご参照ください。
シナリオ 2: コンソールを使用した取得と更新
コンソールは、個々のメディアアセットの詳細情報を表示および管理するための直感的なインターフェースを提供します。この方法は、日常の運用管理や開発中の迅速な検証に適しています。
VOD コンソールにログインします。
VOD コンソールの左側のナビゲーションバーで、メディアファイル を選択します。次に、[音声/動画]、イメージ、または ショート動画素材 をクリックして、対応するページにアクセスします。
管理 をクリックして、メディアアセットの詳細を表示します。
次のセクションでは、オーディオ/ビデオファイルを例として使用します。
基本情報
[基本情報] タブでは、オーディオまたはビデオのタイトル、説明、分類、タグ、サムネイルなどの情報を表示または変更できます。情報の編集が完了したら、保存 をクリックします。
次の表は、パラメーターについて説明します。
パラメーター | 説明 |
カバー | イメージをアップロードするか、ビデオスナップショットを選択して、デフォルトのビデオサムネイルとして設定します。 説明 カスタムサムネイルをアップロードできます。サポートされているフォーマットは JPG または PNG のみで、最大サイズは 1 MB、解像度は 1920 × 1080 以下です。 |
名前 | オーディオ/ビデオの名前。再生中にプレーヤーウィンドウに表示されます。長さは 1 ～ 128 バイトである必要があります。 |
説明 | オーディオ/ビデオの詳細な説明。長さは 0 ～ 1024 バイトである必要があります。 |
分類 | 分類管理でビデオ分類を構成します。詳細については、「メディアアセットの分類」をご参照ください。 |
タグ | 各オーディオ/ビデオに複数のタグを追加します。中国語の文字、英字、数字、およびアンダースコアのみがサポートされています。コンマ、セミコロンを入力するか、Enter キーを押して単一のタグ入力を完了します。 |
ビデオ URL
[ビデオ URL] タブでは、ソースファイルと、異なる形式および定義のトランスコードされたストリームの URL を表示できます。各ストリームの解像度とビットレートも表示されます。
次の表は、特徴について説明します。
特徴 | 説明 |
コピー | 現在の定義の再生アドレスをブラウザまたはプレーヤーにコピーしてプレビューします。 |
プレビュー | 現在の定義のビデオをコンソールで直接プレビューします。 |
削除 | 対応する定義のビデオを削除します。 |
すべて削除 | すべてのトランスコードされたファイル (オリジナルファイルを除く) をパージします。一度パージすると、ファイルは回復できません。慎重に使用してください。 |
Web プレーヤーコード
[Web プレーヤーコード] タブでは、各ビデオの HTML または JavaScript コードを取得できます。また、クイック構成ツールを使用して、プレーヤーサイズや自動再生設定などのプレーヤーパラメーターを構成することもできます。このツールは、開発効率を向上させるために、コードスニペット内の対応するパラメーターを自動的に変更します。
Web プレーヤーコード タブはビデオファイルにのみ表示されます。
統合には、最新バージョンの Web プレーヤーを使用することを推奨します。詳細については、「Web プレーヤー」をご参照ください。
