すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:GetPlayInfo

    ドキュメントセンター

    ApsaraVideo VOD:GetPlayInfo

    最終更新日:Jul 21, 2026

    音声または動画の ID を指定して再生 URL を取得します。取得した URL は、ApsaraVideo Player や、システムネイティブ、オープンソース、カスタムビルドなどのサードパーティプレーヤーで再生できます。

    操作説明

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

    • 法線状態 (Status フィールドの値が Normal) の動画のみ再生できます。再生 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 のみがサポートされています。以下の方法で ID を取得できます。

    • コンソールからアップロードされた音声または動画ファイルの場合は、ApsaraVideo VOD コンソール にログインし、メディアファイル > 音声/動画 を選択して音声または動画 ID を表示します。

    • CreateUploadVideo 操作を呼び出して音声または動画ファイルをアップロードする場合、音声または動画 ID は VideoId レスポンスパラメーターの値です。

    • 音声または動画ファイルのアップロード後、 SearchMedia 操作を呼び出して音声または動画 ID をクエリします。これは VideoId レスポンスパラメーターの値です。

    93ab850b4f654b6e91d24d81d44****
    Formats

    string

    任意

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

    • mp4

    • m3u8

    • mp3

    • flv

    • mpd

    説明

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

    • mpd フォーマットは、トランスコーディングテンプレートで dash コンテナ形式が設定されている場合にのみ返されます。詳細については、Container: コンテナ形式 を参照してください。

    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 文字列です。URL 認証でタイプ A 署名が有効になっている場合、このパラメーターを使用して認証 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 コンソール にログインし、構成管理 > メディア管理 > ストレージ > 管理 > このストレージの場所から back-to-origin を実行するドメイン名 を選択して、デフォルトの再生ドメイン名を設定します。

    • 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 に設定されている場合、このパラメーターを渡して動画の追跡電子透かし情報を設定し、透かし情報を含むビデオストリームを返します。英字、数字、漢字のみがサポートされています。最大値は 1024 文字です。

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

    test mark。
    DigitalWatermarkType

    string

    任意

    電子透かしのタイプ。有効な値:

    • TraceMark: 追跡電子透かし。

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

    TraceMark。
    CodecName

    string

    任意

    H264
    ReferenceId

    string

    任意

    カスタム ID。小文字、大文字、数字、ハイフン、アンダースコアのみがサポートされています。長さは 6 ～ 64 文字です。ID はユーザーごとに一意です。

    123-123

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

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

    object

    音声または動画ファイルの基本情報。

    CreationTime

    string

    音声または動画ファイルが作成された時間。時間は ISO 8601 標準に従い、yyyy-MM-ddTHH:mm:ssZ フォーマットです。時間は協定世界時 (UTC) で表示されます。

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

    string

    音声または動画ファイルのステータス。有効な値と説明については、Status: 音声および動画のステータス を参照してください。

    Normal
    VideoId

    string

    音声または動画の ID。

    93ab850b4f654b6e91d24d81d44****
    CoverURL

    string

    音声または動画ファイルのサムネイル URL。

    説明

    動画のアップロード後にリアルタイムでサムネイル URL を取得するには、ApsaraVideo VOD コールバックを設定してください。詳細については、HTTP コールバック および SnapshotComplete イベント を参照してください。

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

    string

    音声または動画ファイルの持続時間。単位: 秒。

    3.1667
    Title

    string

    音声または動画ファイルのタイトル。

    Alibaba Cloud VOD。
    MediaType

    string

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

    • video: 動画。

    • audio: 音声のみ。

    video。
    DanMuURL

    string

    中国アクセス可能な弾幕マスクデータの URL。

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

    string

    メディアアセットのストレージクラス。有効な値:

    • Standard: 標準。

    • IA: メディアアセット低頻度アクセス。

    • Archive: メディアアセットアーカイブ。

    • ColdArchive: メディアアセットコールドアーカイブストレージ。

    • SourceIA: ソースファイル低頻度アクセス。

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

    エラーコード

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

    変更履歴

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