ApsaraVideo VOD:Pengaturan pemutaran umum

Konfigurasi nama domain

• Tambahkan nama domain

  • Konfigurasikan nama domain yang dipercepat: Pastikan nama domain ApsaraVideo VOD yang diaktifkan telah memiliki Pendaftaran ICP. Untuk informasi lebih lanjut, lihat Standar penerimaan nama domain.

  • Resolusi CNAME: Pastikan Anda telah membuat Rekaman CNAME untuk nama domain Anda. Jika tidak, pemutaran akan gagal. Untuk membuat Rekaman CNAME, lihat Mengonfigurasi Rekaman CNAME menggunakan Alibaba Cloud DNS. Anda juga dapat menggunakan layanan seperti DNSPod.

  • Konfigurasikan nama domain yang dipercepat CDN: Untuk petunjuk lengkap, lihat Menambahkan nama domain yang dipercepat.

• Konfigurasi otentikasi URL

  • Waktu kedaluwarsa: Anda dapat menggunakan parameter AuthTimeout untuk mengatur waktu kedaluwarsa URL yang dipercepat CDN. Untuk memahami cara menghitung waktu kedaluwarsa URL, lihat bagian "Waktu kedaluwarsa URL" dalam Otentikasi URL.

  • Otentikasi sekunder:

    • Saat mengonfigurasi otentikasi sekunder CDN, Anda dapat mengatur parameter ReAuthInfo untuk menambahkan parameter uid dan rand ke permintaan otentikasi CDN. Untuk informasi lebih lanjut, lihat Mengonfigurasi otentikasi sekunder CDN menggunakan ReAuthInfo.

    • Jika Anda tidak mengonfigurasi otentikasi sekunder CDN, Anda dapat menggunakan parameter rand dalam ReAuthInfo untuk menghasilkan URL unik setiap kali. Misalnya, Anda dapat menggunakan universally unique identifier (UUID) sebagai bilangan acak. Untuk informasi lebih lanjut, lihat Mengonfigurasi otentikasi sekunder CDN menggunakan ReAuthInfo.

• Pemilihan multi-nama domain

  Jika server origin Anda dikonfigurasi dengan beberapa nama domain, Anda dapat mengatur bidang PlayDomain pada parameter PlayConfig untuk mengembalikan URL pemutaran dengan nama domain CDN tertentu. Untuk informasi lebih lanjut, lihat Menyesuaikan pemutaran media menggunakan PlayConfig.

  Jika Anda perlu mendistribusikan video berbeda menggunakan nama domain yang dipercepat berbeda, Anda dapat menggunakan salah satu metode berikut:

  • Metode 1: Saat memanggil operasi GetPlayInfo, tentukan nama domain yang dipercepat berbeda untuk setiap video menggunakan bidang PlayDomain pada parameter PlayConfig. Misalnya, atur PlayConfig={"PlayDomain":"cdn-a.example.com"} untuk Video A dan PlayConfig={"PlayDomain":"cdn-b.example.com"} untuk Video B. Operasi ini akan mengembalikan URL pemutaran dengan nama domain yang sesuai.

  • Metode 2: Setelah memperoleh URL pemutaran, ganti nama domain dalam URL tersebut dengan nama domain yang dipercepat target di kode Anda. Misalnya, ganti cdn-default.example.com dalam URL yang dikembalikan dengan cdn-b.example.com.

  Sebelum menggunakan salah satu metode tersebut, tambahkan beberapa nama domain yang dipercepat dan selesaikan konfigurasi CNAME di Distribution and Acceleration > Domain Name Management.

• Akselerasi HTTPS

  Secara default, API pemutaran mengembalikan URL gambar dan pemutaran HTTP. Untuk memperoleh URL HTTPS, aktifkan akselerasi HTTPS untuk nama domain CDN Anda. Untuk petunjuk lengkap, lihat Akselerasi HTTPS.

Pengaturan transkoding

ApsaraVideo VOD memungkinkan Anda memilih apakah akan melakukan transkoding file media yang diunggah.

• Jika Anda melakukan transkoding file, layanan pemutaran akan mengembalikan URL pemutaran untuk file yang telah dikodekan ulang. Format, definisi, status enkripsi, dan ID watermark bergantung pada pengaturan transkoding Anda.

