ApsaraVideo VOD:Fitur lanjutan

Verifikasi fitur lanjutan

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 lanjutan. Saat Anda menggunakan fitur lanjutan, pemutar memverifikasi lisensi dan mengembalikan hasilnya melalui callback ini. Jika isValid bernilai false, errorMsg berisi alasan kegagalannya.

Pemutaran

/**
 @brief Mode rendering alpha. Mendukung alpha di kanan, kiri, atas, atau bawah. Nilai default adalah none.
 @see AVPAlphaRenderMode
 */
@property(nonatomic) AVPAlphaRenderMode alphaRenderMode;

//--------------Penggunaan View-------------
// Untuk tampilan pemutar, atur warna latar belakang yang transparan.
@property (weak, nonatomic) IBOutlet UIView *mediaPlayerView;
[self.aliplayerview setBackgroundColor:UIColor.clearColor];

//-----------Penggunaan AliPlayer-----------
// Atur mode alpha.
[self.player setAlphaRenderMode:AVP_RENDERMODE_ALPHA_AT_LEFT];
// Atur aset yang sesuai dengan mode alpha.
AVPUrlSource *source = [[AVPUrlSource alloc] urlWithString:@"https://alivc-player.oss-cn-shanghai.aliyuncs.com/video/business_needs_sample/alpha_channel/alpha_left.mp4"];
[self.player setUrlSource:source];

// Opsional: Jika Anda mengalami artefak visual setelah pemutaran selesai, Anda dapat membersihkan layar.
#pragma mark -- AVPDelegate
- (void)onPlayerEvent:(AliPlayer *)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventCompletion:
        {
            [player clearScreen];
        }
            break;
        //...
    }
}

[self.player setAutoPlay: YES];
[self.player prepare];

/**
 @brief Menentukan jenis render video. Nilai valid: 0 (renderer default) dan 1 (renderer campuran). Default: 0.
 */
@property(nonatomic, assign) int videoRenderType;

AVPConfig *config = [self.player getConfig];
// Aktifkan rendering Metal.
config.videoRenderType = 1;
[self.player setConfig:config];
[self.player prepare];

AVPConfig *config = [self.player getConfig];
config.disableVideo = YES;
[self.player setConfig:config];

// Aktifkan decoding hardware (diaktifkan secara default).
self.player.enableHardwareDecoder = YES;

-(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

// Lapisan aplikasi harus mempertahankan 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];

AVPMediaInfo *info = [self.player getMediaInfo];
NSArray<AVPTrackInfo*>* tracks = info.tracks;

// Ganti ke stream tertentu.
[self.player selectTrack:track.trackIndex];
// Aktifkan streaming bitrate adaptif.
[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];

- (void)onTrackChanged:(AliPlayer*)player info:(AVPTrackInfo*)info {
    if (info.trackType == AVPTRACK_TYPE_VIDEO) {
        // Track video telah berubah.
    }
    // dll
}

AVPConfig *config = [self.player getConfig];
config.maxAllowedAbrVideoPixelNumber = 921600; // Atur jumlah piksel maksimum untuk ABR menjadi 921600 (1280 * 720). Ini memastikan bahwa pemutar hanya beralih ke definisi dengan jumlah piksel kurang dari atau sama dengan nilai ini.
[self.player setConfig:config];

Snapshot

// Callback snapshot
- (void)onCaptureScreen:(AliPlayer *)player image:(UIImage *)image {
    // Proses snapshot.
}
// Ambil snapshot frame saat ini.
[self.player snapShot];

Pratinjau

ApsaraVideo Player SDK untuk iOS mendukung fitur pratinjau saat dikonfigurasi dengan ApsaraVideo VOD. SDK mendukung pemutaran VidSts dan VidAuth. VidAuth adalah metode yang direkomendasikan. Untuk informasi lebih lanjut, lihat Pratinjau video.

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

Atur Referer

// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur Referer.
config.referer = referer;
....// Pengaturan lainnya.
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];

User-Agent

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

Konfigurasikan jumlah retry jaringan dan timeout

// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur timeout jaringan dalam milidetik.
config.networkTimeout = 5000;
// Atur jumlah maksimum retry. Interval retry ditentukan oleh networkTimeout. Nilai 0 menonaktifkan retry, memungkinkan aplikasi mengimplementasikan kebijakan retry sendiri. Default adalah 2.
config.networkRetryCount = 2;
//... Pengaturan lainnya
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];

Kontrol cache dan latensi

