All Products
Search
Document Center

ApsaraVideo Live:Real-Time Captions (Pratinjau Publik)

Last Updated:Jul 16, 2026

ApsaraVideo Live menyediakan fitur real-time captions yang menggunakan pengenalan ucapan real-time untuk mengonversi audio dari live stream menjadi teks terjemahan dan mendukung terjemahan. 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 pemicu.

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 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 mengarah ke templat tersebut. Dalam aturan tersebut, tentukan Nama domain dan AppName. AppName harus sesuai dengan AppName dalam URL ingest Anda. Caption hanya 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 Caption

Instruksi Konsol

  1. Masuk ke Konsol ApsaraVideo Live.

  2. Pada panel navigasi di sebelah kiri, pilih Feature Management > Real-time Subtitles untuk membuka halaman Real-time Subtitles, lalu pilih tab yang sesuai.

  3. Pilih wilayah untuk konfigurasi templat caption Anda. Kemudian klik Add Subtitle Template untuk mengonfigurasi templat. Pada halaman Add Caption Template, di bagian Basic Information, pilih Creation Method (Create New Caption Template atau Copy Existing Caption Template), masukkan Caption Template Name (hanya angka, huruf, dan tanda hubung yang diizinkan), serta berikan Caption Template Description (maksimal 128 karakter). Di bagian Caption Settings, konfigurasikan Language, Translation, Maximum Lines, Maximum 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 posisi untuk melihat efek real-time. Tabel berikut mencantumkan parameter templat caption beserta deskripsinya.

Parameter

Deskripsi

Creation Method

  • Create New Caption Template: Buat templat caption kustom dari awal.

  • Copy Existing Caption Template: Salin pengaturan dari templat yang sudah ada untuk membuat templat baru dengan cepat.

Caption Template Name

Nama templat caption. Hanya angka, huruf besar dan kecil, serta tanda hubung (-) yang diizinkan. Tanda hubung tidak boleh berada di awal.

Caption Template Description

Deskripsi templat caption. 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.

  • Jika Anda memilih Tiongkok, Inggris, Spanyol, atau Rusia, Anda dapat memilih apakah akan menampilkan bahasa sumber.

  • Jika Anda memilih No Translation, bahasa sumber selalu ditampilkan.

Maximum Lines

Jumlah maksimum baris yang ditampilkan. Masukkan bilangan bulat dari 1 hingga 300.

Maximum Characters Per Line

Jumlah maksimum karakter per baris. Masukkan bilangan bulat dari 10 hingga 320.

Font

Font yang tersedia:

  • KaiTi

  • Alibaba PuHuiTi-Regular

  • Alibaba PuHuiTi-Bold

  • Alibaba PuHuiTi-Light

  • Source Han Sans-Regular

  • Source Han Sans-Bold

  • Source Han Sans-Light

Font Size

Ukuran font.

Caption Background

Jika dinonaktifkan, tidak ada latar belakang di belakang caption. Jika diaktifkan, Anda dapat mengatur warna latar belakang dan transparansi.

Color Settings

Atur warna dan transparansi caption, serta warna dan transparansi latar belakang caption.

Screen Size (W×H)

Ukuran layar pratinjau. Opsi:

  • Landscape Low Definition 360P 640×360

  • Portrait Low Definition 360P 360×640

  • Landscape Standard Definition 480P 854×480

  • Portrait Standard Definition 480P 480×854

  • Landscape High Definition 720P 1280×720

  • Portrait High Definition 720P 720×1280

  • Landscape Ultra-High Definition 1080P 1920×1080

  • Portrait Ultra-High Definition 1080P 1080×1920

  1. Klik Submit untuk menyelesaikan konfigurasi templat caption.

  2. Setelah berhasil menambahkan templat caption, 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.

  3. Pada 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 aktual.

    Modify

    Sesuaikan parameter templat caption.

    Delete

    • Pada halaman daftar templat caption, jika Bound Caption Rules menunjukkan angka 0, berarti templat tidak memiliki aturan terkait. Klik Delete untuk menghapus templat.

    • Jika Bound Caption Rules menunjukkan angka lebih dari 0, berarti templat sudah 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 Caption.

    Catatan

    Memodifikasi 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

Tambahkan templat caption live

DeleteLiveAISubtitle

Hapus templat caption

