全部产品
Search

搜索本产品

    ApsaraVideo VOD：GetPlayInfo

    文档中心

    ApsaraVideo VOD：GetPlayInfo

    更新时间：Dec 15, 2025

    Panggil operasi ini dan berikan ID audio atau video untuk mendapatkan URL pemutaran. Anda kemudian dapat menggunakan ApsaraVideo Player atau pemutar pihak ketiga—seperti pemutar native, open source, atau proprietary—untuk memutar konten tersebut.

    Deskripsi operasi

    • Sebelum menggunakan operasi ini, pastikan Anda memahami sepenuhnya metode penagihan dan harga ApsaraVideo VOD. Mengunduh atau memutar video dari URL pemutaran ApsaraVideo VOD akan dikenai biaya lalu lintas keluar. Jika Anda tidak mengonfigurasi nama domain yang dipercepat, lihat Penagihan lalu lintas keluar dari penyimpanan. Jika Anda mengonfigurasi nama domain yang dipercepat, lihat Penagihan layanan akselerasi. Jika Anda mengaktifkan akselerasi transfer untuk penyimpanan, mengunduh atau memutar video dari URL pemutaran ApsaraVideo VOD juga akan dikenai biaya akselerasi unduhan. Untuk informasi selengkapnya tentang penagihan, lihat Penagihan akselerasi transfer untuk penyimpanan.

    • Hanya video dengan status Normal yang dapat diputar. Untuk informasi selengkapnya tentang petunjuk dan batasan pemutaran, lihat Pemutaran audio dan video.

    • Jika media asset tidak berada dalam kelas penyimpanan Standard, atur bidang StorageClass pada parameter PlayConfig sesuai kebutuhan. Untuk informasi selengkapnya, lihat PlayConfig.

    • Jika pemutaran video tidak normal, panggil operasi GetMezzanineInfo untuk memeriksa informasi file sumber video.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    vod:GetPlayInfo

    get

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    VideoId

    string

    No

    ID file audio atau video. Anda hanya dapat menentukan satu ID. Dapatkan ID dengan salah satu cara berikut:

    • Untuk file audio atau video yang diunggah melalui Konsol ApsaraVideo VOD, login ke Konsol ApsaraVideo VOD dan pilih Media Assets > Audio/Video untuk melihat ID-nya.

    • Jika Anda menggunakan operasi CreateUploadVideo untuk mengunggah file audio atau video, nilai parameter VideoId dalam respons adalah ID file tersebut.

    • Setelah file audio atau video diunggah, Anda dapat memanggil operasi SearchMedia untuk menanyakan ID-nya. Nilai parameter VideoId dalam respons adalah ID file tersebut.

    93ab850b4f654b6e91d24d81d44****
    Formats

    string

    No

    Format aliran media. Pisahkan beberapa format dengan koma (,). Nilai yang valid:

    • mp4

    • m3u8

    • mp3

    • flv

    • mpd

    Catatan

    • Secara default, aliran dalam semua format dikembalikan.

    • Format MPD hanya dikembalikan jika format kontainer dash dikonfigurasi dalam template transkoding. Untuk informasi selengkapnya, lihat Container: format kontainer.

    mp4,m3u8
    AuthTimeout

    integer

    No

    Periode validitas URL pemutaran. Satuan: detik.

    • Jika OutputType diatur ke cdn:

      • URL pemutaran kedaluwarsa hanya jika Penandatanganan URL diaktifkan. Jika tidak, URL tersebut berlaku permanen. Untuk informasi selengkapnya tentang cara mengaktifkan dan mengonfigurasi Penandatanganan URL, lihat Penandatanganan URL.

      • Nilai minimum: 1.

      • Nilai maksimum: Tidak ada batas.

      • Nilai default: Jika Anda tidak mengatur parameter ini, periode validitas default yang ditentukan dalam pengaturan Penandatanganan URL akan digunakan.

    • Jika OutputType diatur ke oss:

      • URL pemutaran kedaluwarsa hanya jika izin penyimpanan bersifat privat. Jika tidak, URL tersebut berlaku permanen.

      • Nilai minimum: 1.

      • Nilai maksimum: Untuk mengurangi risiko keamanan di origin, periode validitas maksimum adalah 604800 (7 hari) jika file media disimpan di bucket ApsaraVideo VOD, dan 129600 (36 jam) jika disimpan di bucket OSS Anda sendiri. Jika nilai maksimum ini tidak memenuhi kebutuhan Anda, Anda dapat mengatur OutputType ke cdn dan mengonfigurasi Penandatanganan URL untuk periode validitas yang lebih lama.

      • Nilai default: Jika Anda tidak mengatur parameter ini, nilai default-nya adalah 3600.

    1800
    OutputType

    string

    No

    Jenis URL output. Nilai yang valid:

    • oss: URL origin.

    • cdn (default): URL yang dipercepat.

    cdn
    StreamType

    string

    No

    Jenis aliran media. Pisahkan beberapa jenis dengan koma (,). Nilai yang valid:

    • video: aliran video.

    • audio: aliran audio.

    Secara default, aliran semua jenis dikembalikan.

    video
    ReAuthInfo

    string

    No

    Parameter otentikasi sekunder untuk CDN, dalam bentuk string JSON. Jika Anda mengaktifkan Penandatanganan URL dengan metode autentikasi A, Anda dapat menggunakan parameter ini untuk mengatur bidang uid dan rand pada URL autentikasi. Untuk informasi selengkapnya, lihat Metode autentikasi A.

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

    string

    No

    Definisi aliran video. Pisahkan beberapa definisi dengan koma (,). Nilai yang valid:

    • FD: Definisi rendah.

    • LD: Definisi standar.

    • SD: Definisi tinggi.

    • HD: Definisi ultra tinggi.

    • OD: Kualitas asli.

    • 2K: 2K.

    • 4K: 4K.

    • SQ: Kualitas standar.

    • HQ: Kualitas tinggi.

    • AUTO: Bitrate adaptif.

    Catatan

    • Secara default, aliran semua definisi dikembalikan.

    • Saat menghasilkan jejak watermark, parameter ini wajib diisi. Nilainya harus sama dengan definisi yang ditetapkan untuk jejak watermark selama transkoding.

    • Definisi AUTO tersedia hanya jika pengemasan dikonfigurasi dalam template transkoding. Untuk informasi selengkapnya, lihat PackageSetting: Pengaturan transkoding dan pengemasan.

    LD
    ResultType

    string

    No

    Jenis data yang dikembalikan. Nilai yang valid:

    • Single (default): Hanya mengembalikan aliran yang telah dikodekan ulang terbaru untuk setiap definisi dan format.

    • Multiple: Mengembalikan semua aliran yang telah dikodekan ulang untuk setiap definisi dan format.

    Single
    PlayConfig

    string

    No

    Pengaturan pemutaran kustom dalam bentuk string JSON. Anda dapat menentukan pengaturan pemutaran untuk nama domain tertentu. Untuk informasi selengkapnya tentang cara menyusun parameter ini, lihat PlayConfig.

    Catatan

    • Jika PlayConfig atau bidang PlayDomain-nya tidak diatur, operasi ini akan menggunakan nama domain default yang dikonfigurasi di ApsaraVideo VOD. Jika tidak ada nama domain default yang dikonfigurasi, sistem akan menanyakan nama domain secara terbalik berdasarkan waktu modifikasi terakhir dan menggunakan yang paling baru dimodifikasi. Untuk mencegah pengembalian nama domain yang tidak diinginkan, atur nama domain pemutaran default. Caranya, login ke Konsol ApsaraVideo VOD, lalu pilih Configuration Management > Media Asset Management > Storage > Manage. Kemudian, atur nama domain pemutaran default di bagian Domain Names for Origin Fetch to This Storage Address.

    • Jika EncryptType dalam PlayConfig diatur ke AliyunVoDEncryption, URL pemutaran untuk aliran yang dienkripsi secara privat tidak dikembalikan secara default demi menjaga keamanan video. Untuk mengembalikan URL tersebut, atur ResultType ke Multiple.

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

    string

    No

    Menentukan apakah akan mendapatkan URL data overlay komentar langsung. Atur nilainya ke danmu.

    Catatan

    Parameter ini hanya berlaku saat outputType diatur ke cdn.

    danmu
    Trace

    string

    No

    Informasi watermark digital kustom.

    • Jika DigitalWatermarkType bernilai TraceMark, Anda dapat menggunakan parameter ini untuk mengatur informasi watermark untuk jejak watermark. Operasi ini akan mengembalikan aliran video yang berisi watermark tersebut. Nilainya dapat berisi huruf Inggris, angka, dan karakter Tionghoa, dengan panjang maksimum 1.024 karakter.

    • Jika DigitalWatermarkType bernilai CopyrightMark, Trace berkorespondensi dengan Watermark Text yang Anda atur saat membuat template watermark. Anda dapat menggunakan parameter ini untuk menanyakan dan mengembalikan aliran video dengan teks watermark yang ditentukan.

    test mark
    DigitalWatermarkType

    string

    No

    Jenis watermark digital. Nilai yang valid:

    • TraceMark: Jejak watermark.

    • CopyrightMark: Watermark hak cipta.

    TraceMark
    ReferenceId

    string

    No

    ID kustom. Panjangnya antara 6 hingga 64 karakter dan dapat berisi huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_). ID ini harus unik untuk setiap pengguna.

    123-123

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tanggapan.

    RequestId

    string

    ID permintaan.

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

    object

    Informasi dasar file audio atau video.

    CreationTime

    string

    Waktu pembuatan file audio atau video. Waktu dalam format UTC yyyy-MM-ddTHH:mm:ssZ.

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

    string

    Status file audio atau video. Untuk informasi selengkapnya tentang nilai dan deskripsi yang valid, lihat Status: Status audio dan video.

    Normal
    VideoId

    string

    ID file audio atau video.

    93ab850b4f654b6e91d24d81d44****
    CoverURL

    string

    URL Gambar mini.

    Catatan

    Untuk mendapatkan URL Gambar mini secara real time setelah mengunggah video, konfigurasikan callback ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Callback HTTP dan Penangkapan Gambar mini selesai.

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

    string

    Durasi file audio atau video. Satuan: detik.

    3.1667
    Title

    string

    Judul file audio atau video.

    阿里云VOD
    MediaType

    string

    Jenis file media. Nilai yang valid:

    • video: video.

    • audio: hanya audio.

    video
    DanMuURL

    string

    URL data overlay komentar langsung.

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

    string

    Kelas penyimpanan aset media. Nilai yang valid:

    • Standard: Standard.

    • IA: Infrequent Access (IA).

    • Archive: Archive.

    • ColdArchive: Cold Archive.

    • SourceIA: Source IA.

    • SourceArchive: Source Archive.

    • SourceColdArchive: Source Cold Archive.

    • Changing: Kelas penyimpanan sedang diubah.

    • SourceChanging: Kelas penyimpanan file sumber sedang diubah.

    Standard
    PlayInfoList

    object

    PlayInfo

    array<object>

    Informasi pemutaran aliran audio atau video.

    object

    Detail file audio atau video.

    CreationTime

    string

    Waktu pembuatan aliran. Waktu dalam format UTC yyyy-MM-ddTHH:mm:ssZ.

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

    string

    Status aliran media. Nilai yang valid:

    • Normal: Aliran dalam keadaan normal. Status ini diberikan kepada aliran yang telah dikodekan ulang terbaru untuk setiap definisi dan format.

    • Invisible: Aliran dalam keadaan tidak terlihat. Jika beberapa aliran dihasilkan untuk definisi dan format yang sama, aliran terbaru ditandai sebagai Normal dan yang lainnya ditandai sebagai Invisible.

    Normal
    Specification

    string

    Spesifikasi output transkoding. Untuk informasi selengkapnya tentang nilai dan deskripsi yang valid, lihat Specification: Spesifikasi output.

    H264.LD
    NarrowBandType

    string

    Jenis transkoding. Nilai yang valid:

    • 0: Transkoding normal.

    • 1.0: Narrowband HD 1.0.

    • 2.0: Narrowband HD 2.0.

    0
    Height

    integer

    Tinggi aliran media. Satuan: px.

    640
    Bitrate

    string

    Bitrate aliran media. Satuan: Kbps.

    Catatan

    Karena fitur sharding dinamis M3U8, bitrate yang dihitung mungkin mengalami deviasi.

    450.878
    ModificationTime

    string

    Waktu terakhir aliran diperbarui. Waktu dalam format UTC yyyy-MM-ddTHH:mm:ssZ.

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

    string

    ID template watermark yang terkait dengan aliran media saat ini.

    dgfn26457856****
    Encrypt

    integer

    Menunjukkan apakah aliran media dienkripsi. Nilai yang valid:

    • 0: Tidak.

    • 1: Ya.

    1
    Definition

    string

    Definisi aliran video. Nilai yang valid:

    • FD: Definisi rendah.

    • LD: Definisi standar.

    • SD: Definisi tinggi.

    • HD: Definisi ultra tinggi.

    • OD: Kualitas asli.

    • 2K: 2K.

    • 4K: 4K.

    • SQ: Kualitas standar.

    • HQ: Kualitas tinggi.

    • AUTO: Bitrate adaptif.

    LD
    EncryptType

    string

    Jenis enkripsi aliran media. Nilai yang valid:

    • AliyunVoDEncryption: Enkripsi privat Alibaba Cloud.

    • HLSEncryption: Enkripsi standar HLS.

    Catatan

    Jika jenis enkripsi adalah AliyunVoDEncryption, Anda hanya dapat memutar aliran tersebut menggunakan SDK ApsaraVideo Player.

    AliyunVoDEncryption
    EncryptMode

    string

    Mode enkripsi aliran media. Nilai yang valid:

    • License: Mode dekripsi lokal.

    Catatan

    Jika mode enkripsi adalah License, Anda hanya dapat memutar aliran tersebut menggunakan SDK ApsaraVideo Player.

    License
    StreamType

    string

    Jenis aliran media. Nilainya adalah video untuk aliran video atau audio untuk aliran hanya audio.

    video
    JobId

    string

    ID pekerjaan transkoding untuk aliran media. ID ini berfungsi sebagai pengidentifikasi unik untuk aliran media tersebut.

    80e9c6580e754a798c3c19c59b16****
    Size

    integer

    Ukuran aliran media. Satuan: byte.

    Catatan

    Karena fitur sharding dinamis M3U8, ukuran aliran yang dihitung mungkin mengalami deviasi.

    418112
    Width

    integer

    Lebar aliran media. Satuan: px.

    360
    Fps

    string

    Laju frame aliran media. Satuan: frame per detik.

    25
    Duration

    string

    Durasi aliran media. Satuan: detik.

    9.0464
    PlayURL

    string

    URL pemutaran aliran video.

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

    string

    Format aliran media.

    • Nilainya adalah mp4 atau m3u8 untuk file video.

    • Nilainya adalah mp3 untuk file hanya audio.

    m3u8
    HDRType

    string

    Jenis High Dynamic Range (HDR) aliran media. Nilai yang valid:

    • HDR

    • HDR10

    • HLG

    • DolbyVision

    • HDRVivid

    • SDR+

    HLG
    BitDepth

    integer

    Kedalaman warna. Nilainya berupa bilangan bulat.

    8
    JobType

    integer

    Jenis watermark digital. Nilai yang valid:

    • 1: Jejak watermark.

    • 2: Watermark hak cipta.

    2
    JobExt

    string

    Informasi watermark kustom untuk watermark hak cipta. Bidang ini dikembalikan hanya saat JobType bernilai 2.

    CopyrightMarkTest
    CodecName

    string

    Jenis encoding. Nilai yang valid:

    • H264

    • H265

    H264

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.