// Ambil konfigurasi.
AVPConfig *config = [self.player getConfig];
// Latensi maksimum dalam milidetik. Catatan: Parameter ini hanya untuk streaming langsung. Jika latensi menjadi tinggi, Player SDK menyinkronkan frame untuk menjaganya dalam batas ini.
config.maxDelayTime = 5000;
// Durasi maksimum (dalam milidetik) data yang dapat dibuffer oleh pemutar.
config.maxBufferDuration = 50000;
// Durasi buffer tinggi dalam milidetik. Saat kondisi jaringan buruk, pemutar berhenti memuat data begitu 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 tersendat segera setelah pemutaran dimulai.
config.startBufferDuration = 500;
// Pengaturan lainnya.
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];

Atur Header HTTP

// Dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Definisikan 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

Aktifkan PiP

- (void)onPlayerEvent:(AliPlayer *)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventPrepareDone:
        {
            [self.player setPictureInPictureEnable:YES];
        }
            break;
        default:
            break;
    }
}

Tetapkan delegate PiP

Contoh kode berikut menunjukkan interaksi umum antara jendela Picture-in-Picture (PiP) dan pemutar. Interaksi ini mencakup menampilkan kontrol pemutaran seperti jeda, putar, maju cepat, dan mundur cepat, serta mengimplementasikan logika putar ulang. Untuk referensi lengkap metode delegasi, lihat file header AliPlayerPictureInPictureDelegate.h, yang terletak di AliyunPlayer.framework dalam folder SDK dari demo player SDK.

1. Atur delegasi Picture-in-Picture.

   /**
   * @brief Mengatur delegasi untuk event Picture-in-Picture.
   */
   -(void) setPictureinPictureDelegate:(id<AliPlayerPictureInPictureDelegate>)delegate;
   
   
   // Atur delegasi Picture-in-Picture.
   [self.player setPictureinPictureDelegate:self];

2. Tambahkan properti dan implementasikan metode delegasi.

   1. Tambahkan properti ke view controller Anda untuk mengelola status pemutar dan jendela Picture-in-Picture.

      #import "YourUIViewController.h"
      #import <AliyunPlayer/AliyunPlayer.h>
      
      @interface YourUIViewController () <AVPDelegate, AliPlayerPictureInPictureDelegate>
      // Instans pemutar.
      @property (nonatomic, strong) AliPlayer *player;
      // Tampilan kontainer untuk pemutar.
      @property (nonatomic, strong) UIView *playerView;
      // Melacak apakah jendela Picture-in-Picture dijeda.
      @property (nonatomic, assign) BOOL isPipPaused;
      // Melacak status pemutaran saat ini pemutar, diperbarui oleh callback onPlayerStatusChanged:oldStatus:newStatus:.
      @property (nonatomic, assign) AVPStatus currentPlayerStatus;
      // Referensi lemah ke pengontrol picture-in-picture. Ini diatur dalam callback pictureInPictureControllerWillStartPictureInPicture: dan harus diatur ke nil sebelum view controller dealokasi. Menggunakan referensi lemah direkomendasikan.
      @property (nonatomic, weak) AVPictureInPictureController *pipController;
      // Melacak progres pemutaran, diperbarui oleh parameter 'position' dalam callback progres pemutaran.
      @property (nonatomic, assign) int64_t currentPosition;
      
      @end

      Catatan

      Properti pipController harus dideklarasikan dengan atribut weak atau assign untuk mencegah siklus retensi. Jika Anda menggunakan assign, atur properti tersebut ke nil secara manual pada waktu yang tepat.

   2. Dalam metode delegasi onPlayerStatusChanged: Anda, beri tahu pengontrol picture-in-picture untuk memperbarui statusnya.

      - (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus {
          self.currentPlayerStatus = newStatus;
      
        if (_pipController) {
           [self.pipController invalidatePlaybackState];
         }
      }

   3. Dalam metode delegasi onPlayerEvent: Anda, perbarui status Picture-in-Picture 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 pencarian selesai.
            if (_pipController) {
             [self.pipController invalidatePlaybackState];
          }
        }
      }

   4. Implementasikan metode delegasi.

      • Implementasikan callback untuk saat Picture-in-Picture akan dimulai.

        /**
         @brief Memberi tahu delegasi bahwa Picture-in-Picture akan dimulai.
         @param pictureInPictureController Pengontrol picture-in-picture.
         */
        - (void)pictureInPictureControllerWillStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            if (!_pipController) {
             self.pipController = pictureInPictureController;
          }
            self.isPipPaused = !(self.currentPlayerStatus == AVPStatusStarted);
          [pictureInPictureController invalidatePlaybackState];
        }

      • Implementasikan callback untuk saat Picture-in-Picture akan dihentikan.

        /**
         @brief Memberi tahu delegasi bahwa Picture-in-Picture akan dihentikan.
         @param pictureInPictureController Pengontrol picture-in-picture.
         */
        - (void)pictureInPictureControllerWillStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            self.isPipPaused = NO;
          [pictureInPictureController invalidatePlaybackState];
        }

      • Implementasikan callback untuk memulihkan UI sebelum Picture-in-Picture dihentikan.

        /**
         @brief Memberi tahu delegasi untuk memulihkan antarmuka pengguna sebelum Picture-in-Picture dihentikan.
         @param pictureInPictureController Pengontrol picture-in-picture.
         @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 delegasi untuk rentang waktu yang dapat diputar saat ini.
         @param pictureInPictureController Pengontrol picture-in-picture.
         @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 delegasi apakah pemutaran saat ini dijeda.
         @param pictureInPictureController Pengontrol picture-in-picture.
         @return Nilai Boolean yang menunjukkan apakah pemutaran dijeda.
         */
        - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{
            return self.isPipPaused;
        }

        Catatan

        Callback ini dipanggil sebelum Picture-in-Picture dimulai. Callback ini harus mengembalikan false pada titik ini agar jendela PiP dapat diluncurkan. Mengembalikan true mencegah Picture-in-Picture dimulai.

      • Implementasikan callback untuk menangani tindakan maju cepat dan mundur cepat dari kontrol Picture-in-Picture.

        /**
         @brief Memberi tahu delegasi bahwa pengguna telah meminta untuk maju cepat atau mundur cepat.
         @param pictureInPictureController Pengontrol picture-in-picture.
         @param skipInterval Interval waktu untuk dilewati.
         @param completionHandler Handler penyelesaian yang harus Anda panggil setelah operasi pencarian 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 Picture-in-Picture.

        /**
         @brief Memberi tahu delegasi bahwa pengguna telah mengaktifkan/menonaktifkan tombol putar/jeda.
         @param pictureInPictureController Pengontrol picture-in-picture.
         @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 secara default di luar aplikasi. Untuk mengimplementasikan gambar-dalam-gambar dalam aplikasi, pertama-tama panggil antarmuka berikut untuk memeriksa apakah gambar-dalam-gambar aktif:

/**
 @brief Memberi tahu delegasi apakah gambar-dalam-gambar diaktifkan.
 @param pictureInPictureController Pengontrol picture-in-picture 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];
    }
}

// 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: Memutar hanya saluran audio kiri.
// AVP_AUDIO_CHANNEL_RIGHT: Memutar hanya saluran audio kanan.
self.player.outputAudioChannel = AVP_AUDIO_CHANNEL_NONE;

/**
 @brief
 @param color  warna
 */
