ApsaraVideo VOD:FAQ Pemutar iOS

Masalah terkait lisensi

Atasi masalah lisensi tidak valid atau kedaluwarsa di FAQ Lisensi.

Masalah umum lintas platform

• Untuk masalah yang berlaku lintas platform, periksa FAQ pemutar lintas platform.

• Developer berpengalaman juga dapat memecahkan masalah error pemutaran secara mandiri.

Terjadi error saat Anda memaketkan aplikasi dengan Xcode 14 dan mengirimkannya ke App Store untuk ditinjau

Error terkait Bitcode

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

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

Error terkait cURL

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/

Error tentang API non-publik

Solusi: Ini adalah peringatan dari build Xcode 14 dan biasanya tidak memengaruhi rilis jika proyek berhasil dibangun. Jika aplikasi tidak dapat dirilis, gunakan Xcode 13.

Error terkait plugin post-processing seperti mpf_filter.framework dan vfi_filter.framework untuk interpolasi frame dan penajaman

Setelah saya mengintegrasikan ApsaraVideo Player SDK untuk iOS, apakah saya bisa melakukan debug dan menjalankan aplikasi saya di emulator Xcode?

ApsaraVideo Player SDK untuk iOS tidak mendukung emulator. Gunakan iPhone fisik untuk melakukan debug dan menjalankan aplikasi Anda.

Cara mendapatkan progres pemutaran saat ini

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

Cara mendapatkan lebar dan tinggi video

Progress bar melompat mundur setelah operasi seek

Penyebab: Pemutar menggunakan seek tidak akurat secara default. Setelah operasi seek, pemutar memulai pemutaran dari keyframe terdekat dengan titik seek.

Solusi: Beralih ke mode seek akurat.

Cara beralih antara mode seek akurat dan tidak akurat

// 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];

Progress bar tetap melompat mundur setelah saya beralih ke mode seek akurat

Penyebab: Seek akurat membutuhkan waktu lebih lama daripada seek tidak akurat. Jika jarak dari titik seek ke keyframe terdekat terlalu besar dan melebihi interval maksimum untuk seek akurat, ApsaraVideo Player SDK secara otomatis beralih ke seek tidak akurat. Hal ini menyebabkan progress bar melompat mundur.

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

Error selama caching video: encrypt check fail

Caching bekerja sama seperti pengunduhan. Dengan secure download diaktifkan, file verifikasi enkripsi harus sesuai dengan informasi aplikasi. Unduh file tersebut dari Unduhan offline dan tambahkan ke SDK. Ikuti langkah-langkah di Unduhan video, jika tidak, caching atau pengunduhan akan gagal.

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

Bagaimana cara mendapatkan piksel setiap frame video di pemutar?

ApsaraVideo Player SDK untuk iOS: Anda dapat memperoleh piksel dengan mendengarkan callback onRenderingFrame.

player.renderingDelegate = self;


#pragma mark CicadaRenderingDelegate
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo{
    if(frameInfo.frameType==Cicada_FrameType_Video){
        // Video
        NSLog(@"Menerima frame HW:%p pts:%ld format %d", frameInfo.video_pixelBuffer, frameInfo.pts, CVPixelBufferGetPixelFormatType(frameInfo.video_pixelBuffer));

    } else if (frameInfo.frameType==Cicada_FrameType_Audio){
        // Audio
    }
    return NO;
}

Logika switching bitrate adaptif

Logika retry kustom

SDK secara default mencoba ulang operasi jaringan yang gagal dua kali dengan timeout 15 detik. Jika semua percobaan ulang gagal, callback Error dipicu.

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // Atur jumlah percobaan ulang. 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 percobaan ulang.
        // TODO: Tambahkan logika pemrosesan.
    }
}

Terjadi error 403 dan pemutaran aliran HLS gagal setelah caching lokal dikonfigurasi

Gejala: Memutar aliran HLS (M3U8) dengan VidAuth dan caching lokal diaktifkan gagal dengan error 403.

Penyebab: Jika Anda keluar sebelum video sepenuhnya dicache, pemutar menggunakan kredensial VidAuth yang kedaluwarsa pada upaya pemutaran berikutnya, menyebabkan error 403.

Solusi: Di SDK V5.5.4.0 dan yang lebih baru, atur field AVPConfig.enableStrictAuthMode untuk mengontrol mode autentikasi untuk aliran HLS dengan parameter autentikasi. Nilai default adalah false.

• Autentikasi non-ketat (false): Informasi autentikasi dicache bersama konten media. Jika hanya sebagian media yang dicache sebelumnya, pemutar menggunakan informasi autentikasi yang dicache untuk meminta bagian yang belum dicache. Jika autentikasi URL memiliki periode validitas singkat atau jika pemutaran dilanjutkan setelah jeda panjang, autentikasi mungkin kedaluwarsa. Untuk menangani hal ini, Anda perlu mengimplementasikan fitur refresh sumber otomatis.

