ApsaraVideo VOD：FAQ untuk ApsaraVideo Player SDK untuk iOS

Gejala: Saat memaketkan aplikasi dengan Xcode 14 dan mengirimkannya ke App Store untuk ditinjau, terjadi error terkait bitcode. Kode berikut menunjukkan contoh pesan error:

 ITMS-90482: Invalid Executable - The executable 'xxx.app/Frameworks/alivcffmpeg.framework/alivcffmpeg' contains bitcode.

Solusi: Anda dapat menjalankan perintah xcrun bitcode_strip untuk menghapus bitcode dari framework secara manual. Pada contoh berikut, ${framework_path} adalah path file biner framework tersebut.

xcrun bitcode_strip ${framework_path} -r -o ${framework_path}

Gejala: Saat memaketkan aplikasi dengan Xcode 14 dan mengirimkannya ke App Store untuk ditinjau, terjadi error terkait cURL. Kode berikut menunjukkan contoh pesan error:

ITMS-90338: Non-public API usage - The app references non-public symbols in Frameworks/AliyunPlayer.framework/AliyunPlayer: _curl_multi_poll, _curl_multi_wakeup. If method names in your source code match the private Apple APIs listed above, altering your method names will help prevent this app from being flagged in future submissions. In addition, note that one or more of the above APIs may be located in a static library that was included with your app. If so, they must be removed. For further information, visit the Technical Support Information at http://developer.apple.com/support/technical/

Solusi:

• Jika proyek Anda hanya mengintegrasikan ApsaraVideo Player SDK (AliPlayerSDK_iOS), upgrade SDK ke versi di atas 5.4.9.2.

• Jika proyek Anda mengintegrasikan ApsaraVideo Player SDK (AliPlayerPartSDK_iOS) dan short video SDK, upgrade ApsaraVideo Player SDK ke versi di atas 5.4.9.2, alivcffmpeg (QuCore-ThirdParty) ke versi 4.3.6, dan short video SDK ke versi di atas 3.26.

Gejala: Saat memaketkan aplikasi dengan Xcode 14 dan mengirimkannya ke App Store untuk ditinjau, terjadi error terkait API non-publik. Gambar berikut menunjukkan contoh pesan error:

Gejala: Saat memaketkan aplikasi dengan Xcode 14 dan mengirimkannya ke App Store untuk ditinjau, terjadi error terkait plugin post-processing seperti mpf_filter.framework dan vfi_filter.framework untuk interpolasi frame dan sharpening. Gambar berikut menunjukkan contoh pesan error:

Solusi:

• Jika proyek Anda tidak menggunakan plugin yang disebutkan dalam pesan error, Anda dapat menghapus plugin tersebut. Hal ini tidak memengaruhi fitur pemutar dan dapat mengurangi ukuran paket.

• Jika proyek Anda harus menggunakan plugin yang disebutkan dalam error, Anda dapat sementara menghapus "_" dari string nilai pada pasangan kunci-nilai "Bundle identifier" di file Info.plist di bawah path framework, lalu kompilasi dan bangun proyek.

• Anda dapat melakukan upgrade ke versi 5.5.2.0 atau lebih baru, di mana penamaan telah diperbaiki.

Secara default, ApsaraVideo Player SDK memanggil balik progres pemutaran setiap 500 ms. Anda dapat mengubah interval callback tersebut. Perpendek intervalnya untuk mendapatkan progres pemutaran saat ini lebih sering. Kode berikut memberikan contohnya:

AVPConfig *config = [self.player getConfig];
config.positionTimerIntervalMs = 100; // Ubah interval callback. Satuan: ms.
[self.player setConfig:config];

