ApsaraVideo Live:Perekaman siaran langsung

Metode 1: Konsol

1. Masuk ke Konsol ApsaraVideo Live.

2. Di bilah navigasi kiri, pilih Feature Management > Recording. Di tab Recording Configuration, pilih VOD.

3. Pilih domain streaming yang akan dikonfigurasi, lalu klik Add.

4. Konfigurasikan template perekaman.

   Pengaturan perekaman dasar

   Parameter	Deskripsi
   Application Name	Nama aplikasi harus sama dengan AppName dalam URL ingest aliran agar berlaku. Untuk menerapkan ke semua aplikasi di bawah domain, masukkan *.
   Stream Name	Nama stream. Mendukung pencocokan eksak untuk merekam stream tertentu. Untuk merekam semua siaran langsung di bawah AppName saat ini, masukkan *.
   VOD Application	Ruang kerja tempat file yang direkam disimpan, dibuat dalam layanan ApsaraVideo VOD. Bidang ini tidak ditampilkan jika ruang kerja tidak diaktifkan.
   Bucket	Anda dapat memilih lokasi penyimpanan yang dibuat dalam layanan ApsaraVideo VOD di wilayah saat ini. Secara default, sistem menggunakan alamat unggah default yang dikonfigurasi di ApsaraVideo VOD.
   Recording Source	Anda dapat merekam Raw Stream atau Transcoded Streams. Keduanya dapat dipilih secara bersamaan. Saat Anda memilih Transcoded Streams, Anda dapat menentukan hingga 10 template transkoding atau memilih semua template transkoding. Perekaman aliran yang telah dikodekan ulang hanya berlaku jika AppName template transkoding adalah * atau sama dengan AppName template perekaman.
   Trigger Mode	Perekaman dapat dipicu dengan cara berikut: Automatic, Callback Confirmation, Ingest Parameter Trigger, dan Manual. Untuk informasi lebih lanjut, lihat Metode pemicu perekaman.
   Format	Mendukung format M3U8, FLV, dan MP4. Saat memilih beberapa format, Anda dapat mengonfigurasi pengaturan VOD untuk setiap format secara terpisah.
   Recording Cycle	Durasi maksimum file perekaman tunggal. Jika durasi siaran langsung melebihi ambang batas ini, sistem akan menghasilkan file baru. Default: 180 menit. Rentang: 15 hingga 360 menit.
   Reconnect Timeout	Jika gangguan siaran langsung lebih pendek dari durasi ini, perekaman dilanjutkan ke file yang sama. Gangguan yang lebih lama menyebabkan file baru dibuat. Default: 180 detik. Rentang: 15 hingga 21.600 detik.
   Segment Length	Durasi segmen TS tunggal. Ini hanya ditampilkan saat Anda memilih format M3U8. Default: 30 detik. Rentang: 5 hingga 30 detik.

   Pengaturan VOD

   Saat menyimpan rekaman di ApsaraVideo VOD, Anda dapat menggunakan pengaturan ini untuk memproses file yang direkam dengan kemampuan pemrosesan media ApsaraVideo VOD. Jika Anda memilih beberapa format perekaman, Anda dapat mengonfigurasinya secara terpisah.

   Parameter	Deskripsi
   Auto Merge	Jika diaktifkan, beberapa file dari siklus perekaman berbeda secara otomatis digabung menjadi satu file rekaman dan disimpan di ApsaraVideo VOD setelah siaran langsung berakhir. File rekaman asli tetap disimpan.
   Video Processing	Gunakan layanan ApsaraVideo VOD untuk memproses video yang direkam. Source Video: Setiap file siklus perekaman diproses secara individual. Merged Video: Memproses file yang digabung (Ditampilkan setelah penggabungan otomatis diaktifkan).
   Processing Method	MendukungTranscoding Template Group dan Workflow.
   Processing Template	Pilih kelompok template transkoding atau template alur kerja dari layanan ApsaraVideo VOD. Catatan: Anda hanya dapat memilih template yang dibuat di wilayah yang sama dengan pusat siaran langsung domain.
   Category	Tetapkan kategori untuk file yang direkam dalam layanan ApsaraVideo VOD.

5. Klik OK untuk membuat template perekaman.

Metode 2: API

Panggil API AddLiveRecordVodConfig untuk menambahkan konfigurasi penyimpanan rekaman di ApsaraVideo VOD. Contoh kode:

