全部产品
Search
文档中心

ApsaraVideo VOD:Pemutaran Media

更新时间:Jul 06, 2025

ApsaraVideo VOD mendukung pemutaran audio dan video. Anda dapat melihat pratinjau file audio dan video di Konsol ApsaraVideo VOD atau memutar file tersebut menggunakan SDK Pemutar ApsaraVideo atau pemain pihak ketiga. Topik ini menjelaskan proses, persiapan, prasyarat, metode, URL pemutaran, dan keamanan untuk pemutaran audio dan video.

Pengenalan

ApsaraVideo VOD mendukung pemutaran jenis file audio dan video berikut:

  • File aliran yang telah dikodekan ulang: Jika Anda menentukan template transkoding saat mengunggah file audio dan video, file aliran yang telah dikodekan ulang akan dibuat.

  • File asli: Jika Anda menggunakan template Tanpa Transcoding saat mengunggah file audio dan video, file diputar dalam kualitas asli. Anda hanya dapat memutar file audio dan video dalam format MP4, FLV, M3U8, MP3, dan WEBM dalam kualitas asli tanpa transkoding.

Anda dapat menggunakan salah satu metode berikut untuk memutar file audio dan video:

Anda dapat menggunakan salah satu metode berikut untuk mendapatkan URL pemutaran:

  • Lihat notifikasi peristiwa setelah transkoding selesai atau panggil operasi GetPlayInfo.

  • Integrasi SDK Pemutar ApsaraVideo dan panggil operasi GetVideoPlayAuth untuk mendapatkan kredensial pemutaran. SDK Pemutar ApsaraVideo secara otomatis mendapatkan URL pemutaran berdasarkan kredensial pemutaran.

Persiapan

  • Konfigurasikan nama domain untuk akselerasi. Pastikan bahwa pengajuan ICP untuk nama domain yang ingin digunakan di ApsaraVideo VOD sudah selesai. Untuk informasi lebih lanjut, lihat Persyaratan Nama Domain.

  • Ikat rekaman CNAME ke nama domain. Jika Anda tidak mengikat rekaman CNAME ke nama domain, pemutaran video gagal. Untuk informasi lebih lanjut, lihat Tambahkan Rekaman CNAME di Alibaba Cloud DNS. Anda juga dapat menggunakan DNSPod untuk mengikat rekaman CNAME ke nama domain. Untuk informasi lebih lanjut, lihat Konfigurasikan Rekaman CNAME pada DNSPod.

  • Konfigurasikan pengaturan transkoding. Anda dapat menentukan apakah akan transcoding file media yang diunggah ke ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Transkoding Audio dan Video.

  • Tentukan kebijakan keamanan. ApsaraVideo VOD menyediakan beberapa kebijakan keamanan termasuk kontrol akses, penandatanganan URL, otentikasi jarak jauh, enkripsi video, dan unduhan aman untuk melindungi konten video Anda. Kebijakan keamanan menentukan apakah video dapat diputar. Untuk informasi lebih lanjut, lihat Ikhtisar.