/****
 @brief Mengatur warna latar belakang video.
 @param color Warna latar belakang.
 */
-(void) setVideoBackgroundColor:(UIColor *)color;

// Parameter adalah nilai heksadesimal 8 digit dalam format ARGB (alpha, merah, hijau, biru).
// Misalnya, 0x0000ff00 merepresentasikan hijau.
[self.player setVideoBackgroundColor:0x0000ff00]

/**
 @brief Putar video menggunakan ID video dan kredensial pemutaran (PlayAuth). Untuk informasi lebih lanjut, 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;

VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
// Tambahkan bidang playDomain. Untuk daftar bidang 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]:

// Atur ke 1 untuk mengaktifkan decoding latar belakang atau 0 untuk menonaktifkannya. Default: 0.
[self.player setOption:ALLOW_DECODE_BACKGROUND valueInt:1];

// Ganti x.x.x dengan versi Player SDK Anda.
pod 'AliPlayerSDK_iOS_VVC_CODEC_PLUGIN', 'x.x.x'

// Ganti x.x.x dengan versi SDK all-in-one Anda.
pod 'AliVCSDK_Standard/AliPlayerSDK_iOS_VVC_CODEC', 'x.x.x'

[AliPlayerGlobalSettings enableCodecPlugin:@"vvc" valid:true];

/**
 @brief Mengatur callback untuk notifikasi kedaluwarsa sumber VidAuth.

 Callback ini dipicu saat pemutar mendeteksi bahwa sumber VidAuth saat ini telah kedaluwarsa. Sumber VidAuth kedaluwarsa jika PlayAuth atau URL pemutaran telah kedaluwarsa.
 Anda dapat menyegarkan 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;

/**
 @protocol AVPSourceRefreshCallback
 @brief Protokol untuk menangani hasil penyegaran sumber, yang harus Anda implementasikan.

 Protokol ini memberi tahu aplikasi Anda saat pemutar meminta penyegaran sumber, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil penyegaran,
 termasuk keberhasilan atau kegagalan.

 @note Protokol ini berlaku untuk sumber URL, sumber VidAuth, dan skenario serupa yang memerlukan logika penyegaran.
 */
@protocol AVPSourceRefreshCallback <NSObject>

