すべてのプロダクト
Search

このプロダクト

    :GetPlayInfo

    ドキュメントセンター

    :GetPlayInfo

    最終更新日:Nov 06, 2025

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

    操作説明

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

    • Normal 状態 (Status パラメーターが Normal に設定されている) のビデオのみ再生できます。再生 URL の再生手順と制限の詳細については、「オーディオとビデオの再生」をご参照ください。

    • ビデオの再生が異常な場合は、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 コンソールにログインします。ナビゲーションウィンドウで、[メディアファイル] > [オーディオ/ビデオ] を選択します。オーディオまたはビデオ ID を表示します。この方法は、ApsaraVideo VOD コンソールにアップロードされたオーディオおよびビデオファイルに使用されます。

    • 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 (デフォルト): 高速化ドメイン名。

    cdn
    StreamType

    string

    任意

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

    • video: ビデオ。

    • audio: オーディオ。

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

    video
    ReAuthInfo

    string

    任意

    CDN 認証パラメーター。このパラメーターは JSON 文字列です。URL 署名方式 A を有効にすると、認証 URL に uid および rand フィールドを設定できます。詳細については、「URL 署名方式 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 (デフォルト): 各解像度とフォーマットについて、最新のトランスコード済みストリームの再生 URL のみ返されます。

    • Multiple: 各解像度とフォーマットについて、すべてのトランスコード済みストリームの再生 URL が返されます。

    Single
    PlayConfig

    string

    任意

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

    説明

    • 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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンス。

    RequestId

    string

    リクエストの ID。

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

    object

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

    CreationTime

    string

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

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

    string

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

    Normal
    VideoId

    string

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

    93ab850b4f654b6e91d24d81d44****
    CoverURL

    string

    サムネイルの URL。

    説明

    ビデオをアップロードした後にリアルタイムでサムネイル URL を取得したい場合は、イベント通知を設定できます。詳細については、「HTTP コールバック」および「SnapshotComplete」をご参照ください。

    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: SourceIA。

    • SourceArchive: SourceArchive。

    • SourceColdArchive: SourceColdArchive。

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

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

    Standard
    PlayInfoList

    object

    PlayInfo

    array<object>

    オーディオまたはビデオストリームに関する再生情報。

    object

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

    CreationTime

    string

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

    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

    メディアストリームのビットレート。単位: Kbit/s。

    説明

    M3U8 の動的シャーディング機能により、ビットレートにドリフトが生じる場合があります。

    450.878
    ModificationTime

    string

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

    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

    メディアストリームのフレームレート。単位: 1 秒あたりのフレーム数。

    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"
      }
    ]
  }
}

    エラーコード

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

    変更履歴

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