ApsaraVideo Live：Implementasi penarikan aliran RTS pada iOS

Buat player

1. Buat pemutar.

   Buat instans AliPlayer.

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

   Catatan

   Fitur-fitur pemutar seperti Pemantauan kualitas pemutaran (yang memungkinkan Anda melihat data tentang kualitas pemutaran keseluruhan), Pelacakan titik tunggal (yang memungkinkan Anda menemukan pengguna atau perangkat tertentu, menganalisis perilaku pemutaran mereka, dan mengidentifikasi masalah seperti pemutaran abnormal dengan cepat), serta Statistik pemutaran video, bergantung pada fitur pelaporan log instrumentasi.

   Saat Anda membuat pemutar, fitur-fitur yang tersedia bervariasi tergantung pada pengaturan parameter setTraceID:

   • Jika Anda tidak meneruskan parameter setTraceID (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.

   • Jika Anda meneruskan traceId ke parameter setTraceID: Anda harus menentukan nilai traceId tersebut. traceId harus berupa pengenal unik untuk pengguna atau perangkat, seperti ID pengguna dari aplikasi Anda, International Mobile Equipment Identity (IMEI), atau identifier for advertisers (IDFA). Setelah Anda meneruskan traceId, fitur pelaporan log instrumentasi diaktifkan. Anda kemudian dapat menggunakan fitur pemantauan kualitas pemutaran, pelacakan titik tunggal, dan statistik pemutaran video.

   • Jika Anda mengatur parameter setTraceID ke DisableAnalytics: Fitur pelaporan log instrumentasi dinonaktifkan. Anda tidak dapat menggunakan fitur pemantauan kualitas pemutaran, pelacakan titik tunggal, maupun statistik pemutaran video.

2. Atur sumber pemutaran.

   Pemutar mendukung empat jenis sumber pemutaran: VidSts, VidAuth, VidMps, dan UrlSource. Untuk memutar video dari URL, gunakan UrlSource. Untuk menggunakan layanan RTS, Anda harus mengatur protokol URL menjadi artc://.

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

   Catatan

   Untuk informasi selengkapnya tentang cara mengatur sumber pemutaran, lihat Fitur dasar.

3. Konfigurasikan parameter pemutaran.

   Anda dapat mengonfigurasi parameter pemutaran untuk meningkatkan performa RTS.

   Catatan

   ApsaraVideo Player SDK V6.3.0 dan yang lebih baru mendukung konfigurasi optimal otomatis untuk pemutaran latensi rendah. Jika URL pemutaran dimulai dengan "artc://" dan Anda belum mengubah secara manual nilai MaxDelayTime, HighBufferDuration, atau StartBufferDuration dari AVPConfig, SDK akan mengatur parameter-parameter tersebut secara otomatis menjadi 1000, 10, dan 10.

   Untuk menyesuaikan parameter ini, lihat contoh berikut:

   //1. Dapatkan dan ubah konfigurasi.
   AVPConfig *config = mAliPlayer.getConfig;
   
   if ([playUrl hasPrefix:@"artc://"]) {
       // Latensi maksimum adalah 1 detik.
       [config setMaxDelayTime:1000];
       // Durasi buffer saat startup pemutaran.
       [config setStartBufferDuration:10];
       // Durasi buffer untuk pemulihan saat tersendat.
       [config setHighBufferDuration:10];
   } else {
       // Gunakan konfigurasi default untuk config atau sesuaikan sendiri.
   }
   
   //2. Terapkan konfigurasi.
   [mAliPlayer setConfig:config];

4. Mulai pemutaran.

   // Persiapkan pemutaran.
   [mAliPlayer prepare];
   // Setelah prepare dipanggil, panggil operasi start secara sinkron. Pemutaran akan dimulai secara otomatis setelah callback onPrepared selesai.
   [mAliPlayer start];

Kontrol pemutaran

ApsaraVideo Player SDK untuk iOS mendukung operasi umum seperti memulai pemutaran dan mencari ke waktu tertentu.

 [mAliPlayer start];

[mAliPlayer stop];

// Hapus secara sinkron. API stop dipanggil secara internal secara otomatis.
[mAliPlayer destroy];
// Hapus secara asinkron. API stop dipanggil secara internal secara otomatis.
[mAliPlayer destroyAsync];

Aksesibilitas

1. Aktifkan atau nonaktifkan log

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

2. Fallback siaran langsung

   Catatan

   • Fallback kegagalan pemutaran hanya berlaku untuk skenario timeout. Jika solusi fallback dikonfigurasi, sistem akan melakukan fallback pemutaran saat terjadi timeout. Jika tidak, callback onError pemutar akan dipicu. Pengecualian seperti error 404, error 403, atau koneksi streamer terputus tidak memicu fallback.

   • Fallback RTS otomatis menggunakan nama domain yang sama untuk fallback dari RTS ke FLV. Jika nama domain RTS dan FLV Anda berbeda, konfigurasikan solusi fallback RTS kustom untuk menentukan nama domain FLV tujuan.

   1. Fallback RTS otomatis (diaktifkan secara default)

      Saat Anda memutar video dari URL RTS, jika fallback RTS kustom tidak dikonfigurasi dan penarikan aliran RTS gagal, sistem secara otomatis melakukan fallback ke URL FLV default yang sesuai dengan URL RTS tersebut untuk pemutaran. Berikut contoh kodenya:

      // 1: diaktifkan. 0: dinonaktifkan. Secara default, fitur ini diaktifkan.
      [AliPlayerGlobalSettings setOption:ALLOW_PRE_RENDER valueInt:1];

   2. Fallback RTS kustom

      Saat Anda memutar video dari URL RTS, Anda dapat mengatur URL fallback, seperti URL HLS atau FLV. Jika penarikan aliran RTS gagal, sistem secara otomatis melakukan fallback ke URL tersebut untuk pemutaran.

      // Atur sumber downgradeUrl fallback.
      AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:downgradeUrl];
      // Opsional. Konfigurasi item lain untuk config.
      AVPConfig *config = [mAliPlayer getConfig];
      // Atur URL fallback.
      [mAliPlayer enableDowngrade:urlSource config:config];

3. Dapatkan TraceID

   Setiap pemutaran latensi rendah memiliki traceId yang dapat digunakan untuk troubleshooting. Anda dapat memperoleh traceId melalui callback event pemutar.

   // Dengarkan callback onPlayerEvent dari pemain dan parse 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;
       }
   }