/**
 @brief Dipanggil oleh pemutar saat operasi penyegaran berhasil.
 
 @param newSource Objek sumber baru yang berisi informasi yang diperbarui.

 Metode ini menunjukkan bahwa operasi penyegaran telah berhasil diselesaikan. Anda harus meneruskan
 `newSource` yang diperbarui kembali ke pemutar agar dapat memuat resource baru.
 */
- (void)onSuccess:(id)newSource;

/**
 @brief Dipanggil oleh pemutar saat operasi penyegaran gagal.
 
 @param errorMsg String yang menjelaskan alasan kegagalan.

 Metode ini menunjukkan bahwa operasi penyegaran telah gagal. Anda dapat menggunakan `errorMsg` untuk menangkap detail kegagalan
 dan menangani kesalahan tersebut.
 */
- (void)onError:(NSString *)errorMsg;

@end

[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 kesalahan.
            [callback onError:errorMsg];
        }];
        // ------------------- Akhir implementasi pengguna -------------------
    }
}];

/**
 @brief Mengatur callback untuk notifikasi kedaluwarsa sumber URL.

 Callback ini dipicu saat pemutar mendeteksi bahwa sumber URL saat ini telah kedaluwarsa.
 Anda dapat menyegarkan sumber URL dalam callback ini dan mengembalikan sumber URL baru melalui parameter `callback` untuk memastikan pemutaran berkelanjutan.

 @note Untuk informasi lebih lanjut 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 memberikan objek `URLSource` yang valid untuk memperbarui pemutar.
 */
-(void)setOnURLSourceExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief Protokol untuk menangani hasil penyegaran sumber, yang harus Anda implementasikan.

 Protokol ini memberi tahu aplikasi Anda saat pemutar meminta penyegaran sumber, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil penyegaran,
 termasuk keberhasilan atau kegagalan.

 @note Protokol ini berlaku untuk sumber URL, sumber VidAuth, dan skenario serupa yang memerlukan logika penyegaran.
 */
@protocol AVPSourceRefreshCallback <NSObject>

/**
 @brief Dipanggil oleh pemutar saat operasi penyegaran berhasil.
 
 @param newSource Objek sumber baru yang berisi informasi yang diperbarui.

 Metode ini menunjukkan bahwa operasi penyegaran telah berhasil diselesaikan. Anda harus meneruskan
 `newSource` yang diperbarui kembali ke pemutar agar dapat memuat resource baru.
 */
- (void)onSuccess:(id)newSource;

/**
 @brief Dipanggil oleh pemutar saat operasi penyegaran gagal.
 
 @param errorMsg String yang menjelaskan alasan kegagalan.

 Metode ini menunjukkan bahwa operasi penyegaran telah gagal. Anda dapat menggunakan `errorMsg` untuk menangkap detail kegagalan
 dan menangani kesalahan tersebut.
 */
- (void)onError:(NSString *)errorMsg;

@end

[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, anggap 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"];
        }
    }
}];

#import "CdnAuthUtil.h"
#import <CommonCrypto/CommonDigest.h>

@implementation CdnAuthUtil

#pragma mark - Auth Method A
+ (NSString *)aAuthWithUri:(NSString *)uri key:(NSString *)key exp:(NSTimeInterval)exp {
    NSDictionary *components = [self matchUri:uri];
    if (!components) return nil;

    NSString *scheme = components[@"scheme"];
    NSString *host = components[@"host"];
    NSString *path = components[@"path"];
    NSString *args = components[@"args"];

    NSString *rand = @"0";
    NSString *uid = @"0";

    NSString *sstring = [NSString stringWithFormat:@"%@-%lld-%@-%@-%@", path, (long long)exp, rand, uid, key];
    NSString *hashvalue = [self md5sum:sstring];
    NSString *authKey = [NSString stringWithFormat:@"%lld-%@-%@-%@", (long long)exp, rand, uid, hashvalue];

    if (args.length > 0) {
        return [NSString stringWithFormat:@"%@%@%@%@&auth_key=%@", scheme, host, path, args, authKey];
    } else {
        return [NSString stringWithFormat:@"%@%@%@%@?auth_key=%@", scheme, host, path, args, authKey];
    }
}

#pragma mark - Private Helper: MD5
+ (NSString *)md5sum:(NSString *)src {
    const char *cStr = [src UTF8String];
    unsigned char result[CC_MD5_DIGEST_LENGTH];
    CC_MD5(cStr, (unsigned int)strlen(cStr), result);

    NSMutableString *hexString = [NSMutableString string];
    for (int i = 0; i < CC_MD5_DIGEST_LENGTH; i++) {
        [hexString appendFormat:@"%02x", result[i]];
    }
    return hexString.copy;
}

