Topik ini menjelaskan cara menggunakan fitur advanced dari ApsaraVideo Player SDK untuk iOS. Untuk panduan lengkap mengenai semua fitur, lihat Referensi API.
Untuk mencoba demo, unduh demonya dan ikuti instruksi di Jalankan demo untuk mengompilasi dan menjalankannya.
Verifikasi fitur advanced
Beberapa fitur pemutar memerlukan lisensi Edisi Profesional. Untuk informasi selengkapnya, lihat Fitur. Untuk mendapatkan lisensi, lihat Mendapatkan lisensi.
Atur listener saat startup aplikasi atau sebelum melakukan panggilan API pemutar apa pun:
void premiumVeryfyCallback(AVPPremiumBizType biztype, bool isValid, NSString* errorMsg) {
NSLog(@"onPremiumLicenseVerifyCallback: %d, isValid: %d, errorMsg: %@", biztype, isValid, errorMsg);
}
[AliPrivateService setOnPremiumLicenseVerifyCallback:premiumVeryfyCallback];Di sini, AVPPremiumBizType adalah enumerasi fitur advanced. Saat Anda menggunakan fitur advanced, pemutar memverifikasi lisensi dan mengembalikan hasilnya melalui callback ini. Jika isValid bernilai false, errorMsg berisi alasan kegagalan tersebut.
Pemutaran
Pemutaran daftar
Player SDK untuk iOS menawarkan fitur pemutaran daftar yang komprehensif untuk skenario video pendek. Fitur ini menggunakan teknik seperti preloading untuk mengurangi Time-to-First-Frame (TTTF) secara signifikan.
Untuk pengalaman pemutaran daftar yang lebih baik, pertimbangkan untuk menggunakan solusi drama format pendek kami. Untuk detailnya, lihat Pengembangan Sisi Klien untuk Drama Format Pendek.
Memutar video dengan alpha channel
Ikhtisar
ApsaraVideo Player SDK mendukung rendering alpha channel untuk membuat efek dinamis, seperti hadiah animasi. Di ruang live streaming, Anda dapat memutar efek animasi ini di atas konten utama untuk meningkatkan pengalaman pengguna secara signifikan.
Batasan
Rendering alpha channel didukung dalam all-in-one SDK 6.8.0 atau yang lebih baru, atau ApsaraVideo Player SDK 6.9.0 atau yang lebih baru.
Manfaat
Menggunakan video MP4 dengan alpha channel untuk efek animasi menawarkan kualitas animasi yang lebih baik, ukuran file yang lebih kecil, kompatibilitas yang lebih tinggi, dan efisiensi pengembangan yang lebih besar.
Kualitas animasi lebih baik: Video MP4 mempertahankan detail dan warna animasi asli lebih akurat dibandingkan format lain, seperti APNG atau IXD.
Ukuran file lebih kecil: File MP4 dapat dikompresi lebih efektif daripada format lain seperti APNG atau IXD, yang meningkatkan kecepatan pemuatan dan mengurangi konsumsi network bandwidth.
Kompatibilitas lebih tinggi: Sebagai format video universal, MP4 didukung secara luas di sebagian besar perangkat dan browser.
Efisiensi pengembangan lebih tinggi: Implementasinya sederhana dan tidak mengharuskan developer membangun logika parsing atau rendering yang kompleks. Hal ini memungkinkan mereka fokus pada fitur lain.
Rendering Metal
Alibaba Cloud Player SDK untuk iOS mendukung rendering video menggunakan framework Metal.
Saat ini, rendering Metal hanya mendukung warna latar belakang, scaling mode, dan Gambar-dalam-Gambar (PiP).
Parameter
/**
@brief Menentukan jenis render video. Nilai yang valid: 0 (renderer default) dan 1 (renderer campuran). Default: 0.
*/
@property(nonatomic, assign) int videoRenderType;Contoh
AVPConfig *config = [self.player getConfig];
// Aktifkan rendering Metal.
config.videoRenderType = 1;
[self.player setConfig:config];
[self.player prepare];Subtitle eksternal
Untuk contoh kode terperinci, lihat modul ExternalSubtitle di API-Example. Proyek sampel Objective-C ini mendemonstrasikan cara mengintegrasikan fitur inti ApsaraVideo Player SDK untuk iOS.
ApsaraVideo Player SDK untuk iOS mendukung penambahan dan penggantian subtitle eksternal dalam format SRT, SSA, ASS, dan VTT.
Contoh berikut menunjukkan cara mengimplementasikan fitur ini.
Buat view untuk menampilkan subtitle.
Buat view berdasarkan format subtitle.
// Inisialisasi subTitleLabel kustom. UILabel *subTitleLabel = [[UILabel alloc] initWithFrame:frame]; // Tambahkan label subtitle ke superView kustom. [superView addSubview:subTitleLabel];Atur listener terkait subtitle.
// Dipanggil saat track subtitle eksternal ditambahkan. - (void)onSubtitleExtAdded:(AliPlayer*)player trackIndex:(int)trackIndex URL:(NSString *)URL {} // Callback untuk header subtitle. - (void)onSubtitleHeader:(AliPlayer *)player trackIndex:(int)trackIndex Header:(NSString *)header{} // Dipanggil saat subtitle ditampilkan. - (void)onSubtitleShow:(AliPlayer*)player trackIndex:(int)trackIndex subtitleID:(long)subtitleID subtitle:(NSString *)subtitle { subTitleLabel.text =subtitle; subTitleLabel.tag =subtitleID; } // Dipanggil saat subtitle disembunyikan. - (void)onSubtitleHide:(AliPlayer*)player trackIndex:(int)trackIndex subtitleID:(long)subtitleID{ [subTitleLabel removeFromSuperview]; }Tambahkan track subtitle.
[self.player addExtSubtitle:URL];Ganti track subtitle.
[self.player selectExtSubtitle:trackIndex enable:YES];
Subtitle eksternal (rendering kustom)
Menggunakan AliVttSubtitleView dan AliVttRenderImpl, fitur ini sepenuhnya mendukung subtitle eksternal WebVTT dan memungkinkan Anda menyesuaikan gaya seperti font, warna, dan ukuran.
Kasus penggunaan:
Anda ingin menyesuaikan gaya subtitle WebVTT, seperti font, warna, dan ukuran.
Integrasi Anda menggunakan Alibaba Cloud Player SDK v7.11.0 atau yang lebih baru dan AliVttSubtitleView.
Mendukung subtitle multibahasa (seperti Arab, Cina, Jepang, dan Korea) dan secara otomatis mencocokkan font yang sesuai.
Prasyarat:
Anda telah menambahkan file font (.ttf) yang diperlukan ke proyek Xcode Anda.
Anda telah mengonfigurasi listener subtitle untuk menerima konten WebVTT.
Font yang diperlukan dimuat dengan memanggil metode loadFontFromBundle.
Sesuaikan gaya subtitle
Buat kelas implementasi rendering kustom yang mewarisi AliVttRenderImpl.
// CustomFontVttRenderImpl.h @interface CustomFontVttRenderImpl : AliVttRenderImpl @end // CustomFontVttRenderImpl.m @implementation CustomFontVttRenderImpl // Opsional: Timpa logika pembuatan font. - (UIFont *)customizeFont:(UIFont *)originalFont contentAttribute:(VttContentAttribute *)contentAttribute contentText:(NSString *)text { // Contoh: Pilih font secara otomatis berdasarkan konten. if ([self containsArabicCharacters:text]) { return [UIFont fontWithName:@"NotoSansArabic-Regular" size:originalFont.pointSize]; } if ([self containsCJKCharacters:text]) { return [UIFont fontWithName:@"NotoSansCJKsc-Regular" size:originalFont.pointSize]; } return originalFont; } // Opsional: Paksa warna tertentu. - (void)applyColorStyle:(NSMutableDictionary *)attrs contentAttribute:(VttContentAttribute *)contentAttribute { // Paksa warna menjadi merah. attrs[NSForegroundColorAttributeName] = [UIColor redColor]; } // Opsional: Perbesar font. - (void)applyFontStyle:(NSMutableDictionary *)attrs contentAttribute:(VttContentAttribute *)contentAttribute context:(RenderContext *)context { CGFloat originalSize = contentAttribute.fontSizePx / context.contentsScale; CGFloat newSize = originalSize * 2.0; // Perbesar 2x. UIFont *font = [self generateFontWithName:contentAttribute.fontName fontSize:newSize isBold:contentAttribute.mBold isItalic:contentAttribute.mItalic]; attrs[NSFontAttributeName] = font; } // Helper: Deteksi karakter Arab. - (BOOL)containsArabicCharacters:(NSString *)text { for (NSUInteger i = 0; i < text.length; i++) { unichar c = [text characterAtIndex:i]; if ((c >= 0x0600 && c <= 0x06FF) || (c >= 0x0750 && c <= 0x077F)) { return YES; } } return NO; } // Helper: Deteksi karakter CJK. - (BOOL)containsCJKCharacters:(NSString *)text { for (NSUInteger i = 0; i < text.length; i++) { unichar c = [text characterAtIndex:i]; if ((c >= 0x4E00 && c <= 0x9FFF) || // Cina (c >= 0x3040 && c <= 0x309F) || // Hiragana Jepang (c >= 0xAC00 && c <= 0xD7AF)) { // Korea return YES; } } return NO; } @end(Opsional) Muat font kustom secara dinamis.
- (void)loadCustomFontFromBundle:(NSString *)fontName { NSString *path = [[NSBundle mainBundle] pathForResource:fontName ofType:@"ttf"]; if (path) { NSData *fontData = [NSData dataWithContentsOfFile:path]; CGDataProviderRef provider = CGDataProviderCreateWithCFData((__bridge CFDataRef)fontData); CGFontRef fontRef = CGFontCreateWithDataProvider(provider); if (CTFontManagerRegisterGraphicsFont(fontRef, NULL)) { NSLog(@"Font berhasil didaftarkan: %@", fontName); } else { NSLog(@"Pendaftaran font gagal: %@", fontName); } CGFontRelease(fontRef); CGDataProviderRelease(provider); } }Inisialisasi view subtitle dan ikat renderer kustom.
// Buat view subtitle. AliVttSubtitleView *subtitleView = [[AliVttSubtitleView alloc] init]; // Atur factory renderer kustom. [subtitleView setRenderImplFactory:^AliVttRenderImpl*() { CustomFontVttRenderImpl *impl = [[CustomFontVttRenderImpl alloc] init]; // Opsional: Preload font. [impl loadCustomFontFromBundle:@"LongCang-Regular"]; return impl; }]; // Lampirkan ke pemutar. [player setExternalSubtitleView:subtitleView];Tangani callback subtitle pemutar.
Implementasikan metode berikut pada AVPDelegate Anda:
// Header subtitle (berisi definisi gaya dan wilayah). - (void)onSubtitleHeader:(AliPlayer *)player trackIndex:(int)trackIndex Header:(NSString *)header { [self.subtitleView setVttHeader:player trackIndex:trackIndex Header:header]; } // Tampilkan subtitle. - (void)onSubtitleShow:(AliPlayer *)player trackIndex:(int)trackIndex subtitleID:(long)subtitleID subtitle:(NSString *)subtitle { [self.subtitleView show:player trackIndex:trackIndex subtitleID:subtitleID subtitle:subtitle]; } // Sembunyikan subtitle. - (void)onSubtitleHide:(AliPlayer *)player trackIndex:(int)trackIndex subtitleID:(long)subtitleID { [self.subtitleView hide:player trackIndex:trackIndex subtitleID:subtitleID]; } // Track subtitle berhasil ditambahkan. Gunakan callback ini untuk mengaktifkan track. - (void)onSubtitleExtAdded:(AliPlayer *)player trackIndex:(int)trackIndex URL:(NSString *)URL { [player selectExtSubtitle:trackIndex enable:YES]; }
Pemutaran audio-only
Untuk mengaktifkan pemutaran audio-only, nonaktifkan track video. Konfigurasikan PlayerConfig sebelum memanggil prepare.
AVPConfig *config = [self.player getConfig];
config.disableVideo = YES;
[self.player setConfig:config];Pergantian decoder
Player SDK untuk iOS mendukung decoding hardware untuk H.264 dan H.265. Fitur ini diaktifkan secara default dan dikontrol oleh properti enableHardwareDecoder. Jika decoding hardware gagal diinisialisasi, pemutar secara otomatis beralih ke decoding software untuk memastikan pemutaran tetap berlanjut.
// Aktifkan decoding hardware (diaktifkan secara default).
self.player.enableHardwareDecoder = YES;Ketika pemutar secara otomatis beralih dari decoding hardware ke software, pemutar memicu callback onPlayerEvent, seperti yang ditunjukkan dalam contoh berikut:
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
if (eventWithString == EVENT_SWITCH_TO_SOFTWARE_DECODER) {
// Beralih ke decoding software.
}
}Pemutaran adaptif H.265
Jika model perangkat ada dalam blacklist H.265 berbasis cloud atau jika decoding hardware H.265 gagal, fallback adaptif akan dipicu. Jika stream cadangan H.264 dikonfigurasi, pemutar akan memutarnya secara otomatis. Jika tidak, pemutar akan kembali ke decoding software H.265.
Fitur ini hanya tersedia setelah mengaktifkan layanan decoding adaptif cloud-native. Anda perlu mengirimkan formulir Yida untuk mengajukan lisensi.
Layanan decoding adaptif cloud-native menyediakan dua kemampuan utama: 1. Pengiriman data kompatibilitas decoding hardware secara dinamis dari cloud. 2. Fallback adaptif dari stream H.265 ke H.264.
SDK tetap dapat beralih secara otomatis ke decoding software jika decoding hardware gagal, bahkan tanpa layanan nilai tambah ini.
Contoh berikut menunjukkan cara mengatur stream cadangan:
// Lapisan aplikasi harus memelihara dictionary untuk memetakan URL asli ke URL cadangannya.
NSString* getBackupUrlCallback(AVPBizScene scene, AVPCodecType codecType, NSString* oriurl){
NSMutableDictionary *globalMap = [AliPlayerViewController getGlobalBackupUrlMap];
NSString *backupUrl = globalMap[oriurl];
return backupUrl;
}
[AliPlayerGlobalSettings setAdaptiveDecoderGetBackupURLCallback:getBackupUrlCallback];Streaming bitrate adaptif
Anda dapat menghasilkan stream adaptif multi-bitrate menggunakan kelompok template transcoding dan pengemasan video di ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Mengonfigurasi streaming bitrate adaptif untuk ApsaraVideo VOD.
Untuk memutar stream adaptif dari ApsaraVideo VOD dengan metode pemutaran VidAuth, atur daftar definisi ke
AUTO. Jika tidak, pemutar akan memilih stream definisi rendah secara default. Untuk informasi selengkapnya tentang urutan pemutaran default untuk definisi, lihat Jika video ditranskode ke beberapa definisi, definisi mana yang diputar ApsaraVideo Player SDK secara default? Contoh berikut menunjukkan caranya:AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init]; authSource.definitions = @"AUTO";
ApsaraVideo Player SDK untuk iOS mendukung stream adaptif multi-bitrate. Setelah metode prepare berhasil, Anda dapat memanggil metode getMediaInfo untuk mendapatkan TrackInfo untuk setiap stream.
AVPMediaInfo *info = [self.player getMediaInfo];
NSArray<AVPTrackInfo*>* tracks = info.tracks;Selama pemutaran, Anda dapat mengganti stream dengan memanggil metode selectTrack milik pemutar. Untuk mengaktifkan streaming bitrate adaptif, teruskan SELECT_AVPTRACK_TYPE_VIDEO_AUTO.
// Beralih ke stream tertentu.
[self.player selectTrack:track.trackIndex];
// Aktifkan streaming bitrate adaptif.
[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];Callback onTrackChanged mengonfirmasi pergantian stream.
- (void)onTrackChanged:(AliPlayer*)player info:(AVPTrackInfo*)info {
if (info.trackType == AVPTRACK_TYPE_VIDEO) {
// Track video telah berubah.
}
// dll
}Opsional: Sebelum memanggil metode selectTrack untuk mengaktifkan streaming bitrate adaptif, Anda dapat membatasi definisi video untuk mencegah pemutar beralih ke bitrate yang terlalu tinggi secara tak terduga. Terapkan konfigurasi ini sebelum memanggil metode prepare atau metode moveTo untuk pemutaran daftar.
AVPConfig *config = [self.player getConfig];
config.maxAllowedAbrVideoPixelNumber = 921600; // Atur jumlah piksel maksimum untuk ABR ke 921600 (1280 * 720). Ini memastikan bahwa pemutar hanya beralih ke definisi dengan jumlah piksel yang kurang dari atau sama dengan nilai ini.
[self.player setConfig:config];Snapshot
Player SDK untuk iOS menyediakan fitur untuk mengambil snapshot dari video saat ini. Fitur ini diimplementasikan oleh API snapShot. Fitur ini menangkap data mentah dan mengembalikannya sebagai bitmap. Callback-nya adalah onCaptureScreen. Berikut adalah contohnya:
// Callback snapshot
- (void)onCaptureScreen:(AliPlayer *)player image:(UIImage *)image {
// Proses snapshot.
}
// Ambil snapshot dari frame saat ini.
[self.player snapShot];Snapshot tidak menyertakan UI.
Pratinjau
ApsaraVideo Player SDK untuk iOS mendukung fitur pratinjau ketika dikonfigurasi dengan ApsaraVideo VOD. SDK mendukung pemutaran VidSts dan VidAuth. VidAuth adalah metode yang disarankan. Untuk informasi selengkapnya, lihat Pratinjau video.
Setelah Anda mengonfigurasi fitur pratinjau, gunakan metode setPreviewTime dari antarmuka VidPlayerConfigGen untuk mengatur durasi pratinjau bagi pemutar. Berikut adalah contoh pemutaran VidSts:
AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
....
VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
[vp setPreviewTime:20]; // Pratinjau 20 detik
source.playConfig = [vp generatePlayerConfig]; // Terapkan konfigurasi ke sumber pemutaran.
...Ketika Anda mengatur durasi pratinjau dan menggunakan iOS player SDK untuk memutar video, server hanya mengembalikan konten video untuk periode pratinjau, bukan konten video penuh.
Anda dapat menggunakan kelas VidPlayerConfigGenerator untuk mengatur parameter permintaan sisi server. Untuk informasi selengkapnya, lihat Deskripsi parameter permintaan.
Mengatur Referer
Player SDK untuk iOS memungkinkan Anda mengatur Referer untuk menerapkan kontrol akses. Fitur ini bekerja dengan blacklist dan daftar putih Referer yang Anda konfigurasikan di konsol ApsaraVideo VOD. Anda dapat mengatur Referer dalam objek AVPConfig, seperti yang ditunjukkan dalam contoh berikut:
// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur Referer.
config.referer = referer;
....// Pengaturan lainnya.
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];User-Agent
iOS player SDK menyediakan AVPConfig untuk mengatur User-Agent kustom, yang kemudian disertakan pemutar dalam semua permintaan jaringan berikutnya. Contoh berikut menunjukkan caranya:
// Dapatkan konfigurasi saat ini.
AVPConfig *config = [self.player getConfig];
// Atur User-Agent.
config.userAgent = userAgent;
//... pengaturan lainnya
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];Mengonfigurasi jumlah percobaan ulang jaringan dan timeout
Untuk mengonfigurasi timeout jaringan dan jumlah percobaan ulang untuk iOS player SDK, gunakan objek AVPConfig. Contohnya:
// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur timeout jaringan dalam milidetik.
config.networkTimeout = 5000;
// Atur jumlah percobaan ulang maksimum. Interval percobaan ulang ditentukan oleh networkTimeout. Nilai 0 menonaktifkan percobaan ulang, memungkinkan aplikasi menerapkan kebijakan percobaan ulangnya sendiri. Defaultnya adalah 2.
config.networkRetryCount = 2;
//... Pengaturan Lainnya
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];Jika
networkRetryCountlebih besar dari 0, pemutar akan mencoba ulang hingganetworkRetryCountkali ketika terjadi masalah jaringan selama pemuatan. Interval percobaan ulang ditentukan olehnetworkTimeout.Jika pemutar gagal memuat setelah semua upaya percobaan ulang, callback
onErrorakan dipicu, dan AVPErrorModel.code adalah ERROR_LOADING_TIMEOUT.Jika
networkRetryCountadalah 0, timeout jaringan memicu callbackonPlayerEventdengan parametereventWithStringdiatur keEVENT_PLAYER_NETWORK_RETRY. Anda kemudian dapat memanggil metodereloadmilik pemutar untuk mencoba ulang permintaan jaringan atau melakukan tindakan lain.
Kontrol cache dan latensi
Kontrol cache sangat penting untuk kinerja pemutar. Konfigurasi yang tepat dapat meningkatkan kecepatan startup dan mengurangi stuttering. Player SDK untuk iOS menyediakan antarmuka untuk mengonfigurasi pengaturan cache dan latensi dalam objek AVPConfig:
// Ambil konfigurasi.
AVPConfig *config = [self.player getConfig];
// Latensi maksimum dalam milidetik. Catatan: Parameter ini hanya untuk live streaming. Jika latensi menjadi tinggi, Player SDK menyinkronkan frame agar tetap dalam batas ini.
config.maxDelayTime = 5000;
// Durasi maksimum (dalam milidetik) data yang dapat dibuffer oleh pemutar.
config.maxBufferDuration = 50000;
// Durasi buffer tinggi dalam milidetik. Ketika kondisi jaringan buruk, pemutar berhenti memuat data setelah buffer mencapai durasi ini.
config.highBufferDuration = 3000;
// Durasi buffer startup dalam milidetik. Nilai yang lebih kecil menghasilkan kecepatan startup yang lebih cepat tetapi dapat menyebabkan stuttering sesaat setelah pemutaran dimulai.
config.startBufferDuration = 500;
// Pengaturan lainnya.
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];Durasi buffer harus memenuhi hubungan ini: startBufferDuration ≤ highBufferDuration ≤ maxBufferDuration.
Jika durasi buffer maksimum (maxBufferDuration) melebihi 5 menit, sistem memberlakukan batas 5 menit untuk mencegah pengecualian memori akibat buffer yang terlalu besar.
Mengatur HTTP header
Gunakan objek AVPConfig untuk menambahkan HTTP header ke permintaan pemutar:
// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Tentukan header.
NSMutableArray *httpHeaders = [[NSMutableArray alloc] init];
// Misalnya, atur header Host saat Anda menggunakan HTTPDNS.
[httpHeaders addObject:@"Host:example.com"];
// Atur header.
config.httpHeaders = httpHeaders;
....// Pengaturan lainnya.
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];Gambar-dalam-Gambar
Lihat modul PictureInPicture di proyek API-Example untuk contoh kode terperinci. Proyek sampel Objective-C ini mendemonstrasikan cara mengintegrasikan fitur inti Alibaba Cloud Player SDK untuk iOS.
Gambar-dalam-Gambar (PiP) memerlukan iOS 15 atau yang lebih baru dan ApsaraVideo Player SDK untuk iOS 5.4.9.0 atau yang lebih baru.
Versi ApsaraVideo Player SDK untuk iOS sebelum 5.5.2.0 hanya menyediakan metode untuk mengaktifkan atau menonaktifkan PiP dan menampilkan jendela PiP saat aplikasi masuk ke latar belakang. Mulai versi 5.5.2.0, Anda juga dapat mengatur delegate PiP eksternal untuk menyesuaikan perilaku PiP.
Untuk menggunakan PiP, pastikan fitur ini diaktifkan di pengaturan perangkat Anda (Settings > General > Picture in Picture).
Aktifkan PiP
Setelah Anda mengaktifkan gambar-dalam-gambar, video terus diputar di jendela kecil saat aplikasi masuk ke latar belakang. Saat aplikasi kembali ke latar depan, video kembali ke tampilan aslinya. Untuk mengaktifkan gambar-dalam-gambar, panggil setPictureInPictureEnable setelah pemutar memasuki status AVPEventPrepareDone. Contoh berikut menunjukkan caranya:
- (void)onPlayerEvent:(AliPlayer *)player eventType:(AVPEventType)eventType {
switch (eventType) {
case AVPEventPrepareDone:
{
[self.player setPictureInPictureEnable:YES];
}
break;
default:
break;
}
}Memanggil metode stop milik pemutar tidak secara otomatis menutup jendela gambar-dalam-gambar. Oleh karena itu, Anda harus menonaktifkan gambar-dalam-gambar dengan memanggil setPictureInPictureEnable sebelum Anda memanggil stop.
Konfigurasikan delegasi PiP
Contoh kode berikut mendemonstrasikan interaksi umum antara jendela Gambar-dalam-Gambar (PiP) dan pemutar. Contoh ini mencakup menampilkan kontrol pemutaran seperti jeda, putar, maju cepat, dan mundur, serta mengimplementasikan logika putar ulang. Untuk referensi lengkap metode delegate, lihat file header AliPlayerPictureInPictureDelegate.h, yang terletak di AliyunPlayer.framework dalam folder SDK dari demo player SDK.
Atur delegate Gambar-dalam-Gambar.
/** * @brief Mengatur delegate untuk event Gambar-dalam-Gambar. */ -(void) setPictureinPictureDelegate:(id<AliPlayerPictureInPictureDelegate>)delegate; // Atur delegate Gambar-dalam-Gambar. [self.player setPictureinPictureDelegate:self];Tambahkan properti dan implementasikan metode delegate.
Tambahkan properti ke view controller Anda untuk mengelola status pemutar dan jendela Gambar-dalam-Gambar.
#import "YourUIViewController.h" #import <AliyunPlayer/AliyunPlayer.h> @interface YourUIViewController () <AVPDelegate, AliPlayerPictureInPictureDelegate> // Instans pemutar. @property (nonatomic, strong) AliPlayer *player; // View kontainer untuk pemutar. @property (nonatomic, strong) UIView *playerView; // Melacak apakah jendela Gambar-dalam-Gambar dijeda. @property (nonatomic, assign) BOOL isPipPaused; // Melacak status pemutaran pemutar saat ini, diperbarui oleh callback onPlayerStatusChanged:oldStatus:newStatus:. @property (nonatomic, assign) AVPStatus currentPlayerStatus; // Referensi lemah ke controller gambar-dalam-gambar. Ini diatur dalam callback pictureInPictureControllerWillStartPictureInPicture: dan harus diatur ke nil sebelum view controller dialokasikan ulang. Menggunakan referensi lemah sangat disarankan. @property (nonatomic, weak) AVPictureInPictureController *pipController; // Melacak progres pemutaran, diperbarui oleh parameter 'position' dalam callback progres pemutaran. @property (nonatomic, assign) int64_t currentPosition; @endCatatanProperti
pipControllerharus dideklarasikan dengan atributweakatauassignuntuk mencegah retain cycle. Jika Anda menggunakanassign, atur properti kenilsecara manual pada waktu yang tepat.Dalam metode delegate
onPlayerStatusChanged:Anda, beri tahu controller gambar-dalam-gambar untuk memperbarui statusnya.- (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus { self.currentPlayerStatus = newStatus; if (_pipController) { [self.pipController invalidatePlaybackState]; } }Dalam metode delegate
onPlayerEvent:Anda, perbarui status Gambar-dalam-Gambar sebagai respons terhadap event pemutaran.- (void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType { if (eventType == AVPEventCompletion) { if (_pipController) { self.isPipPaused = YES; // Saat pemutaran selesai, atur status PiP ke dijeda. [self.pipController invalidatePlaybackState]; } } else if (eventType == AVPEventSeekEnd) { // Operasi seek selesai. if (_pipController) { [self.pipController invalidatePlaybackState]; } } }Implementasikan metode delegate.
Implementasikan callback untuk saat Gambar-dalam-Gambar akan dimulai.
/** @brief Memberi tahu delegate bahwa Gambar-dalam-Gambar akan dimulai. @param pictureInPictureController Controller gambar-dalam-gambar. */ - (void)pictureInPictureControllerWillStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController { if (!_pipController) { self.pipController = pictureInPictureController; } self.isPipPaused = !(self.currentPlayerStatus == AVPStatusStarted); [pictureInPictureController invalidatePlaybackState]; }Implementasikan callback untuk saat Gambar-dalam-Gambar akan berhenti.
/** @brief Memberi tahu delegate bahwa Gambar-dalam-Gambar akan berhenti. @param pictureInPictureController Controller gambar-dalam-gambar. */ - (void)pictureInPictureControllerWillStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController { self.isPipPaused = NO; [pictureInPictureController invalidatePlaybackState]; }Implementasikan callback untuk memulihkan UI sebelum Gambar-dalam-Gambar berhenti.
/** @brief Memberi tahu delegate untuk memulihkan antarmuka pengguna sebelum Gambar-dalam-Gambar berhenti. @param pictureInPictureController Controller gambar-dalam-gambar. @param completionHandler Handler penyelesaian yang dipanggil dengan YES untuk mengizinkan sistem menyelesaikan pemulihan. */ - (void)pictureInPictureController:(AVPictureInPictureController *)pictureInPictureController restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:(void (^)(BOOL restored))completionHandler { if (_pipController) { _pipController = nil; } completionHandler(YES); }Implementasikan callback yang menyediakan rentang waktu yang dapat diputar.
/** @brief Meminta delegate untuk rentang waktu yang dapat diputar saat ini. @param pictureInPictureController Controller gambar-dalam-gambar. @return Rentang waktu yang dapat diputar saat ini. */ - (CMTimeRange)pictureInPictureControllerTimeRangeForPlayback:(nonnull AVPictureInPictureController *)pictureInPictureController layerTime:(CMTime)layerTime{ Float64 current64 = CMTimeGetSeconds(layerTime); Float64 start; Float64 end; if (currentPosition <= self.player.duration) { double curPostion = self.currentPosition / 1000.0; double duration = self.player.duration / 1000.0; double interval = duration - curPostion; start = current64 - curPostion; end = current64 + interval; CMTime t1 = CMTimeMakeWithSeconds(start, layerTime.timescale); CMTime t2 = CMTimeMakeWithSeconds(end, layerTime.timescale); return CMTimeRangeFromTimeToTime(t1, t2); } else { return CMTimeRangeMake(kCMTimeNegativeInfinity, kCMTimePositiveInfinity); } }Implementasikan callback yang melaporkan apakah pemutaran dijeda.
/** @brief Meminta delegate apakah pemutaran sedang dijeda. @param pictureInPictureController Controller gambar-dalam-gambar. @return Nilai Boolean yang menunjukkan apakah pemutaran dijeda. */ - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{ return self.isPipPaused; }CatatanCallback ini dipanggil sebelum Gambar-dalam-Gambar dimulai. Callback ini harus mengembalikan
falsepada titik ini agar jendela PiP dapat diluncurkan. Mengembalikantruemencegah Gambar-dalam-Gambar dimulai.Implementasikan callback untuk menangani tindakan lompat maju dan lompat mundur dari kontrol Gambar-dalam-Gambar.
/** @brief Memberi tahu delegate bahwa pengguna telah meminta untuk lompat maju atau mundur. @param pictureInPictureController Controller gambar-dalam-gambar. @param skipInterval Interval waktu untuk dilewati. @param completionHandler Handler penyelesaian yang harus Anda panggil setelah operasi seek selesai. */ - (void)pictureInPictureController:(nonnull AVPictureInPictureController *)pictureInPictureController skipByInterval:(CMTime)skipInterval completionHandler:(nonnull void (^)(void))completionHandler { int64_t skipTime = skipInterval.value / skipInterval.timescale; int64_t skipPosition = self.currentPosition + skipTime * 1000; if (skipPosition < 0) { skipPosition = 0; } else if (skipPosition > self.player.duration) { skipPosition = self.player.duration; } [self.player seekToTime:skipPosition seekMode:AVP_SEEKMODE_INACCURATE]; [pictureInPictureController invalidatePlaybackState]; }Implementasikan callback untuk menangani tindakan putar dan jeda dari kontrol Gambar-dalam-Gambar.
/** @brief Memberi tahu delegate bahwa pengguna telah menekan tombol putar/jeda. @param pictureInPictureController Controller gambar-dalam-gambar. @param playing Nilai Boolean yang menunjukkan apakah pemutaran harus dimulai. */ - (void)pictureInPictureController:(nonnull AVPictureInPictureController *)pictureInPictureController setPlaying:(BOOL)playing { if (!playing){ [self.player pause]; self.isPipPaused = YES; } else { // Tips: Jika Anda ingin tombol putar memulai ulang video setelah pemutaran selesai, tambahkan blok berikut. if (self.currentPlayerStatus == AVPStatusCompletion) { [self.player seekToTime:0 seekMode:AVP_SEEKMODE_ACCURATE]; } [self.player start]; self.isPipPaused = NO; } [pictureInPictureController invalidatePlaybackState]; }
Gambar-dalam-gambar dalam aplikasi
Gambar-dalam-gambar berada di luar aplikasi secara default. Untuk mengimplementasikan gambar-dalam-gambar dalam aplikasi, pertama-tama panggil antarmuka berikut untuk memeriksa apakah gambar-dalam-gambar aktif:
/**
@brief Memberi tahu delegate apakah gambar-dalam-gambar diaktifkan.
@param pictureInPictureController Controller gambar-dalam-gambar yang melaporkan statusnya.
@param isEnable `YES` jika gambar-dalam-gambar diaktifkan; `NO` jika tidak.
*/
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;Untuk menonaktifkan startup otomatis dan beralih ke aktivasi manual saat gambar-dalam-gambar berjalan, gunakan kode sampel berikut:
- (void) pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *) pictureInPictureController isEnable:(BOOL) isEnable
{
if (isEnable && pictureInPictureController) {
_pipController = pictureInPictureController;
// Nonaktifkan auto-start pip.
if (@available(iOS 15.0, *)) {
_pipController.canStartPictureInPictureAutomaticallyFromInline = false;
}
} else {
_pipController = NULL;
}
}
- (void) switchPip:(bool) enable {
if (_pipController == nil) {
return;
}
if (enable) {
// Mulai pip.
[_pipController startPictureInPicture];
} else {
// Hentikan pip.
[_pipController stopPictureInPicture];
}
}Fallback RTS Live
Untuk contoh kode terperinci, lihat modul RtsLiveStream di API-Example. Proyek sampel Objective-C ini menunjukkan cara mengintegrasikan fitur inti Alibaba Cloud Player SDK untuk iOS.
Untuk informasi selengkapnya, lihat Pemutaran live RTS.
Mengganti saluran audio
Gunakan properti outputAudioChannel untuk mengatur saluran audio output. Jika sumber input adalah saluran stereo, Anda dapat mengganti output ke saluran audio kiri atau kanan. Pengaturan ini tidak berpengaruh jika sumber input adalah saluran mono.
Pengaturan saluran audio output memengaruhi rendering audio dan callback data PCM.
// Atur saluran audio output menggunakan nilai enumerasi AVPOutputAudioChannel.
// AVP_AUDIO_CHANNEL_NONE: Memutar saluran audio asli dari sumber input. Ini adalah nilai default.
// AVP_AUDIO_CHANNEL_LEFT: Hanya memutar saluran audio kiri.
// AVP_AUDIO_CHANNEL_RIGHT: Hanya memutar saluran audio kanan.
self.player.outputAudioChannel = AVP_AUDIO_CHANNEL_NONE;Mengatur warna latar belakang video
Player SDK untuk iOS memungkinkan Anda mengatur warna latar belakang view rendering.
Contoh API
/**
@brief
@param color warnanya
*/
/****
@brief Mengatur warna latar belakang video.
@param color Warna latar belakang.
*/
-(void) setVideoBackgroundColor:(UIColor *)color;Penggunaan
// Parameternya adalah nilai heksadesimal 8 digit dalam format ARGB (alpha, merah, hijau, biru).
// Misalnya, 0x0000ff00 mewakili warna hijau.
[self.player setVideoBackgroundColor:0x0000ff00]Menentukan domain pemutaran dengan VidAuth
Gunakan metode VidAuth untuk menentukan field, seperti domain pemutaran, yang terkait dengan ID video (vid). Untuk daftar field yang didukung, lihat Parameter permintaan GetPlayInfo.
Contoh API
/**
@brief Putar video menggunakan ID video dan kredensial pemutaran (PlayAuth). Untuk informasi selengkapnya, lihat: https://www.alibabacloud.com/help/en/vod/user-guide/use-playback-credentials-to-play-videos
@param source Objek AVPVidAuthSource.
@see AVPVidAuthSource
*/
- (void)setAuthSource:(AVPVidAuthSource*)source;Penggunaan
Gunakan metode addVidPlayerConfigByStringValue dari antarmuka VidPlayerConfigGenerator untuk menambahkan field playDomain.
VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
// Tambahkan field playDomain. Untuk daftar field yang didukung, lihat:
// https://www.alibabacloud.com/help/en/vod/developer-reference/api-vod-2017-03-21-getplayinfo
[gen addVidPlayerConfigByStringValue:@"playDomain" value: @"com.example.xxx"];
[source setPlayConfig:[gen generatePlayerConfig]];
[self.player setAuthSource:source]:Pendekodean latar belakang
Mulai versi 6.12.0, player SDK mendukung decoding latar belakang. Mengaktifkan fitur ini memungkinkan pemutar untuk terus mendekode dan memutar stream video, serta memicu callback saat aplikasi berjalan di latar belakang. Contoh berikut menunjukkan cara mengaktifkan fitur ini:
// Atur ke 1 untuk mengaktifkan decoding latar belakang atau 0 untuk menonaktifkannya. Default: 0.
[self.player setOption:ALLOW_DECODE_BACKGROUND valueInt:1];Plugin decoding H.266
H.266, juga dikenal sebagai Versatile Video Coding (VVC), adalah standar pengkodean video generasi berikutnya yang memberikan kualitas visual yang sama dengan bitrate yang jauh lebih rendah. Untuk mengoptimalkan kinerja dan mengontrol ukuran SDK utama, decoder H.266 disediakan sebagai plugin terpisah yang dapat Anda integrasikan sesuai permintaan.
Prasyarat
Player SDK atau all-in-one SDK V7.6.0 atau yang lebih baru.
Anda memiliki lisensi Edisi Profesional. Untuk informasi selengkapnya, lihat Mendapatkan lisensi.
Plugin decoding H.266 untuk Player SDK hanya mendukung video H.266 yang ditranskode oleh Transcoding Alibaba Cloud.
Integrasikan plugin
Mengaktifkan plugin
Mulai Player SDK untuk iOS v7.7.0, plugin diaktifkan secara default dan tidak memerlukan aktivasi manual.
[AliPlayerGlobalSettings enableCodecPlugin:@"vvc" valid:true];Kode kesalahan
Untuk kode kesalahan plugin decoding H.266, lihat FAQ untuk ApsaraVideo Player SDK.
Refresh sumber secara otomatis
Aktifkan refresh sumber otomatis untuk mencegah gangguan pemutaran akibat autentikasi yang kedaluwarsa. Ketika sumber kedaluwarsa, pemutar memicu callback untuk mendapatkan sumber baru, memastikan pemutaran yang lancar dan berkelanjutan.
Prasyarat
Pemutar atau SDK terintegrasi harus versi 7.9.0 atau yang lebih baru.
Gunakan sumber VidAuth untuk pemutaran atau telah mengonfigurasi penandatanganan URL.
Sumber VidAuth
Contoh API
/**
@brief Mengatur callback untuk notifikasi kedaluwarsa sumber VidAuth.
Callback ini dipicu ketika pemutar mendeteksi bahwa sumber VidAuth saat ini telah kedaluwarsa. Sumber VidAuth kedaluwarsa jika PlayAuth atau URL pemutarannya telah kedaluwarsa.
Anda dapat me-refresh sumber VidAuth dalam callback ini dan meneruskan objek baru melalui parameter `callback` untuk memastikan pemutaran yang lancar.
@param callback Blok callback yang dipicu saat sumber VidAuth kedaluwarsa.
Gunakan callback ini untuk memperbarui pemutar dengan objek `VidAuth` yang valid.
*/
-(void)setOnVidAuthExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;Komponen kunci
Penggunaan
Anda dapat memperoleh PlayAuth dengan memanggil operasi GetVideoPlayAuth. Disarankan untuk mengintegrasikan server-side SDK untuk VOD guna mendapatkan kredensial, yang menghindari perlunya penandatanganan URL manual. Untuk informasi selengkapnya, lihat Portal OpenAPI.
[self.player setOnVidAuthExpiredCallback:^(id expiredSource, id<AVPSourceRefreshCallback> callback) {
// Dapatkan objek AVPVidAuthSource.
if ([expiredSource isKindOfClass:[AVPVidAuthSource class]]) {
AVPVidAuthSource *vidAuth = (AVPVidAuthSource *)expiredSource;
// ------------------- Awal implementasi pengguna -------------------
// Panggil fungsi kustom Anda untuk mengambil PlayAuth baru dari server aplikasi Anda.
// clinetGetPlayAuthFunction adalah nama fungsi sampel. Ganti dengan implementasi aktual Anda.
[self clinetGetPlayAuthFunction:vidAuth.vid success:^(NSString* newPlayAuth){
// 1. Dalam callback sukses, setelah mengambil kredensial baru:
[vidAuth setPlayAuth:newPlayAuth];
// 2. Teruskan objek sumber yang diperbarui kembali ke pemutar melalui callback SDK.
[callback onSuccess:vidAuth];
} failure:^(NSString* errorMsg) {
// Dalam callback kegagalan.
// errorMsg berisi detail tentang kesalahan.
[callback onError:errorMsg];
}];
// ------------------- Akhir implementasi pengguna -------------------
}
}];Sumber URL
Contoh API
/**
@brief Mengatur callback untuk notifikasi kedaluwarsa sumber URL.
Callback ini dipicu ketika pemutar mendeteksi bahwa sumber URL saat ini telah kedaluwarsa.
Anda dapat me-refresh sumber URL dalam callback ini dan mengembalikan sumber URL baru melalui parameter `callback` untuk memastikan pemutaran berkelanjutan.
@note Untuk informasi selengkapnya tentang cara mengonfigurasi penandatanganan URL, lihat dokumentasi Alibaba Cloud:
https://www.alibabacloud.com/help/en/vod/user-guide/configure-url-signing
@param callback Blok callback yang dipicu saat sumber URL kedaluwarsa.
Anda dapat menggunakan callback ini untuk menyediakan objek `URLSource` yang valid guna memperbarui pemutar.
*/
-(void)setOnURLSourceExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;Komponen kunci
Penggunaan
[self.player setOnURLSourceExpiredCallback:^(id expiredSource, id<AVPSourceRefreshCallback> callback) {
// Dapatkan objek AVPUrlSource.
if ([expiredSource isKindOfClass:[AVPUrlSource class]]) {
AVPUrlSource *expiredUrlSource = (AVPUrlSource *)expiredSource;
NSString *expiredUrl = [expiredUrlSource.playerUrl absoluteString];
// Periksa apakah URL berisi "auth_key".
if (![expiredUrl containsString:@"auth_key="]) {
return;
}
// 1. Ekstrak URL asli dari URL yang kedaluwarsa.
NSRange authKeyQuestionRange = [expiredUrl rangeOfString:@"?auth_key="];
NSRange authKeyAmpersandRange = [expiredUrl rangeOfString:@"&auth_key="];
NSInteger authKeyIndex = NSNotFound;
if (authKeyQuestionRange.location != NSNotFound) {
authKeyIndex = authKeyQuestionRange.location;
} else if (authKeyAmpersandRange.location != NSNotFound) {
authKeyIndex = authKeyAmpersandRange.location;
}
NSString *originalUrl = nil;
if (authKeyIndex != NSNotFound) {
originalUrl = [expiredUrl substringToIndex:authKeyIndex];
} else {
// Jika "auth_key" tidak ditemukan, asumsikan seluruh URL adalah URL asli.
originalUrl = expiredUrl;
}
// 2. Siapkan parameter autentikasi baru: authKey dan waktu kedaluwarsa.
// Gunakan anggota kelas authKey jika valid.
NSString *key = (self.authKey.length > 0) ? self.authKey : @"";
if (!NOT_EMPTY(key)) {
[callback onError:@"REFRESH_ERROR:key fail"];
return;
}
// Gunakan anggota kelas validTime jika valid; jika tidak, gunakan nilai default.
NSTimeInterval validTime = (self.validTime > 0) ? self.validTime : 3600; // Default: 3600 detik.
NSTimeInterval newExpireTime = [[NSDate date] timeIntervalSince1970] + validTime;
// 3. Hasilkan URL bertanda tangan baru dengan CdnAuthUtil (Metode A).
NSString *newAuthUrl = [CdnAuthUtil aAuthWithUri:originalUrl key:key exp:newExpireTime];
AVPUrlSource *resultSource = [[AVPUrlSource alloc] urlWithString:newAuthUrl];
// 4. Tangani callback.
if (newAuthUrl) {
[callback onSuccess:resultSource];
} else {
[callback onError:@"REFRESH_ERROR:refresh fail"];
}
}
}];Fungsi pembantu
Contoh berikut menggunakan metode autentikasi A.
Peningkatan audio
ApsaraVideo Player SDK untuk iOS menyediakan plugin peningkatan audio untuk meningkatkan pengalaman pemutaran audio. Fitur ini mencakup tiga fitur utama: normalisasi volume, peningkatan dialog, dan suara surround.
Fitur
Normalisasi volume: Secara otomatis menyesuaikan semua konten audio ke tingkat volume yang konsisten, meningkatkan pemutaran untuk video dengan volume asli yang terlalu rendah atau terlalu tinggi.
Saluran yang didukung: mono, stereo, 5.1, dan 7.1.
Laju sampel yang didukung: 16 kHz, 44,1 kHz, dan 48 kHz.
Peningkatan dialog: Secara cerdas menekankan dialog, membuat suara dalam adegan bising lebih jelas tanpa mengubah timbre asli.
Saluran yang didukung: stereo.
Laju sampel yang didukung: 44,1 kHz dan 48 kHz.
Suara surround: Menerapkan rendering surround virtual ke audio multi-saluran dan stereo, memberikan pengalaman imersif pada headphone atau perangkat standar. Fitur ini mencakup dua mode: 3DSurround dan MegaBass.
Saluran yang didukung: mono, stereo, 5.1, dan 7.1.
Laju sampel yang didukung: 44,1 kHz dan 48 kHz.
Prasyarat
ApsaraVideo Player SDK untuk iOS harus v7.13.0 atau yang lebih baru.
Anda harus memiliki Lisensi Edisi Profesional. Untuk informasi selengkapnya, lihat Mendapatkan lisensi untuk ApsaraVideo Player SDK.
Fitur peningkatan audio mendukung sumber audio berikut:
Stream VOD: Memerlukan transcoding media di ApsaraVideo VOD.
Stream live: Semua sumber didukung.
Mengintegrasikan plugin
Integrasi CocoaPods
Tambahkan dependensi untuk plugin ke Podfile Anda:
Untuk versi terbaru ApsaraVideo Player SDK untuk iOS, lihat Catatan rilis untuk ApsaraVideo Player SDK untuk iOS.
// x.x.x harus cocok dengan versi player SDK.
pod 'AliPlayerSDK_iOS_AUDIO_ENHANCE_FILTER', 'x.x.x'Integrasi lokal
Unduh versi terbaru ApsaraVideo Player SDK untuk iOS. Tambahkan file audioEnhanceFilter.framework ke Frameworks, Libraries, and Embedded Content, atur Embed ke Embed & Sign, dan konfigurasikan Framework Search Paths. Untuk informasi selengkapnya, lihat Integrasi lokal.
API
setFilterValid
Mengontrol sakelar utama untuk fitur peningkatan audio. Nama target dari filter peningkatan audio adalah audioEnhance. Menonaktifkan fitur ini juga menonaktifkan semua sub-fiturnya. Secara default, fitur ini dinonaktifkan.
[player setFilterValid:@"audioEnhance" valid:YES]; // Aktifkan
[player setFilterValid:@"audioEnhance" valid:NO]; // NonaktifkansetFilterConfig
Atur objek FilterConfig sebelum Anda memanggil metode prepare. Konfigurasi berlaku saat pemutaran dimulai.
AVPFilterConfig *filterConfig = [[AVPFilterConfig alloc] init];
AVPFilter *filterItem = [[AVPFilter alloc] initWithTarget:@"audioEnhance"];
AVPFilterOptions *opts = [[AVPFilterOptions alloc] init];
// Suara surround
[opts setOptions:@"enable_surround" value:@YES];
[opts setOptions:@"surround_effect_type" value:@"3DSurround"]; // Jenis harus diatur saat pertama kali mengaktifkan suara surround.
// Peningkatan dialog
[opts setOptions:@"enable_dialoguenhance" value:@YES];
[opts setOptions:@"dialoguenhance_voice" value:@(1.0)]; // Rentang: 1,0 hingga 10,0. Tingkat suara harus diatur saat pertama kali mengaktifkan peningkatan dialog.
// Normalisasi volume
[opts setOptions:@"enable_normalizer" value:@YES];
[filterItem setOptions:opts];
[filterConfig addFilter:filterItem];
[player setFilterConfig:filterConfig];Parameter | Jenis | Deskripsi |
| Boolean | Menentukan apakah akan mengaktifkan fitur suara surround. |
| String | Mode suara surround. Nilai yang valid: |
| Boolean | Menentukan apakah akan mengaktifkan fitur peningkatan dialog. |
| Float | Intensitas peningkatan dialog. Rentang: 1,0 hingga 10,0. |
| Boolean | Menentukan apakah akan mengaktifkan fitur normalisasi volume. |
updateFilterConfig
Panggil metode ini untuk menyesuaikan parameter secara dinamis setelah pemutar disiapkan atau saat sedang memutar.
Memanggil updateFilterConfig sebelum metode prepare tidak berpengaruh. Gunakan metode setFilterConfig untuk konfigurasi awal.
AVPFilterOptions *opts = [[AVPFilterOptions alloc] init];
[opts setOptions:@"enable_surround" value:@YES];
[opts setOptions:@"surround_effect_type" value:@"3DSurround"]; // Jenis hanya dapat diatur saat mengaktifkan suara surround untuk pertama kalinya. Ini diabaikan pada panggilan berikutnya karena filter sudah diinisialisasi.
[player updateFilterConfig:@"audioEnhance" options:opts];Tipe suara surround ("3DSurround" atau "MegaBass") dan kekuatan peningkatan dialog (dialoguenhance_voice) harus dikonfigurasi menggunakan properti enable saat pertama kali diaktifkan. Jika tidak, keduanya akan diinisialisasi ke nilai default ("3DSurround" untuk suara surround dan 1,0 untuk kekuatan peningkatan dialog) serta tidak dapat diubah selama pemutaran.
Kinerja
Mengatur scene pemutar
Mengatur scene pemutar secara otomatis menerapkan parameter optimal untuk skenario tersebut, seperti pengaturan buffer dan toggle fitur. Parameter kustom yang Anda atur dengan metode setConfig akan menimpa default scene.
Setelah Anda mengatur scene pemutar, Anda dapat memanggil metode
getConfiguntuk melihat konfigurasi yang berlaku.
Contoh API
/**
@brief Mengatur scene pemutar.
@param scene Scene pemutar.
@see AVPScene
*/
-(void) setPlayerScene:(AVPScene)scene;Scene Pemain
typedef enum _AVPScene {
/**
* Tidak ada scene khusus yang diatur.
*/
SceneNone,
/**
* Scene video panjang, cocok untuk video lebih dari 30 menit.
*/
SceneLong,
/**
* Scene video menengah, cocok untuk video antara 5 hingga 30 menit.
*/
SceneMedium,
/**
* Scene video pendek, cocok untuk video hingga 5 menit.
*/
SceneShort,
/**
* Scene live streaming.
*/
SceneLive,
/**
* Scene live RTS.
*/
SceneRTSLive
} AVPScene;Penggunaan
// Atur scene video pendek.
[self.player setPlayerScene:SceneShort];
// Atur scene video menengah.
[self.player setPlayerScene:SceneMedium];
// Atur scene video panjang.
[self.player setPlayerScene:SceneLong];
// Atur scene live streaming.
[self.player setPlayerScene:SceneLive]; Pre-rendering
Alibaba Cloud Player SDK untuk iOS dapat merender frame pertama video sebelum pemutaran dimulai, yang dapat meningkatkan kecepatan startup.
Fitur ini dinonaktifkan secara default.
Anda harus mengatur
Viewpemutar sebelum memanggilPrepareuntuk memastikan frame dirender keViewsegera setelah siap.Mengaktifkan fitur ini memengaruhi urutan pemicuan event keberhasilan persiapan dan rendering frame pertama. Saat fitur ini dinonaktifkan, event keberhasilan persiapan dipicu sebelum event rendering frame pertama. Saat fitur ini diaktifkan, event rendering frame pertama mungkin dipicu sebelum event keberhasilan persiapan, tergantung pada kecepatan decoding dan rendering. Hal ini tidak memengaruhi pemutaran.
Contoh berikut menunjukkan cara mengaktifkan fitur ini:
[self.player setOption:ALLOW_PRE_RENDER valueInt:1];Cache lokal
Untuk contoh kode terperinci, lihat modul PreloadUrl di proyek API-Example. Proyek sampel ini, ditulis dalam Objective-C, mendemonstrasikan cara mengintegrasikan fitur inti Alibaba Cloud Player SDK untuk iOS.
Alibaba Cloud Player SDK untuk iOS menyediakan fitur cache lokal. Fitur ini meningkatkan kecepatan startup dan kecepatan seek, mengurangi stuttering, dan menghemat network traffic selama pemutaran berulang.
Mengaktifkan cache lokal
Fitur cache lokal dinonaktifkan secara default. Untuk menggunakan fitur ini, Anda harus mengaktifkannya dengan metode enableLocalCache dari kelas AliPlayerGlobalSettings. Contoh berikut menunjukkan caranya.
/**
* Mengaktifkan cache lokal. Saat diaktifkan, konten di-cache ke file lokal.
* @param enable Nilai boolean yang menentukan apakah akan mengaktifkan cache lokal. true: diaktifkan, false: dinonaktifkan. Nilai default: false.
* @param maxBufferMemoryKB Parameter ini tidak digunakan lagi di v5.4.7.1 dan yang lebih baru serta tidak berpengaruh.
* @param localCacheDir Direktori untuk file cache lokal. Anda harus menentukan jalur mutlak.
*/
[AliPlayerGlobalSettings enableLocalCache:true maxBufferMemoryKB:1024 localCacheDir:@""];
/**
@brief Mengonfigurasi pembersihan otomatis file cache lokal.
@param expireMin Parameter ini tidak digunakan lagi di v5.4.7.1 dan yang lebih baru serta tidak berpengaruh.
@param maxCapacityMB Ukuran cache maksimum dalam MB. Nilai default: 20 GB. Selama pembersihan, jika total ukuran cache melebihi batas ini, item cache tertua dihapus satu per satu hingga total ukuran berada dalam batas.
@param freeStorageMB Ruang disk kosong minimum dalam MB. Nilai default: 0. Selama pembersihan, jika ruang disk yang tersedia kurang dari nilai ini, file cache dihapus satu per satu hingga ruang kosong sama dengan atau lebih besar dari nilai ini, atau hingga semua file yang di-cache dihapus.
*/
[AliPlayerGlobalSettings setCacheFileClearConfig:0 maxCapacityMB:0 freeStorageMB:0];
/**
* Callback untuk mendapatkan nilai hash dari URL. Nilai ini digunakan sebagai ID unik untuk URL. Anda harus memastikan bahwa setiap URL memiliki nilai hash yang unik.
*/
// Anda harus mengimplementasikan fungsi ini dan meneruskan pointernya ke setCacheUrlHashCallback.
static NSString *CaheUrlHashHandle(NSString *url) {
return @"xxx";
}
[AliPlayerGlobalSettings setCacheUrlHashCallback:&CaheUrlHashHandle];Jika URL pemutaran video menyertakan parameter autentikasi, parameter tersebut berubah antara caching dan pemutaran. Untuk meningkatkan tingkat hit cache untuk URL yang sama di bawah autentikasi yang berbeda, hapus parameter autentikasi sebelum menghitung nilai hash (misalnya, MD5) melalui
setCacheUrlHashCallback. Misalnya, untuk URL sepertihttp://****.mp4?aaa, hitung hash menggunakanhttp://****.mp4. Namun, untuk video m3u8 terenkripsi, jika Anda menghapus parameter autentikasi dari keyURL sebelum hashing, video yang berbeda mungkin mengenai kunci yang sama, menyebabkan kegagalan pemutaran. Solusi: Dalam callbacksetCacheUrlHashCallback, periksa domain dan hanya hapus parameter autentikasi untuk domain pemutaran (http(s)://xxxxx.m3u8?aaaa), bukan untuk domain keyURL (http(s)://yyyyy?bbbb). Gunakan curl untuk mendapatkan playlist video HLS terenkripsi M3U8, di mana playURL adalah alamat M3U8 dan keyURL adalah alamat kunci dekripsi AES-128. Contoh output terminal:# playURL: Permintaan playlist M3U8 C:\Users\futan>curl "https://videxxxv.cc/a003xxx2a-hd-encrypt-stream.m3u8?MtsHlsUriToken=uheAz07oi-jlo9CeIU6LxxxAr4a3WtzrJXnCn4ClS44dTYHCQGmXBlo7TyuPLE0a&auth_key=17xxxrmonwFHJ" #EXTM3U #EXT-X-VERSION:3 #EXT-X-ALLOW-CACHE:YES #EXT-X-TARGETDURATION:10 #EXT-X-MEDIA-SEQUENCE:0 # keyURL: Alamat kunci enkripsi AES-128 #EXT-X-KEY:METHOD=AES-128,URI="https://apxxx.cc/decrypt?Ciphertext=NWNiNDQyN2MtNjV1ZS00ZWIwLTk0YTAtNTJhOWIyZWV1OTY2MzdoRTJ6TjVxcXkweFY2xxxNCt4OGNFRGNReHRG&MtsHlsUriToken=uheAz07oi-jlo9CeIU6LxxxAr4a3WtzrJXnCn4ClS44dTYHCQGmXBlo7TyuPLE0a" #EXTINF:10.000000, e9012989ecd8e987eb7349d84d3b06d8-hd-encrypt-stream-00001.ts?auth_key=1706560316-65b7xxx39f1d6c77 #EXTINF:10.000000, e9012989ecd8e987eb7349d84d3b06d8-hd-encrypt-stream-00002.ts?auth_key=1706560316-65b7xxxe8eca2faf #EXTINF:10.000000, e9012989ecd8e987eb7349d84d3b06d8-hd-encrypt-stream-00003.ts?auth_key=1706560316-65b7xxx50c6981b3 #EXTINF:10.000000, e9012989ecd8e987eb7349d84d3b06d8-hd-encrypt-stream-00004.ts?auth_key=1706560316-65b7xxxf7228c594 #EXTINF:10.000000, e9012989ecd8e987eb7349d84d3b06d8-hd-encrypt-stream-00005.ts?auth_key=1706560316-65b7xxx6dc68c35dJika server menyajikan file media yang sama melalui HTTP dan HTTPS, Anda dapat meningkatkan tingkat hit cache dengan menghapus atau menormalisasi protokol sebelum menghitung nilai hash. Misalnya:
Jika URL pemutaran adalah
https://****.mp4danhttp://****.mp4, gunakan****.mp4untuk menghitung nilai hash.Jika URL pemutaran adalah
https://****.mp4, Anda dapat secara konsisten menggunakanhttp://****.mp4untuk menghitung nilai hash.
Untuk Alibaba Cloud Player SDK v5.5.4.0 dan yang lebih baru, jika Anda memutar stream HLS dengan URL yang berisi parameter autentikasi, Anda dapat mengatur field
AVPConfig.enableStrictAuthModeuntuk memilih mode autentikasi. Nilai defaultnya adalahfalseuntuk versi lama dantrueuntuk v7.13.0 dan yang lebih baru.Autentikasi non-ketat (
false): Informasi autentikasi di-cache bersama dengan konten media. Jika hanya sebagian media yang di-cache sebelumnya, pemutar menggunakan informasi autentikasi yang di-cache untuk meminta bagian yang belum di-cache. Jika autentikasi URL memiliki periode validitas yang singkat atau jika pemutaran dilanjutkan setelah jeda yang lama, autentikasi mungkin kedaluwarsa. Untuk menangani ini, Anda perlu mengimplementasikan fitur refresh sumber otomatis.Autentikasi ketat (
true): Informasi autentikasi tidak di-cache. Autentikasi terjadi di awal setiap sesi pemutaran. Hal ini dapat menyebabkan kegagalan pemutaran jika tidak ada koneksi jaringan.
Mengaktifkan atau menonaktifkan cache untuk URL
Jika Anda ingin menonaktifkan fitur cache lokal untuk satu URL, Anda dapat mengonfigurasinya di player config. Berikut adalah contohnya:
// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Menentukan apakah akan mengaktifkan caching lokal untuk URL pemutaran. Nilai default: true.
// Untuk mengaktifkan caching lokal untuk URL ini, pengaturan ini dan pengaturan global di AliPlayerGlobalSettings harus diaktifkan.
// Jika ini diatur ke false, caching lokal dinonaktifkan untuk URL ini.
config.enableLocalCache = false;
....// Pengaturan lainnya
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];Menggunakan jalur cache default
Untuk menggunakan jalur cache default, aktifkan caching lokal tanpa menentukan direktori di AliPlayerGlobalSettings.
[AliPlayerGlobalSettings enableLocalCache:true];Preloading
Alibaba Cloud Player SDK untuk iOS menyediakan fitur preloading, yang merupakan penyempurnaan dari cache lokal. Preloading mengunduh sebagian video ke dalam cache sebelum pemutaran dimulai, sehingga meningkatkan kecepatan startup.
Preloading memiliki batasan berikut:
Hanya mendukung file media tunggal, seperti MP4, MP3, FLV, dan HLS.
Secara default, Alibaba Cloud Player SDK untuk iOS secara otomatis menjadwalkan resource jaringan untuk preloading guna meminimalkan gangguan pada video yang sedang diputar. Permintaan preload dikirim hanya setelah buffer video yang sedang diputar mencapai ambang batas tertentu. Untuk menonaktifkan perilaku ini dan mengelola permintaan preload secara real-time, panggil metode berikut:
[AliPlayerGlobalSettings enableNetworkBalance:false];Aktifkan fitur cache lokal seperti yang dijelaskan dalam Cache lokal.
Atur sumber data.
VidAuth (disarankan)
AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init]; [vidAuthSource setVid:@"your_video_id"]; // Wajib. ID video. [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // Wajib. Kredensial pemutaran. Anda harus memanggil operasi GetVideoPlayAuth dari ApsaraVideo for VOD untuk menghasilkan kredensial. [vidAuthSource setRegion:@"your_region"]; // Parameter ini tidak digunakan lagi di SDK v5.5.5.0 dan yang lebih baru. Pemutar secara otomatis mengurai region. Untuk versi sebelumnya, parameter ini wajib dan defaultnya adalah cn-shanghai. [vidAuthSource setQuality:@"AUTO"]; // "AUTO" mengaktifkan streaming bitrate adaptif.VidSts
AVPVidStsSource* vidStsSource = [[AVPVidStsSource alloc] init]; [vidStsSource setVid: @""]; // Wajib. ID video. [vidStsSource setRegion:@""]; // Wajib. Wilayah tempat ApsaraVideo VOD diaktifkan. Nilai default: cn-shanghai. [vidStsSource setSecurityToken: @"<yourSecurityToken>"]; // Wajib. Token keamanan STS. Anda harus memanggil operasi API AssumeRole dari STS untuk mendapatkan token. [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // Wajib. Rahasia AccessKey dari pasangan AccessKey STS sementara. Anda harus memanggil operasi API AssumeRole dari STS untuk mendapatkan rahasia AccessKey. [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // Wajib. AccessKey ID dari pasangan AccessKey STS sementara. Anda harus memanggil operasi API AssumeRole dari STS untuk mendapatkan AccessKey ID. [vidStsSource setQuality:@""]; // "AUTO" menentukan streaming bitrate adaptif.UrlSource
NSString* url = @"your_playback_url"; // Wajib. URL pemutaran. Bisa berupa URL VOD pihak ketiga atau URL pemutaran dari ApsaraVideo for VOD. AVPUrlSource* urlSource = [[AVPUrlSource alloc]urlWithString:url];Atur parameter task.
CatatanParameter ini hanya berlaku untuk video multi-bitrate. Anda hanya perlu mengatur salah satu dari
setDefaultBandWidth,setDefaultResolution, dansetDefaultQuality.AVPPreloadConfig *config = [[AVPPreloadConfig alloc]init]; // Atur bitrate preload untuk stream multi-bitrate. [config setDefaultBandWidth:400000]; // Atur resolusi preload untuk stream multi-bitrate. [config setDefaultResolution:640 * 480]; // Atur kualitas preload untuk stream multi-bitrate. [config setDefaultQuality:@"FD"]; // Atur durasi preload. [config setDuration:1000];Tambahkan listener task.
Bangun task, tambahkan ke instans
MediaLoaderV2, dan mulai preloading.VidAuth (disarankan)
// Bangun task preload. AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithVidAuthSource:vidAuthSource preloadConfig:config]; // Dapatkan instans MediaLoaderV2. AliMediaLoaderV2* vodMedialoader = [AliMediaLoaderV2 shareInstance]; // Tambahkan task dan mulai preloading. NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];VidSts
// Bangun task preload. AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithVidStsSource:vidStsSource preloadConfig:config]; // Dapatkan instans MediaLoaderV2. AliMediaLoaderV2* vodMedialoader = [[AliMediaLoaderV2 alloc]init]; // Tambahkan task dan mulai preloading. NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];UrlSource
// Bangun task preload. AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithUrlSource:urlSource preloadConfig:config]; // Dapatkan instans MediaLoaderV2. AliMediaLoaderV2* vodMedialoader = [[AliMediaLoaderV2 alloc]init]; // Tambahkan task dan mulai preloading. NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];Opsional: Kelola tugas.
[vodMedialoader cancelTask:taskId];// Batalkan task preload dengan ID yang ditentukan. [vodMedialoader pauseTask:taskId];// Jeda task preload dengan ID yang ditentukan. [vodMedialoader resumeTask:taskId];// Lanjutkan task preload dengan ID yang ditentukan.Opsional: Hapus file yang dimuat.
Untuk menghemat ruang, Anda dapat menghapus file yang di-cache. Karena Alibaba Cloud Player SDK untuk iOS tidak menyediakan antarmuka penghapusan, Anda harus menghapus file secara manual dari direktori cache dalam aplikasi Anda.
Preloading dinamis
Strategi preloading dinamis memungkinkan Anda mengontrol caching untuk video saat ini dan jumlah video yang akan di-preload. Ini membantu Anda menyeimbangkan pengalaman pemutaran dengan biaya.
Preloading video HLS multi-bitrate
Dalam skenario listPlayer dengan video HLS multi-bitrate, Anda dapat mem-preload stream yang sesuai dengan kualitas pemutaran saat ini dan memilih mode preload yang sesuai dengan kebutuhan bisnis Anda.
Kecepatan unduhan
Anda bisa mendapatkan kecepatan unduhan video yang sedang diputar dari parameter speed dalam callback onCurrentDownloadSpeed. Contoh berikut menunjukkan caranya.
- (void)onCurrentDownloadSpeed:(AliPlayer *)player speed:(int64_t)speed{
intspeed_=speed;
}Fitur jaringan
HTTPDNS
HTTPDNS menyelesaikan nama domain melalui HTTP ke server tertentu, mengurangi risiko pembajakan DNS dan memberikan resolusi yang lebih cepat dan stabil.
ApsaraVideo Player SDK menyediakan HTTPDNS yang ditingkatkan untuk domain Alibaba Cloud CDN, mendukung penjadwalan CDN yang presisi dan resolusi real-time.
Contoh HTTPDNS yang ditingkatkan
HTTPDNS yang ditingkatkan hanya menyediakan layanan untuk domain Alibaba Cloud CDN. Pastikan domain Anda adalah domain Alibaba Cloud CDN dan dikonfigurasi dengan benar. Untuk menambahkan domain CDN di VOD, lihat Tambahkan domain yang dipercepat. Alibaba Cloud CDN.
// Aktifkan HTTPDNS yang ditingkatkan.
[AliPlayerGlobalSettings enableEnhancedHttpDns:YES];
// Opsional. Tambahkan nama domain untuk pra-resolusi HTTPDNS.
[[AliDomainProcessor shareInstance] addPreResolveDomain:@"player.***alicdn.com"];HTTP/2
Mulai dari v5.5.0.0, Alibaba Cloud Player SDK untuk iOS mengaktifkan HTTP/2 secara default.
Alibaba Cloud Player SDK untuk iOS mendukung HTTP/2, yang menggunakan multiplexing untuk menghindari blokir kepala antrian dan meningkatkan kinerja pemutaran. Contoh:
[AliPlayerGlobalSettings setUseHttp2:true];Pra-koneksi TCP
Untuk permintaan pemutaran video HTTP (bukan HTTPS), membuat koneksi TCP terlebih dahulu secara signifikan meningkatkan pengalaman pengguna dengan mengurangi waktu koneksi, memastikan pemutaran langsung dan berkelanjutan, serta mengoptimalkan penggunaan resource jaringan dan sistem. Contoh:
// Format domain adalah host[:port]. Port bersifat opsional. Gunakan titik koma (;) untuk memisahkan beberapa nama domain.
// Pengaturan global.
// Ini adalah pengaturan mutlak. Setiap kali Anda memanggil metode ini, string baru menggantikan string sebelumnya. String kosong menonaktifkan pra-koneksi.
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];Unduhan video
Untuk contoh kode terperinci, lihat modul Unduhan Video dan Pemutaran Offline (Download) di API-Example. Proyek sampel Objective-C ini mendemonstrasikan cara mengintegrasikan fitur inti ApsaraVideo Player SDK untuk iOS.
ApsaraVideo Player SDK untuk iOS memungkinkan Anda mengunduh konten ApsaraVideo VOD untuk pemutaran offline. SDK menawarkan dua mode unduhan: unduhan standar dan unduhan aman.
Unduhan standar: Data video yang diunduh tidak dienkripsi oleh Alibaba Cloud dan dapat diputar menggunakan pemutar pihak ketiga.
Unduhan aman: Data video yang diunduh dienkripsi oleh Alibaba Cloud. Data ini tidak dapat diputar oleh pemutar pihak ketiga dan hanya dapat diputar menggunakan ApsaraVideo Player.
Penggunaan
Fitur unduhan video hanya tersedia untuk sumber VidSts dan VidAuth.
Untuk menggunakan fitur unduhan video, Anda harus mengaktifkan dan mengonfigurasi mode unduhan di konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat unduhan offline.
Fitur unduhan video mendukung unduhan yang dapat dilanjutkan.
Prosedur
Opsional: Konfigurasikan file kunci untuk unduhan aman. Langkah ini hanya diperlukan untuk unduhan aman.
CatatanPastikan informasi dalam file kunci yang dikonfigurasi sesuai dengan informasi aplikasi Anda. Jika tidak, unduhan video akan gagal.
Jika Anda menggunakan mode unduhan aman, Anda harus mengonfigurasi ApsaraVideo Player SDK dengan file kunci yang Anda hasilkan di konsol ApsaraVideo VOD. File ini digunakan untuk dekripsi dan verifikasi selama unduhan dan pemutaran video. Untuk instruksi tentang cara menghasilkan file kunci, lihat Mengaktifkan unduhan aman.
Lakukan konfigurasi ini hanya sekali dalam aplikasi Anda, seperti yang ditunjukkan dalam contoh berikut:
NSString *encrptyFilePath = [[NSBundle mainBundle] pathForResource:@"encryptedApp" ofType:@"dat"]; [AliPrivateService initKey:encrptyFilePath];Buat dan konfigurasikan downloader.
Kode berikut memberikan contoh:
AliMediaDownloader *downloader = [[AliMediaDownloader alloc] init]; [downloader setSaveDirectory:self.downLoadPath]; [downloader setDelegate:self];Atur listener event.
Downloader mendukung beberapa listener event. Kode berikut memberikan contoh:
-(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info { // Item unduhan berhasil disiapkan. } -(void)onError:(AliMediaDownloader *)downloader errorModel:(AVPErrorModel *)errorModel { // Terjadi kesalahan selama unduhan. } -(void)onDownloadingProgress:(AliMediaDownloader *)downloader percentage:(int)percent { // Persentase progres unduhan. } -(void)onProcessingProgress:(AliMediaDownloader *)downloader percentage:(int)percent { // Persentase progres pemrosesan. } -(void)onCompletion:(AliMediaDownloader *)downloader { // Unduhan berhasil. }Siapkan sumber unduhan.
Panggil metode
prepareuntuk menyiapkan sumber unduhan. Sumber VidSts dan VidAuth didukung. Kode berikut memberikan contoh:VidSts
// Buat sumber VidSts. AVPVidStsSource* stsSource = [[AVPVidStsSource alloc] init]; stsSource.region = @"your_region"; // Wilayah layanan ApsaraVideo VOD Anda. Nilai default: cn-shanghai. stsSource.vid = @"your_video_id"; // ID video. stsSource.securityToken = @"<yourSecurityToken>"; // Token keamanan STS. Untuk mendapatkan token ini, panggil operasi AssumeRole STS. stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // Rahasia AccessKey dari kredensial STS sementara. Untuk mendapatkan rahasia ini, panggil operasi AssumeRole STS. stsSource.accessKeyId = @"<yourAccessKeyId>"; // AccessKey ID dari kredensial STS sementara. Untuk mendapatkan ID ini, panggil operasi AssumeRole STS. // Jika Anda telah mengaktifkan transmisi langsung parameter untuk enkripsi HLS di konsol ApsaraVideo VOD // dan nama parameter default adalah MtsHlsUriToken, Anda harus mengatur config dan meneruskannya ke sumber VidSts. // Jika fitur ini tidak diaktifkan, Anda dapat melewati kode berikut. VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init]; [vp setHlsUriToken:yourMtsHlsUriToken]; stsSource.playConfig = [vp generatePlayerConfig]; // Siapkan sumber unduhan. [downloader prepareWithVid:stsSource];VidAuth
// Buat sumber VidAuth. AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init]; authSource.vid = @"your_video_id"; // ID video. authSource.playAuth = @"<yourPlayAuth>"; // Kredensial pemutaran. Untuk mendapatkan kredensial ini, panggil operasi GetVideoPlayAuth ApsaraVideo VOD. authSource.region = @"your_region"; // Tidak digunakan lagi di ApsaraVideo Player SDK V5.5.5.0 dan yang lebih baru karena pemutar secara otomatis mengurai region. // Wajib untuk versi sebelumnya. // Wilayah layanan ApsaraVideo VOD Anda. Nilai default: cn-shanghai. // Jika Anda telah mengaktifkan transmisi langsung parameter untuk enkripsi HLS di konsol ApsaraVideo VOD // dan nama parameter default adalah MtsHlsUriToken, Anda harus mengatur config dan meneruskannya ke sumber VidAuth. // Jika fitur ini tidak diaktifkan, Anda dapat melewati kode berikut. VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init]; [vp setHlsUriToken:yourMtsHlsUriToken]; authSource.playConfig = [vp generatePlayerConfig]; // Siapkan sumber unduhan. [downloader prepareWithVid:authSource];
CatatanJika Anda mengaktifkan transmisi langsung parameter untuk enkripsi HLS di konsol ApsaraVideo VOD dan nama parameter default adalah MtsHlsUriToken, Anda harus mengatur nilai MtsHlsUriToken di sumber unduhan seperti yang ditunjukkan dalam kode di atas. Untuk informasi selengkapnya, lihat transmisi langsung parameter untuk enkripsi HLS.
Pilih track video setelah sumber disiapkan.
Setelah sumber unduhan disiapkan, metode
onPrepareddipanggil. ParametermediaInfodari callback berisi informasi tentang setiap track video yang tersedia, seperti kualitas video. Pilih track untuk diunduh. Kode berikut memberikan contoh:-(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info { NSArray<AVPTrackInfo*>* tracks = info.tracks; // Misalnya, untuk mengunduh track pertama: [downloader selectTrack:[tracks objectAtIndex:0].trackIndex]; }Perbarui sumber unduhan dan mulai unduhan.
Untuk mencegah kredensial VidSts dan VidAuth kedaluwarsa, disarankan untuk memperbarui informasi sumber sebelum Anda memulai unduhan. Kode berikut memberikan contoh:
// Perbarui sumber unduhan. [downloader updateWithVid:vidSource] // Mulai unduhan. [downloader start];Lepaskan downloader setelah unduhan selesai atau gagal.
Panggil metode
destroyuntuk melepaskan downloader.[self.downloader destroy]; self.downloader = nil;
Pemutaran terenkripsi
ApsaraVideo VOD mendukung enkripsi standar HLS, enkripsi proprietari Alibaba Cloud, dan Enkripsi DRM. Video live hanya mendukung Enkripsi DRM. Untuk informasi selengkapnya, lihat Pemutaran terenkripsi.
Pemutaran RTS Native
iOS player SDK mengintegrasikan Native RTS SDK untuk mengaktifkan live streaming latensi rendah. Untuk informasi selengkapnya, lihat Mengimplementasikan penarikan aliran berbasis RTS di iOS.