Relai aliran tarik | ApsaraVideo Live - ApsaraVideo Live

Relai aliran tarik memungkinkan Anda menarik sumber siaran langsung atau video sesuai permintaan (VOD) yang sudah ada dan mendorongnya sebagai aliran langsung baru.

Ikhtisar

Relai aliran tarik menarik konten dari aliran langsung pihak ketiga atau video rekaman, lalu menyiarkannya ke penonton secara real time tanpa langkah ingest tradisional.

Alur kerja:

Skenario khas: Akses pengawasan kendaraan

Perangkat yang dipasang di kendaraan sering kali menghasilkan aliran video dalam protokol privat seperti JT/T 1078 atau standar Provinsi Jiangsu. Untuk menghubungkan aliran tersebut ke ApsaraVideo Live, gunakan gerbang konversi protokol untuk mengubah aliran berbasis protokol privat menjadi aliran RTMP standar. Selanjutnya, buat tugas relai aliran tarik. Atur Source Stream Type ke Live Stream, atur protokol aliran sumber ke RTMP, lalu masukkan URL aliran sumber RTMP yang telah dikonversi dan URL ingest tujuan. Klien seluler kemudian dapat memutar aliran tersebut menggunakan Alibaba Cloud Player SDK.

Catatan penggunaan

Fitur ini merupakan fitur berbayar. Penagihan dimulai pukul 00.00 pada 5 Desember 2025. Informasi harga: Biaya relai aliran tarik.
Setiap tugas mendorong satu aliran. Untuk mendorong beberapa aliran, buat beberapa tugas.
Untuk menghindari konflik selama penarikan aliran dan ingest aliran, pastikan hanya satu tugas aktif yang menggunakan URL ingest tujuan tertentu dalam satu waktu. Dua URL ingest tujuan dianggap sama jika semua bagiannya—termasuk StreamName—identik, meskipun nilai auth_key-nya berbeda. Jika beberapa tugas menggunakan URL ingest tujuan yang sama secara bersamaan, tugas yang lebih baru dapat menimpa atau menggantikan aliran sebelumnya, sehingga dapat mengganggu atau menghentikan siaran langsung.
Anda bertanggung jawab memastikan bahwa konten yang digunakan dengan fitur ini mematuhi semua hukum dan peraturan yang berlaku. ApsaraVideo Live hanya menyediakan layanan transmisi aliran. Jika terdapat ancaman hukum, ApsaraVideo Live akan menghentikan layanan untuk konten terkait dan berhak mengambil tindakan hukum.
Untuk menarik atau mendorong aliran di luar Tiongkok daratan, atur wilayah tugas ke wilayah di luar Tiongkok daratan.
Fitur ini mendukung callback event. Untuk detailnya, lihat Callback event relai aliran tarik.
Setiap akun dapat menjalankan maksimal 100 tugas secara bersamaan.

Prasyarat

ApsaraVideo Live telah diaktifkan.

Anda memiliki informasi yang diperlukan tentang sumber siaran langsung atau VOD.

Jenis sumber	Informasi
Live	URL pemutaran aliran langsung. Protokol yang didukung: RTMP, SRT, dan HTTP-FLV.
VOD	ID aset media dari sumber VOD. Untuk mendapatkan ID tersebut, lihat Mendapatkan atau memperbarui informasi aset media.
Video	Jalur URL sumber video. Catatan Jalur URL video harus diawali dengan http:// atau https:// dan diakhiri dengan .mp4 atau .flv.

Catatan

Maksimal 30 ID aset media VOD atau jalur URL sumber video.
Kodek video yang didukung: H.264 dan H.265.
Kodek audio yang didukung: AAC. Laju sampling: 16 kHz hingga 44,1 kHz.
Sumber VOD harus menggunakan format MP4 atau FLV.

URL ingest telah dibuat dari domain ingest Anda. Untuk informasi lebih lanjut, lihat Membuat URL streaming.

Prosedur

Buat tugas

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay.
Pilih wilayah pusat siaran langsung.
Klik Create Task.

Konfigurasikan parameter tugas.

Tabel berikut menjelaskan parameter tugas.