• Autentikasi ketat (true): Informasi autentikasi tidak dicache. Autentikasi terjadi di awal setiap sesi pemutaran. Hal ini dapat menyebabkan pemutaran gagal jika tidak ada koneksi jaringan.

Preempt audio mencegah ApsaraVideo Player SDK untuk iOS memutar video

Gejala: Saat proyek Anda menggunakan ApsaraVideo Player SDK dan kontrol audio lainnya, muncul masalah pemutaran seperti tidak ada suara atau video tersendat.

Penyebab: AVAudioSession di iOS adalah singleton. Tanpa konfigurasi terpadu di berbagai kontrol audio, preempt audio dapat mencegah pemutaran video.

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

Terjadi crash stack yang mengarah ke SDK saat ApsaraVideo Player SDK untuk iOS berjalan

Apakah ApsaraVideo Player SDK untuk iOS mendukung pengunduhan saat memutar?

Tidak. SDK mendukung caching lokal, yang mengunduh video selama pemutaran untuk digunakan offline nanti. Namun, SDK tidak mendukung pemutaran file cache yang disimpan di direktori file terpisah.

Apakah ApsaraVideo Player SDK untuk iOS mendukung mendapatkan progres buffering video?

Ya. ApsaraVideo Player SDK untuk iOS mendukung memperoleh kecepatan buffering, laju frame rendering real-time, bitrate audio dan video, serta bitrate unduhan jaringan. Dapatkan informasi pemutaran.

Terjadi crash saat pemutar berjalan

Terjadi crash terkait inisialisasi program atau preload saat ApsaraVideo Player SDK V5.4.6.0 berjalan

Upgrade ApsaraVideo Player SDK ke versi di atas V5.4.7.1. Untuk mempertahankan stabilitas V5.4.6.0, Anda juga dapat menggunakan versi hotfix pod 5.4.6.0-25587639.

Cara mengaktifkan pemutaran layar penuh

ApsaraVideo Player SDK untuk iOS tidak menyediakan API untuk pemutaran layar penuh. Anda perlu mengimplementasikan fitur ini berdasarkan sistem. Demo ApsaraVideo Player SDK untuk iOS untuk versi 5.5.0.0 dan yang lebih baru telah diadaptasi ke metode layar penuh iOS 16.0 dan yang lebih baru.

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 di bawah 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];
}

Muncul bilah hitam selama pemutaran video

Audio diputar tetapi tidak ada video yang ditampilkan, dan log melaporkan "log[AFVTBDecoder] :IOS8VT: throw frame"

Tersendat dan desinkronisasi audio-video terjadi selama penarikan aliran RTS pada klien iOS

Solusi: Integrasikan komponen ultra-low latency terbaru dari pemutar. Implementasikan penarikan aliran RTS pada klien iOS.

Saat aplikasi iOS berada di latar belakang atau belum dimulai, audio diputar tetapi tidak ada video yang ditampilkan jika pengguna membuka aplikasi melalui notifikasi.

- (AliPlayer *)aliPlayer{
    if (!_aliPlayer && UIApplicationStateActive == [[UIApplication sharedApplication] applicationState]) {
        _aliPlayer = [[AliPlayer alloc] init];
        _aliPlayer.scalingMode =  AVP_SCALINGMODE_SCALEASPECTFIT;
        _aliPlayer.rate = 1;
        _aliPlayer.delegate = self;
        _aliPlayer.playerView = self.playerView;
    }
    return _aliPlayer;
}

Saat memutar aliran langsung, log melaporkan error standar: "-5, IO error (Input/Output (I/O))"

Saat Anda memutar aliran langsung, gunakan nilai default untuk pengaturan cache dan kontrol latensi (startBufferDuration, highBufferDuration, dan maxBufferDuration di AVPConfig). Jangan menyesuaikan pengaturan ini secara manual. Verifikasi konfigurasi Anda terhadap Konfigurasi cache dan kontrol latensi.

Setelah saya menjeda pemutaran, berpindah ke halaman lain, lalu kembali untuk melanjutkan pemutaran, muncul error terkait audio di log: "Deactivating an audio session that has running I/O." atau "All I/O should be stopped or paused prior to deactivating the audio session."

Gejala: Di halaman pemutaran video, Anda menjeda pemutaran dan berpindah ke halaman lain yang memiliki audio. Saat kembali, Anda tidak dapat melanjutkan pemutaran, dan muncul error terkait audio seperti "Deactivating an audio session that has running I/O." atau "All I/O should be stopped or paused prior to deactivating the audio session." di log.

