ApsaraVideo Live menyediakan fitur real-time captions yang menggunakan pengenalan suara real-time untuk mengonversi audio dari live stream menjadi teks terjemahan (caption) serta mendukung penerjemahan. Saat ini, ApsaraVideo Live mendukung terjemahan timbal balik antara bahasa Tiongkok, Inggris, Spanyol, dan Rusia. Topik ini membantu Anda memahami cara menggunakan real-time captions dengan cepat, termasuk alur kerja dan metode pemicunya.
Catatan Penting
Untuk daftar live center yang mendukung real-time captions, lihat Wilayah layanan.
Real-time captions saat ini berada dalam pratinjau undangan. Setiap pengguna dapat membuat hingga 300 templat caption. Satu templat caption dapat dikaitkan dengan beberapa aturan caption.
Templat caption hanya menentukan pengaturan terkait caption, seperti konten dan tata letak. Templat ini tidak mencakup asosiasi dengan nama domain atau AppName dalam live stream. Aturan caption menentukan bagaimana nama domain dan AppName dikaitkan dengan templat caption.
Setelah mengonfigurasi templat caption, tambahkan aturan caption yang mengacu pada templat tersebut. Dalam aturan tersebut, tentukan nama domain dan AppName. AppName harus sesuai dengan AppName dalam URL ingest Anda. Caption hanya akan muncul dalam pemutaran setelah Anda melakukan restart stream ingest.
Real-time captions merupakan fitur berbayar. Selama pratinjau publik, Anda dapat menggunakannya secara gratis. Biaya normal akan diberlakukan setelah masa pratinjau publik berakhir. Kami akan mengumumkan waktu pastinya secara terpisah.
Alur Kerja
Langkah 1: Tambahkan Templat Subtitle
Instruksi Konsol
Masuk ke Konsol ApsaraVideo Live.
Di panel navigasi sebelah kiri, pilih Feature Management > Real-time Subtitles untuk membuka halaman Real-time Subtitles, lalu pilih tab yang sesuai.
Pilih wilayah untuk konfigurasi templat caption Anda, lalu klik Add Subtitle Template untuk mengonfigurasi templat. Di halaman Add Subtitle Template, pada bagian Basic Information, pilih Creation Method (Create New Subtitle Template atau Copy Existing Subtitle Template), masukkan Subtitle Template Name (hanya angka, huruf, dan tanda hubung yang diizinkan), serta berikan Template Description (maksimal 128 karakter). Di bagian Subtitle Settings, konfigurasikan Language, Translation, Maximum Lines, Max Characters per Line, dan Font. Gunakan panel Preview di sebelah kanan untuk melihat perubahan Anda.
Anda dapat melihat pratinjau caption di area pratinjau. Sesuaikan ukuran layar pratinjau, ukuran caption, dan posisinya untuk melihat efek real-time. Tabel berikut mencantumkan parameter templat caption beserta deskripsinya.
Parameter | Deskripsi |
Creation Method |
|
Subtitle Template Name | Nama templat subtitle. Hanya angka, huruf besar dan kecil, serta tanda hubung (-) yang diizinkan. Tanda hubung tidak boleh berada di awal. |
Template Description | Deskripsi templat subtitle. Mendukung karakter Tiongkok, Inggris, angka, dan simbol. Panjang maksimum: 128 karakter. |
Source Language | Mendukung bahasa Tiongkok, Inggris, dan Rusia. |
Translation | Opsi: Tiongkok, Inggris, Spanyol, Rusia, atau No Translation.
|
Maximum Lines | Jumlah maksimum baris yang ditampilkan. Masukkan bilangan bulat dari 1 hingga 300. |
Max Characters per Line | Jumlah maksimum karakter per baris. Masukkan bilangan bulat dari 10 hingga 320. |
Font | Font yang tersedia:
|
Font Size | Ukuran font. |
Subtitle Background | Jika dinonaktifkan, tidak ada latar belakang di belakang caption. Jika diaktifkan, Anda dapat mengatur warna latar belakang dan transparansinya. |
Color | Atur warna dan transparansi caption, serta warna dan transparansi latar belakang caption. |
Resolution (Width × Height) | Ukuran layar pratinjau. Opsi:
|
Klik Submit untuk menyelesaikan konfigurasi templat caption.
Setelah berhasil menambahkan templat caption, akan muncul prompt untuk menambahkan aturan caption. Klik Add Now untuk membuat aturan untuk templat ini. Jika Anda tidak perlu menambahkan aturan sekarang, klik Later dan konfigurasikan aturan nanti.
Di tab Subtitle Templates, temukan templat Anda dalam daftar. Di kolom Actions, klik Preview, Modify, atau Delete untuk mengelola templat:
Action
Deskripsi
Preview
Pratinjau efek caption yang sebenarnya.
Modify
Sesuaikan parameter templat caption.
Delete
Di halaman daftar templat caption, jika Bound Caption Rules menunjukkan angka 0, berarti templat tersebut tidak memiliki aturan terkait. Klik Delete untuk menghapus templat.
Jika Bound Caption Rules menunjukkan angka lebih dari 0, berarti templat tersebut telah dikaitkan dengan aturan. Tombol Delete akan berwarna abu-abu dan tidak tersedia. Anda harus menghapus semua aturan caption terkait terlebih dahulu sebelum menghapus templat. Klik angka di bawah Bound Caption Rules untuk melihat aturan terkait.
Add Subtitle Rule
Tambahkan aturan caption untuk templat ini dan konfigurasikan parameter terkait. Untuk detailnya, lihat Langkah 2: Tambahkan Aturan Subtitle.
CatatanMemodifikasi atau menghapus templat caption tidak memengaruhi live stream yang sedang berlangsung. Perubahan hanya berlaku setelah Anda melakukan restart stream ingest.
Instruksi API
Melalui konfigurasi API, API berikut tersedia untuk Anda gunakan.
Interface | Dokumen Referensi |
AddLiveAISubtitle | |
DeleteLiveAISubtitle | |
UpdateLiveAISubtitle | |
DescribeLiveAISubtitle |
Langkah 2: Tambahkan Aturan Subtitle
Instruksi Konsol
Masuk ke Konsol ApsaraVideo Live.
Di panel navigasi sebelah kiri, pilih Feature Management > Real-time Subtitles untuk membuka halaman Real-time Subtitles, lalu pilih tab Subtitle Rules.
Pilih wilayah untuk konfigurasi aturan caption Anda. Setelah memilih wilayah, Anda hanya dapat mengonfigurasi nama domain dan templat caption dalam wilayah tersebut. Lalu klik Add Subtitle Rule. Di halaman konfigurasi, masukkan Rule Description, pilih Streaming Domain, masukkan AppName (maksimal 256 karakter; mendukung angka, huruf, tanda hubung, dan garis bawah), pilih Subtitle Templates (klik Preview untuk melihat efeknya), pilih Output Settings (rasio aspek output harus sesuai dengan rasio aspek templat), dan aktifkan atau nonaktifkan sakelar Triggered by Stream Pulling sesuai kebutuhan. Lalu klik Submit.
Tabel berikut mencantumkan parameter aturan caption beserta deskripsinya.
Parameter | Deskripsi |
Rule Description | Deskripsi aturan caption. Mendukung karakter Tiongkok, Inggris, angka, dan simbol. Panjang maksimum: 128 karakter. |
Streaming Domain | Pilih domain streaming utama yang akan dikonfigurasi. |
AppName | Nama aplikasi tempat stream tersebut berada. AppName harus persis sama dengan AppName dalam URL ingest Anda agar templat caption berlaku. Mendukung angka, huruf besar dan kecil, tanda hubung (-), dan garis bawah (_). Panjang maksimum: 256 karakter. |
Subtitle Templates | Pilih templat subtitle yang telah dikonfigurasi. Jika belum ada templat, tambahkan terlebih dahulu. Untuk detailnya, lihat Langkah 1: Tambahkan Templat Subtitle. |
Output Settings | Kami menyarankan agar pengaturan output dalam aturan caption sesuai dengan ukuran layar dalam templat subtitle untuk pemutaran yang akurat. Spesifikasi output yang didukung:
|
Triggered by Stream Pulling | Cara stream caption dipicu.
|
Klik Submit untuk menyelesaikan konfigurasi aturan caption.
CatatanSetelah berhasil mengonfigurasi aturan caption, lakukan restart stream ingest agar caption muncul dalam pemutaran.
Di tab Subtitle Rules, temukan aturan Anda dalam daftar. Di kolom Actions, klik Preview, Edit, atau Delete:
Preview: Pratinjau efek caption yang sebenarnya.
Edit: Sesuaikan parameter aturan caption.
Delete: Hapus aturan caption.
Instruksi API
Melalui konfigurasi API, Anda dapat menggunakan API berikut.
Interface | Dokumen Referensi |
AddLiveAIProduceRules | |
UpdateLiveAIProduceRules | |
DescribeLiveAIProduceRules | |
DeleteLiveAIProduceRules |
Langkah 3: Stream Ingest
Gunakan Pembuat URL di konsol atau buat URL ingest Anda secara manual. Untuk detailnya, lihat Buat URL streaming langsung.
Langkah 4: Putar Stream yang Dilengkapi Subtitle
Untuk memutar live stream dengan caption, gunakan URL pemutaran stream caption. Tambahkan _{nama templat caption} ke StreamName:
RTMP: rtmp://example.aliyundoc.com/app/stream_{nama templat caption}?auth_key={token akses}
FLV: http://example.aliyundoc.com/app/stream_{nama templat caption}.flv?auth_key={token akses}
M3U8: http://example.aliyundoc.com/app/stream_{nama templat caption}.m3u8?auth_key={token akses}
Real-time captions tidak mendukung pemutaran melalui protokol ARTC.