全部产品
Search

搜索本产品

    ApsaraVideo Live：Kelola aplikasi ApsaraVideo Real-time Communication

    文档中心

    ApsaraVideo Live：Kelola aplikasi ApsaraVideo Real-time Communication

    更新时间：Nov 23, 2025

    Untuk menggunakan ApsaraVideo Real-time Communication (RTC), Anda harus terlebih dahulu membuat aplikasi RTC. Hal ini memungkinkan Anda membangun fitur-fitur seperti panggilan, obrolan santai, dan konferensi. Topik ini menjelaskan cara membuat aplikasi RTC.

    Buat aplikasi RTC

    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, pilih Terms Of Service, lalu klik Buy Now.

    5. Setelah aplikasi dibuat, muat ulang halaman ApsaraVideo Real-time Communication Applications untuk melihat aplikasi tersebut.

      Catatan

      Pembuatan aplikasi tidak dikenai biaya. Anda akan dikenai biaya berdasarkan penggunaan aktual dengan skema bayar sesuai penggunaan. Untuk informasi selengkapnya, lihat Penagihan RTC.

    Konfigurasi relay aliran

    1. Masuk ke Konsol ApsaraVideo Live.

    2. Pada panel navigasi di sebelah kiri, klik Live + > ApsaraVideo Real-time Communication > Applications. Temukan 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 StartLiveMPUTask - Buat tugas pencampuran dan relay aliran (baru) 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 stream relay, aliran audio dan video akan direlay ke server origin ApsaraVideo Live. Anda kemudian dapat menggunakan nama domain pemutaran untuk mengonfigurasi fitur-fitur seperti transkoding, perekaman, dan pengambilan snapshot, atau menarik aliran langsung untuk ditonton.

        1. Nyalakan sakelar Stream Relay.

        2. Konfigurasi parameter relay.

          Parameter

          Opsi Konfigurasi

          Deskripsi

          Stream Relay

          On atau Off

          Setelah Anda mengaktifkan relay aliran tunggal, semua aliran audio dan video secara default direlay ke streaming langsung standar. Setelah relay, Anda masih dapat memperbarui tata letak pencampuran aliran menggunakan kit pengembangan perangkat lunak (SDK) atau API sisi server.

          Nama domain pemutaran

          Contoh: "play.example.com"

          Nama domain pemutaran untuk aliran setelah direlay ke streaming langsung standar. Anda dapat menggunakan nama domain ini untuk memutar aliran langsung dan mengonfigurasi fitur-fitur seperti transkoding dan perekaman.

          Catatan

          • Jika Anda belum memiliki nama domain pemutaran, buka Domain Names untuk menambahkannya.

          • Nama domain pemutaran tidak mendukung Streaming Real-Time (RTS) dengan latensi 400 ms hingga 600 ms. Jika tidak, relay aliran akan gagal.

          AppName

          Hingga 255 karakter. Dapat berisi angka, huruf kapital, huruf kecil, tanda hubung (-), garis bawah (_), dan tanda sama dengan (=).

          Nilai default adalah "live". Anda dapat menentukan nilai kustom.

          AppName dalam URL streaming setelah relay. Untuk informasi selengkapnya, lihat Hasilkan URL streaming.

          Catatan

          Untuk menyambungkan templat transkoding, perekaman, atau pengambilan snapshot ke aliran yang direlay, Anda harus mengatur AppName ini agar sama dengan AppName dalam templat agar templat tersebut berlaku.

          SEI Insertion

          • Sisipkan SEI pada interval reguler: Menyisipkan frame SEI pada interval tertentu. Anda dapat mengatur interval dari 1.000 ms hingga 5.000 ms.

          • Sisipkan SEI dalam Frame-I: Menyisipkan SEI dalam Frame-I dari aliran video.

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

          Catatan

          Jika nama domain pemutaran untuk penonton belum ada di Domain Names, Anda harus menambahkannya terlebih dahulu. Untuk informasi selengkapnya, lihat Tambahkan nama domain.

    Format SEI

    Tipe Data

    Nama Parameter

    Nilai

    Informasi aliran video

    stream

    Informasi streamer:

    uid: ID pengguna streamer.

    Informasi tata letak panel tempat streamer berada. Perhatikan parameter berikut:

    • paneid: ID panel. Nilai valid: [0,8].

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

    • x: Koordinat x area dalam kanvas. Nilainya merupakan persentase ternormalisasi.

    • y: Koordinat y area dalam kanvas. Nilainya merupakan persentase ternormalisasi.

    • w: Lebar area. Nilainya merupakan persentase ternormalisasi.

    • h: Tinggi area. Nilainya merupakan persentase ternormalisasi.

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

    • vad: Deteksi aktivitas suara. Nilai valid: [0,150]. Nilai 150 menunjukkan bahwa suara manusia terdeteksi. Nilai selain 150 menunjukkan waktu redam dari saat suara hadir hingga tidak ada.

    Catatan

    Jika aliran dua pengguna dengan ID pengguna (UID) 111 dan 222 dicampur, kode berikut memberikan contoh pesan SEI: 

    {"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}]}

    Event callback

    ApsaraVideo Real-time Communication menyediakan event callback untuk saluran, pengguna, bypass, dan pencampuran aliran. Bagian ini menjelaskan cara mengonfigurasi event callback tersebut di konsol.

    Ikhtisar callback

    Dengan menggunakan event callback, server bisnis Anda dapat menerima perubahan status real-time terkait saluran, pengguna, bypass, dan pencampuran aliran di RTC:

    • Callback saluran: Event seperti pembuatan saluran dan penghentian saluran.

    • Callback pengguna: Event seperti pengguna bergabung atau meninggalkan saluran, mengganti peran, serta memulai atau menghentikan pengambilan dan penarikan aliran.

    • Callback bypass dan pencampuran aliran: Event Stream Relay.

    Untuk informasi selengkapnya tentang callback saluran dan pengguna, lihat Berlangganan callback event saluran. Untuk informasi selengkapnya tentang callback bypass dan pencampuran aliran, lihat Berlangganan callback event pencampuran dan relay aliran.

    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, lalu buka halaman manajemen aplikasi.

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

    5. Atur parameter callback. Tabel berikut menjelaskan parameter-parameter tersebut.

      Parameter

      Deskripsi

      Callback URL

      URL server bisnis Anda yang menerima informasi callback. Protokol HTTP dan HTTPS didukung. Kami merekomendasikan penggunaan HTTPS.

      Event Scope

      Event callback mencakup event pengguna dan event saluran.

      • Event pengguna meliputi:

        • Bergabung ke saluran

        • Memulai pengambilan berbagi layar

        • Meninggalkan saluran

        • Menghentikan pengambilan aliran video

        • Mengganti peran

        • Menghentikan pengambilan aliran audio

        • Memulai pengambilan aliran video

        • Menghentikan pengambilan berbagi layar

        • Memulai pengambilan aliran audio

      • Event saluran meliputi:

        • Saluran dimulai

        • Saluran diakhiri

      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 event pengguna. Jika Anda menentukan ID pengguna, Anda juga harus menentukan ID saluran. Anda dapat memasukkan hingga 20 ID pengguna, dipisahkan dengan koma (,).

    6. Klik OK untuk membuat tugas.

    Callback bypass dan 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, klik Manage, lalu buka halaman manajemen aplikasi.

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

    5. Atur parameter callback. Tabel berikut menjelaskan parameter-parameter tersebut.

      Parameter

      Deskripsi

      Callback URL

      URL server bisnis Anda yang menerima informasi callback. Protokol HTTP dan HTTPS didukung. Kami merekomendasikan penggunaan HTTPS.

      Channel Scope

      Opsional. Tentukan saluran (ChannelIDs) tempat Anda ingin menerima callback. Anda dapat menentukan hingga 20 ID saluran. Pisahkan beberapa ID dengan koma (,). Setiap ID saluran dapat memiliki panjang hingga 64 karakter dan dapat berisi huruf kapital, huruf kecil, angka, garis bawah (_), dan tanda hubung (-). Jika Anda membiarkan parameter ini kosong, callback untuk semua saluran akan diterima.

    Edit dan hapus tugas callback

    Callback saluran dan pengguna

    Setelah Anda membuat tugas callback untuk 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 Tindakan, klik Edit atau Delete untuk memodifikasi atau menghapus tugas tersebut.

    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 Anda membuat tugas callback dan tugas tersebut berlaku, Anda dapat mengkueri detail event callback di catatan callback.

    image

    image