// Pengaturan parameter untuk permintaan API
AddLiveRecordVodConfigRequest.RecordFormat recordFormat0 = AddLiveRecordVodConfigRequest.RecordFormat.builder()
        .format("m3u8")
        .sliceDuration(30)
        .autoCompose("ON")
        .videoProcess("origin,compose")
        .processMethod("transcode")
        .processTemplateId("e2d796d3bb5fd8049d32bff62f94****")
        .tags("sports")
        .build();

AddLiveRecordVodConfigRequest addLiveRecordVodConfigRequest = AddLiveRecordVodConfigRequest.builder()
        .regionId("<Your RegionID>")
        .domainName("<Your DomainName>")
        .appName("live")
        .streamName("stream1")
        .cycleDuration(3600)
        .spaceId("app-1000000")
        .storageLocation("<Your StorageLocation>")
        .onDemand(0)
        .recordContent("raw,transcode")
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Konfigurasi rewrite tingkat permintaan, dapat mengatur parameter permintaan Http, dll.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

Parameter utama

• OnDemand

  Metode pemicu perekaman. Nilai yang valid: 0 (perekaman otomatis), 1 (perekaman on-demand), 2 (pengaturan parameter ingest), 7 (perekaman manual). Untuk detail, lihat Metode pemicu perekaman.

• DelayTime

  Durasi penyambungan untuk aliran yang terputus dalam detik. Jika gangguan siaran langsung lebih pendek dari durasi ini, perekaman dilanjutkan ke file yang sama. Gangguan yang lebih lama menyebabkan file baru dibuat.

• RecordContent, TranscodeTemplates

  Tentukan apakah akan merekam aliran sumber atau aliran yang telah dikodekan ulang. Saat merekam aliran yang telah dikodekan ulang, Anda harus menentukan ID template transkoding.

• RecordFormat: Mengatur format penyimpanan dan konfigurasi VOD. Ini mencakup:

  • AutoCompose: Jika diaktifkan, beberapa file dari siklus perekaman berbeda secara otomatis digabung menjadi satu file setelah siaran langsung berakhir.

  • VideoProcess, ProcessMethod, ProcessTemplateId: Gunakan template transkoding atau alur kerja ApsaraVideo VOD untuk memproses file rekaman asli atau video yang telah digabung otomatis.

Untuk deskripsi parameter lengkap, lihat AddLiveRecordVodConfig - Tambahkan konfigurasi untuk menyimpan rekaman siaran langsung di VOD.

Metode 1: Konsol

1. Masuk ke Konsol ApsaraVideo Live.

2. Di bilah navigasi kiri, pilih Feature Management > Recording. Di tab Recording Configuration, pilih OSS.

3. Pilih domain streaming yang akan dikonfigurasi, lalu klik Add.

