ApsaraVideo Live:Implementasikan penarikan aliran berbasis RTS pada iOS

Buat pemutar

1. Buat pemutar.

   Buat instans AliPlayer.

   // Buat instans pemutar
   AliPlayer mAliPlayer = [[AliPlayer alloc] init];
   
   // Buat kontainer tampilan untuk menampilkan konten pemutaran dan atur tampilan rendering pemutar
   UIView playerView = [[UIView alloc] initWithFrame:self.view.bounds];
   [self.view addSubview:playerView];
   mAliPlayer.playerView = playerView;
   
   [mAliPlayer setTraceID:traceId];

   Catatan

   Pemutar menyediakan fitur Pemantauan Kualitas Pemutaran (melihat data terkait kualitas pemutaran secara keseluruhan), Pelacakan Titik Tunggal (melokalisasi pengguna atau perangkat tertentu, menganalisis perilaku pemutaran mereka, dan mengidentifikasi anomali pemutaran dengan cepat), serta fitur Statistik Pemutaran Video—semuanya bergantung pada fitur pelaporan log instrumentasi.

   Kemampuan yang tersedia setelah Anda membuat pemutar bergantung pada konfigurasi parameter setTraceID, sebagai berikut:

   • Jika parameter setTraceID diabaikan (default), fitur pelaporan log instrumentasi diaktifkan. Anda dapat menggunakan fitur pemantauan kualitas pemutaran dan statistik pemutaran video, tetapi tidak dapat menggunakan fitur pelacakan titik tunggal.

   • Parameter setTraceID diberikan dengan trace ID: Anda menentukan nilai trace ID, yang harus berupa pengenal unik untuk pengguna atau perangkat pengguna Anda, seperti ID pengguna bisnis Anda atau ID perangkat seperti IMEI atau IDFA. Setelah memberikan trace ID, fitur pelaporan log instrumentasi diaktifkan, dan Anda selanjutnya dapat menggunakan fitur pemantauan kualitas pemutaran, pelacakan titik tunggal, dan statistik pemutaran video.

   • Parameter setTraceID diatur ke DisableAnalytics: Ini menonaktifkan pelaporan log instrumentasi. Akibatnya, Anda tidak dapat menggunakan fitur pemantauan kualitas pemutaran, pelacakan titik tunggal, maupun statistik pemutaran video.

2. Atur sumber pemutaran.

   Pemutar mendukung empat sumber pemutaran: VidSts, VidAuth, VidMps, dan UrlSource. Di antaranya, UrlSource memungkinkan pemutaran langsung melalui URL dan memerlukan agar URL diatur ke protokol artc:// untuk menggunakan layanan RTS.

   AVPUrlSource *urlSource = [[AVPUrlSource alloc] 
   urlWithString:"artc://<streaming URL>"]; 
   [mAliPlayer setUrlSource:urlSource];

   Catatan

   Untuk informasi lebih lanjut tentang pengaturan sumber pemutaran, lihat Fitur Dasar.

3. Konfigurasikan parameter pemutaran.

   Konfigurasikan parameter pemutaran untuk meningkatkan efek RTS.

   Catatan

   Mulai versi 6.3.0, SDK pemutar mendukung konfigurasi otomatis optimal untuk latensi rendah. Saat URL pemutaran dimulai dengan artc:// dan Anda belum mengubah secara manual nilai MaxDelayTime, HighBufferDuration, atau StartBufferDuration dalam AVPConfig, SDK secara otomatis menggunakan nilai 1000, 10, dan 10 untuk pemutaran aktual.

   Untuk menyesuaikan parameter ini, gunakan contoh berikut:

   //1. Dapatkan dan ubah konfigurasi.
   AVPConfig *config = mAliPlayer.getConfig;
   
   if ([playUrl hasPrefix:@"artc://"]) {
       // Latensi maksimum. Satuan: milidetik. Dalam contoh ini, atur nilainya ke 1000, yaitu 1 detik.
       [config setMaxDelayTime:1000];
       // Durasi buffer saat startup pemutaran.
       [config setStartBufferDuration:10];
       // Durasi buffer untuk pemulihan saat tersendat.
       [config setHighBufferDuration:10];
   } else {
       // Anda dapat menggunakan konfigurasi default atau menentukan nilai kustom.
   }
   
   //2. Terapkan konfigurasi.
   [mAliPlayer setConfig:config];