/**
 @brief: Callback untuk posisi pemutaran saat ini.
 @param player: Pointer pemutar.
 @param position: Posisi pemutaran saat ini.
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // Progres pemutaran saat ini.
    long currentPosition = position;
}

Anda dapat menggunakan salah satu dari tiga metode berikut:

• Metode 1: Setelah metode prepare dipanggil untuk instans AliPlayer untuk iOS dan pemutar siap (AVPEventPrepareDone), Anda dapat langsung mendapatkan lebar dan tinggi instans AliPlayer.

  -(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
      if (eventType == AVPEventPrepareDone) {
        NSLog(@"Lebar video: %d, tinggi: %d", player.width, player.height);
      }
  }

• Metode 2: Dengarkan callback yang dikembalikan saat ukuran video berubah. Callback ini langsung mengembalikan lebar dan tinggi video.

  - (void)onVideoSizeChanged:(AliPlayer*)player width:(int)width height:(int)height rotation:(int)rotation {
      NSLog(@"Lebar video: %d, tinggi: %d", width, height);
  }

• Metode 3: Dengarkan callback yang dikembalikan saat informasi track diperoleh. Dapatkan videoWidth dan videoHeight dari AVPTrackInfo yang dikembalikan dalam array info.

  Catatan

  Mendengarkan callback informasi track melibatkan permintaan jaringan. Keberhasilan mendapatkan lebar dan tinggi video bergantung pada kualitas jaringan. Gunakan Metode 1 atau Metode 2 untuk mendapatkan lebar dan tinggi video agar lebih andal.

  - (void)onTrackReady:(AliPlayer*)player info:(NSArray<AVPTrackInfo*>*)info {
      for (int i=0; i<info.count; i++) {
        AVPTrackInfo *trackInfo = info[i];
        NSLog(@"Lebar video: %d, tinggi: %d", trackInfo.videoWidth, trackInfo.videoHeight);
    }
  }

Kode berikut memberikan contoh cara mengganti mode seek:

// Beralih ke seek tidak akurat.
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_INACCURATE];
// Beralih ke seek akurat.
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_ACCURATE];

Solusi: Anda dapat memanggil API untuk mengatur interval maksimum yang lebih besar untuk seek akurat. Hal ini mengurangi frekuensi pemutar beralih dari seek akurat ke seek tidak akurat dan meningkatkan akurasi seek. Namun, jika jarak dari titik seek ke keyframe terdekat terlalu besar, operasi seek membutuhkan waktu lebih lama. Atur interval maksimum untuk seek akurat sesuai kebutuhan. Kode berikut memberikan contohnya:

// Satuan: ms.
[self.player setMaxAccurateSeekDelta:10000];

Kode berikut memberikan contoh cara mendapatkan data sumber audio dan video:

// Atur callback rendering.
self.player.renderingDelegate = self;

// Dengarkan callback rendering.
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo {
    if (frameInfo.frameType == Cicada_FrameType_Video) { // Data video dasar.

    } else if (frameInfo.frameType == Cicada_FrameType_Audio) { // Data audio dasar.

    }
    return NO;
}

Setelah Anda mengaktifkan switching bitrate adaptif dengan memanggil API [self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];, ApsaraVideo Player SDK mengumpulkan statistik kecepatan jaringan saat ini. Jika kecepatan jaringan mencapai level bitrate berikutnya dalam 10 detik, pemutar beralih ke bitrate tersebut. Jika kecepatan jaringan tidak mencapai level bitrate berikutnya dalam 10 detik, pemutar tidak beralih.

• Saat beralih dari bitrate tinggi ke bitrate rendah, jika kecepatan jaringan mencapai level bitrate berikutnya dalam 10 detik, pemutar beralih setelah konten yang dicache pada bitrate tinggi selesai diputar.

• Saat beralih dari bitrate rendah ke bitrate tinggi, jika kecepatan jaringan mencapai level bitrate berikutnya dalam 10 detik, pemutar beralih segera.

Anda dapat menyesuaikan logika retry. Saat retry dipicu, event retry dikirim ke modul eksternal, yang menentukan logika retry spesifik. Kode berikut memberikan contohnya:

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // Atur jumlah retry. Pada contoh ini, nilainya diatur ke 0.
[self.player setConfig:config];

/**
 @brief: Callback untuk event pemutar.
 @param player: Pointer pemutar.
 @param eventWithString: Jenis event pemutar.
 @param description: Deskripsi event pemutar.
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_NETWORK_RETRY) { // Error jaringan. Diperlukan retry.
        // TODO: Tambahkan logika pemrosesan.
    }
}

Solusi: Anda dapat mengonfigurasi AVAudioSession secara terpadu di lokasi yang tepat dalam proyek Anda. Misalnya, Anda dapat mengonfigurasi sesi audio aplikasi sebagai kategori playback dan mengizinkan pencampuran dengan aplikasi lain. Anda juga dapat mengonfigurasi sesi audio aplikasi sebagai kategori PlayAndRecord untuk skenario perekaman dan pemutaran. Jika terjadi error selama operasi, pesan error disimpan dalam variabel err.

[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback withOptions:AVAudioSessionCategoryOptionMixWithOthers error:&err];

Pada saat yang sama, di sisi ApsaraVideo Player SDK untuk iOS, Anda dapat menyesuaikan proxy untuk AVAudioSession dan tidak menggunakan logika AVAudioSession yang didefinisikan di dalam SDK. Hal ini membantu menghindari risiko preempt audio yang mungkin disebabkan oleh ApsaraVideo Player SDK untuk iOS. Kode berikut menunjukkan contoh konfigurasi di sisi ApsaraVideo Player SDK untuk iOS:

1. Atur proxy.

   [AliPlayer setAudioSessionDelegate:self];

2. Atur listener untuk proxy.

   return TRUE menunjukkan bahwa SDK tidak lagi mengonfigurasi AVAudioSession secara internal.

   #pragma mark CicadaAudioSessionDelegate
   - (BOOL)setActive:(BOOL)active error:(NSError **)outError
   {
       return YES;
   }
   
   - (BOOL)setCategory:(NSString *)category withOptions:(AVAudioSessionCategoryOptions)options error:(NSError **)outError
   {
         return YES;
   }
   
   - (BOOL)setCategory:(AVAudioSessionCategory)category mode:(AVAudioSessionMode)mode routeSharingPolicy:(AVAudioSessionRouteSharingPolicy)policy options:(AVAudioSessionCategoryOptions)options error:(NSError **)outError
   {
       return YES;
   }

Jika terjadi crash stack yang mengarah ke SDK saat Anda menggunakan ApsaraVideo Player SDK untuk iOS, Anda dapat menggunakan metode berikut untuk menyelesaikan masalah tersebut:

1. Jika Anda tidak menggunakan versi terbaru ApsaraVideo Player SDK untuk iOS, upgrade ke versi terbaru. ApsaraVideo Player SDK untuk iOS terus diperbarui untuk meningkatkan stabilitas. Untuk informasi lebih lanjut tentang cara mendapatkan SDK terbaru, lihat Pengenalan SDK.

2. Jika crash tetap terjadi setelah Anda melakukan upgrade ke versi terbaru, berikan informasi crash lengkap kepada dukungan teknis Alibaba Cloud. Untuk informasi lebih lanjut tentang cara mendapatkan dukungan teknis, lihat Dapatkan dukungan teknis.

Anda dapat mengikuti langkah-langkah berikut untuk mengidentifikasi penyebab masalah:

1. Periksa apakah crash terjadi di ApsaraVideo Player SDK.

   Periksa apakah stack crash berisi awalan AliyunPlayer. Jika ya, masalah terjadi di ApsaraVideo Player SDK.

2. Upgrade ke versi terbaru ApsaraVideo Player SDK dan verifikasi apakah masalah telah terselesaikan.

3. Jika masalah tetap ada, siapkan file crash terkait (termasuk semua thread), log crash, dan skenario crash. Untuk informasi lebih lanjut, lihat Cara mendapatkan log.

Kode berikut memberikan contoh cara mengimplementasikan fitur ini:

UIInterfaceOrientation orientation = UIInterfaceOrientationLandscapeLeft; // Putar ke layar penuh
......

// Untuk iOS 16.0 dan lebih baru
if (@available(iOS 16.0, *)) {
    @try {
            NSArray *array = [[[UIApplication sharedApplication] connectedScenes] allObjects];
      UIWindowScene *ws = (UIWindowScene *)array[0];
        Class GeometryPreferences = NSClassFromString(@"UIWindowSceneGeometryPreferencesIOS");
      id geometryPreferences = [[GeometryPreferences alloc]init];
      UIInterfaceOrientationMask orientationMask = UIInterfaceOrientationMaskLandscapeRight;
      if (orientation == UIInterfaceOrientationPortrait) {
          orientationMask = UIInterfaceOrientationMaskPortrait;
      }
      [geometryPreferences setValue:@(orientationMask) forKey:@"interfaceOrientations"];
      SEL sel_method = NSSelectorFromString(@"requestGeometryUpdateWithPreferences:errorHandler:");
      void (^ErrorBlock)(NSError *err) = ^(NSError *err){
            NSLog(@"Error rotasi layar:%@", [err debugDescription]);
      };
      if ([ws respondsToSelector:sel_method]) {
          (((void (*)(id, SEL,id,id))[ws methodForSelector:sel_method])(ws, sel_method,geometryPreferences,ErrorBlock));
      }
  } @catch (NSException *exception) {
      NSLog(@"Error rotasi layar:%@", exception.reason);
  } @finally {
  }
} else { // Untuk sistem sebelum iOS 16.0
  if ([[UIDevice currentDevice] respondsToSelector:@selector(setOrientation:)]) {
      SEL selector = NSSelectorFromString(@"setOrientation:");
      NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:[UIDevice instanceMethodSignatureForSelector:selector]];
      [invocation setSelector:selector];
      [invocation setTarget:[UIDevice currentDevice]];
      [invocation setArgument:&Orientation atIndex:2];
      [invocation invoke];
  }
  [[UIApplication sharedApplication]setStatusBarOrientation:orientation animated:YES];
}

Anda dapat mengikuti langkah-langkah berikut untuk mengidentifikasi penyebab masalah:

1. Periksa apakah sumber video itu sendiri memiliki bilah hitam.

2. Anda dapat memanggil API berikut untuk menyesuaikan mode penskalaan pemutar.

   /*
   AVP_SCALINGMODE_SCALEASPECTFILL: Video diskalakan agar mengisi layar. Video mungkin terpotong.
   AVP_SCALINGMODE_SCALEASPECTFIT: Video diskalakan agar sesuai dengan layar. Bilah hitam mungkin muncul.
   AVP_SCALINGMODE_SCALETOFILL: Video diskalakan agar mengisi layar tanpa mempertahankan rasio aspek. Video mungkin terdistorsi.
   */
   self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

