Fitur live subtitles mengonversi ucapan dalam live stream menjadi subtitel melalui pengenalan suara dan mendukung terjemahan real-time antara bahasa Mandarin, Inggris, Spanyol, dan Rusia. Topik ini menjelaskan cara menggunakan fitur tersebut.
Sebelum memulai
Fitur ini hanya didukung di wilayah tertentu. Untuk informasi ketersediaan, lihat Wilayah yang Didukung.
Fitur ini saat ini berada dalam pratinjau publik dan tidak dikenakan biaya. Setelah masa pratinjau berakhir, biaya standar akan berlaku. Anda akan diberi tahu sebelumnya mengenai perubahan apa pun.
Prosedur
ApsaraVideo Live menambahkan live subtitles ke aliran berdasarkan templat subtitel dan aturan:
Templat subtitel: Menentukan konfigurasi subtitel, termasuk konten, tata letak, gaya, dan pengaturan visual lainnya. Anda dapat menambahkan hingga 300 templat subtitel untuk satu akun.
Aturan subtitel: Mengaitkan templat subtitel dengan live stream berdasarkan Nama domain dan AppName. Setelah dikonfigurasi, templat subtitel akan secara otomatis diterapkan pada live stream yang baru diingest dan sesuai dengan Nama domain serta AppName yang ditentukan dalam aturan.
Satu templat subtitel dapat dikaitkan dengan beberapa aturan subtitel.
Langkah 1: Tambahkan templat subtitel
Di Konsol
Masuk ke Konsol ApsaraVideo Live.
Di panel navigasi sebelah kiri, pilih Feature Management > Live Subtitles. Lalu, pilih tab Subtitle Templates.
Pilih wilayah dan klik Add Subtitle Template untuk mengonfigurasi pengaturan dasar subtitel.

Konsol menyediakan pratinjau agar Anda dapat memeriksa efek visual setelah penyesuaian. Tabel berikut menjelaskan parameter yang dapat dikonfigurasikan untuk templat subtitel:
Parameter | Deskripsi |
Creation Method |
|
Subtitle Template Name | Nama templat subtitel. Dapat berisi angka, huruf, dan tanda hubung (-), tetapi tidak boleh diawali dengan tanda hubung. |
Template Description | Deskripsi templat subtitel. Panjangnya maksimal 128 karakter dan dapat berisi huruf, angka, serta karakter khusus. |
Source Language | Nilai yang valid: Chinese, English, dan Russian. |
Translation | Nilai yang valid: Chinese, English, Spanish, Russian, No Translation.
|
Maximum Lines | Jumlah maksimum baris yang ditampilkan. Nilai yang valid: bilangan bulat dari 1 hingga 300. |
Max Characters per Line | Jumlah maksimum karakter yang dapat dimuat dalam setiap baris. Nilai yang valid: bilangan bulat dari 10 hingga 320. |
Font | Nilai yang valid:
|
Font Size | Ukuran font. |
Subtitle Background | Menentukan apakah latar belakang subtitel ditampilkan. Jika diaktifkan, Anda dapat mengonfigurasi warna dan opasitas latar belakang. |
Color | Warna dan opasitas teks. |
Resolution (Width × Height) | Ukuran pratinjau. Nilai yang valid:
|
Klik Submit untuk membuat templat subtitel.
Setelah templat subtitel ditambahkan, muncul prompt yang mengingatkan Anda untuk menambahkan aturan subtitel. Anda dapat mengklik Add Now atau Later.
Untuk mengelola templat yang telah dibuat, pada tab Subtitle Templates, klik operasi yang diinginkan di kolom Actions:
Preview: Pratinjau efek visual subtitel.
Modify: Sesuaikan konfigurasi templat subtitel.
Delete: Saat templat tidak dikaitkan dengan aturan subtitel apa pun (Bound Subtitle Rules=0), tombol ini dapat diklik. Jika tidak, tombol tersebut akan dinonaktifkan. Anda harus menghapus aturan yang terkait terlebih dahulu. Klik Bound Subtitle Rules untuk melihat aturan yang terkait.
Add Subtitle Rule: Tambahkan aturan subtitel untuk templat ini. Untuk detailnya, lihat Langkah 2: Tambahkan aturan subtitel.
Perubahan pada templat subtitel tidak memengaruhi aliran aktif. Untuk menerapkan modifikasi atau penghapusan, ingest ulang aliran tersebut.
Melalui API
Panggil operasi AddLiveAISubtitle untuk menambahkan templat subtitel.
ApsaraVideo Live juga menyediakan antarmuka berikut untuk mengelola templat subtitel:
DeleteLiveAISubtitle: Menghapus templat subtitel.
UpdateLiveAISubtitle: Memperbarui templat subtitel.
DescribeLiveAISubtitle: Menanyakan templat subtitel.
Langkah 2: Tambahkan aturan subtitel
Di Konsol
Masuk ke Konsol ApsaraVideo Live.
Di panel navigasi sebelah kiri, pilih Feature Management > Live Subtitles. Lalu, pilih tab Subtitle Rules.
Pilih wilayah tempat templat target dibuat. Aturan hanya dapat diterapkan pada Nama domain di wilayah yang sama. Lalu, klik Add Subtitle Rule.

