ApsaraVideo VOD:Fitur lanjutan

Konfirmasi keterampilan profesional

Tetapkan listener saat aplikasi Anda dimulai atau sebelum memanggil operasi 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 kemampuan profesional. Saat Anda menggunakan fitur terkait, pemutar memverifikasi kemampuan tersebut dan mengembalikan hasil verifikasi melalui callback ini. Jika isValid bernilai false, errorMsg berisi alasan spesifiknya.

Pemutaran

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

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

//-----------Penggunaan AliPlayer-----------
// Tetapkan mode alpha.
[self.player setAlphaRenderMode:AVP_RENDERMODE_ALPHA_AT_LEFT];
// Tetapkan materi yang sesuai dengan mode alpha.
AVPUrlSource *source = [[AVPUrlSource alloc] urlWithString:@"https://alivc-player.oss-cn-shanghai.aliyuncs.com/video/%E4%B8%9A%E5%8A%A1%E9%9C%80%E6%B1%82%E6%A0%B7%E6%9C%AC/alpha%E9%80%9A%E9%81%93/alpha_left.mp4"];
[self.player setUrlSource:source];

// Opsi: Bersihkan layar setelah pemutaran selesai untuk mencegah artefak visual.
#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 Jenis render video, 0 berarti render default; 1 berarti render campuran. Default adalah 0.
 */
/****
 @brief jenis render video, 0 berarti render default; 1 berarti render campuran.
 */
@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 perangkat keras. 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 perangkat lunak.
    }
}

Pemutaran adaptif H.265

// Lapisan aplikasi memelihara peta URL asli ke URL cadangan.
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 bitrate tertentu.
[self.player selectTrack:track.trackIndex];
// Aktifkan pergantian bitrate adaptif.
[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];

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

AVPConfig *config = [self.player getConfig];
config.maxAllowedAbrVideoPixelNumber = 921600;// Tetapkan jumlah piksel maksimum yang diizinkan untuk ABR ke 1280x720. Pemutar hanya akan beralih ke definisi dengan jumlah piksel kurang dari atau sama dengan nilai ini.
[self.player setConfig:config];

Ambil snapshot

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

Pratinjau

Dalam kombinasi dengan konfigurasi ApsaraVideo VOD, Anda dapat mengimplementasikan fitur pratinjau. Fitur ini didukung untuk pemutaran VidSts dan VidAuth (disarankan). Untuk petunjuk konfigurasi, lihat Pratinjau video.

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
....
VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
[vp setPreviewTime:20];// Pratinjau 20 detik
source.playConfig = [vp generatePlayerConfig];// Tetapkan untuk sumber pemutaran
...

Tetapkan Referer

// Dapatkan konfigurasi terlebih dahulu.
AVPConfig *config = [self.player getConfig];
// Tetapkan Referer.
config.referer = referer;
....// Pengaturan lain
// Tetapkan konfigurasi untuk pemutar.
[self.player setConfig:config];

Tetapkan User-Agent

// Dapatkan konfigurasi terlebih dahulu.
AVPConfig *config = [self.player getConfig];
// Tetapkan User-Agent.
config.userAgent = userAgent;
....// Pengaturan lain
// Tetapkan konfigurasi untuk pemutar.
[self.player setConfig:config];

Konfigurasi jumlah retry jaringan dan timeout

// Dapatkan konfigurasi saat ini.
AVPConfig *config = [self.player getConfig];
// Tentukan periode timeout jaringan. Satuan: milidetik.
config.networkTimeout = 5000;
// Tentukan jumlah maksimum retry saat terjadi timeout jaringan. Interval retry adalah nilai parameter networkTimeout. Nilai 0 berarti tidak ada retry. Aplikasi menentukan kebijakan retry. Nilai default adalah 2.
config.networkRetryCount = 2;
....// Konfigurasi pengaturan lain.
// Konfigurasikan pengaturan untuk pemutar.
[self.player setConfig:config];

Konfigurasi cache dan kontrol latensi

// Ambil konfigurasi.
AVPConfig *config = [self.player getConfig];
// Tentukan latensi maksimum. Catatan: Parameter ini hanya berlaku untuk streaming langsung. Jika latensi tinggi, Player SDK menyinkronkan frame untuk memastikan latensi berada dalam batas yang ditentukan.
config.maxDelayTime = 5000;
// Tentukan durasi buffer maksimum. Satuan: milidetik. Parameter ini menentukan durasi maksimum data yang dapat dibuffer pemutar sekaligus.
config.maxBufferDuration = 50000;
// Tentukan durasi buffer puncak. Satuan: milidetik. Saat pemutar memuat data karena kondisi jaringan buruk, pemutar berhenti memuat setelah durasi data yang dibuffer mencapai nilai ini.
config.highBufferDuration = 3000;
// Tentukan durasi buffer startup. Satuan: milidetik. Nilai lebih kecil menunjukkan durasi loading startup lebih pendek. Namun, pemutar mungkin segera memasuki status loading setelah pemutaran dimulai.
config.startBufferDuration = 500;
// Konfigurasi pengaturan lain.
// Terapkan konfigurasi ke pemutar.
[self.player setConfig:config];

Tetapkan header HTTP

// Ambil konfigurasi.
AVPConfig *config = [self.player getConfig];
// Definisikan header.
NSMutableArray *httpHeaders = [[NSMutableArray alloc] init];
// Misalnya, konfigurasikan host saat menggunakan HTTPDNS.
[httpHeaders addObject:@"Host:example.com"];
// Konfigurasikan header.
config.httpHeaders = httpHeaders;
....// Konfigurasi pengaturan lain.
// Konfigurasikan pengaturan untuk 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;
    }
}