#pragma mark - Private Helper: Regex Match
+ (NSDictionary *)matchUri:(NSString *)uri {
    NSError *error = nil;
    NSRegularExpression *regex = [NSRegularExpression regularExpressionWithPattern:@"^(https?://)?([^/?]+)(/[^?]*)?(\\?.*)?$"
                                  options:0
                                  error:&error];
    if (error) {
        NSLog(@"Regex error: %@", error.localizedDescription);
        return nil;
    }

    NSTextCheckingResult *match = [regex firstMatchInString:uri
                                   options:0
                                   range:NSMakeRange(0, uri.length)];
    if (!match) return nil;

    __block NSString *scheme = nil, *host = nil, *path = nil, *args = nil;

    void (^setStringFromRange)(NSInteger, NSString**) = ^(NSInteger idx, NSString **outStr) {
        NSRange range = [match rangeAtIndex:idx];
        if (range.location != NSNotFound && range.length > 0) {
            *outStr = [uri substringWithRange:range];
        } else {
            *outStr = nil;
        }
    };

    setStringFromRange(1, &scheme);
    setStringFromRange(2, &host);
    setStringFromRange(3, &path);
    setStringFromRange(4, &args);

    // Tangani nilai default.
    if (!scheme) scheme = @"http://";
    if (!path) path = @"/";

    return @{
        @"scheme": scheme,
        @"host": host,
        @"path": path,
        @"args": args ?: @""
        };
}
@end

// x.x.x harus sesuai dengan versi player SDK.
pod 'AliPlayerSDK_iOS_AUDIO_ENHANCE_FILTER', 'x.x.x'

[player setFilterValid:@"audioEnhance" valid:YES];  // Aktifkan
[player setFilterValid:@"audioEnhance" valid:NO];   // Nonaktifkan

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 Anda 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 Anda pertama kali mengaktifkan peningkatan dialog.
// Normalisasi volume
[opts setOptions:@"enable_normalizer" value:@YES];

[filterItem setOptions:opts];
[filterConfig addFilter:filterItem];
[player setFilterConfig:filterConfig];

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. Diabaikan pada panggilan berikutnya karena filter sudah diinisialisasi.
[player updateFilterConfig:@"audioEnhance" options:opts];

Kinerja

Atur skenario pemutar

Mengatur skenario pemutar secara otomatis menerapkan parameter optimal untuk skenario tersebut, seperti pengaturan buffer dan toggle fitur. Parameter kustom yang Anda atur dengan metode setConfig menggantikan default skenario.

Contoh API

/**
 @brief Mengatur skenario pemutar.
 @param scene Skenario pemutar.
 @see AVPScene
 */
-(void) setPlayerScene:(AVPScene)scene;

Skenario pemutar

typedef enum _AVPScene {
    /**
     * Tidak ada skenario khusus yang diatur.
     */
    SceneNone,
    /**
     * Skenario video panjang, cocok untuk video lebih dari 30 menit.
     */
    SceneLong,
    /**
     * Skenario video menengah, cocok untuk video antara 5 hingga 30 menit.
     */
    SceneMedium,
    /**
     * Skenario video pendek, cocok untuk video hingga 5 menit.
     */
    SceneShort,
    /**
     * Skenario streaming langsung.
     */
    SceneLive,
    /**
     * Skenario RTS langsung.
     */
    SceneRTSLive
} AVPScene;

Penggunaan

// Atur skenario video pendek.
[self.player setPlayerScene:SceneShort];

// Atur skenario video menengah.
[self.player setPlayerScene:SceneMedium]; 

// Atur skenario video panjang.
[self.player setPlayerScene:SceneLong];  

// Atur skenario streaming langsung.
[self.player setPlayerScene:SceneLive];   

Pre-rendering

[self.player setOption:ALLOW_PRE_RENDER valueInt:1];

Cache lokal

Alibaba Cloud Player SDK untuk iOS menyediakan fitur cache lokal. Fitur ini meningkatkan kecepatan startup dan kecepatan pencarian, mengurangi tersendat, dan menghemat lalu lintas jaringan selama pemutaran berulang.

Aktifkan cache lokal

/**
 * 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 lebih baru dan 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 lebih baru dan tidak berpengaruh.
 @param maxCapacityMB Ukuran cache maksimum dalam MB. Nilai default: 20 GB. Selama pembersihan, jika ukuran total cache melebihi batas ini, item cache terlama dihapus satu per satu hingga ukuran total 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 cache dihapus.
 */
[AliPlayerGlobalSettings setCacheFileClearConfig:0 maxCapacityMB:0 freeStorageMB:0];