Solusi: Periksa konflik dalam pengaturan audio (properti AudioSession). Misalnya, saat Anda keluar dari halaman lain yang memiliki audio, sumber daya audio mungkin tidak dilepas tepat waktu (perekaman atau pemutaran audio terkait tidak dihentikan segera).

Terjadi error saat AliListPlayer digunakan untuk memutar video HLS (m3u8)

Terjadi error unsupported protocol saat Anda memutar aliran ARTC

Penyebab 1: Lapisan bridge antara pemutar dan komponen RTS (AlivcArtc) serta komponen RTS (RtsSDK) belum diintegrasikan, meskipun ApsaraVideo Player SDK telah diintegrasikan.

Solusi: Untuk informasi cara mengintegrasikan komponen, lihat Implementasikan penarikan aliran RTS pada klien iOS.

Penyebab 2: Versi lapisan bridge antara pemutar dan komponen RTS (AlivcArtc) tidak konsisten dengan versi pemutar.

Solusi: Lapisan bridge (AlivcArtc) dan pemutar harus memiliki nomor versi yang sama. Implementasikan penarikan aliran RTS pada klien iOS.

Jika video ditranskode ke beberapa definisi, definisi mana yang diputar oleh ApsaraVideo Player SDK secara default?

SDK memutar definisi pertama yang tersedia dalam urutan berikut: FD, LD, SD, HD, 2K, 4K, OD. Definisi.

Cara menentukan definisi default untuk pemutaran video

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

Jika suatu definisi memiliki beberapa aliran, aliran mana yang diputar oleh ApsaraVideo Player SDK?

Jika suatu definisi memiliki beberapa aliran, ApsaraVideo Player SDK memutar aliran terbaru.

Bagaimana cara mengonfigurasi video agar diputar tanpa watermark tetapi diunduh dengan watermark?

Transkode video ke beberapa definisi. Putar definisi tanpa watermark dan unduh definisi dengan watermark.

Mode landscape tidak berlaku

ApsaraVideo Player SDK untuk iOS tidak menyediakan metode untuk mengimplementasikan mode landscape. Anda perlu mengimplementasikan fitur ini berdasarkan API sistem iOS. Saat mengimplementasikan mode landscape, pastikan untuk mengatur dengan benar frame dari aliplayer.playerView.

Cara memperoleh log

Kirimkan log saat meminta dukungan teknis Alibaba Cloud untuk mempercepat penyelesaian masalah.

1. Peroleh log.

   Atur tingkat log ke LOG_LEVEL_TRACE sebelum memperoleh log. Peroleh log SDK.

2. Berikan log yang dihasilkan kepada dukungan teknis Alibaba Cloud.

   Dapatkan dukungan teknis.

Setelah cache lokal diaktifkan, video multi-bitrate (HLS) melewatkan cache.

Fenomena masalah: Cache lokal telah diaktifkan dan dipreloaded sesuai dokumen, tetapi progres saat mencari kembali melewatkan cache selama pemutaran, atau pemutaran tidak dapat dilanjutkan setelah jaringan terputus, atau pemeriksaan file cache mengembalikan bahwa file tersebut tidak ada, atau direktori cache kosong setelah preload dimatikan.

Penyebab masalah: Dalam skenario multi-bitrate (HLS), jika aliran tertentu tidak dipilih secara eksplisit selama pemutaran, pemutar beroperasi dalam mode ABR (adaptive bit rate), dan data dalam mode ABR tidak disimpan ke disk, sehingga tidak ada cache lokal yang dihasilkan. Hanya setelah selectTrack dipanggil secara eksplisit untuk memilih aliran kode tertentu, data yang dipilih akan dicache ke lokal. Jika selectTrack tidak dipanggil (atau diberikan SELECT_AVPTRACK_TYPE_VIDEO_AUTO), pemrosesan dilakukan sesuai ABR.

Solusi: Pastikan preload dan pemutaran menggunakan definisi yang sama dan alamat pemutaran yang sama, serta pilih aliran kode secara eksplisit selama pemutaran.

1. Pada tahap preload, cache lokal diaktifkan untuk memulai preload pada aliran kode definisi tertentu.

2. Pada fase pemutaran, panggil selectTrack setelah onPlayerEvent menerima event persiapan selesai (AVPEventPrepareDone), dan pilih definisi yang sama dengan preload; setUrlSource(AVPUrlSource) menggunakan alamat pemutaran yang sama dengan preload, lalu prepare dan start.

3. Jika bitrate awal tidak konsisten dengan bitrate default, buffering akan dipicu. Disarankan untuk mengatur bitrate awal guna mengurangi gangguan saat switching.

Memutar file HLS (m3u8) yang diunduh secara lokal menghasilkan error “No such file or directory.”

Fenomena masalah: Setelah HLS diunduh offline, memutar alamat lokal melaporkan No such file or directory (file tidak ditemukan). Masalah ini mungkin tidak selalu terjadi dan lebih mudah direproduksi dalam skenario seperti switching cepat multi-halaman (sliding cepat).