4. Mulai pemutaran.

   // Siapkan untuk pemutaran
   [mAliPlayer prepare];
   // Setelah prepare, Anda dapat memanggil operasi start secara sinkron. Pemutaran akan otomatis dimulai ketika callback onPrepared selesai.
   [mAliPlayer start];

Kontrol pemutaran

ApsaraVideo Player SDK mendukung kontrol pemutaran umum, seperti memulai pemutaran dan mencari ke titik waktu tertentu.

 [mAliPlayer start];

[mAliPlayer stop];

// Hapus pemutar secara sinkron. Sistem secara otomatis memanggil metode stop.
[mAliPlayer destroy];
// Hapus pemutar secara asinkron. Sistem secara otomatis memanggil metode stop.
[mAliPlayer destroyAsync];

Gunakan fitur tambahan

1. Log Switch

   // Aktifkan logging.
   [mAliPlayer setEnableLog:YES];
   [mAliPlayer setLogCallbackInfo:LOG_LEVEL_TRACE callbackBlock:nil];
   
   // Nonaktifkan logging.
   [mAliPlayer setEnableLog:NO];
   [mAliPlayer setLogCallbackInfo:LOG_LEVEL_NONE callbackBlock:nil];

2. Fallback Siaran Langsung

   Catatan

   • Penurunan spesifikasi saat kegagalan pemutaran hanya berlaku untuk skenario timeout. Jika terjadi timeout dan Anda telah mengonfigurasi salah satu opsi downgrade di bawah, pemutar akan secara otomatis menurunkan spesifikasi. Jika tidak, callback onError akan dipicu. Error seperti HTTP 404, 403, atau koneksi streamer terputus tidak memicu downgrade.

   • Downgrade RTS Otomatis menurunkan spesifikasi dari RTS ke FLV menggunakan domain yang sama. Jika domain RTS dan FLV Anda berbeda, konfigurasikan Downgrade RTS Kustom untuk menentukan domain FLV tujuan.

   1. Downgrade RTS Otomatis (aktif secara default)

      Saat memutar URL streaming RTS dan tidak ada konfigurasi downgrade kustom, pemutar secara otomatis menurunkan spesifikasi ke URL FLV default yang terkait dengan URL RTS jika penarikan aliran RTS gagal. Contohnya:

      // 1 berarti aktif, dan 0 berarti nonaktif. Nilai default adalah aktif.
      [AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

   2. Downgrade RTS Kustom

      Saat memutar URL streaming RTS, tentukan URL downgrade seperti URL HLS atau FLV. Jika penarikan aliran RTS gagal, pemutar secara otomatis memutar dari URL yang ditentukan.

      // Tentukan URL sumber downgrade.
      AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
      // Opsional. Konfigurasikan pengaturan lainnya.
      AVPConfig *config = [mAliPlayer getConfig];
      // Tentukan URL streaming yang diturunkan spesifikasinya.
      [mAliPlayer enableDowngrade:urlSource config:config];

3. Dapatkan Trace ID

   Setiap pemutaran latensi rendah menghasilkan trace ID, yang dapat Anda gunakan untuk troubleshooting. Ambil trace ID dari callback event pemutar.

   // Dengarkan callback onPlayerEvent dan urai pesan DemuxerTraceID.
   - (void)onPlayerEvent:(AliPlayer*)mAliPlayer eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
       switch (eventWithString) {
           case EVENT_PLAYER_DEMUXER_TRACE_ID:
               {
                   NSString *traceId = description;
               }
                   break;
               default:
                   break;
       }
   }