/**
 * Callback untuk mendapatkan nilai hash 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 pointer-nya ke setCacheUrlHashCallback.
static NSString *CaheUrlHashHandle(NSString *url) {
    return @"xxx";
}

[AliPlayerGlobalSettings setCacheUrlHashCallback:&CaheUrlHashHandle];

Aktifkan atau nonaktifkan cache untuk URL

// 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 diatur ke false, caching lokal dinonaktifkan untuk URL ini.
config.enableLocalCache = false;
....// Pengaturan lainnya

// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];

[AliPlayerGlobalSettings enableLocalCache:true];

Preloading

Alibaba Cloud Player SDK untuk iOS menyediakan fitur preloading, yang merupakan peningkatan dari cache lokal. Preloading mengunduh sebagian video ke cache sebelum pemutaran dimulai, meningkatkan kecepatan startup.

[AliPlayerGlobalSettings enableNetworkBalance:false];

1. Aktifkan fitur cache lokal seperti yang dijelaskan di Cache lokal.

2. Atur sumber data.

   VidAuth (direkomendasikan)

   AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init];
   [vidAuthSource setVid:@"your_video_id"]; // Wajib. ID video.
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // Wajib. Kredensial pemutaran. Anda harus memanggil operasi GetVideoPlayAuth ApsaraVideo untuk VOD untuk menghasilkan kredensial.
   [vidAuthSource setRegion:@"your_region"]; // Parameter ini tidak digunakan lagi di SDK v5.5.5.0 dan lebih baru. Pemutar secara otomatis mengurai wilayah. Untuk versi sebelumnya, parameter ini wajib dan default ke 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 STS untuk mendapatkan token.
   [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // Wajib. Rahasia AccessKey dari pasangan kunci akses STS sementara. Anda harus memanggil operasi API AssumeRole STS untuk mendapatkan rahasia AccessKey.
   [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // Wajib. ID AccessKey dari pasangan kunci akses STS sementara. Anda harus memanggil operasi API AssumeRole STS untuk mendapatkan ID AccessKey.
   [vidStsSource setQuality:@""]; // "AUTO" menentukan streaming bitrate adaptif.

   UrlSource

   NSString* url = @"your_playback_url"; // Wajib. URL pemutaran. Dapat berupa URL VOD pihak ketiga atau URL pemutaran dari ApsaraVideo untuk VOD.
   AVPUrlSource* urlSource = [[AVPUrlSource alloc]urlWithString:url];

3. Atur parameter tugas.

   Catatan

   Parameter ini hanya berlaku untuk video multi-bitrate. Anda hanya perlu mengatur salah satu dari setDefaultBandWidth, setDefaultResolution, dan setDefaultQuality.

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

4. Tambahkan listener tugas.

   Contoh kode

   @interface YourViewController () <OnPreloadListener>
   
   @property(nonatomic,strong) AliMediaLoaderV2* vodMedialoader; // Preloader.
   @property(nonatomic,strong) AVPVidAuthSource* vidSource; // Sumber data VidAuth.
   @property(nonatomic,strong) AVPUrlSource* urlSource; // Sumber data UrlSource.
   @property(nonatomic,strong) AVPVidStsSource* vidStsSource; // Sumber data VidSts.
   
   @end
   
   @implementation YourViewController
   
   - (void)onCompleted:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"Tugas saat ini (%@) selesai: %@", taskId,urlOrVid);
   }
   
   - (void)onError:(NSString *)taskId urlOrVid:(NSString *)urlOrVid errorModel:(AVPErrorModel *)errorModel {
       NSLog(@"Terjadi kesalahan: %@", urlOrVid);
   }
   
   - (void)onCanceled:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"Tugas dibatalkan: %@", urlOrVid);
   }
   
   @end

5. Buat tugas, tambahkan ke instans MediaLoaderV2, dan mulai preloading.

   VidAuth (direkomendasikan)

   // Buat tugas preload.
   AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithVidAuthSource:vidAuthSource preloadConfig:config];
   // Dapatkan instans MediaLoaderV2.
   AliMediaLoaderV2* vodMedialoader = [AliMediaLoaderV2 shareInstance];
   // Tambahkan tugas dan mulai preloading.
   NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];

   VidSts

   // Buat tugas preload.
   AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithVidStsSource:vidStsSource preloadConfig:config];
   // Dapatkan instans MediaLoaderV2.
   AliMediaLoaderV2* vodMedialoader = [[AliMediaLoaderV2 alloc]init];
   // Tambahkan tugas dan mulai preloading.
   NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];

   UrlSource

   // Buat tugas preload.
   AVPPreloadTask* mPreloadTask = [[AVPPreloadTask alloc]initWithUrlSource:urlSource preloadConfig:config];
   // Dapatkan instans MediaLoaderV2.
   AliMediaLoaderV2* vodMedialoader = [[AliMediaLoaderV2 alloc]init];
   // Tambahkan tugas dan mulai preloading.
   NSString* taskId = [vodMedialoader addTask:mPreloadTask listener:self];

6. Opsi: Kelola tugas.

   [vodMedialoader cancelTask:taskId];// Batalkan tugas preload dengan ID yang ditentukan.
   [vodMedialoader pauseTask:taskId];// Jeda tugas preload dengan ID yang ditentukan.
   [vodMedialoader resumeTask:taskId];// Lanjutkan tugas preload dengan ID yang ditentukan.

7. Opsional: Hapus file yang diunggah.

   Untuk menghemat ruang, Anda dapat menghapus file 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 dipreloading. Hal ini membantu Anda menyeimbangkan pengalaman pemutaran dengan biaya.

// Aktifkan konfigurasi yang direkomendasikan dan preloading dinamis.
[self.listPlayer setScene:AVP_SHORT_VIDEO];

// Konfigurasikan durasi preload dasar.
// Atur durasi preload ke 1.000 ms.
AVPPreloadConfig *config = [[AVPPreloadConfig alloc] init];
config.preloadDuration = 1000;
[self.listPlayer updatePreloadConfig:config];

// Konfigurasikan jumlah item yang akan dipreloading. Ini mendukung preloading ke dua arah.
// 1 adalah jumlah item sebelumnya yang akan dipreloading, dan 3 adalah jumlah item berikutnya yang akan dipreloading.
[self.listPlayer setPreloadCount:1 nextCount:3];

// Konfigurasikan offset penurunan untuk preloading dinamis.
[self.listPlayer enableStrategy:AVP_STRATEGY_DYNAMIC_PRELOAD enable:true];
[self.listPlayer setStrategyParam:AVP_STRATEGY_DYNAMIC_PRELOAD strategyParam:@"{\"algorithm\": \"sub\",\"offset\": \"200\"}"];

typedef enum AVPMultiBitratesMode : NSUInteger {
    /**
     * Konfigurasi default. Memutar dan mempreloading bitrate default.
     */
    AVPMultiBitratesMode_Default = 0,
    /**
     * Mengutamakan time to first frame yang cepat. Pemutar mulai dengan memutar bitrate yang telah selesai dipreloading.
     */
    AVPMultiBitratesMode_FCPrio = 1,
    /**
     * Menyeimbangkan time to first frame yang cepat dengan pemutaran yang lancar. Pemutar berusaha memutar bitrate yang sama sebelum dan sesudah panggilan `moveToNext`.
     */
    AVPMultiBitratesMode_FC_AND_SMOOTH = 2,
    /**
     * Mengutamakan pemutaran yang lancar. Pemutar berusaha memulai video berikutnya pada bitrate yang sama dengan video sebelumnya.
     */
    AVPMultiBitratesMode_SmoothPrio = 3,
} AVPMultiBitratesMode;