Penyebab masalah: Unduhan offline HLS biasanya hanya mengunduh slice ts dan m3u8 salah satu definisi (misalnya 540p) untuk menghemat ruang, tetapi master m3u8 yang disimpan secara lokal masih menyimpan catatan semua definisi (misalnya 1080p/720p/540p/360p) apa adanya. Selama pemutaran, jika definisi yang diunduh tidak ditentukan sebelum prepare, pemutar akan mencoba meminta bagian definisi lain yang tidak ada secara lokal sesuai logika default/adaptif, sehingga melaporkan bahwa file tidak ditemukan. Penyebab umum adalah kelalaian memanggil dengan kejelasan yang ditentukan, atau waktu pemanggilan lebih lambat dari prepare.

Solusi:

1. setDefaultResolution dipanggil sebelum prepare, menentukan definisi yang sama dengan unduhan offline.

2. Pastikan semua portal pemutaran diatur dengan definisi default, termasuk sliding cepat, multiplexing multi-instans, switching preload, dan cabang lainnya untuk menghindari melewatkan 1 jalur.

3. getCurrentTrack dapat digunakan untuk memverifikasi apakah definisi awal aktual adalah definisi yang diunduh.

Terjadi ketidaksesuaian audio dan video setelah pergantian video, atau video yang sama diputar berulang kali dan melewatkan cache.

Fenomena masalah: Setelah cache lokal diaktifkan, saat mengganti video (seperti mengganti episode), terjadi ketidaksesuaian suara dan gambar (layar menampilkan video baru tetapi suara masih dari video sebelumnya), atau video yang sama diputar berulang kali tanpa mengenai cache; Setelah cache dihapus, kembali normal.

Penyebab masalah: Setelah cache lokal diaktifkan, pemutar menggunakan Hash yang dikembalikan oleh callback setCacheUrlHashCallback sebagai pengenal cache unik untuk setiap alamat pemutaran (iOS mengimplementasikan callback ini melalui pointer fungsi C). Jika callback tidak memastikan bahwa "alamat pemutaran yang sama selalu mengembalikan hash yang sama, konten berbeda mengembalikan hash berbeda", hal ini akan menyebabkan ketidakcocokan kunci cache: konten berbeda mengenai cache yang sama (ditampilkan sebagai ketidaksesuaian audio dan gambar), atau alamat yang sama setiap kali menghasilkan hash berbeda dan tidak dapat mengenai cache.

Solusi:

1. Callback harus secara stabil mengembalikan hash yang sama untuk alamat pemutaran yang sama, dan media berbeda harus mengembalikan hash berbeda.

2. Misalnya, untuk menghapus parameter autentikasi guna meningkatkan tingkat hit, hanya hitung hash setelah parameter autentikasi dihapus untuk alamat pemutaran (m3u8/mp4); keyURL m3u8 terenkripsi tidak perlu diautentikasi, jika tidak kunci video berbeda akan mengenai cache yang sama dan menyebabkan kegagalan pemutaran—dapat ditangani secara berbeda berdasarkan nama domain dalam callback.

3. Jika file yang sama memiliki alamat HTTP dan HTTPS, protokol dapat diseragamkan atau hash dapat dihitung setelah header protokol dihapus.

Untuk detailnya, lihat Fitur lanjutan.

Autentikasi gagal saat memutar video terenkripsi privat Alibaba Cloud

Fenomena masalah: Saat memutar video yang dienkripsi oleh Alibaba Cloud (enkripsi privat), autentikasi gagal atau tidak dapat diputar.

Penyebab masalah: Enkripsi video Alibaba Cloud (enkripsi privat) didekripsi melalui interaksi antara pemutar dan server, dan pemutaran harus dimulai melalui pemutaran vid. Jika Anda menggunakan AVPUrlSource on-demand untuk langsung mentransfer alamat pemutaran (enkripsi privat umum), autentikasi dan dekripsi tidak dapat diselesaikan, sehingga gagal.

Solusi:

1. Video terenkripsi privat diputar di iOS sesuai permintaan melalui AVPVidAuthSource (VidAuth) atau AVPVidStsSource (VidSts). Jika aliran keluaran mencakup campuran aliran terenkripsi privat dan non-privat, Anda dapat mengatur tipe enkripsi ke AliyunVoDEncryption untuk memfilter aliran terenkripsi privat.

2. Catatan: Hanya "enkripsi privat berlisensi" yang mendukung pemutaran on-demand AVPUrlSource (MP4 harus ditambahkan etavirp_nuyila=1 di akhir URL, HLS dapat langsung menggunakan URL asli di versi yang didukung), enkripsi privat biasa tidak berlaku.

Untuk detailnya, lihat Putar video terenkripsi.