Parameter | Deskripsi |
Rule Description | Deskripsi aturan subtitel. Panjangnya maksimal 128 karakter dan dapat berisi huruf, angka, serta karakter khusus. |
Streaming Domain | Domain streaming utama tempat aturan diterapkan. |
AppName | Nama aplikasi tempat live stream berasal. Harus sama dengan nama aplikasi yang ditentukan dalam URL ingest. Panjang nilai maksimal 256 karakter dan dapat berisi angka, huruf, tanda hubung (-), serta garis bawah (_). |
Subtitle Templates | Templat subtitel yang akan dikaitkan dengan aturan. |
Output Settings | Kami menyarankan agar Anda mengatur resolusi output sama dengan resolusi yang ditentukan dalam templat subtitel. Nilai yang valid:
|
Triggered by Stream Pulling | Menentukan apakah subtitel dipicu oleh penarikan aliran.
|
Klik Submit untuk membuat aturan.
CatatanSetelah mengonfigurasi aturan subtitel, ingest ulang aliran agar subtitel ditampilkan.
Untuk mengelola aturan yang telah dibuat, pada tab Subtitle Rules, klik operasi yang diinginkan di kolom Actions:
Preview: Pratinjau efek visual subtitel.
Edit: Sesuaikan konfigurasi aturan subtitel.
Delete: Hapus aturan subtitel.
Melalui API
Panggil operasi AddLiveAIProduceRules untuk menambahkan aturan subtitel.
ApsaraVideo Live juga menyediakan antarmuka berikut untuk mengelola aturan subtitel:
UpdateLiveAIProduceRules: Memperbarui aturan subtitel.
DeleteLiveAIProduceRules: Menghapus aturan subtitel.
DescribeLiveAIProduceRules: Menanyakan aturan subtitel.
Langkah 3: Ingest aliran
Gunakan Pembuat URL di Konsol ApsaraVideo Live atau ikuti aturan penggabungan dalam kode untuk membuat URL ingest. Untuk informasi lebih lanjut, lihat Generate streaming URLs.
Ingest aliran ke URL yang dihasilkan menggunakan OBS, Push SDK yang disediakan oleh ApsaraVideo Live, atau alat lainnya.
Langkah 4: Putar aliran subtitel
Gunakan aturan penggabungan berikut untuk membuat URL streaming guna memutar aliran dengan live subtitles:
Format: Protokol + Streaming domain + AppName + StreamName
_Nama templat subtitel+ {Access token}Contoh:
RTMP: rtmp://example.aliyundoc.com/app/stream_{Nama templat subtitel}?auth_key={Access token}
FLV: http://example.aliyundoc.com/app/stream_{Nama templat subtitel}.flv?auth_key={Access token}
M3U8: http://example.aliyundoc.com/app/stream_{Nama templat subtitel}.m3u8?auth_key={Access token}
Tarik aliran dari URL streaming yang dihasilkan menggunakan pemutar media VLC, ApsaraVideo Player SDK, atau alat lainnya.
Aliran live subtitle tidak mendukung pemutaran melalui protokol ARTC.