// Pilih mode pemuatan multi-bitrate.
[self.listPlayer->SetMultiBitratesMode(preLoadMode)];

// Opsional: Pilih bitrate startup.
[self.listPlayer setDefaultBandWidth:defaultBandWidth];

// Opsional: Dalam callback onPlayerEvent untuk AVPEventPrepareDone, pilih mode bitrate adaptif (ABR).
-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventPrepareDone: {
            [self.listPlayer selectTrack:-1];
        }
            break;
        case AVPEventFirstRenderedStart: {
        }
            break;
        default:
            break;
    }
}

Kecepatan unduh

- (void)onCurrentDownloadSpeed:(AliPlayer *)player speed:(int64_t)speed{
  intspeed_=speed;
}

Fitur jaringan

// Aktifkan HTTPDNS yang ditingkatkan.
[AliPlayerGlobalSettings enableEnhancedHttpDns:YES];
// Opsional. Tambahkan nama domain untuk pra-resolusi HTTPDNS.
[[AliDomainProcessor shareInstance] addPreResolveDomain:@"player.***alicdn.com"];

[AliPlayerGlobalSettings setUseHttp2:true];

// Format domain adalah host[:port]. Port opsional. Gunakan titik koma (;) untuk memisahkan beberapa nama domain.
// Pengaturan global.
// Ini adalah pengaturan absolut. Setiap kali Anda memanggil metode ini, string baru menggantikan yang sebelumnya. String kosong menonaktifkan koneksi awal.
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];

Unduh video

ApsaraVideo Player SDK untuk iOS memungkinkan Anda mengunduh konten ApsaraVideo VOD untuk pemutaran offline. SDK menawarkan dua mode unduh: unduh standar dan unduh aman.

• Unduh standar: Data video yang diunduh tidak dienkripsi oleh Alibaba Cloud dan dapat diputar menggunakan pemutar pihak ketiga.

• Unduh 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 unduh video hanya tersedia untuk sumber VidSts dan VidAuth.

• Untuk menggunakan fitur unduh video, Anda harus mengaktifkan dan mengonfigurasi mode unduh di konsol ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat unduh offline.