Atur delegate PiP

Bagian ini menyediakan contoh kode umum untuk interaksi antara jendela Gambar-dalam-Gambar (PiP) dan jendela pemutar. Contoh ini mencakup logika untuk menampilkan tombol jeda, pemutaran, maju cepat, mundur cepat, dan putar ulang PiP. Untuk detail tentang metode delegate, lihat Demo SDK Pemutar, khususnya file header AliPlayerPictureInPictureDelegate.h di folder AliyunPlayer.framework.

1. Tetapkan delegate PiP.

   /**
   * @brief Tetapkan delegate PiP.
   */
   -(void) setPictureinPictureDelegate:(id<AliPlayerPictureInPictureDelegate>)delegate;
   
   
   // Tetapkan delegate PiP.
   [self.player setPictureinPictureDelegate:self];

2. Tambahkan variabel dan implementasikan antarmuka delegate.

   1. Tambahkan variabel global untuk mengelola status pemutar dan PiP.

      #import "YourUIViewController.h"
      #import <AliyunPlayer/AliyunPlayer.h>
      
      @interface YourUIViewController () <AVPDelegate, AliPlayerPictureInPictureDelegate>
      // Instans pemutar.
      @property (nonatomic, strong) AliPlayer *player;
      // Kontainer view pemutar.
      @property (nonatomic, strong) UIView *playerView;
      // Dengarkan apakah PiP sedang dijeda.
      @property (nonatomic, assign) BOOL isPipPaused;
      // Dengarkan status pemutaran saat ini pemutar. Tetapkan melalui callback newStatus dari listener perubahan status event pemutaran.
      @property (nonatomic, assign) AVPStatus currentPlayerStatus;
      // Tetapkan controller PiP. Tetapkan dalam metode callback saat PiP akan dimulai. Anda perlu secara aktif menyetelnya ke nil saat halaman akan dihancurkan. Kami menyarankan menyetelnya.
      @property (nonatomic, weak) AVPictureInPictureController *pipController;
      // Dengarkan progres pemutaran saat ini pemutar. Tetapkan currentPosition ke nilai parameter position dalam callback untuk posisi pemutaran video saat ini.
      @property (nonatomic, assign) int64_t currentPosition;
      
      @end

      Catatan

      Anda harus menggunakan pengubah weak atau assign untuk pipController. Jika menggunakan pengubah assign, pastikan Anda menyetel variabel yang benar ke null.

   2. Perbarui status controller PiP saat mendengarkan event onPlayerStatusChanged.

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

   3. Saat mendengarkan callback event pemutaran, panggil metode berikut untuk memperbarui status controller Gambar-dalam-Gambar (PiP).

      - (void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
          if (eventType == AVPEventCompletion) {
            if (_pipController) {
             self.isPipPaused = YES; // Setelah pemutaran berakhir, ubah status PiP ke dijeda.
             [self.pipController invalidatePlaybackState];
          }
        } else if (eventType == AVPEventSeekEnd) {
          // Pencarian selesai.
            if (_pipController) {
             [self.pipController invalidatePlaybackState];
          }
        }
      }

   4. Tetapkan listener.

      • Dengarkan callback saat PiP akan dimulai.

        /**
         @brief 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];
        }

      • Dengarkan callback saat PiP akan berhenti.

        /**
         @brief Gambar-dalam-Gambar sedang bersiap berhenti.
         @param pictureInPictureController Controller Gambar-dalam-Gambar.
         */
        - (void)pictureInPictureControllerWillStopPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            self.isPipPaused = NO;
          [pictureInPictureController invalidatePlaybackState];
        }

      • Dengarkan callback yang menginstruksikan delegate untuk memulihkan antarmuka pengguna sebelum PiP berhenti.

        /**
         @brief Memberi tahu delegate untuk memulihkan antarmuka pengguna sebelum Gambar-dalam-Gambar berhenti.
         @param pictureInPictureController Controller Gambar-dalam-Gambar.
         @param completionHandler Panggil dan teruskan YES untuk mengizinkan sistem menyelesaikan pemulihan antarmuka pengguna pemutar.
         */
        - (void)pictureInPictureController:(AVPictureInPictureController *)pictureInPictureController restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:(void (^)(BOOL restored))completionHandler {
            if (_pipController) {
              _pipController = nil;
          }
          completionHandler(YES);
        }

      • Dengarkan callback yang menyetel rentang waktu yang dapat diputar saat ini untuk PiP.

        /**
         @brief Memberi tahu controller Gambar-dalam-Gambar tentang 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);
            }
        }

      • Callback untuk memantau apakah Gambar-dalam-Gambar (PiP) dijeda atau diputar.

        /**
         @brief Mencerminkan status dijeda atau diputar di UI.
         @param pictureInPictureController Controller Gambar-dalam-Gambar.
         @return Dijeda atau diputar.
         */
        - (BOOL)pictureInPictureControllerIsPlaybackPaused:(nonnull AVPictureInPictureController *)pictureInPictureController{
            return self.isPipPaused;
        }

        Catatan

        Callback ini dipicu sebelum PiP dimulai. Pastikan nilai kembalian callback ini false pada saat ini. Jika tidak, PiP tidak dapat diaktifkan.

      • Dengarkan callback saat pengguna melewati maju atau mundur untuk menyinkronkan progres pemutaran ke pemutar.

        /**
         @brief Tombol maju cepat atau mundur cepat diklik.
         @param pictureInPictureController Controller Gambar-dalam-Gambar.
         @param skipInterval Interval waktu untuk maju cepat atau mundur cepat.
         @param completionHandler Closure yang harus dipanggil untuk menunjukkan bahwa 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];
        }

      • Dengarkan callback saat tombol jeda atau putar diklik di PiP, dan lakukan operasi yang diperlukan.

        /**
         @brief Tombol jeda di Gambar-dalam-Gambar diklik.
         @param pictureInPictureController Controller Gambar-dalam-Gambar.
         @param playing Apakah sedang diputar.
         */
        - (void)pictureInPictureController:(nonnull AVPictureInPictureController *)pictureInPictureController setPlaying:(BOOL)playing {
            if (!playing){
              [self.player pause];
              self.isPipPaused = YES;
            } else {
              // Rekomendasi: Jika pemutaran PiP selesai dan perlu diputar ulang, Anda dapat mengeksekusi kode dalam pernyataan if 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

Secara default, PiP diaktifkan saat aplikasi berpindah ke latar belakang. Untuk mengimplementasikan PiP dalam aplikasi, Anda dapat mengontrol aktivasi secara manual. Pertama, tentukan apakah PiP telah dimulai.

/**
 @brief Apakah PiP dimulai.
 @param pictureInPictureController Controller PiP.
 @param isEnable Apakah PiP dimulai.
 */
/****
 @brief pictureInPicture diaktifkan atau tidak
 @param pictureInPictureController controller gambar dalam gambar
 @param isEnable diaktifkan atau tidak
 */
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;

Saat PiP diaktifkan, nonaktifkan aktivasi otomatis dan kendalikan secara manual.

- (void) pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *) pictureInPictureController isEnable:(BOOL) isEnable
{
    if (isEnable && pictureInPictureController) {
        _pipController = pictureInPictureController;
        // tutup pemulaan otomatis 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 {
        // tutup pip
        [_pipController stopPictureInPicture];
    }
}

// Tetapkan nilai enumerasi AVPOutputAudioChannel untuk mengganti saluran.
// AVP_AUDIO_CHANNEL_NONE: Jangan tentukan saluran. Putar dengan saluran audio sumber input. Ini adalah nilai default.
// AVP_AUDIO_CHANNEL_LEFT: Beralih ke saluran audio kiri untuk pemutaran.
// AVP_AUDIO_CHANNEL_RIGHT: Beralih ke saluran audio kanan untuk pemutaran.
self.player.outputAudioChannel = AVP_AUDIO_CHANNEL_NONE;

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

// Parameter adalah nilai heksadesimal 8 digit. 8 digit dikelompokkan berpasangan, mewakili A (alpha/transparansi), R (merah), G (hijau), dan B (biru) secara berurutan.
// Misalnya, 0x0000ff00 merepresentasikan hijau.
[self.player setVideoBackgroundColor:0x0000ff00]

/**
 @brief Putar menggunakan metode vid+playauth. Lihat https://www.alibabacloud.com/help/zh/vod/user-guide/use-playback-credentials-to-play-videos
 @param source Jenis input AVPVidAuthSource.
 @see AVPVidAuthSource
 */
- (void)setAuthSource:(AVPVidAuthSource*)source;

VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
// Tambahkan field playDomain. Untuk field yang dapat ditambahkan, lihat
// https://www.alibabacloud.com/help/zh/vod/developer-reference/api-vod-2017-03-21-getplayinfo
[gen addVidPlayerConfigByStringValue:@"playDomain" value: @"com.xxx.xxx"];
[source setPlayConfig:[gen generatePlayerConfig]];
[self.player setAuthSource:source]:

// Nilai 1 mengaktifkan decoding latar belakang. Nilai 0 menonaktifkan decoding latar belakang. Nilai default adalah 0.
[self.player setOption:ALLOW_DECODE_BACKGROUND valueInt:1];

// x.x.x harus sama dengan nomor versi ApsaraVideo Player SDK.
pod 'AliPlayerSDK_iOS_VVC_CODEC_PLUGIN', 'x.x.x'

// x.x.x harus sama dengan nomor versi SDK terintegrasi yang Anda gunakan.
pod 'AliVCSDK_Standard/AliPlayerSDK_iOS_VVC_CODEC', 'x.x.x'

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

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

 Saat pemutar mendeteksi bahwa sumber VidAuth saat ini telah kedaluwarsa, callback ini dipicu. Kedaluwarsa sumber VidAuth mencakup kedaluwarsa PlayAuth dan URL pemutaran.
 Anda dapat memperbarui sumber VidAuth dalam callback dan mengirimkan objek VidAuth baru melalui `callback` untuk memastikan pemutaran video stabil dan lancar.

 @param callback Blok callback yang dipicu saat sumber VidAuth kedaluwarsa.
 Anda dapat menggunakan callback ini untuk mengembalikan objek `VidAuth` yang valid untuk memperbarui pemutar.
 */
/****
 @brief Tetapkan callback untuk notifikasi kedaluwarsa sumber VidAuth.

 Metode ini dipicu saat pemutar mendeteksi bahwa sumber VidAuth saat ini telah kedaluwarsa.
 Anda dapat memperbarui sumber VidAuth dalam callback dan menggunakan `callback` untuk mengembalikan sumber VidAuth yang diperbarui,
 memastikan pemutaran video tidak terganggu dan lancar.

 @param callback Blok callback yang dipicu saat sumber VidAuth kedaluwarsa.
 Gunakan callback ini untuk menyediakan objek `VidAuth` yang valid untuk memperbarui pemutar.
 */
-(void)setOnVidAuthExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief Protokol untuk menangani hasil refresh sumber pemutaran, yang perlu diimplementasikan developer.

 Protokol ini memberi tahu developer saat pemutar meminta refresh sumber pemutaran, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil refresh kepada developer,
 termasuk keberhasilan atau kegagalan.

 @note Protokol ini berlaku untuk sumber URL, sumber VidAuth, dan skenario serupa yang memerlukan logika refresh.
 */
 /****
 @brief Protokol untuk menangani hasil refresh sumber pemutaran, yang perlu diimplementasikan developer.

 Protokol ini memberi tahu developer saat pemutar meminta refresh sumber pemutaran, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil refresh kepada developer,
 termasuk keberhasilan atau kegagalan.

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

/**
 @brief Dipanggil oleh pemutar saat operasi refresh berhasil.
 @param newSource Objek sumber pemutaran baru yang berisi informasi terbaru.

 Metode ini menunjukkan bahwa operasi refresh telah berhasil diselesaikan. Developer perlu meneruskan
 `newSource` yang diperbarui kembali ke pemutar agar dapat memuat resource terbaru.
 */
 /****
 @brief Dipanggil oleh pemutar saat operasi refresh berhasil.
 
 @param newSource Objek sumber pemutaran baru yang berisi informasi terbaru.

 Metode ini menunjukkan bahwa operasi refresh telah berhasil diselesaikan. Developer perlu meneruskan
 `newSource` yang diperbarui kembali ke pemutar agar dapat memuat resource terbaru.
 */
- (void)onSuccess:(id)newSource;

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

 Metode ini menunjukkan bahwa operasi refresh telah gagal. Developer dapat menggunakan `errorMsg` untuk menangkap detail kegagalan
 dan menangani pemrosesan selanjutnya sesuai kebutuhan.
 */
 /****
 @brief Dipanggil oleh pemutar saat operasi refresh gagal.
 
 @param errorMsg String yang menjelaskan alasan kegagalan.

 Metode ini menunjukkan bahwa operasi refresh telah gagal. Developer dapat menggunakan `errorMsg` untuk menangkap detail kegagalan
 dan menangani pemrosesan selanjutnya sesuai kebutuhan.
 */
- (void)onError:(NSString *)errorMsg;

@end

[self.player setOnVidAuthExpiredCallback:^(id expiredSource, id<AVPSourceRefreshCallback> callback) {
    // Dapatkan AVPVidAuthSource
    if ([expiredSource isKindOfClass:[AVPVidAuthSource class]]) {

        // ------------------- Implementasi pengguna dimulai -------------------
        // Panggil fungsi Anda sendiri untuk mendapatkan PlayAuth baru dari server aplikasi Anda.
        // clinetGetPlayAuthFunction adalah nama fungsi contoh. Ganti dengan implementasi Anda sendiri.
        [self clinetGetPlayAuthFunction:vid success:^(NSString* newPlayAuth){
            // 1. Callback untuk pengambilan kredensial baru berhasil
            [vidAuth setPlayAuth:newPlayAuth];
            // 2. Kembalikan objek yang diperbarui ke pemutar melalui callback SDK
            [callback onSuccess:vidAuth];
        } failure:^(NSString* errorMsg) {
            // Callback untuk pengambilan kredensial gagal.
            // errorMsg berisi informasi kesalahan detail.
            [callback onError:errorMsg];
        }];
        // ------------------- Implementasi pengguna berakhir -------------------
    }
}];

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

 Saat pemutar mendeteksi bahwa sumber URL saat ini telah kedaluwarsa, callback ini dipicu.
 Anda dapat memperbarui sumber URL dalam callback dan menggunakan `callback` untuk mengembalikan sumber URL baru, memastikan pemutaran video tidak terganggu.

 @note Untuk informasi tentang konfigurasi penandatanganan URL, lihat dokumentasi Alibaba Cloud:
 https://www.alibabacloud.com/help/zh/vod/user-guide/configure-url-signing?spm=a2c4g.11186623.0.0.560c4140fGh8MW
 
 @param callback Blok callback yang dipicu saat sumber URL kedaluwarsa.
 Anda dapat menggunakan callback ini untuk menyediakan objek `URLSource` yang valid untuk memperbarui pemutar.
 */
 /****
 @brief Tetapkan callback untuk notifikasi kedaluwarsa sumber URL.

 Metode ini dipicu saat pemutar mendeteksi bahwa sumber URL saat ini telah kedaluwarsa.
 Anda dapat memperbarui sumber URL dalam callback dan menggunakan `callback` untuk mengembalikan sumber URL yang diperbarui,
 memastikan pemutaran video tidak terganggu.

 @param callback Blok callback yang dipicu saat sumber URL kedaluwarsa.
 Gunakan callback ini untuk menyediakan objek `URLSource` yang valid untuk memperbarui pemutar.
 */
-(void)setOnURLSourceExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

/**
 @protocol AVPSourceRefreshCallback
 @brief Protokol untuk menangani hasil refresh sumber pemutaran, yang perlu diimplementasikan developer.

 Protokol ini memberi tahu developer saat pemutar meminta refresh sumber pemutaran, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil refresh kepada developer,
 termasuk keberhasilan atau kegagalan.

 @note Protokol ini berlaku untuk sumber URL, sumber VidAuth, dan skenario serupa yang memerlukan logika refresh.
 */
 /****
 @brief Protokol untuk menangani hasil refresh sumber pemutaran, yang perlu diimplementasikan developer.

 Protokol ini memberi tahu developer saat pemutar meminta refresh sumber pemutaran, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil refresh kepada developer,
 termasuk keberhasilan atau kegagalan.

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

/**
 @brief Dipanggil oleh pemutar saat operasi refresh berhasil.
 @param newSource Objek sumber pemutaran baru yang berisi informasi terbaru.

 Metode ini menunjukkan bahwa operasi refresh telah berhasil diselesaikan. Developer perlu meneruskan
 `newSource` yang diperbarui kembali ke pemutar agar dapat memuat resource terbaru.
 */
 /****
 @brief Dipanggil oleh pemutar saat operasi refresh berhasil.
 
 @param newSource Objek sumber pemutaran baru yang berisi informasi terbaru.

 Metode ini menunjukkan bahwa operasi refresh telah berhasil diselesaikan. Developer perlu meneruskan
 `newSource` yang diperbarui kembali ke pemutar agar dapat memuat resource terbaru.
 */
- (void)onSuccess:(id)newSource;

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

 Metode ini menunjukkan bahwa operasi refresh telah gagal. Developer dapat menggunakan `errorMsg` untuk menangkap detail kegagalan
 dan menangani pemrosesan selanjutnya sesuai kebutuhan.
 */
 /****
 @brief Dipanggil oleh pemutar saat operasi refresh gagal.
 
 @param errorMsg String yang menjelaskan alasan kegagalan.

 Metode ini menunjukkan bahwa operasi refresh telah gagal. Developer dapat menggunakan `errorMsg` untuk menangkap detail kegagalan
 dan menangani pemrosesan selanjutnya sesuai kebutuhan.
 */
- (void)onError:(NSString *)errorMsg;

@end

[self.player setOnURLSourceExpiredCallback:^(id expiredSource, id<AVPSourceRefreshCallback> callback) {
    // Dapatkan AVPUrlSource
    if ([expiredSource isKindOfClass:[AVPUrlSource class]]) {
        AVPUrlSource *expiredUrlSource = (AVPUrlSource *)expiredSource;
        NSString *expiredUrl = [expiredUrlSource.playerUrl absoluteString];

        // Periksa apakah auth_key disertakan
        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 sebagai URL asli
            originalUrl = expiredUrl;
        }

        // 2. Siapkan parameter autentikasi baru: authKey dan waktu kedaluwarsa
        // Jika anggota kelas authKey valid, gunakan authKey
        NSString *key = (self.authKey.length > 0) ? self.authKey : @"";
        if (!NOT_EMPTY(key)) {
            [callback onError:@"REFRESH_ERROR:key fail"];
            return;
        }       
        
        // Jika anggota kelas validTime valid, gunakan validTime; 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 terautentikasi baru menggunakan CdnAuthUtil (Metode A)
        NSString *newAuthUrl = [CdnAuthUtil aAuthWithUri:originalUrl key:key exp:newExpireTime];
        AVPUrlSource *resultSource = [[AVPUrlSource alloc] urlWithString:newAuthUrl];

        // 4. Penanganan 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);

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

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

Kinerja

Tetapkan skenario pemutaran

Menyetel skenario pemutaran secara otomatis mengonfigurasi parameter optimal (termasuk pengaturan buffer dan toggle fitur) sambil mempertahankan pengaturan kustom yang dibuat melalui antarmuka setConfig (pengaturan kustom memiliki prioritas lebih tinggi).

Contoh API

/**
 Ringkasan: Mengatur skenario pemutar.
 Parameter scene: Skenario pemutar.
 Lihat juga: AVPScenario
 */
/****
 Ringkasan: Mengatur pemandangan pemutar.
 Parameter scene: Pemandangan pemutar.
 Lihat juga: AVPScene
 */
-(void) setPlayerScene:(AVPScene)scene;

Skenario pemutaran

typedef enum _AVPScene {
    /**
     * Skenario: Tidak ada
     */
    /****
     * tidak ada skenario
     */
    SceneNone,
    /**
     * Skenario video panjang: Berlaku untuk video lebih dari 30 menit
     */
    /****
     * skenario panjang: berlaku untuk lebih dari 30 menit
     */
    SceneLong,
    /**
     * Skenario video menengah: Berlaku untuk video 5–30 menit
     */
    /****
     * skenario menengah: berlaku untuk 5 menit-30 menit
     */
    SceneMedium,
    /**
     * Skenario video pendek: Berlaku untuk video hingga 5 menit
     */
    /****
     * skenario pendek: berlaku untuk 0 detik-5 menit
     */
    SceneShort,
    /**
     * Skenario streaming langsung
     */
    /****
     * skenario langsung
     */
    SceneLive,
    /**
     * Skenario streaming langsung latensi ultra-rendah
     */
    /****
     * skenario langsung RTS
     */
    SceneRTSLive
} AVPScene;

Penggunaan

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

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

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

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

Pre-rendering

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

Cache lokal

ApsaraVideo Player SDK untuk iOS menyediakan caching lokal untuk meningkatkan kecepatan startup, kecepatan pencarian, dan mengurangi tersendat untuk pemutaran video berulang. Fitur ini juga menghemat bandwidth.

Aktifkan cache lokal

/**
 * Aktifkan cache lokal. Setelah diaktifkan, akan menyimpan cache ke file lokal.
 * @param enable: Saklar fitur cache lokal. true: aktifkan, false: nonaktifkan. Default adalah nonaktifkan.
 * @param maxBufferMemoryKB: Tidak berlaku sejak V5.4.7.1. Tidak berpengaruh.
 * @param localCacheDir: Harus ditetapkan. Direktori untuk file cache lokal. Harus berupa jalur mutlak.
 */
[AliPlayerGlobalSettings enableLocalCache:true maxBufferMemoryKB:1024 localCacheDir:@""];

/**
 @brief Pengaturan untuk pembersihan otomatis file cache lokal.
 @param expireMin: Tidak berlaku sejak V5.4.7.1. Tidak berpengaruh.
 @param maxCapacityMB: Kapasitas cache maksimum dalam megabyte. Default adalah 20 GB. Selama pembersihan, jika total kapasitas cache melebihi ukuran ini, file cache tertua akan dihapus satu per satu, diurutkan berdasarkan waktu cache terakhir dari cacheItem, hingga kapasitas kurang dari atau sama dengan kapasitas cache maksimum.
 @param freeStorageMB: Ruang disk kosong minimum dalam megabyte. Default adalah 0. Selama pembersihan, mirip dengan kapasitas cache maksimum, jika ruang disk saat ini kurang dari nilai ini, file cache juga akan dihapus satu per satu sesuai aturan hingga freeStorage lebih besar dari atau sama dengan nilai ini atau semua cache dihapus.
 */
[AliPlayerGlobalSettings setCacheFileClearConfig:0 maxCapacityMB:0 freeStorageMB:0];

/**
 * Callback untuk mendapatkan nilai hash dari URL yang dimuat. Digunakan sebagai ID unik untuk URL. Anda harus memastikan setiap URL berbeda.
 */

// Anda perlu mengimplementasikan fungsi ini sendiri dan meneruskan pointer fungsi ke setCacheUrlHashCallback.
static NSString *CaheUrlHashHandle(NSString *url) {
    return @"xxx";
}

[AliPlayerGlobalSettings setCacheUrlHashCallback:&CaheUrlHashHandle];

Aktifkan atau nonaktifkan cache lokal untuk URL tunggal

// Dapatkan konfigurasi terlebih dahulu.
AVPConfig *config = [self.player getConfig];
// Apakah akan mengaktifkan cache lokal untuk URL pemutaran. Default adalah true. Saat cache lokal diaktifkan di AliPlayerGlobalSettings dan juga diaktifkan di sini (ditetapkan ke true), cache lokal untuk URL ini berlaku. Jika ditetapkan ke false di sini, cache lokal untuk URL ini dinonaktifkan.
config.enableLocalCache = false;
....// Pengaturan lain

// Tetapkan konfigurasi untuk pemutar.
[self.player setConfig:config];

[AliPlayerGlobalSettings enableLocalCache:true];

Preloading

ApsaraVideo Player SDK untuk iOS menyediakan preloading, peningkatan dari caching lokal yang meningkatkan kecepatan startup dengan mengunduh sebagian video ke cache sebelum pemutaran dimulai.

[AliPlayerGlobalSettings enableNetworkBalance:false];

1. Aktifkan cache lokal seperti dijelaskan di Cache lokal.

2. Tetapkan sumber data.

   VidAuth (disarankan)

   AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init];
   [vidAuthSource setVid:@"Informasi Vid"]; // Wajib. ID video (VideoId).
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // Wajib. Kredensial pemutaran. Anda perlu memanggil operasi GetVideoPlayAuth ApsaraVideo VOD untuk menghasilkannya.
   [vidAuthSource setRegion:@"Wilayah akses"]; // Untuk player SDK V5.5.5.0 ke atas, parameter ini tidak berlaku. Anda tidak perlu menyetel wilayah. Pemutar akan mengurai wilayah secara otomatis. Untuk versi player SDK sebelum 5.5.5.0, parameter ini wajib. Wilayah akses ApsaraVideo VOD. Default adalah cn-shanghai.
   [vidAuthSource setQuality:@"Definisi yang dipilih"]; //"AUTO" merepresentasikan bitrate adaptif.

   VidSts

   AVPVidStsSource* vidStsSource = [[AVPVidStsSource alloc] init];
   [vidStsSource setVid: @"Informasi Vid"]; // Wajib. ID video (VideoId).
   [vidStsSource setRegion:@"Wilayah akses"]; // Wajib. Wilayah akses ApsaraVideo VOD. Default adalah cn-shanghai.
   [vidStsSource setSecurityToken: @"<yourSecurityToken>"]; // Wajib. Token keamanan STS. Anda perlu memanggil operasi AssumeRole STS untuk menghasilkannya.
   [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // Wajib. Rahasia AccessKey pasangan AccessKey STS sementara. Anda perlu memanggil operasi AssumeRole STS untuk menghasilkannya.
   [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // Wajib. ID AccessKey pasangan AccessKey STS sementara. Anda perlu memanggil operasi AssumeRole STS untuk menghasilkannya.
   [vidStsSource setQuality:@"Definisi yang dipilih"]; //"AUTO" merepresentasikan bitrate adaptif.

   UrlSource

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

3. Tetapkan parameter tugas.

   Catatan

   Ini hanya berlaku untuk video multi-bitrate. Anda dapat memilih salah satu dari setDefaultBandWidth, setDefaultResolution, atau setDefaultQuality.

   AVPPreloadConfig *config = [[AVPPreloadConfig alloc]init];
   // Tetapkan bitrate preload untuk stream multi-bitrate.
   [config setDefaultBandWidth:400000];
   // Tetapkan resolusi preload untuk stream multi-bitrate.
   [config setDefaultResolution:640 * 480];
   // Tetapkan kualitas preload untuk stream multi-bitrate.
   [config setDefaultQuality:@"FD"];
   // Tetapkan durasi preload.
   [config setDuration:1000];

4. Tambahkan listener tugas.

   Perluas untuk melihat 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 url
   @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 pengecualian:%@", urlOrVid);
   }
   
   - (void)onCanceled:(NSString *)taskId urlOrVid:(NSString *)urlOrVid {
       NSLog(@"Tugas dibatalkan:%@", urlOrVid);
   }
   
   @end

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

   VidAuth (disarankan)

   // 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 tugas tertentu.
   [vodMedialoader pauseTask:taskId];// Jeda tugas preload dengan ID tugas tertentu.
   [vodMedialoader resumeTask:taskId];// Lanjutkan tugas preload dengan ID tugas tertentu.

7. Opsi: Hapus file yang dimuat.

   Anda dapat menghapus file yang dimuat sesuai kebutuhan untuk menghemat ruang. SDK tidak menyediakan antarmuka penghapusan. Anda perlu menghapus file di direktori pemuatan dalam aplikasi.

Preloading dinamis

Kebijakan preloading dinamis memungkinkan Anda menyeimbangkan pengalaman pemutaran dan biaya dengan mengontrol cache video saat ini dan jumlah item yang dipreloading.

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

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

// Konfigurasikan jumlah item yang akan dipreloading. Mendukung kedua arah.
// 1 adalah jumlah item yang akan dipreloading mundur, 3 adalah jumlah item yang akan dipreloading maju.
[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. Putar dan preload bitrate default.
     */
    /****
     * mode default, putar dan preload bitrate default stream
     */
    AVPMultiBitratesMode_Default = 0,
    /**
     * Konfigurasi prioritas frame pertama. Video mulai diputar pada bitrate yang telah selesai dipreloading.
     */
    /****
     * Prioritas biaya frame pertama (FC), kurangi biaya frame pertama. hanya putar bitrate stream hls yang telah dipreloading.
     */
    AVPMultiBitratesMode_FCPrio = 1,
    /**
     * Menyeimbangkan frame pertama dan pemutaran lancar. Bitrate video konsisten sebelum dan sesudah pergantian (moveToNext), dan kinerja frame pertama juga dipertimbangkan.
     */
    /****
     * Frame pertama dan pemutaran lancar, putar bitrate yang sama sebelum dan sesudah moveToNext
     */
    AVPMultiBitratesMode_FC_AND_SMOOTH = 2,
    /**
     * Konfigurasi prioritas pemutaran lancar. Video mulai diputar pada bitrate video sebelumnya.
     */
    /****
     * Prioritas pemutaran lancar, putar bitrate yang sama sebelum dan sesudah moveToNext.
     */
    AVPMultiBitratesMode_SmoothPrio = 3,
} AVPMultiBitratesMode;

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

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

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

Dapatkan kecepatan unduh

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

Fitur jaringan

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

[AliPlayerGlobalSettings setUseHttp2:true];

// Format domain adalah host[:port]. Port opsional. Beberapa domain dipisahkan dengan titik koma (;).
// Pengaturan global.
// Setiap kali antarmuka lengkap diatur, string saat ini digunakan (tambah untuk lebih banyak, hapus untuk lebih sedikit). String kosong menghentikan pra-koneksi.
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];

Unduh video

ApsaraVideo Player SDK untuk iOS menyediakan fitur unduh video untuk konten ApsaraVideo VOD, dengan mode standar dan aman.

• Unduhan standar: Video yang diunduh tidak dienkripsi dan dapat diputar oleh pemutar pihak ketiga.

• Unduhan aman: Video yang diunduh dienkripsi dan hanya dapat diputar oleh ApsaraVideo Player.

Catatan penggunaan

• Fitur ini hanya untuk sumber VidSts dan VidAuth.

• Aktifkan dan konfigurasikan mode unduhan di Konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Unduhan offline.

• Anda dapat melanjutkan unduhan video dari breakpoint.

Prosedur

1. Opsi: Konfigurasikan file verifikasi enkripsi untuk unduhan aman. Konfigurasikan file ini hanya untuk unduhan aman. Unduhan standar tidak memerlukannya.

   Catatan

   Pastikan file verifikasi enkripsi sesuai dengan informasi aplikasi Anda. Jika tidak, unduhan video gagal.

   Jika Anda menggunakan unduhan aman, konfigurasikan file kunci yang dihasilkan di Konsol ApsaraVideo VOD di Player SDK. File kunci digunakan untuk mendekripsi dan memverifikasi video untuk diunduh dan diputar. Untuk informasi selengkapnya tentang menghasilkan file kunci, lihat Aktifkan unduhan aman.

   Anda hanya perlu mengonfigurasi ini sekali dalam aplikasi. Berikut contohnya:

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

2. Buat dan siapkan downloader.

   Contoh:

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

3. Tetapkan listener event.

   Objek unduh menyediakan beberapa listener.

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       // Item unduhan berhasil dipersiapkan.
   }
   -(void)onError:(AliMediaDownloader *)downloader errorModel:(AVPErrorModel *)errorModel {
       // Terjadi kesalahan 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.
   }

4. Persiapkan sumber unduhan.

   Panggil metode prepare untuk mempersiapkan sumber unduhan. Jenis sumber yang didukung termasuk VidStsSource dan VidAuthSource. Contoh berikut:

   • VidSts

     // Buat VidSts.
     AVPVidStsSource* stsSource = [[AVPVidStsSource alloc] init];
     stsSource.region = @"Access region"; // Wilayah akses ApsaraVideo VOD. Nilai default-nya adalah cn-shanghai.
     stsSource.vid = @"Vid information"; // ID video (VideoId).
     stsSource.securityToken = @"<yourSecurityToken>"; // Token keamanan STS. Anda perlu memanggil operasi AssumeRole dari STS untuk menghasilkannya.
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // Rahasia AccessKey dari pasangan Kunci Akses STS temporary. Anda perlu memanggil operasi AssumeRole dari STS untuk menghasilkannya.
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // ID AccessKey dari pasangan Kunci Akses STS temporary. Anda perlu memanggil operasi AssumeRole dari STS untuk menghasilkannya.
     
     // Jika Anda telah mengaktifkan transmisi langsung parameter enkripsi standar HLS di konsol VOD, dan nama parameter default-nya adalah MtsHlsUriToken, Anda perlu mengatur konfigurasi tersebut dan meneruskannya ke vid. Lihat contoh berikut.
     // Jika Anda belum mengaktifkan transmisi langsung parameter enkripsi standar HLS di konsol VOD, Anda tidak perlu mengintegrasikan kode berikut.
     VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
     [vp setHlsUriToken:yourMtsHlsUriToken];
     stsSource.playConfig = [vp generatePlayerConfig];
     // Siapkan sumber unduhan.
     [downloader prepareWithVid:stsSource];

   • VidAuth

     // Buat VidAuth.
     AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
     authSource.vid = @"Informasi Vid"; // ID video (VideoId).
     authSource.playAuth = @"<yourPlayAuth>"; // Kredensial pemutaran. Anda perlu memanggil operasi GetVideoPlayAuth dari ApsaraVideo VOD untuk menghasilkannya.
     authSource.region = @"Wilayah akses"; // Untuk Player SDK versi V5.5.5.0 dan yang lebih baru, parameter ini sudah tidak digunakan lagi. Anda tidak perlu mengatur wilayah. Pemutar akan secara otomatis mengurai wilayah tersebut. Untuk versi Player SDK sebelum 5.5.5.0, parameter ini wajib diisi. Wilayah akses ApsaraVideo VOD. Nilai default-nya adalah cn-shanghai.
     // Jika Anda telah mengaktifkan fitur pass-through parameter enkripsi standar HLS di Konsol VOD, dan nama parameter default-nya adalah MtsHlsUriToken, Anda perlu mengatur konfigurasi dan meneruskannya ke dalam vid. Lihat contoh berikut.
     // Jika Anda belum mengaktifkan fitur pass-through parameter enkripsi standar HLS di Konsol VOD, Anda tidak perlu mengintegrasikan kode berikut.
     VidPlayerConfigGenerator* vp = [[VidPlayerConfigGenerator alloc] init];
     [vp setHlsUriToken:yourMtsHlsUriToken];
     authSource.playConfig = [vp generatePlayerConfig];
     // Siapkan sumber unduhan.
     [downloader prepareWithVid:authSource];

   Catatan

   Jika Anda mengaktifkan parameter pass-through untuk HLS encryption di ApsaraVideo VOD console, parameter default-nya adalah MtsHIsUriToken. Untuk informasi selengkapnya, lihat Parameter pass-through for HLS encryption. Kemudian, atur nilai MtsHIsUriToken ke sumber ApsaraVideo VOD dengan mengikuti kode sebelumnya.

5. Pilih item download.

   Setelah persiapan berhasil, metode onPrepared dipanggil. TrackInfo yang dikembalikan mencakup informasi seperti definisi setiap aliran video. Pilih track yang akan didownload. Berikut ini contohnya:

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       NSArray<AVPTrackInfo*>* tracks = info.tracks;
       // Misalnya, download AVPTrackInfo pertama.
       [downloader selectTrack:[tracks objectAtIndex:0].trackIndex];
   }

6. Perbarui sumber unduhan dan mulai unduhan.

   VidSts atau VidAuth mungkin kedaluwarsa sebelum unduhan dimulai. Oleh karena itu, kami menyarankan untuk memperbarui sumber unduhan sebelum Anda memulai unduhan.

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

7. Setelah pengunduhan berhasil atau gagal, lepaskan downloader.

   Setelah pengunduhan berhasil, panggil destroy untuk melepaskan downloader.

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

Pemutaran terenkripsi

ApsaraVideo VOD mendukung enkripsi standar HLS, enkripsi proprietary Alibaba Cloud, dan Enkripsi DRM. Untuk petunjuknya, lihat Putar video terenkripsi.

Native RTS playback

SDK mengintegrasikan Native RTS SDK untuk mengimplementasikan live streaming berlatensi rendah. Untuk informasi selengkapnya, lihat Implement RTS-based stream pulling on iOS.

Referensi

• Referensi API

• Kode error

• FAQ pemutar iOS