Prasyarat

  • Status Video

    Saat file audio atau video sedang diproduksi, diproses, atau didistribusikan, status file audio atau video berubah. Status video adalah kondisi utama yang menentukan apakah video dapat diputar. Untuk informasi lebih lanjut tentang status video, lihat bagian "Status: status video" dari topik Tipe Data Dasar. Gambar berikut menunjukkan bagaimana status video berubah.

    • Perubahan status saat transkoding diaktifkan

    • Perubahan status saat transkoding dinonaktifkan

  • Video yang Dapat Diputar

    • Hanya video yang Status-nya adalah Normal yang dapat diputar. Anda dapat memperoleh URL pemutaran video ini dengan menggunakan API atau SDK ApsaraVideo VOD.

    • Video yang Status-nya adalah Checking atau Blocked hanya dapat diputar menggunakan Konsol ApsaraVideo VOD atau alamat IP yang ditambahkan ke grup keamanan tinjauan. Anda dapat menambahkan alamat IP ke grup keamanan tinjauan menggunakan API atau SDK ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Pratinjau Alamat IP Keamanan.

  • Kapan Video Siap untuk Diputar

    Setelah video diunggah, video siap untuk diputar hanya setelah ApsaraVideo VOD menerima video tersebut. Anda dapat menentukan kapan video siap untuk diputar berdasarkan notifikasi peristiwa.

    • File audio atau video yang tidak dikodekan ulang siap untuk diputar setelah Anda menerima notifikasi peristiwa FileUploadComplete. Setelah Anda menerima notifikasi peristiwa FileUploadComplete, Anda dapat memanggil operasi GetPlayInfo untuk mendapatkan URL pemutaran. Anda hanya dapat memutar file audio dan video dalam format MP4, FLV, M3U8, MP3, dan WEBM tanpa transkoding.

    • File audio atau video yang dikodekan ulang siap untuk diputar setelah Anda menerima notifikasi peristiwa StreamTranscodeComplete. Untuk memastikan bahwa video dalam semua definisi diperoleh, putar video setelah Anda menerima notifikasi peristiwa TranscodeComplete.

Mode pemutaran

  • Pratinjau Video di Konsol ApsaraVideo VOD

    ApsaraVideo VOD menyediakan pemain yang dapat Anda gunakan untuk melihat pratinjau video. Saat menggunakan pemain, Anda dapat mengonfigurasi fast-forwarding, volume, subtitle, trek audio, definisi, dan komentar peluru untuk video. Ini memungkinkan Anda melihat pratinjau video dengan cara yang nyaman.预览视频

    • Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sisi kiri, klik Audio/Video. Pada halaman Video and Audio yang muncul, lihat pratinjau video. Aliran terenkripsi diprioritaskan untuk diputar.

    • Di halaman Video dan Audio, temukan video yang ingin Anda pratinjau dan klik Kelola di kolom Tindakan. Pada tab URL Video, pilih aliran yang ingin Anda pratinjau. Untuk memastikan keamanan video, Anda hanya dapat melihat pratinjau aliran yang tidak terenkripsi di tab URL Video.

  • Integrasi SDK Pemutar ApsaraVideo

  • Integrasi Pemain Pihak Ketiga

    • Anda dapat mengintegrasikan pemain pihak ketiga untuk mendapatkan URL pemutaran untuk pemutaran. Untuk informasi lebih lanjut, lihat Dapatkan URL Pemutaran untuk Memutar Video.

    • Anda dapat melewati URL pemutaran ke pemain pihak ketiga untuk pemutaran. Dalam hal ini, Anda harus melakukan operasi pengembangan seperti mengonversi definisi video dan menangani pengecualian.

