Bagaimana cara menggunakan ApsaraVideo Player SDK untuk memutar video? - ApsaraVideo Media Processing

ApsaraVideo Media Processing (MPS) memungkinkan Anda memutar video berdasarkan URL pemutaran atau ID media. Topik ini menjelaskan cara memutar video.

Metode pemutaran

Memutar video berdasarkan URL pemutaran mereka
- Skenario: Video yang ditranskode oleh MPS memiliki URL output tertentu. Untuk memutar video yang telah ditranskode, Anda dapat langsung meneruskan URL Object Storage Service (OSS)-nya atau URL Content Delivery Network (CDN) ke ApsaraVideo Player SDK.
- Keuntungan: Server menghasilkan URL pemutaran sehingga klien dapat langsung menggunakan URL tersebut untuk memutar video.
- Kerugian: Server perlu mengimplementasikan autentikasi OSS atau autentikasi CDN dan menggunakan nama domain untuk menggabungkan URL pemutaran. Selain itu, baik pengalihan resolusi otomatis maupun manual tidak dapat diimplementasikan di sisi klien.
Memutar video berdasarkan ID media mereka
- Keuntungan: Dalam alur kerja media, setiap file media input secara unik ditentukan oleh ID media. Anda dapat mengaitkan beberapa format output dan resolusi dengan ID media. Dengan cara ini, jika Anda memutar file media berdasarkan ID medianya, Anda dapat memutar file media dalam format berbeda dan beralih antar resolusi secara otomatis.
- Metode pemutaran: Gunakan Security Token Service (STS) dari Resource Access Management (RAM) untuk memutar video berdasarkan ID media mereka. STS tidak menggunakan izin akun Alibaba Cloud Anda. Sebagai gantinya, STS memungkinkan Anda memberikan izin terbatas dengan periode validitas tertentu kepada pengguna RAM atau peran RAM. Ini mencegah penyalahgunaan izin dan kebocoran data.
Catatan
- Anda harus memutar video terenkripsi berdasarkan ID media mereka untuk memastikan keamanan. Pemutar HTML5 tidak dapat memutar video terenkripsi. Kami menyarankan Anda menggunakan pemutar Flash untuk memutar video terenkripsi pada klien web.
- Anda dapat menggunakan alur kerja media untuk membuat file video-on-demand (VOD) dari streaming langsung. Untuk memutar file VOD, Anda dapat memanggil operasi QueryMediaListByURL untuk menanyakan ID media file VOD dengan menentukan URL-nya dalam parameter permintaan. Untuk informasi lebih lanjut, lihat Ikhtisar.

Memutar video berdasarkan URL pemutaran mereka

Implementasikan autentikasi OSS atau autentikasi CDN dan gunakan nama domain untuk menggabungkan URL pemutaran di server. Lalu, teruskan langsung URL OSS atau URL CDN dari video yang akan diputar ke ApsaraVideo Player SDK. Untuk informasi lebih lanjut tentang autentikasi, lihat bagian Autentikasi Pemutaran dari topik ini.

Memutar video berdasarkan ID media mereka

Untuk memutar video terenkripsi berdasarkan ID media mereka, Anda harus menggunakan STS dari RAM. Untuk informasi lebih lanjut tentang STS, lihat bagian STS dari topik ini.

Untuk mengenkripsi video, lakukan langkah-langkah berikut:

Buat layanan penerbitan token untuk menghasilkan parameter MtsHlsUriToken.
Penting
Layanan penerbitan token digunakan untuk menghasilkan parameter MtsHlsUriToken.
Panggil operasi Decrypt dari KMS untuk membuat layanan dekripsi dan kembalikan DK ke pemutar.
Penting
Setelah Anda memanggil operasi Decrypt dari KMS untuk mendapatkan DK yang dikodekan Base64 dari KMS, dekode DK menggunakan algoritma Base64 dan kembalikan DK yang didekode ke pemutar.
Panggil operasi QueryMediaList dari MPS untuk menanyakan URL OSS dari file M3U8, tambahkan parameter MtsHlsUriToken ke URL OSS, dan kemudian kembalikan URL OSS ke pemutar.
Pemutar menggunakan parameter MtsHlsUriToken dan DK untuk meminta URL streaming video dari CDN. CDN memodifikasi file M3U8 dan mengembalikan key URI dan EDK ke pemutar. Kemudian, pemutar mendekripsi dan memutar video.

STS

