Bagikan melalui

Media Services Tracks API

  • Artikel

Logo Azure Media Services v3

Peringatan

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

Aset Media Services berisi file media di akun penyimpanan Azure terkait. File-file ini berisi data untuk trek audio, video, dan teks. Tracks API memungkinkan Anda memahami dan mengelola trek yang ada di aset. Trek digunakan oleh pemutar video DASH atau HLS untuk menyajikan audio, video, dan subtitel atau keterangan (teks) kepada audiens. Titik akhir streaming Media Services mengomunikasikan informasi tentang trek ke pemutar melalui manifes DASH atau daftar putar HLS saat diminta.

Dengan Tracks API, Anda dapat:

  • Mendapatkan daftar trek audio, video, dan teks dalam aset.
  • Menambahkan atau menghapus trek teks.
  • Menambahkan atau menghapus trek audio.
  • Tentukan atribut aksesibilitas trek teks atau audio.
  • Edit trek di portal Azure, atau unduh lalu unggah kembali ke aset.
  • Tampilkan atau sembunyikan trek teks di pemutar video.

Catatan

Anda hanya dapat menambahkan atau memperbarui trek teks pada aset video sesuai permintaan (VOD). Selain itu, pengikatan audio terlambat tidak didukung untuk aset streaming langsung.

Trek teks

Menggunakan trek teks dengan media yang diproduksi secara lokal

Setelah membuat video secara lokal dan mengekspor keterangan, Anda dapat mengunggah keterangan tersebut ke aset yang berisi media sesuai permintaan Anda.

Alur kerja umum untuk menggunakan trek teks dengan teks yang diproduksi secara lokal:

  1. Buat video dan ekspor keterangan ke file yang dalam format VTT atau TTML.
  2. Terjemahkan atau edit file VTT atau TTML, dan simpan salinan untuk:
    1. Trek untuk bahasa tambahan dengan teks deskriptif untuk memenuhi persyaratan aksesibilitas.
    2. Trek untuk teks tambahan untuk komentar sutradara.
  3. PENTING: Anda harus menambahkan penanda bahasa ke header VTT agar bahasa yang benar ditampilkan di pemutar klien. Contohnya:
    WEBVTT
Language: en-us
  4. Unggah video ke Media Services.
  5. Buat transformasi dan pekerjaan untuk mengodekan video.
  6. Unggah trek teks tambahan.

Menggunakan trek teks dengan transkripsi langsung

Saat transkripsi langsung diaktifkan untuk acara langsung, trek teks WebVTT tambahan dibuat selain trek transkripsi langsung real time yang dilihat penonton di pemutar video langsung. File WebVTT ini berisi versi terbaik dari transkrip langsung yang berisi kalimat lengkap alih-alih hasil parsial real-time. Anda dapat mengunduh file .vtt setelah seluruh transkrip tersedia dan output langsung dihapus.

Peringatan

File VTT transkripsi langsung yang dihasilkan secara otomatis akhir tertunda untuk diproses. Kecuali Anda menunggu beberapa menit sebelum menghapus output langsung, konten dalam file akan terpotong. Selain itu, transkripsi langsung tidak tersedia untuk digunakan dengan beberapa aliran input untuk acara langsung.

Alur kerja umum untuk menggunakan trek teks transkripsi langsung:

  1. Buat acara langsung dengan transkripsi langsung diaktifkan dan dengan bahasa sumber dipilih.
  2. Saat acara langsung selesai, tunggu beberapa menit, lalu hapus output langsung. Aset yang diarsipkan akan tersedia untuk streaming sesuai permintaan. URL streaming yang valid masih akan dapat diakses oleh pemirsa Anda.
  3. Cantumkan trek dalam aset yang diarsipkan atau lihat di portal. Akan ada file WebVTT yang berisi transkripsi NBest. Ini akan memiliki ekstensi .vtt. File diberi nama auto-generated-best_XXX.vtt.
  4. Edit file VTT di portal Azure atau unduh dan edit.
  5. Untuk menyajikan trek teks dalam beberapa bahasa, terjemahkan trek teks sumber ke bahasa tersebut dan simpan sebagai file terpisah untuk setiap bahasa menggunakan ekstensi .vtt.
  6. Unggah trek bahasa sumber, dan trek teks untuk setiap bahasa.
  7. Jika Anda tidak menggunakan portal Azure untuk mengunggah file, edit (atau perbarui) file .ism untuk memberi tahu pemutar trek teks mana yang akan digunakan serta pelabelan dan visibilitasnya dengan:
    1. Menggunakan Tracks API untuk memperbarui manifes secara terprogram menggunakan salah satu SDK atau CLI:
      1. Node.JS
      2. Python
      3. .Bersih
      4. CLI

Penting

Saat memperbarui file .ism, pastikan Anda menyembunyikan trek teks transkripsi langsung, dan menampilkan trek teks dalam bahasa yang sesuai untuk penampil.

Trek audio

Anda dapat menambahkan trek audio tambahan ke aset untuk memberi penonton audio dalam bahasa yang berbeda, menambahkan audio deskriptif untuk aksesibilitas, atau menambahkan komentar sutradara.

Alur kerja umum untuk trek audio

  1. Buat trek audio tambahan untuk acara langsung. Mereka dapat berupa audio dalam bahasa yang berbeda atau audio deskriptif yang digunakan untuk aksesibilitas. Anda juga dapat menggunakan trek audio untuk komentar sutradara.
  2. Unggah trek audio ke aset yang diarsipkan.
  3. Perbarui data trek dengan mengedit file manifes di portal atau dengan memperbarui data trek menggunakan REST, atau SDK.

Catatan

Saat trek audio atau teks dihapus, file yang mendasar tidak dihapus dari kontainer penyimpanan. Media Services mengatur packager dinamis (titik akhir streaming) untuk tidak menampilkan informasi tentang trek dalam manifes atau daftar putar yang diminta oleh pemutar video.

Untuk langkah-langkah Tracks API terperinci, lihat Sampel di bawah ini.

Sampel

Cara, tutorial, dan mulai cepat

Dapatkan bantuan dan dukungan

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