Parameter	Deskripsi
Region	Wilayah tugas penarikan aliran. Pilih wilayah berdasarkan wilayah sumber data atau wilayah ingest aliran. Catatan Wilayah yang didukung: Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Shenzhen), Singapura, dan Indonesia (Jakarta).
Task Name	Nama kustom untuk tugas.
Task Time	Waktu mulai dan akhir tugas. Secara default, waktu mulai adalah lima menit setelah waktu saat ini, dan waktu akhir adalah 24 jam setelah waktu mulai. Pemilih waktu menyediakan pintasan 5 minutes, 30 minutes, dan 1 hour. Pintasan ini menyesuaikan waktu mulai berdasarkan waktu saat ini dan mempertahankan waktu akhir yang valid. Catatan Tugas akan otomatis dimulai pada waktu mulai yang ditentukan. Jika tugas berhenti atau gagal dimulai, klik Enable atau Restart di konsol.
Callback Information	Wajib diisi. URL callback untuk event tugas relai aliran tarik.
Source Type	Jenis aliran sumber. Untuk detail parameter, lihat butir daftar ini. Live Stream: Mendukung protokol aliran sumber RTMP, SRT, dan HTTP-FLV. VOD Asset: Mendukung format video MP4. Jika terdapat beberapa video dengan ID video yang sama, sistem akan memilih video dengan resolusi transkoding tertinggi. Jika video hasil transkoding memiliki resolusi yang sama, salah satu video akan dipilih secara acak. Jika tidak ada video hasil transkoding, video asli akan dipilih. Video Path
Playback Times	Jumlah putaran pemutaran ulang video dalam daftar putar. Pilih putaran tak terbatas atau tentukan jumlah tertentu. Catatan Parameter ini hanya tersedia untuk sumber VOD Asset atau Video Path, dan mengontrol Playback Times.
Destination Ingest URL	URL ingest tujuan untuk mendorong aliran. Untuk sumber aliran langsung, rtmp:// dan rtmps:// didukung. Untuk sumber video sesuai permintaan atau jalur video, hanya rtmp:// yang didukung. Catatan Contoh URL ingest ApsaraVideo Live: rtmp://ingestdomain.com/*/?auth_key=922353-0-0-*f68cba72490a3328a1167c9**

Parameter dalam Callback configuration:

Video switch notification: Sakelar ini hanya ditampilkan untuk sumber VOD Asset atau Video Path dan dinonaktifkan secara default. Saat diaktifkan, callback akan memberi tahu server bisnis Anda saat sumber beralih file.
Callback authentication: Sakelar ini dinonaktifkan secara default. Saat diaktifkan, permintaan callback mencakup header ALI-LIVE-TIMESTAMP dan ALI-LIVE-SIGNATURE.
Metode perhitungan ALI-LIVE-SIGNATURE
```
ALI-LIVE-SIGNATURE=LOWERCASE_HEX(MD5(SIGNCONTENT))
SIGNCONTENT=PullFlowPushTaskID|ALI-LIVE-TIMESTAMP Value|Authentication KEY
```
Deskripsi bidang:
- PullFlowPushTaskID：Setelah pembuatan selesai, nilainya dapat diperoleh di konsol.
- ALI-LIVE-TIMESTAMP：Stempel waktu UNIX (dalam detik) saat permintaan callback dikirim.
- Authentication KEY：Kunci otentikasi yang dikonfigurasi oleh pengguna untuk alamat callback.
Authentication key: Bidang ini hanya ditampilkan saat Callback authentication diaktifkan. Masukkan 16 hingga 64 karakter ASCII yang terlihat (0x21 hingga 0x7e).

Parameter berdasarkan jenis aliran sumber:

Jika Source Stream Type diatur ke Live Stream, sumber mendukung RTMP, SRT, dan HTTP-FLV.
Jika Source Stream Type diatur ke VOD Asset, masukkan ID aset media ke dalam daftar video. Anda dapat menambahkan hingga 30 video, dan sistem akan memutarnya secara berurutan. Untuk Playback Times, pilih Loop atau Specified.
Jika Source Stream Type diatur ke Video Path, masukkan URL video.
Catatan
Jalur URL video harus diawali dengan http:// atau https:// dan diakhiri dengan .mp4 atau .flv.

Klik Submit untuk membuat tugas.

Catatan

Anda juga dapat menggunakan operasi API CreateLivePullToPush untuk membuat tugas.

Kueri tugas

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay.
Pilih wilayah tempat Anda membuat tugas Pulled-stream Relay. Kemudian, Anda dapat melakukan kueri tepat berdasarkan Task ID, Task Name, atau Destination Ingest URL.

Catatan

Anda juga dapat menggunakan operasi API DescribeLivePullToPush.

