すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:メディアアset情報の取得と更新

    ドキュメントセンター

    ApsaraVideo VOD:メディアアset情報の取得と更新

    最終更新日:Aug 05, 2026

    メディアファイルのアップロードまたは処理が完了した後、そのメディアアセット情報を取得および更新できます。このトピックでは、ApsaraVideo VOD コンソール、API、または SDK を使用してこれらの操作を実行する方法について説明します。

    ユースケース 1：API による取得と更新

    さまざまなビジネスシナリオに対応するため、ApsaraVideo VOD ではメディアアセット情報を以下のタイプに分類しています。各タイプは、異なる API を使用して個別に取得および更新できます。

    情報タイプ

    取得用 API

    更新用 API

    ユースケース

    基本情報

    GetVideoInfo

    GetVideoInfos

    GetImageInfo

    UpdateVideoInfo

    UpdateVideoInfos

    UpdateImageInfos

    タイトル、再生時間、ステータスなどの基本情報を取得し、アプリケーション内で表示します。また、コンテンツ管理のため、タイトル、説明、サムネイル、カテゴリ ID、タグなどの属性を更新することもできます。

    ソースファイル情報

    GetMezzanineInfo

    ソースファイル情報は、ファイル自体から抽出されたメタデータであり、更新することはできません。

    元のファイルの URL とパラメータを取得します。これは、アーカイブ、二次処理、またはトラブルシューティングでよく使用されます。

    再生情報

    GetPlayInfo

    再生情報は更新できません。ただし、メディアをトランスコーディングすることで、新しいオーディオおよびビデオストリームを生成できます。SubmitTranscodeJobs

    認証情報を含む再生 URL を取得します。これは、ビデオ再生機能に不可欠です。

    説明

    メディアアセット情報の取得と更新を行う API の呼び出しには、サーバーサイド SDK の使用を推奨します。詳細については、「VOD SDK 使用ガイド」をご参照ください。

    説明

    正確なファイルサイズの取得

    • SearchMedia または GetVideoInfo によって返される Size 値は、インデックスサイズを表す場合や不正確な場合があります。ファイルサイズとして直接使用することは推奨しません。

    • ソースファイルの完全なサイズ (すべての HLS セグメントを含む) を取得するには、GetMezzanineInfo または BatchGetMediaInfos を呼び出し、MezzanineInfo.Size フィールドを確認してください。

    • トランスコーディングされたストリーミングメディアファイルのサイズを取得するには、GetPlayInfo を呼び出してください。

    ユースケース 2：コンソールの使用

    コンソールは、個々のメディアアセットの詳細を表示および管理するための直感的なインターフェイスを提供します。これは、運用担当者による日常的な管理や、開発中の迅速な検証に最適です。

    1. ApsaraVideo VOD コンソールにログインします。

    2. 左側のナビゲーションペインでメディアファイルを選択し、次に[オーディオ/ビデオ]、イメージ、またはショート動画素材をクリックして、対応するページに移動します。

    3. メディアアセットの詳細を表示するには、管理 をクリックします。

    以下の例では、[オーディオ/ビデオ] アセットを管理する方法を示します。

    基本情報

    「基本情報」タブでは、オーディオまたはビデオのタイトル、説明、カテゴリ、タグ、およびサムネイルを表示または変更できます。編集後、保存 をクリックします。

    以下の表では、パラメータについて説明します。

    パラメータ

    説明

    [カバー]

    画像をアップロードするか、ビデオスナップショットを選択して、デフォルトのビデオサムネイルを設定できます。

    説明

    カスタムサムネイルは、JPG または PNG 形式でアップロードできます。画像のサイズは 1 MB 以下、解像度は 1920x1080 以下である必要があります。

    [名前]

    オーディオまたはビデオファイルの名前です。この名前は、再生中にプレーヤーに表示され、1～128 バイトの長さです。

    [説明]

    オーディオまたはビデオファイルの詳細な説明で、最大 1,024 バイトまで入力できます。

    [分類]

    ビデオにカテゴリを割り当てることができます。詳細については、「メディアアセットカテゴリの管理」をご参照ください。

    [タグ]

    各オーディオまたはビデオファイルに複数のタグを追加できます。タグには、中国語、英字、数字、アンダースコア (_) を含めることができます。複数のタグはカンマ (,)、セミコロン (;)、または Enter キーで区切ります。

    ビデオ URL

    ソースファイルのほか、さまざまな形式と品質でトランスコーディングされたすべてのストリームの URL を、対応する解像度とビットレートとともに表示できます。

    ビデオ URL テーブルには、[形式]、[サイズ]、[有効期限] の列も含まれています。ページ上部のヘルプヒントには、[ビデオ再生URLの取得] と [料金] へのリンクがあります。

    以下の表では、操作について説明します。

    操作

    説明

    [コピー]

    選択した品質の再生 URL をコピーします (この操作でビデオ URL の表示や取得ができます)。URL をブラウザまたはプレーヤーに貼り付けて、ビデオをプレビューできます。

    [プレビュー]

    選択した品質のビデオをコンソールで直接プレビューします。

    [削除]

    選択した品質のビデオストリームを削除します。

    [すべて削除]

    トランスコーディングされたすべてのファイルを削除しますが、ソースファイルは保持されます。この操作は元に戻すことができません。慎重に実行してください。

    Web プレーヤーコード

    各ビデオについて、開発者は提供された HTML または JavaScript コードスニペットを使用できます。設定ツールを使用すると、プレーヤーのサイズや自動再生などのパラメータを迅速に変更し、より迅速にセットアップできます。

    説明

    • Web プレーヤーコード タブは、動画アセットにのみ表示されます。

    • 統合には、最新バージョンの ApsaraVideo Player for Web を使用してください。詳細については、「ApsaraVideo Player for Web」をご参照ください。