4. Konfigurasikan template perekaman. Anda dapat memilih untuk merekam aliran sumber, aliran yang telah dikodekan ulang, atau keduanya.

   Pengaturan perekaman dasar

   Parameter	Deskripsi
   Application Name	Nama aplikasi. Ini harus sesuai dengan AppName dalam URL dorong agar pengaturan berlaku. Jika Anda ingin pengaturan berlaku untuk semua aplikasi di bawah domain, masukkan *.
   Stream Name	Nama stream. Anda dapat menentukan nama stream eksak untuk merekam stream tertentu. Untuk merekam semua siaran langsung di bawah AppName saat ini, masukkan *.
   Storage Location	Anda dapat memilih bucket yang dibuat di OSS di wilayah saat ini. Catatan Ada dua jenis bucket penyimpanan: Bucket standar: Digunakan untuk penyimpanan file umum. Bucket media: Khusus untuk transkoding video. File yang disimpan di jenis bucket ini dapat secara otomatis memicu pekerjaan transkoding ApsaraVideo Media Processing (MPS). Sistem saat ini tidak memberi label jenis bucket. Jika Anda perlu melakukan transkoding video, harap catat nama bucket media untuk memastikan file yang telah dikodekan ulang disimpan dengan benar.
   Interruption Duration Threshold	Jika gangguan siaran langsung lebih pendek dari durasi ini, perekaman dilanjutkan ke file yang sama. Gangguan yang lebih lama menyebabkan file baru dibuat. Default: 180 detik. Rentang: 15 hingga 21.600 detik.
   Trigger Mode	Anda dapat memicu perekaman dengan cara berikut: Automatic, Callback Confirmation, Ingest Parameter Trigger, dan Manual. Untuk informasi lebih lanjut, lihat Metode pemicu perekaman.

   Rekam aliran sumber

   Parameter	Deskripsi
   Storage Format	Mendukung format M3U8, FLV, MP4, dan CMAF. Anda dapat memilih beberapa format, tetapi tidak dapat memilih M3U8 dan CMAF secara bersamaan.
   Naming Conventions	Konvensi penamaan untuk file yang direkam. Jalur default: M3U8, FLV, MP4: record/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime} TS, fMP4: record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}
   Segment Length	Durasi segmen TS tunggal. Ini hanya ditampilkan saat Anda memilih format M3U8 atau CMAF. Default: 30 detik. Rentang: 5 hingga 30 detik.
   Recording Cycle	Durasi maksimum file perekaman tunggal. Jika durasi siaran langsung melebihi ambang batas ini, sistem akan menghasilkan file baru. Default: 180 menit. Rentang: 15 hingga 360 menit.

   Rekam aliran yang telah dikodekan ulang

   Parameter	Deskripsi
   Transcoded Streams	Pilih aliran yang telah dikodekan ulang untuk direkam. Anda dapat menentukan hingga 10 template transkoding atau memilih semuanya. Agar perekaman aliran yang telah dikodekan ulang berfungsi, AppName template transkoding harus * atau sesuai dengan template perekaman.
   Storage Format	Mendukung format M3U8, FLV, MP4, dan CMAF. Anda dapat memilih beberapa format, tetapi tidak dapat memilih M3U8 dan CMAF secara bersamaan.
   Naming Conventions	Konvensi penamaan untuk file yang direkam. Jalur default: M3U8, FLV, MP4: transcodeRecord/{AppName}/{StreamName}_{TranscodingTemplateID}/{EscapedStartTime}_{EscapedEndTime} TS, fMP4: transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}
   Segment Length	Durasi segmen TS tunggal. Ini hanya ditampilkan saat Anda memilih format M3U8 atau CMAF. Default: 30 detik. Rentang: 5 hingga 30 detik.
   Recording Cycle	Durasi maksimum file perekaman tunggal. Jika durasi siaran langsung melebihi ambang batas ini, sistem akan menghasilkan file baru. Default: 180 menit. Rentang: 15 hingga 360 menit.

5. Klik OK untuk membuat template perekaman.

Metode 2: API

Panggil API AddLiveAppRecordConfig untuk menambahkan konfigurasi penyimpanan rekaman di OSS. Contoh kode:

// Pengaturan parameter untuk permintaan API
AddLiveAppRecordConfigRequest.TranscodeRecordFormat transcodeRecordFormat0 = AddLiveAppRecordConfigRequest.TranscodeRecordFormat.builder()
        .sliceDuration(30)
        .sliceOssObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{EscapedStartTime}_{EscapedEndTime}")
        .cycleDuration(900)
        .format("m3u8")
        .build();

AddLiveAppRecordConfigRequest.RecordFormat recordFormat0 = AddLiveAppRecordConfigRequest.RecordFormat.builder()
        .sliceDuration(30)
        .format("m3u8")
        .cycleDuration(900)
        .sliceOssObjectPrefix("record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}")
        .build();

AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = AddLiveAppRecordConfigRequest.builder()
        .domainName("<Your DomainName>")
        .appName("live")
        .ossEndpoint("<Your OssEndpoint>")
        .ossBucket("<Your OssBucket>")
        .streamName("stream1")
        .onDemand(0)
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeRecordFormat(java.util.Arrays.asList(transcodeRecordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Penulisan ulang konfigurasi tingkat permintaan, dapat mengatur parameter permintaan Http, dll.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

Parameter utama

• OnDemand

  Metode pemicu perekaman. Nilai yang valid: 0 (perekaman otomatis), 1 (perekaman on-demand), 2 (pengaturan parameter ingest), 7 (perekaman manual). Untuk detail, lihat Metode pemicu perekaman.

• DelayTime

  Durasi penyambungan untuk aliran yang terputus dalam detik. Jika gangguan siaran langsung lebih pendek dari durasi ini, perekaman dilanjutkan ke file yang sama. Gangguan yang lebih lama menyebabkan file baru dibuat.

• RecordFormat

  Format penyimpanan dan parameter perekaman untuk aliran sumber, termasuk Format (format penyimpanan), OssObjectPrefix (konvensi penamaan), SliceDuration (durasi segmen), dan CycleDuration (siklus perekaman).

• TranscodeTemplates, TranscodeRecordFormat

  Saat merekam aliran yang telah dikodekan ulang, tentukan daftar ID template transkoding dan format penyimpanan serta parameter perekaman untuk aliran yang telah dikodekan ulang.

Untuk deskripsi parameter lengkap, lihat AddLiveAppRecordConfig - Tambahkan konfigurasi perekaman.