Mengembangkan dengan Media Services v3 API

  • Artikel

Logo Azure Media Services v3

Peringatan

Azure Media Services akan dihentikan pada 30 Juni 2024. Untuk informasi selengkapnya, lihat Panduan Penghentian AMS.

Sebagai pengembang, Anda dapat menggunakan pustaka klien untuk (.NET, Python, Node.js, Java, and Go) agar Anda dapat berinteraksi dengan REST API dalam membuat, mengelola, dan memelihara alur kerja media kustom. Media Services v3 API didasarkan pada spesifikasi OpenAPI (sebelumnya dikenal sebagai Swagger).

Artikel ini membahas aturan yang berlaku untuk entitas dan API saat Anda mengembangkannya dengan Media Services v3.

Peringatan

Tidak disarankan untuk mencoba membungkus REST API untuk Media Services langsung ke kode pustaka Anda sendiri, karena melakukannya dengan benar untuk tujuan produksi akan mengharuskan Anda untuk menerapkan logika coba ulang Manajemen Sumber Daya Azure lengkap dan memahami cara mengelola operasi yang berjalan lama di API Manajemen Sumber Daya Azure. Ini ditangani oleh SDK klien untuk berbagai bahasa pemrogram - .NET, Java, TypeScript, Python, dll. - secara otomatis dan mengurangi kemungkinan adanya masalah terkait logika coba lagi atau panggilan API yang gagal. SDK klien semuanya sudah menangani ini untuk Anda.

Mengakses Azure Media Services API

Agar berhak untuk mengakses sumber daya Media Services dan Media Services API, Anda harus diautentikasi terlebih dahulu. Media Services mendukung autentikasi berbasis Azure Active Directory (Azure AD). Dua opsi autentikasi umum yaitu:

  • Autentikasi perwakilan layanan: Digunakan untuk mengautentikasi layanan (misalnya: aplikasi web, aplikasi fungsi, aplikasi logika, API, dan layanan mikro). Aplikasi yang umumnya menggunakan metode autentikasi ini adalah aplikasi yang menjalankan layanan daemon, layanan tingkat menengah, atau pekerjaan yang terjadwal. Misalnya, untuk aplikasi web harus selalu ada tingkat menengah yang terhubung ke Media Services dengan Perwakilan Layanan.
  • Autentikasi pengguna: Digunakan untuk mengautentikasi orang yang menggunakan aplikasi untuk berinteraksi dengan sumber daya Media Services. Aplikasi interaktif harus terlebih dulu meminta info masuk pada pengguna. Contohnya adalah aplikasi konsol manajemen yang digunakan oleh pengguna yang berwenang untuk memantau pekerjaan pengodean atau streaming langsung.

Media Services API mengharuskan pengguna atau aplikasi membuat permintaan REST API memiliki akses ke sumber daya akun Media Services dan menggunakan peran Kontributor atau Pemilik. API dapat diakses dengan peran Pembaca, tetapi hanya operasi Get atau List yang akan tersedia. Untuk informasi selengkapnya, lihat akses kendali berbasis peran Azure (Azure RBAC) untuk akun Media Services.

Daripada membuat perwakilan layanan, pertimbangkan untuk menggunakan identitas terkelola untuk sumber daya Azure untuk mengakses Media Services API melalui Azure Resource Manager. Untuk mempelajari lebih lanjut tentang identitas terkelola untuk sumber daya Azure, lihat Apa identitas terkelola untuk sumber daya Azure.

Perwakilan layanan Azure Active Directory

Perwakilan layanan dan aplikasi Azure Active Directory harus berada di penyewa yang sama. Setelah Anda membuat aplikasi, berikan akses peran kepada Kontributor atau Pemilik aplikasi ke akun Azure Media Services.

Jika Anda tidak yakin apakah Anda memiliki izin untuk membuat aplikasi Azure Active Directory, lihat Izin yang diperlukan.

Dalam gambar sebelumnya, angka mewakili aliran permintaan dalam urutan kronologis:

Autentikasi aplikasi tingkat menengah dengan AAD dari API web

  1. Aplikasi tingkat menengah meminta token akses Azure Active Directory yang memiliki parameter berikut:

    • Titik akhir penyewa Azure Active Directory.
    • URI sumber daya Media Services.
    • URI Sumber Daya untuk REST Media Services.
    • Nilai aplikasi Azure Active Directory: ID klien dan rahasia klien.

    Untuk mendapatkan semua nilai yang diperlukan, lihat Mengakses Azure Media Services API.

  2. Token akses Azure Active Directory dikirim ke tingkat tengah.

  3. Tingkat tengah mengirimkan permintaan ke Azure Media REST API dengan token Azure Active Directory.

  4. Tingkat tengah mendapatkan kembali data dari Azure Media Services.

