Memecahkan masalah Azure Media Services
Peringatan
Azure Media Services akan dihentikan pada 30 Juni 2024. Untuk informasi selengkapnya, lihat Panduan Penghentian AMS.
Temukan penyebab dan solusi masalah dengan Media Services.
Catatan
Banyak masalah dapat diatasi dengan bermigrasi ke API Media Services v3 atau dengan membaca panduan praktik terbaik streaming langsung.
Masalah akun
| Penyebab | Solusi |
|---|---|
| Anda mungkin mencoba menggunakan fitur API v3 dengan akun v2 atau implementasi API v2. | Perbarui kode Anda untuk menggunakan API v3. Untuk mendapatkan bantuan lebih rinci, lihat Panduan migrasi. |
Masalah umum pemutaran video
- Video membutuhkan waktu lama saat mulai diputar.
- Video buram saat mulai diputar.
- Video berkualitas rendah.
- Video tidak berputar sekali atau menampilkan layar hitam.
| Penyebab | Solusi |
|---|---|
| Anda mungkin mencoba menjangkau audiens yang besar tanpa menggunakan CDN yang menyebabkan masalah latensi. | Tambahkan CDN ke pencari streaming Anda. Untuk mengetahui informasi selengkapnya tentang cara menggunakan CDN, lihat Melakukan streaming konten dengan integrasi CDN. |
| Anda mungkin belum menerapkan kemasan dinamis. | Untuk mengetahui informasi selengkapnya tentang penerapan kemasan dinamis, lihat Pengemasan dinamis di Media Services v3. |
| Anda mungkin memiliki apa yang dikenal sebagai "tetangga berisik", yang berarti Anda berbagi sumber daya komputasi dengan pelanggan lain. | Untuk menghindari "tetangga berisik", lakukan peningkatan dari titik akhir streaming standar ke titik akhir streaming premium dengan unit streaming khusus. |
| Anda mungkin menggunakan browser yang lebih lama untuk melihat video. | Tingkatkan browser Anda. |
| Anda mungkin menggunakan filter dan pemutar pihak ketiga. | Tambahkan audio-only=false ke URL streaming agar menjadi https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false) |
Anda tidak dapat memutar file MP4 dari aset
| Penyebab | Solusi |
|---|---|
| Azure Media Services dirancang untuk menggunakan file manifes daripada memutar aliran MP4 ukuran penuh secara langsung. File manifes memberi tahu pemutar fragmen media yang dikodekan mana yang akan diputar dan dalam urutan apa. | Gunakan salah satu encoder media yang disediakan untuk membuat fragmen media dan file manifes. Untuk mengetahui informasi pengodean selengkapnya, lihat Pengodean sadar konten dan Mengodekan dengan pengodean tangga laju bit yang dibuat secara otomatis. |
| Nama file berisi karakter yang dicadangkan. | Hapus karakter yang dicadangkan dari nama berkas. |
Karakter khusus
- Azure Media Services menggunakan nilai name file aset saat membuat URL untuk konten streaming. Karena alasan ini, pengodean persen tidak diperbolehkan. Nilai properti nama tidak boleh memiliki salah satu karakter yang dicadangkan pengodean persen berikut: !*'();:@&=+$,/?%#[]". Juga, hanya ada satu '.' untuk ekstensi nama file.
- Panjang nama tidak boleh melebihi 260 karakter.
Konten terenkripsi tidak akan diputar dalam mode offline.
| Penyebab | Solusi |
|---|---|
| Pemutar yang Anda gunakan untuk memutar video terenkripsi AES yang telah diunduh dalam mode offline di perangkat iOS menangani cara video tersebut diputar. Penyebabnya bukan karena Media Services. | Tinjau dokumentasi untuk pemutar video offline pilihan Anda. |
Audio tidak sinkron.
| Penyebab | Solusi |
|---|---|
| Penyediaan paket video terlambat. | Solusi yang dapat dilakukan: 1. Anda mungkin telah menerapkan kebijakan penerapan versi penyimpanan yang diaktifkan secara otomatis yang menyebabkan buffer dan terputusnya sambungan. Hapus kebijakan dan nonaktifkan penerapan versi penyimpanan otomatis. 2. Aktifkan CDN. 3. Gunakan Titik akhir streaming premium dengan unit cadangan yang memadai. |
Permintaan pemutar untuk file VTT menyebabkan kesalahan CORS.
| Penyebab | Solusi |
|---|---|
| Penyiapan aturan CORS | Siapkan aturan CORS untuk akun penyimpanan atau CDN Anda. |
Anda juga bisa mendapatkan URL pengunduhan file VTT dari aset.
Titik akhir streaming tidak memulai.
| Penyebab | Solusi |
|---|---|
| Anda mungkin telah membuat kebijakan kustom yang hanya mengaktifkan HTTPS. Opsi ini masih belum didukung oleh Media Services. | Solusi yang memungkinkan: 1. Di portal Microsoft Azure, nonaktifkan kebijakan kustom Anda. 2. Buat titik akhir streaming dengan CDN aktif dan nonaktifkan HTTP untuk titik akhir CDN. Atau 1. Jangan mengaktifkan CDN untuk titik akhir streaming dengan portal atau API. 2. Sebagai gantinya, buka halaman Azure CDN di portal Microsoft Azure atau gunakan API Azure CDN untuk membuat titik akhir yang menunjuk ke titik akhir Media Services, mengatur asal untuk titik akhir CDN ke nama host untuk titik akhir streaming. |
| Anda mungkin telah menghentikan titik akhir streaming dengan CDN. | Lihat Titik akhir streaming tidak memulai |
Titik akhir streaming dengan CDN tidak berhenti.
| Penyebab | Solusi |
|---|---|
| Saat Anda mengaktifkan CDN untuk titik akhir streaming apa pun, titik akhir CDN tidak akan dibuat sampai Anda memulai titik akhir streaming. Alasannya adalah bahwa selama proses mulai, platform kami akan membuat titik akhir CDN dan menautkannya ke titik akhir streaming (termasuk mengonfigurasi nama host kustom). Selama proses penghentian untuk titik akhir streaming, platform kami harus menghapus titik akhir CDN. Oleh karena itu, jika titik akhir streaming dalam status berhenti, titik akhir CDN tidak akan ada atau pun menunjuk ke titik akhir streaming. Namun, dalam beberapa skenario, ketika AMS memanggil CDN untuk menghapus titik akhir CDN, AMS gagal menghapus titik akhir karena cache pada CDN. Hal ini mengakibatkan masalah konflik nama host jika titik akhir CDN masih ada dan memicu masalah terhentinya titik akhir streaming. |
Hapus profil CDN secara manual lalu hapus titik akhir streaming dan siapkan yang baru. |
Titik akhir streaming tidak muncul setelah memindahkan akun ke langganan lain.
| Penyebab | Solusi |
|---|---|
| Dibutuhkan beberapa waktu untuk memindahkan titik akhir streaming ke langganan yang baru. | Tunggu selama 2 jam dan periksa apakah titik akhir streaming Anda muncul di langganan baru. |
Encoder lokal tidak mengirim data ke acara langsung.
| Penyebab | Solusi |
|---|---|
| Anda mungkin menggunakan encoder yang belum diuji dengan Media Services. | Silakan lihat Encoder lokal streaming langsung terverifikasi. |
| Encoder lokal mungkin tidak dikonfigurasi dengan benar. | Konfirmasikan bahwa Anda telah mengonfigurasi encoder lokal dengan benar. |
Pengodean tampaknya memakan waktu lama.
Sebagian besar masalah durasi pengodean dapat diselesaikan dengan mengonfigurasi pengaturan encoder untuk mengontrol keseimbangan antara kecepatan dan kualitas. Untuk pengodean yang lebih cepat, atur ke mode kecepatan.
| Penyebab | Solusi |
|---|---|
| File mezzanine mungkin sangat besar. Ukuran file sama dengan laju bit dikalikan dengan durasi. | Tidak ada |
| Ada sejumlah besar lapisan output. | Kurangi jumlah lapisan output. |
| Lapisan output memiliki resolusi tinggi. | Kurangi resolusi lapisan output ke laju bit yang Anda inginkan saat mengalirkan media. |
| File mezzanine mungkin rumit, terutama jika Anda mengodekan file dengan resolusi 4k. | Tidak ada |
Kegagalan transformasi
| Penyebab | Solusi |
|---|---|
| Anda mungkin telah melampaui kuota untuk transformasi per akun yaitu 100. | Menghapus transformasi yang tidak digunakan. |
Tidak dapat mengunggah media
Anda tidak dapat mengunggah media ke akun penyimpanan.
| Penyebab | Solusi |
|---|---|
| Anda mencoba menggunakan HTTP. | Gunakan HTTPS. Protokol HTTP tidak lagi didukung untuk mengunggah konten. |
| Anda tidak menunggu cukup lama hingga akun penyimpanan disebarkan. | Jika Anda membuat akun penyimpanan secara terprogram, tambahkan kode untuk menguji bahwa akun penyimpanan telah disebarkan sebelum mencoba mengunggah media. |
Masalah CORS
| Penyebab | Solusi |
|---|---|
| Jika Anda mencoba menggunakan permintaan preflight yang berisi header traceparent, Anda akan menerima kesalahan CORS. Saat ini, Media Services tidak mendukung permintaan preflight. | Kami menyadari bahwa permintaan preflight bernilai bagi pelanggan kami. Jangan gunakan permintaan preflight hingga fiturnya tersedia. |
Masalah koneksi akun penyimpanan
Status terputus
Status "Terputus" untuk akun Microsoft Azure Media Services menunjukkan bahwa akun tidak lagi memiliki akses ke satu atau beberapa akun penyimpanan yang dilampirkan karena perubahan kunci akses penyimpanan. Kunci akses penyimpanan terbaru diperlukan oleh Microsoft Azure Media Services untuk melakukan banyak tugas di akun.
Berikut ini adalah skenario utama yang akan mengakibatkan akun Microsoft Azure Media Services tidak memiliki akses ke akun penyimpanan terlampir.
| Penyebab | Solusi |
|---|---|
| Akun Microsoft Azure Media Services atau akun penyimpanan terlampir dimigrasikan ke langganan terpisah. | Migrasikan akun penyimpanan atau akun Media Services sehingga semuanya berada dalam langganan yang sama atau gunakan identitas terkelola untuk autentikasi akun penyimpanan jika akun penyimpanan Anda berada di penyewa yang sama. |
| Akun Microsoft Azure Media Services menggunakan akun penyimpanan terlampir dalam langganan yang berbeda karena ini adalah akun Microsoft Azure Media Services awal di mana ini didukung. Semua akun Microsoft Azure Media Services awal dikonversi ke akun berbasis Azure Resources Manager modern dan akan memiliki status Terputus. | Migrasikan akun penyimpanan atau akun Media Services sehingga semuanya berada dalam langganan yang sama atau gunakan identitas terkelola untuk autentikasi akun penyimpanan jika akun penyimpanan Anda berada di penyewa yang sama. |
Akun Media Services tidak dapat mengakses akun penyimpanan
| Penyebab | Solusi |
|---|---|
| Identitas terkelola Azure Media Services belum diberi peran Storage Blob Data Contributor. | Untuk memeriksa ini di Portal Microsoft Azure, pertama-tama cari tahu identitas mana yang diatur untuk akun penyimpanan dengan memilih "Akun penyimpanan" dari menu akun Azure Media Services, ini harus "Ditetapkan sistem" atau nama Identitas Terkelola yang ditetapkan pengguna. Selanjutnya, buka akun penyimpanan di portal, pilih "Access Control (IAM)" dari menu, pilih "Penetapan peran" dari toolbar, lalu tambahkan penetapan peran. Saat menambahkan penetapan peran, Peran harus diatur ke "Storage Blob Data Contributor" dan anggota harus diatur ke Identitas Terkelola yang digunakan oleh akun Azure Media Services untuk mengakses akun penyimpanan. Setelah menambahkan penetapan peran, mungkin perlu beberapa menit agar perubahan diterapkan. |
Azure Media Indexer 2 tidak ditampilkan dalam daftar prosesor media.
| Penyebab | Solusi |
|---|---|
| Azure Media Indexer 2 tidak digunakan lagi sejak 1 Januari 2020. | Bermigrasi ke API Media Services v3. |
Kesalahan jaringan menyebabkan pengunduhan video gagal sebagian.
| Penyebab | Solusi |
|---|---|
| Kesalahan ini biasanya disebabkan oleh masalah koneksi jaringan di sisi klien dan bukan dengan Media Services. | Hubungi administrator jaringan Anda atau gunakan penelusuran kesalahan browser F12 atau Fiddler untuk melihat kesalahan yang mendasarinya. |
Masalah pengunduhan
Anda mungkin telah menerima kesalahan berikut:
"Saat mencoba mengunduh file input, file tidak dapat diakses, silakan periksa ketersediaan sumber"
| Penyebab | Solusi |
|---|---|
| Jika Anda menggunakan token SAS untuk mengakses file, mungkin token telah kedaluwarsa. | Sesuaikan kode Anda untuk memeriksa apakah token belum kedaluwarsa sebelum menggunakannya untuk mengautentikasi. |
Kesalahan 5xx yang terputus-putus dan berlebihan
| Penyebab | Solusi |
|---|---|
| Pengodean lokal mungkin tidak diimplementasikan dengan benar. | Periksa apakah encoder Anda dikonfigurasi dengan benar. |
| Anda mungkin menggunakan encoder lokal yang tidak teruji | Gunakan encoder lokal yang teruji dan periksa apakah encoder dikonfigurasi dengan benar. |
| Rasio penembolokan antara titik akhir streaming dan CDN mungkin tidak mencukupi. | 1. Sesuaikan rasio penembolokan sehingga CDN menangani lebih banyak lalu lintas. 2. Sesuaikan aturan pengoptimalan streaming untuk CDN. |
| Konfigurasi filter mungkin salah. | Periksa apakah filter Anda dikonfigurasi dengan benar. |
Lihat Panduan praktik terbaik streaming langsung.
Kesalahan kode umum
Anda mungkin mengalami kesalahan dalam kode Anda yang tidak tercakup dalam referensi kode kesalahan titik akhir streaming, kode kesalahan acara langsung, atau kode kesalahan pekerjaan.
| Penyebab | Solusi |
|---|---|
| Anda mungkin mencoba menggunakan objek, properti, atau metode yang tidak disertakan dalam versi API yang lebih lama. | Tingkatkan pustaka API Anda di lingkungan pengembangan Anda. |
Jika Anda belum menemukan solusi untuk masalah Anda, hubungi Dukungan Media Services.
Dapatkan bantuan dan dukungan
Anda dapat menghubungi Media Services dengan pertanyaan atau mengikuti pembaruan kami dengan salah satu metode berikut:
- T & A
- Stack Overflow. Beri tag pertanyaan dengan
azure-media-services. - @MSFTAzureMedia atau gunakan @AzureSupport untuk meminta dukungan.
- Buka tiket dukungan melalui portal Azure.