All Products
Search

This Product

    Intelligent Media Services:GetPlayInfo

    Document Center

    Intelligent Media Services:GetPlayInfo

    Last Updated:Aug 06, 2026

    Memperoleh URL pemutaran file media (video atau audio) berdasarkan ID video atau audio. Setelah mengintegrasikan Alibaba Cloud Player SDK (untuk pemutaran berbasis URL) atau pemutar pihak ketiga, Anda dapat menggunakan URL tersebut untuk memutar konten audio dan 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

    ice:GetPlayInfo

    get

    *Semua sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    MediaId

    string

    No

    ID aset media.

    Catatan

    Setidaknya salah satu dari MediaId dan InputURL harus ditentukan.

    86434e152b7d4f20be480574439fe***
    InputURL

    string

    No

    InputURL yang ditentukan saat aset media didaftarkan. Untuk informasi selengkapnya, lihat RegisterMediaInfo.

    Catatan

    Setidaknya salah satu dari MediaId dan InputURL harus ditentukan.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4  or  vod://****20b48fb04483915d4f2cd8ac****
    AuthTimeout

    integer

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    RequestId

    string

    ID permintaan.

    ******11-DB8D-4A9A-875B-275798******
    MediaBase

    object

    Informasi aset media.

    CreationTime

    string

    Waktu pembuatan.

    2021-09-22T10:07:31+08:00
    Status

    string

    Status resource. Nilai yang valid:

    • Init: File sumber belum siap.

    • Preparing: File sumber sedang dipersiapkan, misalnya sedang diunggah atau dikomposisikan.

    • PrepareFail: Gagal mempersiapkan file sumber, misalnya gagal mendapatkan informasi file sumber.

    • Normal: File sumber sudah siap.

    Normal
    MediaId

    string

    ID aset media.

    2eea77a61c7b4ddd95bec34a6f65b***
    CoverURL

    string

    URL sampul.

    https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg
    Title

    string

    Judul.

    testTitle
    MediaType

    string

    Jenis file media. Nilai yang valid:

    video: video. audio: hanya audio.

    video
    MediaTags

    string

    Tag.

    • Maksimal 16 tag didukung.

    • Pisahkan beberapa tag dengan koma (,).

    • Panjang setiap tag maksimal 32 byte.

    • Menggunakan encoding UTF-8.

    test,ccc
    CateId

    integer

    ID kategori. Anda dapat memperoleh ID kategori dengan cara berikut:

    • Login ke Konsol IMS dan pilih Media Asset Management > Category Management untuk melihat ID kategori.

    • Saat membuat kategori dengan memanggil operasi create category, ID kategori adalah nilai CateId dalam respons.

    • Saat menanyakan kategori dengan memanggil operasi get category, ID kategori adalah nilai CateId dalam respons.

    4220
    Description

    string

    Deskripsi konten.

    desc
    PlayInfoList

    array<object>

    Informasi pemutaran audio atau video (informasi aliran).

    object

    Informasi detail audio atau video.

    CreationTime

    string

    Waktu pembuatan. Waktu mengikuti format: yyyy-MM-ddTHH:mm:ssZ (UTC).

    2022-05-10T02:28:49Z
    Status

    string

    Status aliran media. Nilai yang valid:

    • Normal: normal.

    • Invisible: tidak terlihat.

    Normal
    NarrowBandType

    string

    Jenis Narrowband HD. Nilai yang valid:

    • 0: normal.

    • 1.0: Narrowband HD 1.0.

    • 2.0: Narrowband HD 2.0.

    Parameter ini hanya berlaku jika definisi templat transkoding bawaan Narrowband HD 1.0 telah dikonfigurasi. Untuk informasi selengkapnya, lihat Konfigurasi templat transkoding - Definisi.

    0
    Height

    integer

    Tinggi aliran media. Satuan: px.

    1080
    Bitrate

    string

    Bitrate aliran media. Satuan: Kbps.

    20
    ModificationTime

    string

    Waktu modifikasi. Waktu mengikuti format: yyyy-MM-ddTHH:mm:ssZ (UTC).

    2022-05-13T11:39:41.714+08:00
    WatermarkId

    string

    ID watermark yang terkait dengan aliran media saat ini.

    5bed88672b1e2520ead228935ed51***
    Encrypt

    integer

    Menunjukkan apakah aliran media dienkripsi. Nilai yang valid:

    • 0: tidak dienkripsi.

    • 1: dienkripsi.

    0
    Definition

    string

    Definisi aliran video. Nilai yang valid:

    • FD: definisi rendah.

    • LD: definisi standar.

    • SD: definisi tinggi.

    • HD: resolusi ultra-tinggi.

    • OD: kualitas asli.

    • 2K: 2K.

    • 4K: 4K.

    • SQ: kualitas suara standar.

    • HQ: kualitas suara tinggi.

    • AUTO: bitrate adaptif.

    HD
    EncryptType

    string

    Jenis enkripsi aliran media. Nilai yang valid:

    • AliyunVoDEncryption: enkripsi video Alibaba Cloud.

    • HLSEncryption: enkripsi standar HLS.

    Catatan

    Jika jenis enkripsi adalah AliyunVoDEncryption, hanya Alibaba Cloud Player SDK yang dapat digunakan untuk pemutaran.

    AliyunVoDEncryption
    StreamType

    string

    Jenis aliran media. Jika aliran media berupa video, nilainya adalah video. Jika aliran media hanya berupa audio, nilainya adalah audio.

    video
    Size

    integer

    Ukuran aliran media. Satuan: byte.

    418112
    Width

    integer

    Lebar aliran media. Satuan: px.

    1024
    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://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4
    Format

    string

    Format aliran media.

    • Jika file media berupa video, nilai yang valid adalah mp4 dan m3u8.

    • Jika file media hanya berupa audio, nilainya adalah mp3.

    mp4
    HDRType

    string

    Jenis HDR aliran media. Nilai yang valid:

    • HDR

    • HDR10

    • HLG

    • DolbyVision

    • HDRVivid

    • SDR+

    HDR
    BitDepth

    integer

    Kedalaman bit warna.

    8
    FileURL

    string

    URL OSS file.

    http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg
    TransTemplateType

    string

    Jenis templat transkoding. Nilai yang valid:

    • Normal: templat normal.

    • AudioTranscode: transkoding audio.

    • Remux: konversi enkapsulasi.

    • NarrowBandV1: Narrowband HD 1.0.

    • NarrowBandV2: Narrowband HD 2.0.

    • UHD: peningkatan audio dan video (resolusi ultra-tinggi).

    Normal
    StreamTags

    string

    Tag aliran yang mengidentifikasi jenis pemrosesan transkoding.

    "{\"ims.audioServiceType\": \"AudioEnhancement\"}"
    JobId

    string

    ID pekerjaan.

    36c9d38e70bf43ed9f7f8f48d6356***

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaBase": {
    "CreationTime": "2021-09-22T10:07:31+08:00",
    "Status": "Normal",
    "MediaId": "2eea77a61c7b4ddd95bec34a6f65b***",
    "CoverURL": "https://***.oss-cn-shanghai.aliyuncs.com/cover/281c64d6-b5fb-4c57-97cd-84da56a8b151_large_cover_url.jpg",
    "Title": "testTitle",
    "MediaType": "video",
    "MediaTags": "test,ccc",
    "CateId": 4220,
    "Description": "desc"
  },
  "PlayInfoList": [
    {
      "CreationTime": "2022-05-10T02:28:49Z",
      "Status": "Normal",
      "NarrowBandType": "0",
      "Height": 1080,
      "Bitrate": "20",
      "ModificationTime": "2022-05-13T11:39:41.714+08:00",
      "WatermarkId": "5bed88672b1e2520ead228935ed51***",
      "Encrypt": 0,
      "Definition": "HD",
      "EncryptType": "AliyunVoDEncryption",
      "StreamType": "video",
      "Size": 418112,
      "Width": 1024,
      "Fps": "25",
      "Duration": "9.0464",
      "PlayURL": "https://***.aliyuncdn.com/sv/756bee1-17f980f0945/756bee1-17f980f0945.mp4",
      "Format": "mp4",
      "HDRType": "HDR",
      "BitDepth": 8,
      "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/43a68ee9-181809b6aba/43a68ee9-181809b6aba.mpeg",
      "TransTemplateType": "Normal",
      "StreamTags": "\"{\\\"ims.audioServiceType\\\": \\\"AudioEnhancement\\\"}\"",
      "JobId": "36c9d38e70bf43ed9f7f8f48d6356***"
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.