Untuk menggunakan STS, Anda harus melampirkan kebijakan yang diperlukan ke peran RAM saat Anda mengotorisasi pengguna RAM. Untuk informasi lebih lanjut, lihat Buat peran RAM untuk akun Alibaba Cloud tepercaya dan otorisasi peran RAM untuk mengakses MPS.
Setelah Anda membuat dan mengotorisasi pengguna RAM, minta token keamanan. Untuk informasi lebih lanjut, lihat Minta Token Keamanan. Untuk informasi lebih lanjut tentang contoh SDK STS untuk bahasa pemrograman lainnya, lihat SDK STS untuk Java, SDK STS untuk .NET, SDK STS untuk Python, SDK STS untuk Node.js, dan SDK STS untuk Go.

Autentikasi pemutaran

Tabel berikut menjelaskan parameter dari ApsaraVideo Player SDK.

Parameter	Deskripsi	Tipe	Diperlukan
vid	ID media.	String	Ya
source	URL pemutaran.	String	Ya
accId	ID AccessKey yang digunakan untuk meminta token keamanan.	String	Ya
accSecret	Rahasia AccessKey yang digunakan untuk meminta token keamanan.	String	Ya
stsToken	Token keamanan.	String	Ya
domainRegion	Wilayah tempat alur kerja media berada, seperti Tiongkok (Shanghai) atau Tiongkok (Hangzhou).	String	Ya
authInfo	Informasi autentikasi. Nilainya adalah string JSON. Untuk informasi lebih lanjut tentang isi string JSON, lihat deskripsi berikut.	String	Ya

Nilai parameter authInfo adalah string JSON yang berisi tiga argumen:

ExpireTime: waktu ketika autentikasi kedaluwarsa. Saat Anda mendapatkan URL pemutaran video yang ditentukan, pastikan bahwa autentikasi masih valid. Jika tidak, Anda tidak dapat memutar video. Waktu ditampilkan dalam UTC. Waktu non-UTC harus dikonversi menjadi UTC. Tentukan waktu dalam standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ, misalnya, 2021-03-25T23:59:59Z.
MediaId: ID media dari file media yang diproses oleh MPS.
Signature: tanda tangan autentikasi yang digunakan untuk menyaring permintaan palsu.
Untuk menghitung tanda tangan, lakukan langkah-langkah berikut:
- Konfigurasikan parameter dalam pasangan nilai-kunci.
```
ExpireTime="2017-03-25T23:59:59Z"
  MediaId="5aa0276ff6204ace950f75acf9e6187b"
```
- Buat string tanda tangan.
  Gabungkan pasangan nilai-kunci dalam urutan abjad dan gunakan ampersand (&) untuk membuat string tanda tangan. Format nilai harus sesuai dengan spesifikasi RFC2396 untuk pengkodean URL UTF-8. Untuk informasi lebih lanjut, lihat Pengkodean URL.
```
ExpireTime=2017-03-25T23%3A59%3A59Z&MediaId=5aa0276ff6204ace950f75acf9e6187b
```
- Hitung tanda tangan.
  Hitung nilai HMAC_SHA1 dalam biner dari string tanda tangan sebelumnya dan enkode nilai HMAC_SHA1 dalam format Base64.
  Di sistem mirip UNIX, Anda dapat menjalankan perintah base64 dari OpenSSL untuk mengenkode nilai HMAC_SHA1 yang dihitung ke dalam format Base64. Jika kunci autentikasi adalah rahasia, Anda dapat menjalankan perintah berikut untuk menghitung tanda tangan:
```
$echo -n 'ExpireTime=2017-03-25T23%3A59%3A59Z&MediaId=5aa0276ff6204ace950f75acf9e6****' | openssl sha1 -binary -hmac 'secret' | base64
  z7mmSRuTXo4mydiWhRtbu8JKDpM=
```
- Hasilkan tanda tangan.
```
{
    "ExpireTime":"2017-03-25T23:59:59Z",
    "MediaId":"5aa0276ff6204ace950f75acf9e6****",
    "Signature":"z7mmSRuTXo4mydiWhRtbu8JKDpM="
  }
```

Pemutar

MPS Player terintegrasi dengan ApsaraVideo Player. Untuk informasi lebih lanjut, lihat Pengantar SDK Pemutar.

Catatan

Anda dapat meningkatkan ke ApsaraVideo Player Pro berdasarkan kebutuhan bisnis Anda.