Salin tugas

Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay untuk membuka halaman Pulled-stream Relay.
Pilih wilayah pusat siaran langsung tugas tersebut. Temukan tugas dalam daftar tugas, lalu klik Copy pada kolom Actions.
Pada halaman pembuatan tugas, tinjau atau ubah konfigurasi yang telah diisi sebelumnya, lalu klik Submit untuk membuat tugas. Aturan berikut berlaku:
- Jika tugas asli berstatus Not Started, konfigurasi asli serta waktu mulai dan akhir akan diisi sebelumnya. Nama tugas tidak diisi sebelumnya.
- Jika tugas asli berstatus Running, Recovering, atau Stopped, konfigurasi asli akan diisi sebelumnya, waktu mulai diatur menjadi lima menit setelah waktu saat ini, dan waktu akhir asli dipertahankan. Nama tugas tidak diisi sebelumnya.
- Jika tugas asli berstatus Ended, aksi Copy tidak tersedia.
- Dalam semua skenario salin, Task Name dikosongkan. Jika Anda membiarkannya kosong, sistem akan menghasilkan nama dalam format taskname_Timestamp.

Ubah tugas

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay.
Pada halaman Pulled-stream Relay, temukan tugas yang ingin Anda ubah, lalu klik Edit pada kolom Actions.
Pada halaman edit, ubah parameter sesuai kebutuhan, lalu klik Submit.
1. Jika tugas berada dalam status Not Started, Anda dapat mengubah Task Time, Callback URL, Playback Times, pengaturan sumber yang dapat diedit dalam Source Information, Callback authentication, Authentication key, dan Video switch notification.
2. Jika tugas berada dalam status Stopped, Anda dapat mengubah Callback URL, Playback Times, pengaturan sumber yang dapat diedit dalam Source Information, Callback authentication, Authentication key, dan Video switch notification.
3. Dalam semua status tugas, Region, Destination URL, Source Type, dan Source Protocol tidak dapat diubah. Konfigurasi tugas tidak dapat diubah dalam status lainnya.

Catatan

Anda juga dapat menggunakan operasi API UpdateLivePullToPush.

Hapus tugas

Penting

Tugas relai aliran tarik tidak dapat dipulihkan.

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay.
Pada halaman Pulled-stream Relay, temukan tugas yang ingin Anda hapus, lalu klik Delete pada kolom Actions.
Pada kotak dialog yang muncul, klik Delete untuk menghapus tugas.

Catatan

Anda juga dapat menggunakan operasi API DeleteLivePullToPush.

Mulai tugas

Catatan

Hanya tugas dengan status Stopped yang dapat diaktifkan.
Tugas akan otomatis dimulai pada waktu mulai yang ditentukan.

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay.
Pada halaman Pulled-stream Relay, temukan tugas yang ingin Anda mulai, lalu klik Enable pada kolom Actions.
Pada kotak dialog yang muncul, klik Enable untuk memulai tugas.

Mulai ulang tugas

Catatan

Hanya tugas dengan status Running yang dapat direstart.

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management > Pulled-stream Relay.
Pada halaman Pulled-stream Relay, temukan tugas yang ingin Anda restart, lalu klik Restart pada kolom Actions.
Pada kotak dialog yang muncul, klik Restart untuk merestart tugas.

Catatan

Anda juga dapat menggunakan operasi API RestartLivePullToPush.

Hentikan tugas

Catatan

Anda dapat Stop tugas dengan status Running.

Masuk ke Konsol ApsaraVideo Live.
Pada panel navigasi kiri, pilih Feature Management> Pulled-stream Relay.
Pada halaman Pulled-stream Relay, temukan tugas yang ingin Anda hentikan, lalu klik Stop pada kolom Actions.
Pada kotak dialog yang muncul, klik Stop untuk menghentikan tugas.

Catatan

Anda juga dapat menggunakan operasi API StopLivePullToPush.

FAQ

Bagaimana cara membuat URL streaming setelah membuat tugas?

URL streaming untuk tugas relai aliran tarik harus dibuat berdasarkan domain streaming, AppName, dan StreamName yang terkait dengan URL ingest tujuan. Anda dapat membuat URL ini menggunakan Pembuat URL di konsol atau dengan menggabungkannya secara manual.

Apakah tugas relai aliran tarik akan otomatis dilanjutkan jika aliran sumber pihak ketiga terputus?

Saat aliran sumber pihak ketiga terputus, status tugas berubah menjadi Recovering (abnormal). Secara default, sistem akan mencoba menarik aliran kembali setiap menit, hingga tiga kali.

Jika aliran sumber pulih dan berhasil ditarik dalam waktu 3 menit, status tugas secara otomatis berubah menjadi Running (Normal).
Jika ketiga percobaan gagal, status tugas berubah menjadi Offline, dan sistem tidak lagi mencoba menarik aliran secara otomatis. Untuk merestart tugas, klik tombol Restart di konsol atau panggil API RestartLivePullToPush.