3. Jika mode penskalaan tidak sesuai kebutuhan Anda, Anda dapat menyesuaikan lebar dan tinggi tampilan kustom untuk self.player.playerView dengan memodifikasi frame dari self.player.playerView.

Anda dapat mengikuti langkah-langkah berikut untuk mengidentifikasi penyebab masalah:

1. Gunakan pemutar lain untuk memutar video dan periksa apakah file tersebut hanya berisi audio.

2. Jika video diputar normal di pemutar lain dan dimensi video berubah, Anda dapat beralih ke decoding software. Kode berikut menunjukkan cara beralih ke decoding software:

   player.enableHardwareDecoder = NO

Versi ApsaraVideo Player SDK sebelum V5.4.5.0 tidak mendukung penggunaan list player AliListPlayer untuk memutar video HLS (m3u8). Versi V5.4.5.0 dan lebih baru mendukung pemutaran video HLS (m3u8), tetapi Anda harus mengaktifkan caching lokal. Untuk informasi lebih lanjut tentang cara mengaktifkan caching lokal, lihat Caching lokal.

Kode berikut memberikan contohnya:

// Kode berikut memberikan contoh pemutaran menggunakan VidSts.
AVPVidStsSource *stsSource = [[AVPVidStsSource alloc] init];
stsSource.vid = @"<vid>";
stsSource.accessKeyId = @"<accessKeyId>";
stsSource.securityToken = @"<securityToken>";
stsSource.accessKeySecret = @"<accessKeySecret>";
stsSource.quality = @""; // Definisi yang diharapkan untuk pemutaran. Nilai yang valid: FD, LD, SD, HD, 2K, 4K, dan OD.
stsSource.forceQuality = NO; // Menentukan apakah video diputar secara paksa dalam definisi yang diharapkan. NO: Video tidak diputar secara paksa dalam definisi yang diharapkan. Pemutar mencari definisi dalam urutan default dan memutar video dalam definisi pertama yang ditemukan. YES: Video diputar secara paksa dalam definisi yang diharapkan. Jika definisi yang diharapkan tidak ditemukan, video tidak diputar.