All Products
Search

This Product

    ApsaraVideo Live:Manajemen Aplikasi ApsaraVideo Real-time Communication

    Document Center

    ApsaraVideo Live:Manajemen Aplikasi ApsaraVideo Real-time Communication

    Last Updated:Jun 19, 2026

    Untuk menggunakan ApsaraVideo Real-time Communication, Anda harus membuat aplikasi yang mendukung fitur seperti panggilan (calls), obrolan santai (chit-chat), dan rapat (meetings).

    Buat Aplikasi ApsaraVideo Real-time Communication

    1. Masuk ke Konsol ApsaraVideo Live.

    2. Pada panel navigasi di sebelah kiri, klik Live + > ApsaraVideo Real-time Communication > Applications.

    3. Klik Create Application.ed34559efbe60c8073c93d6038eaaeaa

    4. Masukkan Instance Name kustom, terima Terms of Service, lalu klik Purchase.

    5. Setelah pesan sukses muncul, muat ulang halaman ApsaraVideo Real-time Communication > Applications untuk melihat aplikasi co-streaming yang telah Anda buat.

      Catatan

      Pembuatan aplikasi tidak dikenai biaya. Anda akan dikenai biaya berdasarkan skema pay-as-you-go sesuai penggunaan cloud aktual. Untuk informasi selengkapnya, lihat Harga ApsaraVideo Real-time Communication.

    Konfigurasi bypass stream ingest

    1. Masuk ke Konsol ApsaraVideo Live.

    2. Pada panel navigasi di sebelah kiri, klik Live + > ApsaraVideo Real-time Communication > Applications. Pilih aplikasi yang ingin Anda konfigurasi, lalu klik Manage.

    3. Klik Stream Relay. Anda dapat mengonfigurasi Stream Relay dengan salah satu cara berikut:

      1. Mode 1: Relay of Specified Streams

        Panggil operasi CreateLiveMixJob (New) untuk mengonfigurasi Stream Relay real-time (dengan pencampuran aliran) untuk saluran tertentu ke ApsaraVideo Live atau platform pihak ketiga. Hal ini memerlukan sedikit pengembangan sisi server.

      2. Mode 2: Global Stream Relay to ApsaraVideo Live

        Setelah Anda mengaktifkan bypass stream ingest, aliran audio dan video akan diingest ke origin server dari live center Alibaba Cloud. Anda kemudian dapat menggunakan nama domain pemutaran untuk mengonfigurasi fitur seperti transcoding, recording, dan snapshot, atau menarik aliran siaran langsung guna ditonton.

        1. Nyalakan sakelar Stream Relay.

        2. Konfigurasikan parameter ingest.

          Parameter

          Opsi Konfigurasi

          Deskripsi

          Stream Relay

          On atau Off

          Setelah Anda mengaktifkan single-stream ingest, semua aliran audio dan video secara default akan diingest ke ApsaraVideo Live. Anda tetap dapat memperbarui tata letak pencampuran aliran menggunakan software development kit (SDK) atau operasi API sisi server.

          Playback domain name

          Contoh: play.example.com

          Nama domain pemutaran untuk aliran yang diingest ke ApsaraVideo Live. Anda dapat menggunakan nama domain ini untuk memutar siaran langsung dan mengonfigurasi fitur seperti transcoding dan recording.

          Catatan

          • Jika Anda belum memiliki playback domain name, buka konsol Domain Names untuk menambahkannya.

          • Playback domain names tidak mendukung Real-Time Streaming (RTS) dengan latensi 400 ms hingga 600 ms. Penggunaan RTS akan menyebabkan ingest gagal.

          AppName

          Maksimal 255 karakter. Mendukung angka, huruf besar dan kecil, tanda hubung (-), garis bawah (_), dan tanda sama dengan (=).

          Nilai default adalah "live". Anda dapat menyesuaikan nilai ini.

          AppName dalam URL streaming setelah ingest. Untuk informasi selengkapnya, lihat Generate streaming URLs.

          Catatan

          Untuk menyambungkan templat transcoding, recording, atau snapshot ke aliran yang diingest, Anda harus mengatur AppName ini agar sama dengan AppName dalam templat agar templat tersebut berlaku.

          SEI Insertion

          • Insert SEI at regular intervals: Menyisipkan frame Supplemental Enhancement Information (SEI) pada interval tertentu. Anda dapat mengatur interval dari 1000 ms hingga 5000 ms.

          • Insert SEI in I-frames: Menyisipkan SEI dalam I-frame aliran video.

          Supplemental Enhancement Information (SEI) menyisipkan informasi dasar pengguna, seperti user ID (UID) dan parameter tata letak pencampuran aliran, ke dalam aliran melalui sistem SEI. Misalnya, dalam skenario co-streaming, ketika tata letak pencampuran aliran berubah, aplikasi penonton dapat mengurai informasi tata letak dari SEI secara real-time untuk menyesuaikan UI interaktif. Untuk informasi selengkapnya, lihat Format Supplemental Enhancement Information (SEI).
          Catatan

          Jika Anda belum memiliki playback domain name di konsol Domain Names, Anda harus menambahkannya terlebih dahulu. Untuk informasi selengkapnya, lihat Add a domain name.

    Format Supplemental Enhancement Information (SEI)

    Tipe Data

    Nama Parameter

    Nilai

    Informasi aliran video

    stream

    Informasi streamer:

    uid: User ID streamer.

    Informasi tata letak area jendela streamer. Perhatikan parameter berikut:

    • paneid: ID area dalam jendela. Nilai valid: [0,8].

    • zorder: Tingkat penumpukan area. Nilai valid: [0,99].

    • x: Koordinat x area pada kanvas. Persentase ternormalisasi.

    • y: Koordinat y area pada kanvas. Persentase ternormalisasi.

    • w: Lebar area. Persentase ternormalisasi.

    • h: Tinggi area. Persentase ternormalisasi.

    • vol: Volume streamer dalam desibel. Nilai valid: [0,255].

    • vad: Voice activity detection (VAD). Nilai 150 menunjukkan bahwa suara terdeteksi. Nilai selain 150 menunjukkan waktu trailing dari saat suara terdeteksi hingga tidak terdeteksi lagi.
    Catatan

    Sebagai contoh, jika tata letak pencampuran aliran diterapkan pada dua pengguna dengan UID 111 dan 222, pesan SEI-nya adalah sebagai berikut:

    {"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":60,"vad":123}]}

    Callback events

    ApsaraVideo Real-time Communication menyediakan callback events untuk saluran, pengguna, bypass stream ingest, dan pencampuran aliran. Anda dapat mengonfigurasi callback events ini di konsol.

    Pengenalan callback

    Callback events memungkinkan server bisnis Anda menerima perubahan status real-time untuk saluran, pengguna, bypass stream ingest, dan pencampuran aliran:

    • Callback saluran: Event seperti pembuatan atau pembubaran saluran.

    • Callback pengguna: Event seperti pengguna bergabung atau meninggalkan saluran, mengganti role, atau memulai/menghentikan ingest atau pulling aliran.

    • Callback bypass dan pencampuran aliran: Event Stream Relay.

    Untuk informasi lebih lanjut tentang callback saluran dan pengguna, lihat Subscribe to channel message callbacks. Untuk informasi lebih lanjut tentang callback bypass dan pencampuran aliran, lihat Subscribe to stream mixing and ingest events.

    Buat tugas callback

    Callback saluran dan pengguna

    1. Masuk ke Konsol ApsaraVideo Live.

    2. Pada panel navigasi di sebelah kiri, klik Live + > ApsaraVideo Real-time Communication > Applications.

    3. Temukan aplikasi tempat Anda ingin membuat tugas callback, klik Manage untuk membuka halaman manajemen aplikasi.

    4. Pada panel navigasi di sebelah kiri, pilih Callbacks > Channel and User Callbacks, lalu klik Create Task.

    5. Atur parameter callback. Parameter tersebut dijelaskan dalam tabel berikut:

      Parameter

      Deskripsi

      Callback URL

      Alamat server bisnis Anda yang menerima pesan callback. HTTP dan HTTPS didukung. Kami menyarankan Anda menggunakan HTTPS.

      Event Scope

      Event callback mencakup User events dan Channel events.

      • User events mencakup hal berikut:

        • Join channel

        • Start screen sharing

        • Leave

        • Stop video ingest

        • Switch role

        • Stop audio ingest

        • Start video ingest

        • Stop screen sharing

        • Start audio ingest

      • Channel events mencakup hal berikut:

        • Channel started

        • Channel ended

      Specified Channel

      Opsional. Jika Anda tidak menentukan saluran, callback akan dihasilkan untuk event di semua saluran secara default. Jika Anda menentukan saluran, callback hanya akan dihasilkan untuk event di saluran tersebut.

      Specified User

      Opsional. Parameter ini hanya berlaku untuk user events. Jika Anda menentukan user ID, Anda juga harus menentukan channel ID. Anda dapat memasukkan maksimal 20 user ID, dipisahkan dengan koma (,).

    6. Klik OK untuk membuat tugas.

    Bypass dan callback pencampuran aliran

    1. Masuk ke Konsol ApsaraVideo Live.

    2. Pada panel navigasi di sebelah kiri, klik Live + > ApsaraVideo Real-time Communication > Applications.

    3. Temukan aplikasi tempat Anda ingin membuat tugas callback, lalu klik Manage.

    4. Pada panel navigasi di sebelah kiri, pilih Callbacks > Mixed-stream Relay Callbacks, lalu klik Configure.

    5. Atur parameter callback. Parameter tersebut dijelaskan dalam tabel berikut:

      Parameter

      Deskripsi

      Webhook address

      Alamat server bisnis Anda yang menerima pesan callback. HTTP dan HTTPS didukung. Kami menyarankan Anda menggunakan HTTPS.

      Channel scope

      Opsional. Tentukan saluran (ChannelIDs) tempat Anda ingin menerima callback. Anda dapat menentukan maksimal 20 saluran. Pisahkan beberapa ID dengan koma (,). Setiap ID saluran dapat berisi huruf besar, huruf kecil, angka, garis bawah (_), dan tanda hubung (-). Panjang maksimum adalah 64 karakter. Jika Anda biarkan kosong, Anda akan menerima callback dari semua saluran secara default.

    Edit dan hapus catatan callback

    Callback saluran dan pengguna

    Setelah Anda membuat tugas callback saluran dan pengguna, Anda dapat memperbarui atau menghapus tugas tersebut.

    image

    1. Buka halaman Channel and User Callbacks dan temukan tugas yang ingin Anda perbarui atau hapus.

    2. Pada kolom Actions, klik Edit untuk memodifikasi tugas atau Delete untuk menghapus tugas.

    Callback bypass dan pencampuran aliran

    Setelah Anda mengonfigurasi callback bypass dan pencampuran aliran, Anda dapat memodifikasi atau menghapus konfigurasi tersebut.image

    Lihat catatan callback

    Setelah tugas callback aktif, Anda dapat melihat detail event callback dalam catatan callback.

    image

    image