URL pemutaran

  • Nama Domain Akselerasi Dikonfigurasi

    Jika Anda mengonfigurasi nama domain akselerasi di Konsol ApsaraVideo VOD, URL pemutaran video adalah URL CDN Alibaba Cloud. Untuk melihat URL pemutaran, lakukan langkah-langkah berikut: Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sisi kiri, klik Audio/Video. Pada halaman Video dan Audio, temukan video yang ingin Anda lihat URL pemutarannya dan klik Kelola di kolom Tindakan. Pada tab URL Video, lihat URL pemutaran video. URL pemutaran diklasifikasikan menjadi URL tetap dan URL dinamis berdasarkan apakah penandatanganan URL diaktifkan. Untuk informasi lebih lanjut tentang cara mengaktifkan dan mengonfigurasi penandatanganan URL, lihat Konfigurasikan Autentikasi URL.

    • URL Tetap

      URL tetap tidak mengandung informasi autentikasi (auth_key). Mereka dihasilkan saat penandatanganan URL dinonaktifkan. URL tetap valid secara permanen dan cocok untuk skenario yang memiliki persyaratan keamanan rendah. Secara default, penandatanganan URL dinonaktifkan setelah Anda menambahkan nama domain ke ApsaraVideo VOD.

    • URL Dinamis

      URL dinamis dihasilkan secara dinamis dan kedaluwarsa setelah periode waktu tertentu. Mereka cocok untuk skenario yang memiliki persyaratan keamanan tinggi. Parameter Default Validity Period yang Anda tentukan saat mengaktifkan penandatanganan URL menentukan periode validitas default dari URL dinamis. Anda dapat menentukan periode validitas saat Anda menghasilkan URL pemutaran atau saat Anda memanggil operasi GetPlayInfo. Untuk informasi lebih lanjut, lihat Konfigurasikan Autentikasi URL dan GetPlayInfo. Jika Anda mengakses URL pemutaran yang kedaluwarsa, kode status HTTP 403 dikembalikan.

      Contoh Kode:

      http://example.aliyundoc.com/video/aliyun-sample.mp4?auth_key=1500523200-0-0-80cd3862d699b7118eed99103f2a****
      Catatan

      Dalam contoh ini, angka sebelum tanda hubung (-) pertama dalam nilai parameter auth_key adalah 1500523200. Ini menunjukkan waktu 12:00:00 pada tanggal 20 Juli 2017. Jika parameter Default Validity Period diatur ke 60 menit, URL ini kedaluwarsa pada 13:00:00 pada tanggal 20 Juli 2017.

  • Tidak Ada Nama Domain Akselerasi yang Dikonfigurasi

    • Jika Anda tidak mengonfigurasi nama domain akselerasi, URL pemutaran video adalah URL Layanan Penyimpanan Objek (OSS) dan penandatanganan URL tidak didukung. Dalam hal ini, informasi autentikasi OSS dihasilkan secara otomatis. Untuk informasi lebih lanjut, lihat Tambahkan Tanda Tangan ke URL di dokumentasi OSS. Anda masih dapat menggunakan parameter AuthTimeout untuk menentukan periode validitas URL OSS saat Anda memanggil operasi GetPlayInfo. Namun, Anda tidak dapat membuat aturan autentikasi kustom berdasarkan pasangan AccessKey.

    • Jika Anda mengatur Izin Baca-Tulis untuk bucket ke Baca Publik dan Tulis Pribadi di halaman Storage di Konsol ApsaraVideo VOD, abaikan informasi autentikasi OSS. Dalam hal ini, URL pemutaran valid secara permanen. Namun, URL tersebut rentan terhadap pencurian tautan dan unduhan ilegal. Kami merekomendasikan agar Anda mengatur Izin Baca-Tulis ke Baca Pribadi dan Tulis Pribadi untuk bucket. Untuk informasi lebih lanjut, lihat Kelola Penyimpanan VOD.

Untuk informasi lebih lanjut tentang pengaturan URL pemutaran umum, lihat Pengaturan Pemutaran Umum.

Keamanan pemutaran (batasan pada pemutaran dan unduhan)

  • Keamanan Video

    ApsaraVideo VOD menyediakan beberapa kebijakan keamanan termasuk kontrol akses, penandatanganan URL, enkripsi video (Kriptografi Milik Alibaba Cloud dan Enkripsi HLS) untuk melindungi konten video Anda. Untuk informasi lebih lanjut, lihat Batasan Akses, Konfigurasikan Autentikasi URL, dan Ikhtisar.

  • Keamanan Akun

    Untuk memastikan keamanan akun Anda, jangan gunakan pasangan AccessKey dari akun Alibaba Cloud Anda atau dari pengguna RAM di klien, terutama klien web untuk mengakses ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Ikhtisar.

Kesalahan pemutaran

Jika kesalahan pemutaran terjadi, Anda dapat menggunakan alat pemeriksaan untuk URL pemutaran guna mendiagnosis kesalahan. Alat ini memungkinkan Anda mendiagnosis kesalahan pemutaran umum dan memberikan saran untuk menyelesaikan kesalahan tertentu. Untuk informasi lebih lanjut, lihat Selesaikan Kesalahan Pemutaran.