ApsaraVideo VOD:FAQ Pemutar iOS

Gejala: Terjadi error terkait bitcode saat mengirimkan build Xcode 14 ke App Store:

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

Solusi: Jalankan perintah xcrun bitcode_strip untuk menghapus bitcode dari framework. ${framework_path} adalah path binary framework tersebut.

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

Gejala: Terjadi error terkait cURL saat mengirimkan build Xcode 14 ke App Store:

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 yang lebih baru dari 5.4.9.2.

• Jika proyek Anda mengintegrasikan ApsaraVideo Player SDK (AliPlayerPartSDK_iOS) dan SDK video pendek, upgrade ApsaraVideo Player SDK ke versi yang lebih baru dari 5.4.9.2, alivcffmpeg (QuCore-ThirdParty) ke versi 4.3.6, dan SDK video pendek ke versi yang lebih baru dari 3.26.

Gejala: Terjadi error terkait API non-publik saat mengirimkan build Xcode 14 ke App Store: Saat mendistribusikan aplikasi dengan Xcode, muncul kotak dialog Distribution completed with warnings, yang menunjukkan App Store Connect Operation Error. Error tersebut menyatakan bahwa aplikasi mereferensikan selector non-publik onCompletion: di AliyunMediaDownloader.framework/AliyunMediaDownloader.

Gejala: Terjadi error terkait plugin post-processing (mpf_filter.framework, vfi_filter.framework) untuk interpolasi frame dan penajaman saat mengirimkan build Xcode 14 ke App Store: Saat mendistribusikan aplikasi dengan Xcode, muncul error Distribution failed with errors, yang menunjukkan dua error Asset validation failed: CFBundleIdentifier com.alibaba.AliyunPlayer.mpf_filter dari Payload/xxx.app/Frameworks/mpf_filter.framework dan CFBundleIdentifier com.alibaba.AliyunPlayer.vfi_filter dari vfi_filter.framework mengandung karakter yang tidak valid (garis bawah). CFBundleIdentifiers hanya boleh berisi karakter alfanumerik, titik (.), dan tanda hubung (-).

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 build proyek.

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

ApsaraVideo Player SDK melaporkan progres pemutaran setiap 500 ms secara default. Perpendek interval untuk pembaruan yang lebih sering:

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;
}

Tersedia tiga metode:

• Metode 1: Setelah pemutar dipersiapkan (AVPEventPrepareDone), baca lebar dan tinggi dari 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 perubahan ukuran video, yang langsung mengembalikan lebar dan tinggi.

  - (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 informasi track dan baca videoWidth dan videoHeight dari AVPTrackInfo di array info.

  Catatan

  Metode ini bergantung pada permintaan jaringan. Gunakan Metode 1 atau Metode 2 untuk keandalan yang lebih baik.

  - (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);
    }
  }

Contoh:

// 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: Tingkatkan interval maksimum untuk seek akurat guna mengurangi fallback ke seek tidak akurat. Interval yang lebih besar meningkatkan akurasi tetapi dapat memperpanjang waktu seek ketika keyframe berjauhan:

// 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 mengaktifkan switching bitrate adaptif dengan API [self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];, SDK memantau kecepatan jaringan. Jika kecepatan mencapai level bitrate berikutnya dalam 10 detik, pemutar beralih; jika tidak, pemutar tetap pada bitrate saat ini.

• Dari tinggi ke rendah: pemutar beralih setelah konten bitrate tinggi yang di-cache selesai diputar.

• Dari rendah ke tinggi: pemutar beralih segera.

Untuk menyesuaikan logika retry, atur jumlah percobaan ulang menjadi 0 dan tangani event retry secara eksternal:

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // Atur jumlah percobaan ulang. Dalam contoh ini, nilainya diatur menjadi 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 percobaan ulang.
        // 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 mixing 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];

Anda juga dapat mengatur proxy kustom AVAudioSession di sisi SDK untuk melewati logika internal AVAudioSession dan mencegah preempt:

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, ikuti langkah-langkah berikut:

1. Upgrade ke ApsaraVideo Player SDK untuk iOS versi terbaru, yang mencakup peningkatan stabilitas berkelanjutan. Unduh SDK terbaru dari Pengenalan SDK.

2. Jika crash terus terjadi setelah peningkatan, berikan informasi crash yang lengkap kepada dukungan teknis Alibaba Cloud. Dapatkan dukungan teknis.

Untuk mengidentifikasi penyebabnya:

1. Periksa apakah crash terjadi di ApsaraVideo Player SDK.

   Periksa apakah stack crash mengandung 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 (semua thread), log crash, dan skenario crash seperti yang dijelaskan di Cara mendapatkan log.

Kode berikut memberikan contoh cara mengimplementasikan fitur ini:

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

// Untuk iOS 16.0 dan yang 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];
}

Untuk mengidentifikasi penyebabnya:

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 memenuhi kebutuhan Anda, Anda dapat menyesuaikan lebar dan tinggi tampilan kustom untuk self.player.playerView dengan memodifikasi frame dari self.player.playerView.

Untuk mengidentifikasi penyebabnya:

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 SDK Pemutar Video Apsara sebelum V5.4.5.0 tidak mendukung pemutaran video HLS (m3u8) menggunakan pemutar list AliListPlayer. Versi V5.4.5.0 dan yang lebih baru mendukung pemutaran video HLS (m3u8), tetapi Anda harus mengaktifkan caching lokal. Caching lokal.

Contoh:

// 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 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.