すべてのプロダクト
Search

このプロダクト

    :GetPlayInfo

    ドキュメントセンター

    :GetPlayInfo

    最終更新日:Dec 09, 2025

    この操作を呼び出し、オーディオまたはビデオ ID を指定して再生 URL を取得します。その後、ApsaraVideo Player または、ネイティブ、オープンソース、プロプライエタリなどのサードパーティ製プレーヤーを使用してコンテンツを再生できます。

    操作説明

    • この操作を使用する前に、ApsaraVideo VOD の課金方法と料金を十分に理解していることを確認してください。ApsaraVideo VOD の再生 URL からビデオをダウンロードまたは再生すると、アウトバウンドトラフィック料金が発生します。高速化ドメイン名を設定しない場合は、「ストレージからのアウトバウンドトラフィックの課金」をご参照ください。高速化ドメイン名を設定する場合は、「高速化サービスの課金」をご参照ください。ストレージの転送アクセラレーションを有効にすると、ApsaraVideo VOD の再生 URL からビデオをダウンロードまたは再生する際に、ダウンロード高速化料金も発生します。課金の詳細については、「ストレージの転送アクセラレーションの課金」をご参照ください。

    • ステータスが `Normal` のビデオのみ再生できます。再生の指示と制限の詳細については、「オーディオとビデオの再生」をご参照ください。

    • メディア資産が標準ストレージクラスにない場合は、`PlayConfig` パラメーターの `StorageClass` フィールドを適宜設定してください。詳細については、「PlayConfig」をご参照ください。

    • ビデオの再生に異常がある場合は、GetMezzanineInfo 操作を呼び出して、ビデオソースファイルの情報をご確認ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:GetPlayInfo

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    VideoId

    string

    任意

    オーディオまたはビデオファイルの ID。ID は 1 つのみ指定できます。ID は、次のいずれかの方法で取得します。

    • ApsaraVideo VOD コンソールでアップロードされたオーディオまたはビデオファイルの場合、ApsaraVideo VOD コンソールにログインし、[メディア資産] > [オーディオ/ビデオ] を選択して ID を表示します。

    • CreateUploadVideo 操作を使用してオーディオまたはビデオファイルをアップロードした場合、レスポンスの `VideoId` パラメーターの値がファイル ID になります。

    • オーディオまたはビデオファイルがアップロードされた後、SearchMedia 操作を呼び出してその ID をクエリできます。レスポンスの `VideoId` パラメーターの値がファイル ID になります。

    93ab850b4f654b6e91d24d81d44****
    Formats

    string

    任意

    メディアストリームのフォーマット。複数のフォーマットはコンマ (,) で区切ります。有効な値：

    • mp4

    • m3u8

    • mp3

    • flv

    • mpd

    説明

    • デフォルトでは、すべてのフォーマットのストリームが返されます。

    • MPD フォーマットは、トランスコーディングテンプレートで `dash` コンテナフォーマットが設定されている場合にのみ返されます。詳細については、「コンテナ：コンテナフォーマット」をご参照ください。

    mp4,m3u8
    AuthTimeout

    integer

    任意

    再生 URL の有効期間。単位：秒。

    • `OutputType` が `cdn` に設定されている場合：

      • URL 署名が有効になっている場合にのみ、再生 URL は期限切れになります。それ以外の場合、URL は永続的に有効です。URL 署名を有効にして設定する方法の詳細については、「URL 署名」をご参照ください。

      • 最小値：1。

      • 最大値：制限なし。

      • デフォルト値：このパラメーターを設定しない場合、URL 署名設定で指定されたデフォルトの有効期間が使用されます。

    • `OutputType` が `oss` に設定されている場合：

      • ストレージ権限が非公開の場合にのみ、再生 URL は期限切れになります。それ以外の場合、URL は永続的に有効です。

      • 最小値：1。

      • 最大値：オリジンでのセキュリティリスクを軽減するため、メディアファイルが ApsaraVideo VOD バケットに保存されている場合の最大有効期間は 604800 (7 日間)、ご利用の OSS バケットに保存されている場合は 129600 (36 時間) です。この最大値がニーズを満たさない場合は、`OutputType` を `cdn` に設定し、より長い有効期間のために URL 署名を設定できます。

      • デフォルト値：このパラメーターを設定しない場合、デフォルト値は 3600 です。

    1800
    OutputType

    string

    任意

    出力 URL のタイプ。有効な値：

    • oss：オリジン URL。

    • cdn (デフォルト)：高速化 URL。

    cdn
    StreamType

    string

    任意

    メディアストリームのタイプ。複数のタイプはコンマ (,) で区切ります。有効な値：

    • video：ビデオストリーム。

    • audio：オーディオストリーム。

    デフォルトでは、すべてのタイプのストリームが返されます。

    video
    ReAuthInfo

    string

    任意

    CDN の二次認証パラメーター (JSON 文字列)。認証方式 A の URL 署名を有効にする場合、このパラメーターを使用して認証 URL の `uid` および `rand` フィールドを設定できます。詳細については、「認証方式 A」をご参照ください。

    {"uid":"12345","rand":"abckljd"}
    Definition

    string

    任意

    ビデオストリームの解像度。複数の解像度はコンマ (,) で区切ります。有効な値：

    • FD：低画質。

    • LD：標準画質。

    • SD：高画質。

    • HD：超高画質。

    • OD：オリジナル画質。

    • 2K：2K。

    • 4K：4K。

    • SQ：標準品質。

    • HQ：高品質。

    • AUTO：アダプティブビットレート。

    説明

    • デフォルトでは、すべての解像度のストリームが返されます。

    • 追跡ウォーターマークを生成する場合、このパラメーターは必須です。値は、トランスコーディング中に追跡ウォーターマークに設定された解像度と同じである必要があります。

    • AUTO 解像度は、トランスコーディングテンプレートでパッケージングが設定されている場合にのみ使用できます。詳細については、「PackageSetting：トランスコーディングとパッケージングの設定」をご参照ください。

    LD
    ResultType

    string

    任意

    返すデータのタイプ。有効な値：

    • Single (デフォルト)：各解像度とフォーマットの最新のトランスコードされたストリームのみを返します。

    • Multiple：各解像度とフォーマットのすべてのトランスコードされたストリームを返します。

    Single
    PlayConfig

    string

    任意

    カスタム再生設定 (JSON 文字列)。ドメイン名の再生設定を指定できます。パラメーターの作成方法の詳細については、「PlayConfig」をご参照ください。

    説明

    • `PlayConfig` またはその `PlayDomain` フィールドが設定されていない場合、操作は ApsaraVideo VOD で設定されたデフォルトのドメイン名を使用します。デフォルトのドメイン名が設定されていない場合、システムは最終変更時刻の逆時系列順にドメイン名をクエリし、最も最近変更されたものを使用します。予期しないドメイン名が返されるのを防ぐために、デフォルトの再生ドメイン名を設定してください。これを行うには、ApsaraVideo VOD コンソールにログインし、[設定管理] > [メディア資産管理] > [ストレージ] > [管理] を選択します。次に、[このストレージアドレスへのオリジンフェッチ用のドメイン名] セクションでデフォルトの再生ドメイン名を設定します。

    • `PlayConfig` の `EncryptType` が `AliyunVoDEncryption` に設定されている場合、ビデオのセキュリティを確保するため、プライベートに暗号化されたストリームの再生 URL はデフォルトでは返されません。これらの URL を返すには、`ResultType` を `Multiple` に設定してください。

    {"PlayDomain":"vod.test_domain","XForwardedFor":"yqCD7Fp1uqChoVj/sl/p5Q==","PreviewTime":"20","MtsHlsUriToken":"yqCD7Fp1uqChoVjslp5Q"}
    AdditionType

    string

    任意

    弾幕オーバーレイデータの URL を取得するかどうかを指定します。値を danmu に設定します。

    説明

    このパラメーターは、`outputType` が `cdn` に設定されている場合にのみ有効です。

    danmu
    Trace

    string

    任意

    カスタムデジタルウォーターマーク情報。

    • `DigitalWatermarkType` が `TraceMark` の場合、このパラメーターを使用して追跡ウォーターマークのウォーターマーク情報を設定できます。操作はウォーターマークを含むビデオストリームを返します。値には英字、数字、漢字を含めることができ、最大長は 1,024 文字です。

    • `DigitalWatermarkType` が `CopyrightMark` の場合、`Trace` はウォーターマークテンプレートを作成したときに設定したウォーターマークテキストに対応します。このパラメーターを使用して、指定されたウォーターマークテキストを持つビデオストリームをクエリして返すことができます。

    test mark
    DigitalWatermarkType

    string

    任意

    デジタルウォーターマークのタイプ。有効な値：

    • TraceMark：追跡ウォーターマーク。

    • CopyrightMark：著作権ウォーターマーク。

    TraceMark
    ReferenceId

    string

    任意

    カスタム ID。長さは 6～64 文字で、小文字、大文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。ID は各ユーザーで一意である必要があります。

    123-123

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンス。

    RequestId

    string

    リクエスト ID。

    F552E596-967D-5500-842F-17E6364****
    VideoBase

    object

    オーディオまたはビデオファイルの基本情報。

    CreationTime

    string

    オーディオまたはビデオファイルが作成された時刻。時刻は UTC の yyyy-MM-ddTHH:mm:ssZ 形式です。

    2017-06-26T06:38:48Z
    Status

    string

    オーディオまたはビデオファイルのステータス。有効な値と説明の詳細については、「ステータス：オーディオとビデオのステータス」をご参照ください。

    Normal
    VideoId

    string

    オーディオまたはビデオファイルの ID。

    93ab850b4f654b6e91d24d81d44****
    CoverURL

    string

    サムネイルの URL。

    説明

    ビデオをアップロードした後にリアルタイムでサムネイル URL を取得するには、ApsaraVideo VOD コールバックを設定します。詳細については、「HTTP コールバック」および「サムネイルキャプチャ完了」をご参照ください。

    http://example.aliyundoc.com/sample.jpg?auth_key=2333232-atb****
    Duration

    string

    オーディオまたはビデオファイルの長さ。単位：秒。

    3.1667
    Title

    string

    オーディオまたはビデオファイルのタイトル。

    阿里云VOD
    MediaType

    string

    メディアファイルのタイプ。有効な値：

    • video：ビデオ。

    • audio：オーディオのみ。

    video
    DanMuURL

    string

    弾幕オーバーレイデータの URL。

    http://example.aliyundoc.com/****?auth_key=abdf2123-6783232****
    StorageClass

    string

    メディア資産のストレージクラス。有効な値：

    • Standard：標準。

    • IA：低頻度アクセス (IA)。

    • Archive：アーカイブ。

    • ColdArchive：コールドアーカイブ。

    • SourceIA：ソース IA。

    • SourceArchive：ソースアーカイブ。

    • SourceColdArchive：ソースコールドアーカイブ。

    • Changing：ストレージクラスは変更中です。

    • SourceChanging：ソースファイルのストレージクラスは変更中です。

    Standard
    PlayInfoList

    object

    PlayInfo

    array<object>

    オーディオまたはビデオストリームの再生情報。

    object

    オーディオまたはビデオファイルの詳細。

    CreationTime

    string

    ストリームが作成された時刻。時刻は UTC の yyyy-MM-ddTHH:mm:ssZ 形式です。

    2022-04-18T07:37:15Z
    Status

    string

    メディアストリームのステータス。有効な値：

    • Normal：ストリームは通常の状態です。このステータスは、各解像度とフォーマットの最新のトランスコードされたストリームに割り当てられます。

    • Invisible：ストリームは非表示状態です。同じ解像度とフォーマットで複数のストリームが生成された場合、最新のストリームは Normal とマークされ、その他は Invisible とマークされます。

    Normal
    Specification

    string

    トランスコードされた出力の仕様。有効な値と説明の詳細については、「仕様：出力仕様」をご参照ください。

    H264.LD
    NarrowBandType

    string

    トランスコーディングタイプ。有効な値：

    • 0：通常トランスコーディング。

    • 1.0：ナローバンド HD 1.0。

    • 2.0：ナローバンド HD 2.0。

    0
    Height

    integer

    メディアストリームの高さ。単位：px。

    640
    Bitrate

    string

    メディアストリームのビットレート。単位：Kbps。

    説明

    M3U8 の動的シャーディング機能のため、計算されたビットレートにはずれが生じる可能性があります。

    450.878
    ModificationTime

    string

    ストリームが最後に更新された時刻。時刻は UTC の yyyy-MM-ddTHH:mm:ssZ 形式です。

    2022-04-20T06:32:19Z
    WatermarkId

    string

    現在のメディアストリームに関連付けられているウォーターマークテンプレートの ID。

    dgfn26457856****
    Encrypt

    integer

    メディアストリームが暗号化されているかどうかを示します。有効な値：

    • 0：いいえ。

    • 1：はい。

    1
    Definition

    string

    ビデオストリームの解像度。有効な値：

    • FD：低画質。

    • LD：標準画質。

    • SD：高画質。

    • HD：超高画質。

    • OD：オリジナル画質。

    • 2K：2K。

    • 4K：4K。

    • SQ：標準品質。

    • HQ：高品質。

    • AUTO：アダプティブビットレート。

    LD
    EncryptType

    string

    メディアストリームの暗号化タイプ。有効な値：

    • AliyunVoDEncryption：Alibaba Cloud 専用の暗号化。

    • HLSEncryption：HLS 標準暗号化。

    説明

    暗号化タイプが `AliyunVoDEncryption` の場合、ApsaraVideo Player SDK を使用してのみストリームを再生できます。

    AliyunVoDEncryption
    EncryptMode

    string

    メディアストリームの暗号化モード。有効な値：

    • License：ローカル復号モード。

    説明

    暗号化モードが License の場合、ApsaraVideo Player SDK を使用してのみストリームを再生できます。

    License
    StreamType

    string

    メディアストリームのタイプ。値は、ビデオストリームの場合は video、オーディオのみのストリームの場合は audio です。

    video
    JobId

    string

    メディアストリームのトランスコーディングジョブの ID。この ID は、メディアストリームの一意の識別子として機能します。

    80e9c6580e754a798c3c19c59b16****
    Size

    integer

    メディアストリームのサイズ。単位：バイト。

    説明

    M3U8 の動的シャーディング機能のため、計算されたストリームサイズにはずれが生じる可能性があります。

    418112
    Width

    integer

    メディアストリームの幅。単位：px。

    360
    Fps

    string

    メディアストリームのフレームレート。単位：フレーム/秒。

    25
    Duration

    string

    メディアストリームの長さ。単位：秒。

    9.0464
    PlayURL

    string

    ビデオストリームの再生 URL。

    https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8
    Format

    string

    メディアストリームのフォーマット。

    • ビデオファイルの場合、値は mp4 または m3u8 です。

    • オーディオのみのファイルの場合、値は mp3 です。

    m3u8
    HDRType

    string

    メディアストリームのハイダイナミックレンジ (HDR) タイプ。有効な値：

    • HDR

    • HDR10

    • HLG

    • DolbyVision

    • HDRVivid

    • SDR+

    HLG
    BitDepth

    integer

    色深度。値は整数です。

    8
    JobType

    integer

    デジタルウォーターマークのタイプ。有効な値：

    • 1：追跡ウォーターマーク。

    • 2：著作権ウォーターマーク。

    2
    JobExt

    string

    著作権ウォーターマークのカスタムウォーターマーク情報。このフィールドは、`JobType` が `2` の場合にのみ返されます。

    CopyrightMarkTest
    CodecName

    string

    エンコーディングタイプ。有効な値：

    • H264

    • H265

    H264

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "F552E596-967D-5500-842F-17E6364****",
  "VideoBase": {
    "CreationTime": "2017-06-26T06:38:48Z",
    "Status": "Normal",
    "VideoId": "93ab850b4f654b6e91d24d81d44****",
    "CoverURL": "http://example.aliyundoc.com/sample.jpg?auth_key=2333232-atb****",
    "Duration": "3.1667",
    "Title": "阿里云VOD",
    "MediaType": "video",
    "DanMuURL": "http://example.aliyundoc.com/****?auth_key=abdf2123-6783232****",
    "StorageClass": "Standard"
  },
  "PlayInfoList": {
    "PlayInfo": [
      {
        "CreationTime": "2022-04-18T07:37:15Z",
        "Status": "Normal",
        "Specification": "H264.LD",
        "NarrowBandType": "0",
        "Height": 640,
        "Bitrate": "450.878",
        "ModificationTime": "2022-04-20T06:32:19Z",
        "WatermarkId": "dgfn26457856****",
        "Encrypt": 1,
        "Definition": "LD",
        "EncryptType": "AliyunVoDEncryption",
        "EncryptMode": "License",
        "StreamType": "video",
        "JobId": "80e9c6580e754a798c3c19c59b16****",
        "Size": 418112,
        "Width": 360,
        "Fps": "25",
        "Duration": "9.0464",
        "PlayURL": "https://example.aliyundoc.com/d52ee123f331466aabf6ab32a93d****/a777f9e24e6e47a2a942467d5c38ea37-8ee8e04293c6657fdda282bc422704****.m3u8",
        "Format": "m3u8",
        "HDRType": "HLG",
        "BitDepth": 8,
        "JobType": 2,
        "JobExt": "CopyrightMarkTest",
        "CodecName": "H264"
      }
    ]
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。