Sampel

Lihat contoh berikut yang memperlihatkan cara terhubung dengan perwakilan layanan Azure Active Directory:

Konvensi penamaan

Nama sumber daya Azure Media Services v3 (contohnya, Aset, Pekerjaan, Transformasi) tunduk pada batasan penamaan Azure Resource Manager. Sesuai dengan Azure Resource Manager, nama sumber daya selalu unik. Dengan demikian, Anda dapat menggunakan string pengidentifikasi unik (misalnya, GUID) untuk nama sumber daya Anda.

Nama sumber daya Media Services tidak dapat mencakup: '', '<>', '%', '&', ':', '\', '?', '/', '*', '+', '.', karakter kutipan tunggal, atau karakter kontrol apa pun. Semua karakter lainnya diperbolehkan. Panjang maksimum nama sumber daya adalah 260 karakter.

Untuk informasi selengkapnya tentang penamaan Azure Resource Manager, lihat Persyaratan penamaan dan Konvensi penamaan.

Nama file/blob dalam aset

Nama file/blob dalam aset harus mengikuti persyaratan nama blob maupun persyaratan nama NTFS. Alasan untuk persyaratan ini adalah agar file dapat disalin dari penyimpanan blob ke disk NTFS lokal untuk pemrosesan.

Operasi jangka panjang

Operasi yang ditandai x-ms-long-running-operation dengan dalam file swagger Azure Media Services adalah operasi yang berjalan lama.

Untuk detail tentang cara melacak operasi Azure asinkron, lihat Operasi Asinkron.

Media Services memiliki operasi jangka panjang berikut ini:

Setelah berhasil pengajuan operasi yang panjang, Anda menerima '201 Dibuat' dan harus melakukan jajak pendapat untuk penyelesaian operasi menggunakan ID operasi yang dikembalikan.

Artikel melacak operasi Azure asinkron menjelaskan secara mendalam cara melacak status operasi Azure asinkron melalui nilai yang ditampilkan dalam respons.

Hanya satu operasi jangka panjang yang didukung untuk Peristiwa Langsung tertentu atau Output Langsung terkait. Setelah dimulai, operasi jangka panjang harus diselesaikan sebelum memulai operasi jangka panjang berikutnya pada LiveEvent yang sama atau Output Langsung terkait. Untuk Peristiwa Langsung dengan beberapa Output Langsung, Anda harus menunggu penyelesaian operasi yang berjalan lama pada satu Output Langsung sebelum memicu operasi yang berjalan lama pada Output Langsung lainnya.

SDK

Catatan

Azure Media Services v3 SDK tidak dijamin aman untuk utas. Saat mengembangkan aplikasi multiutas, Anda harus menambahkan logika sinkronisasi utas Anda sendiri untuk melindungi klien atau menggunakan objek AzureMediaServicesClient baru per utas. Anda juga harus berhati-hati terhadap masalah multiutas yang diperkenalkan oleh objek opsional yang disediakan oleh kode Anda kepada klien (seperti instans HttpClient di .NET).

SDK Referensi
.NET SDK .NET ref
Java SDK Java ref
Python SDK Python ref
Node.js SDK Node.js ref
Go SDK Go ref

Lihat juga

Azure Media Services Explorer

Azure Media Services Explorer (AMSE) adalah alat yang tersedia untuk pelanggan Windows yang ingin mempelajari tentang Media Services. AMSE adalah aplikasi Winforms/C# yang mengunggah, mengunduh, mengodekan, melakukan streaming VOD dan konten langsung dengan Media Services. Alat AMSE adalah untuk klien yang ingin menguji Media Services tanpa menulis kode apa pun. Kode AMSE disediakan sebagai sumber daya bagi pelanggan yang ingin mengembangkan dengan Media Services.

AMSE adalah proyek Sumber Terbuka, dukungan disediakan oleh komunitas (masalah dapat dilaporkan ke https://github.com/Azure/Azure-Media-Services-Explorer/issues). Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Kode Etik atau hubungi opencode@microsoft.com dengan pertanyaan atau komentar lainnya.

Pemfilteran, pengurutan, pemanggilan entitas Media Services

Lihat Pemfilteran, pengurutan, pemanggilan entitas Media Services.

Mendapatkan bantuan dan dukungan

Anda dapat menghubungi Media Services dengan pertanyaan atau mengikuti pembaruan kami dengan salah satu metode berikut: