All Products
Search

This Product

    ApsaraVideo Live:Live stream ingest

    Document Center

    ApsaraVideo Live:Live stream ingest

    Last Updated:Sep 11, 2026

    Topik ini menjelaskan cara melakukan live stream ingest menggunakan Open Broadcaster Software (OBS) dan Push SDK.

    Prasyarat

    Buat URL ingest. Untuk informasi selengkapnya, lihat Generate live stream URLs.

    Catatan penggunaan

    ApsaraVideo Live hanya menerima satu aliran per URL ingest dalam satu waktu dan menolak aliran tambahan ke URL tersebut.

    Catatan

    • Jika Anda mengalami pengecualian selama live stream ingest, gunakan tool troubleshooting untuk mendiagnosis masalah umum ingest dan mendapatkan solusinya. Untuk informasi selengkapnya, lihat Troubleshooting.

    • Untuk mencegah kegagalan ingest aliran yang jarang terjadi akibat masalah sistem yang memengaruhi layanan live streaming Anda, kami merekomendasikan penerapan kebijakan high availability, seperti retry ingest aliran dan alarm error, saat menggunakan tool ingest aliran pihak ketiga. Anda juga dapat mengonfigurasi callback ingest aliran untuk memantau status ingest aliran. Sebarkan URL streaming hanya setelah ingest aliran berhasil. Untuk informasi selengkapnya, lihat Event Callback.

    • Domain ingest tidak membatasi bitrate ingest aliran. Namun, kami merekomendasikan agar Anda menjaga bitrate satu aliran tetap di bawah 4 Mbps.

    Ingest menggunakan OBS

    OBS tersedia untuk Windows, macOS, dan Linux. Topik ini menggunakan OBS Studio V27.2.3 untuk Windows sebagai contoh. Langkah-langkahnya serupa untuk versi dan sistem operasi lainnya.

    1. Unduh OBS Studio dari Official website dan instal.

    2. Jalankan OBS Studio.

    3. Pada bilah menu, pilih File > Settings.

    4. Pada halaman Settings, klik Stream dan konfigurasikan parameter berikut:

      Parameter

      Deskripsi

      Service

      Pilih Custom.

      Server

      Masukkan URL ingest terautentikasi yang telah dibuat. Contoh: rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************.

      Stream Key

      Biarkan Stream Key kosong.

    5. Pada jendela utama OBS Studio, tambahkan sumber di bagian Sources, lalu klik Start Streaming.

    6. Buka halaman Stream Management. Pada tab Active Streams, Anda dapat melihat dan mengelola aliran aktif Anda.

    Ingest menggunakan demo Push SDK

    1. Pindai kode QR dengan perangkat seluler Anda untuk menginstal demo Push SDK.

      image

      Catatan

      Pada iOS, jika muncul pesan "Untrusted Enterprise Developer", buka Settings > General > Device Management, lalu temukan dan percayai profil Taobao.

    2. Jalankan demo Push SDK.

    3. Pilih Camera Pushing atau Screen Sharing.

      Catatan

      Untuk ingest video lokal, demo hanya mendukung format YUV asli.

    4. Masukkan URL ingest terautentikasi Anda (misalnya, rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************) dan konfigurasikan parameter lain sesuai kebutuhan.

    5. Klik Start Pushing untuk mulai mengambil aliran dari perangkat seluler Anda.

    6. Buka halaman Stream Management. Pada tab Active Streams, Anda dapat melihat dan mengelola aliran aktif Anda.

    Ingest menggunakan Push SDK

    Push SDK for iOS

    1. Integrasikan Push SDK for iOS. Untuk informasi selengkapnya, lihat SDK integration.

    2. Konfigurasikan parameter ingest aliran dan lakukan ingest aliran. Untuk informasi selengkapnya, lihat Feature usage.

      Untuk informasi tentang penanganan pengecualian selama konfigurasi dan ingest, lihat Handle errors, exceptions, and special cases.

    Push SDK for Android

    1. Integrasikan Push SDK for Android. Untuk informasi selengkapnya, lihat SDK integration.

    2. Konfigurasikan parameter ingest aliran dan lakukan ingest aliran. Untuk informasi selengkapnya, lihat Feature usage.

      Untuk informasi tentang penanganan pengecualian selama konfigurasi dan ingest, lihat Handle errors, exceptions, and special cases.

    Push SDK for Flutter

    1. Integrasikan Push SDK for Flutter. Untuk informasi selengkapnya, lihat SDK integration.

    2. Konfigurasikan parameter ingest aliran dan lakukan ingest aliran. Untuk informasi selengkapnya, lihat Feature usage.

    Push SDK for Web

    FAQ

    Apa yang harus dilakukan jika ingest aliran OBS sudah dikonfigurasi dengan benar tetapi pemutaran tidak menampilkan video?

    1. Verifikasi bahwa nama domain ingest, nama aplikasi (appName), dan nama aliran (streamName) telah dikonfigurasi dengan benar di OBS.

    2. Buka halaman Stream management di Konsol untuk memeriksa apakah aliran tersedia di tab Active Stream.

    3. Jika aliran tidak tersedia, lakukan troubleshooting terhadap status ingest lokal OBS dan konektivitas jaringan. Pastikan ingest berhasil sebelum menguji pemutaran.

    Aliran langsung diputar dengan video tersendat tetapi audio normal di perangkat iOS. Apa yang harus saya lakukan?

    Masalah ini biasanya disebabkan oleh ketidaksesuaian antara parameter video encoding dan kemampuan decoding perangkat iOS. Sesuaikan konfigurasi ingest aliran, seperti kodek video, bitrate, dan GOP, untuk memastikan kompatibilitas dengan iOS.

    Bisakah saya melakukan streaming langsung dari Douyin ke ApsaraVideo Live?

    Douyin tidak mendukung ingest aliran langsung ke ApsaraVideo Live. Untuk mengirim konten live stream ke ApsaraVideo Live, gunakan klien ingest independen seperti OBS atau tool ingest kustom. Dorong live stream ke URL ingest yang dihasilkan oleh ApsaraVideo Live menggunakan protokol yang didukung seperti RTMP, ARTC, atau SRT.

    Bagaimana cara melakukan streaming dari kamera RTSP ke ApsaraVideo Live?

    Kamera RTSP biasanya menghasilkan aliran RTSP. ApsaraVideo Live hanya mendukung protokol ingest RTMP, ARTC, dan SRT, serta tidak menerima aliran RTSP secara langsung. Untuk melakukan ingest dari kamera RTSP ke ApsaraVideo Live, gunakan salah satu metode berikut:

    • Hubungi produsen perangkat untuk memeriksa apakah perangkat lunak manajemen atau perangkat gateway mendukung konversi aliran RTSP ke protokol RTMP atau SRT.

    • Gunakan tool ingest pihak ketiga yang mendukung konversi protokol untuk meneruskan aliran RTSP ke ApsaraVideo Live melalui RTMP atau SRT.

    Kapan pengaturan encoding yang saya ubah pada klien ingest berlaku? Bagaimana cara menyesuaikan kualitas aliran?

    Setelah Anda mengubah pengaturan encoding seperti GOP pada klien ingest, hentikan ingest aliran saat ini dan mulai kembali. Pengaturan baru hanya berlaku setelah Anda memulai ulang ingest aliran, sehingga perubahan yang dilakukan selama ingest aliran langsung tidak diterapkan secara langsung.

    Sesuaikan kualitas aliran sesuai dengan cara Anda melakukan ingest aliran:

    • Jika Anda menggunakan demo Push SDK atau aplikasi terkemas, sesuaikan resolusi langsung pada antarmuka ingest.

    • Jika Anda mengintegrasikan Push SDK ke dalam aplikasi Anda sendiri, atur setQualityMode menjadi resolution_first dalam kode Anda untuk memprioritaskan resolusi tinggi, tingkatkan resolusi dan bitrate target, serta aktifkan adaptive bitrate.

    Setelah saya menutup browser, apakah saluran langsung tetap online saat saya menggunakan Web Real-Time Communication (WebRTC) atau ingest aliran berbasis browser? Bagaimana perbedaan ingest aliran berbasis browser dengan ingest OBS?

    Web Real-Time Communication (WebRTC) dan ingest aliran berbasis browser bergantung pada koneksi real-time antara browser dan layanan live streaming. Setelah Anda menutup browser, ingest aliran langsung berhenti dan saluran langsung di ApsaraVideo Live tidak tetap online. Untuk menjaga saluran langsung tetap online, gunakan tool ingest mandiri seperti OBS.

    Dibandingkan dengan ingest aliran berbasis browser, ingest OBS memiliki keunggulan berikut:

    • Mendukung encoding perangkat keras seperti NVENC, QSV, dan VideoToolbox, yang meningkatkan efisiensi encoding.

    • Memberikan kontrol detail halus atas keyframe dan bitrate, yang mengurangi latensi dan membuat ingest aliran lebih stabil.

    • Mendukung protokol SRT, yang tahan terhadap kehilangan paket dan memungkinkan kebijakan rekoneksi kustom.

    • Mengatur sumber daya lebih efisien dan menghindari tersendat yang disebabkan oleh garbage collection browser.

    Langkah selanjutnya

    • Setelah Anda memulai live stream ingest, Anda dapat memulai pemutaran live stream. Untuk informasi selengkapnya, lihat Live stream playback.

    • Untuk mengelola aliran yang telah diingest, lihat Manage streams.