UpdateLiveAISubtitle

Perbarui templat caption

DescribeLiveAISubtitle

Kueri templat caption

Langkah 2: Tambahkan Aturan Caption

Instruksi Konsol

  1. Masuk ke Konsol ApsaraVideo Live.

  2. Pada panel navigasi di sebelah kiri, pilih Feature Management > Real-time Subtitles untuk membuka halaman Real-time Subtitles, lalu pilih tab Subtitle Rules.

  3. Pilih wilayah untuk konfigurasi aturan caption Anda. Setelah memilih wilayah, Anda hanya dapat mengonfigurasi Nama domain dan templat caption dalam wilayah tersebut. Kemudian klik Add Caption Rule. Pada halaman konfigurasi, masukkan Rule Description, pilih Streaming Domain, masukkan AppName (maksimal 256 karakter; mendukung angka, huruf, tanda hubung, dan garis bawah), pilih Caption Template (klik Preview untuk melihat efeknya), pilih Output Setting (rasio aspek output harus sesuai dengan rasio aspek templat), dan aktifkan atau nonaktifkan sakelar Stream Pulling Trigger 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 primary yang akan dikonfigurasi.

AppName

Nama aplikasi tempat stream tersebut berada. AppName harus persis sesuai 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.

Caption Template

Pilih templat caption yang telah dikonfigurasi. Jika belum ada templat, tambahkan terlebih dahulu. Untuk detailnya, lihat Langkah 1: Tambahkan Templat Caption.

Output Setting

Kami merekomendasikan agar pengaturan output dalam aturan caption sesuai dengan ukuran layar dalam templat caption untuk pemutaran yang akurat. Spesifikasi output yang didukung:

  • Landscape Low Definition 360P 640×360

  • Portrait Low Definition 360P 360×640

  • Landscape Standard Definition 480P 854×480

  • Portrait Standard Definition 480P 480×854

  • Landscape High Definition 720P 1280×720

  • Portrait High Definition 720P 720×1280

  • Landscape Ultra-High Definition 1080P 1920×1080

  • Portrait Ultra-High Definition 1080P 1080×1920

Stream Pulling Trigger

Cara stream caption dipicu.

  • Jika diaktifkan: Caption hanya dimulai ketika seseorang memutar live stream. Jika tidak ada yang memutar stream selama 5 menit, caption akan berhenti. Caption akan dimulai ulang ketika pemutaran dilanjutkan.

  • Jika dinonaktifkan: Caption dimulai segera setelah Anda memulai stream ingest, terlepas dari apakah ada penonton atau tidak.

  1. Klik Submit untuk menyelesaikan konfigurasi aturan caption.

    Catatan

    Setelah berhasil mengonfigurasi aturan caption, lakukan restart stream ingest agar caption muncul dalam pemutaran.

  2. Pada tab Subtitle Rules, temukan aturan Anda dalam daftar. Di kolom Actions, klik Preview, Edit, atau Delete:

    • Preview: Pratinjau efek caption aktual.

    • Edit: Sesuaikan parameter aturan caption.

    • Delete: Hapus aturan caption.

Instruksi API

Melalui konfigurasi API, Anda dapat menggunakan API berikut.

Interface

Dokumen Referensi

AddLiveAIProduceRules

Tambahkan aturan caption real-time

UpdateLiveAIProduceRules

Perbarui aturan caption real-time

DescribeLiveAIProduceRules

Kueri aturan caption

DeleteLiveAIProduceRules

Hapus aturan caption

Langkah 3: Stream Ingest

Gunakan Pembuat URL di konsol atau buat URL ingest Anda secara manual. Untuk detailnya, lihat Hasilkan URL streaming langsung.

Langkah 4: Putar Stream yang Diaktifkan Caption

Untuk memutar live stream dengan caption, gunakan URL pemutaran stream caption. Tambahkan _{caption template name} ke StreamName:

  • RTMP: rtmp://example.aliyundoc.com/app/stream_{caption template name}?auth_key={access token}

  • FLV: http://example.aliyundoc.com/app/stream_{caption template name}.flv?auth_key={access token}

  • M3U8: http://example.aliyundoc.com/app/stream_{caption template name}.m3u8?auth_key={access token}

Catatan

Real-time captions tidak mendukung pemutaran melalui protokol ARTC.