• Jika Anda tidak melakukan transkoding file, layanan pemutaran akan mengembalikan URL pemutaran untuk file sumber yang diunggah, yang diputar sebagai video sumber. Hanya file dalam format MP4, FLV, M3U8, MP3, dan WEBM yang dapat diputar langsung tanpa transkoding.

Untuk informasi lebih lanjut, lihat Templat transkoding.

Pengaturan pemutaran

Layanan pemutaran mendukung tiga metode pemutaran berikut:

• Pratinjau konsol: Tidak diperlukan konfigurasi.

• URL pemutaran: Saat memanggil operasi GetPlayInfo, Anda dapat menggunakan pengaturan pemutaran berbeda untuk menyaring URL pemutaran yang dikembalikan.

• Pemutar: Konfigurasikan pengaturan pemutaran di SDK ApsaraVideo Player. Pemutar kemudian secara otomatis menyaring dan memilih URL pemutaran.

Pengaturan API pemutaran

Operasi GetPlayInfo ApsaraVideo VOD memungkinkan Anda menyaring hasil berdasarkan kriteria berikut untuk berbagai skenario pemutaran.

• Definisi

  Parameter Definition memungkinkan Anda memilih beberapa definisi sekaligus untuk mengaktifkan pergantian definisi berdasarkan kondisi jaringan. Jika Anda tidak mengatur parameter ini, API pemutaran akan mengembalikan URL pemutaran untuk semua definisi yang tersedia dari video yang ditentukan.

• Format file output

  Parameter Formats menentukan format kontainer file yang telah dikodekan ulang. Saat ini, hanya MP4, MP3, dan M3U8 yang didukung. Anda dapat menentukan beberapa nilai.

• Jenis aliran output

  Parameter StreamType menentukan apakah aliran tersebut berupa video atau audio.

• Jenis file output

  Parameter OutputType:

  • Jika Anda tidak mengonfigurasi nama domain yang dipercepat CDN, API pemutaran secara default mengembalikan URL origin OSS.

  • Setelah Anda mengonfigurasi nama domain yang dipercepat CDN, API pemutaran secara default mengembalikan URL yang dipercepat CDN.

  • Anda juga dapat mengatur parameter OutputType untuk memperoleh URL origin OSS atau URL yang dipercepat CDN.

• Jenis hasil output

  Parameter ResultType: Secara default, ApsaraVideo VOD hanya menyediakan satu URL pemutaran untuk setiap kombinasi definisi dan format. Jika Anda mengirimkan pekerjaan transkoding media baru untuk video yang telah dikodekan ulang sebelumnya, beberapa URL pemutaran dibuat untuk setiap kombinasi definisi dan format. Untuk memastikan pemutaran output terbaru, API pemutaran secara default hanya mengembalikan URL aliran terbaru. Jika Anda perlu mengambil semua URL untuk semua aliran yang telah dikodekan ulang, atur parameter ResultType ke Multiple.

  Penting

  Jika sebuah video memiliki lebih dari 100 URL aliran output, pengaturan ResultType ke Multiple akan mengembalikan maksimal 100 URL aliran output.

Pengaturan pemutar

SDK ApsaraVideo Player dapat menggunakan Kredensial pemutaran untuk secara otomatis memperoleh URL pemutaran. SDK tersedia untuk Web (H5 dan Flash), iOS, dan Android. Bagian berikut menjelaskan pengaturan pemutaran yang didukung untuk masing-masing platform.

• SDK ApsaraVideo Player untuk Web

  • Dengan pemutar H5, Anda dapat mengatur jenis aliran output (mediaType), format file output (format), dan definisi (definition). Untuk informasi lebih lanjut, lihat Fitur.

  • Pemutar Flash hanya mendukung pemutaran file video. Anda dapat mengatur jenis aliran output (mediaType) dan format file output (format).

• SDK ApsaraVideo Player untuk iOS

  Anda dapat mengatur format file output (format) dan definisi yang diinginkan (quality).

• SDK ApsaraVideo Player untuk Android

  Anda dapat mengatur format file output (format) dan definisi yang diinginkan (quality).