すべてのプロダクト
Search

このプロダクト

    :GetPlayInfo

    ドキュメントセンター

    :GetPlayInfo

    最終更新日:Feb 06, 2026

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

    操作説明

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

    • ステータスが「通常」の動画のみ再生できます。再生の指示と制限の詳細については、「音声と動画の再生」をご参照ください。

    • メディア資産が標準ストレージクラスにない場合は、`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

    説明

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

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

    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

    任意

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

    エラーコード

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

    変更履歴

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