• Fitur unduh video mendukung unduhan yang dapat dilanjutkan.

Prosedur

1. Opsi: Konfigurasikan file kunci untuk unduh aman. Langkah ini hanya diperlukan untuk unduh aman.

   Catatan

   Pastikan informasi dalam file kunci yang dikonfigurasi sesuai dengan informasi aplikasi Anda. Jika tidak, unduh video akan gagal.

   Jika Anda menggunakan mode unduh 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 unduh dan pemutaran video. Untuk instruksi cara menghasilkan file kunci, lihat Aktifkan unduh aman.

   Lakukan konfigurasi ini hanya sekali dalam aplikasi Anda, seperti pada contoh berikut:

   NSString *encrptyFilePath = [[NSBundle mainBundle] pathForResource:@"encryptedApp" ofType:@"dat"];
   [AliPrivateService initKey:encrptyFilePath];

2. Buat dan konfigurasikan downloader.

   Kode berikut memberikan contoh:

   AliMediaDownloader *downloader = [[AliMediaDownloader alloc] init];
   [downloader setSaveDirectory:self.downLoadPath];
   [downloader setDelegate:self];

3. Atur listener event.

   Downloader mendukung beberapa listener event. Kode berikut memberikan contoh:

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       // Item unduh berhasil disiapkan.
   }
   -(void)onError:(AliMediaDownloader *)downloader errorModel:(AVPErrorModel *)errorModel {
       // Terjadi kesalahan selama unduh.
   }
   -(void)onDownloadingProgress:(AliMediaDownloader *)downloader percentage:(int)percent {
       // Persentase progres unduh.
   }
   -(void)onProcessingProgress:(AliMediaDownloader *)downloader percentage:(int)percent {
       // Persentase progres pemrosesan.
   }
   -(void)onCompletion:(AliMediaDownloader *)downloader {
       // Unduh berhasil.
   }

4. Siapkan sumber unduh.

   Panggil metode prepare untuk menyiapkan sumber unduh. 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 STS AssumeRole.
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // Rahasia AccessKey dari kredensial STS sementara. Untuk mendapatkan rahasia ini, panggil operasi STS AssumeRole.
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // ID AccessKey dari kredensial STS sementara. Untuk mendapatkan ID ini, panggil operasi STS AssumeRole.
     
     // Jika Anda telah mengaktifkan pass-through 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 unduh.
     [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 ApsaraVideo VOD GetVideoPlayAuth.
     authSource.region = @"your_region"; // Tidak digunakan lagi di ApsaraVideo Player SDK V5.5.5.0 dan lebih baru karena pemutar secara otomatis mengurai wilayah.
     // Wajib untuk versi sebelumnya.
     // Wilayah layanan ApsaraVideo VOD Anda. Nilai default: cn-shanghai.
     // Jika Anda telah mengaktifkan pass-through 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 unduh.
     [downloader prepareWithVid:authSource];

   Catatan

   Jika Anda mengaktifkan pass-through parameter untuk enkripsi HLS di konsol ApsaraVideo VOD dan nama parameter default adalah MtsHlsUriToken, Anda harus mengatur nilai MtsHlsUriToken dalam sumber unduh seperti yang ditunjukkan dalam kode di atas. Untuk informasi lebih lanjut, lihat pass-through parameter untuk enkripsi HLS.

5. Pilih track video setelah sumber disiapkan.

   Setelah sumber unduh disiapkan, metode onPrepared dipanggil. Parameter mediaInfo dari 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];
   }

6. Perbarui sumber unduh dan mulai unduh.

   Untuk mencegah kredensial VidSts dan VidAuth kedaluwarsa, kami merekomendasikan memperbarui informasi sumber sebelum Anda memulai unduh. Kode berikut memberikan contoh:

   // Perbarui sumber unduh.
   [downloader updateWithVid:vidSource]
   // Mulai unduh.
   [downloader start];

7. Lepaskan downloader setelah unduh selesai atau gagal.

   Panggil metode destroy untuk melepaskan downloader.

   [self.downloader destroy];
   self.downloader = nil;

Pemutaran terenkripsi

ApsaraVideo VOD mendukung enkripsi standar HLS, enkripsi eksklusif Alibaba Cloud, dan enkripsi DRM. Video langsung hanya mendukung enkripsi DRM. Untuk informasi lebih lanjut, lihat Pemutaran terenkripsi.

Pemutaran RTS native

iOS player SDK mengintegrasikan Native RTS SDK untuk mengaktifkan streaming langsung berlatensi rendah. Untuk informasi lebih lanjut, lihat Implementasikan penarikan aliran berbasis RTS di iOS.

Referensi

• Referensi API

• Kode kesalahan seluler

• FAQ pemutar iOS