ApsaraVideo VOD：Fitur lanjutan

Verifikasi kemampuan profesional

Anda dapat mengatur listener saat aplikasi dimulai atau sebelum memanggil operasi API player apa pun.

void premiumVeryfyCallback(AVPPremiumBizType biztype, bool isValid, NSString* errorMsg) {
    NSLog(@"onPremiumLicenseVerifyCallback: %d, isValid: %d, errorMsg: %@", biztype, isValid, errorMsg);
}

[AliPrivateService setOnPremiumLicenseVerifyCallback:premiumVeryfyCallback];

AVPPremiumBizType adalah tipe enumerasi untuk fitur premium. Saat fitur terkait digunakan, player memvalidasi fitur tersebut dan mengembalikan hasil melalui callback ini. Jika isValid bernilai false, errorMsg berisi alasan spesifiknya.

Pemutaran

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

//--------------Penggunaan View-------------
// Untuk View, Anda perlu mengatur clearColor.
@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 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];

// Opsional: Jika terjadi masalah koneksi setelah pemutaran instance tunggal selesai, Anda dapat mengosongkan 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 Tipe rendering video. 0 menunjukkan renderer default. 1 menunjukkan renderer campuran. Nilai default: 0.
 */
@property(nonatomic, assign) int videoRenderType;

AVPConfig *config = [self.player getConfig];
// Gunakan metode 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. Ini 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 H.265 adaptif

// Lapisan aplikasi memelihara peta yang menyimpan semua pasangan kunci-nilai URL asli dan URL cadangan. Saat beralih, kueri URL cadangan di peta berdasarkan URL asli.
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 bitrate.
[self.player selectTrack:track.trackIndex];
// Aktifkan adaptive bitrate streaming.
[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];

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

AVPConfig *config = [self.player getConfig];
config.maxAllowedAbrVideoPixelNumber = 921600; // Atur jumlah maksimum piksel untuk definisi ABR menjadi 921600 (lebar × tinggi = 1280 × 720), sehingga jumlah piksel untuk definisi yang dapat dialihkan ABR 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 layar pemutaran saat ini.
[self.player snapShot];

Pratinjau

ApsaraVideo Player SDK untuk iOS, bersama dengan konfigurasi ApsaraVideo VOD, dapat mengimplementasikan fitur pratinjau. SDK mendukung metode pemutaran VidSts dan VidAuth (direkomendasikan untuk ApsaraVideo VOD). Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan fitur pratinjau, lihat Pratinjau video.

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

Atur Referer

// Pertama, dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur Referer.
config.referer = referer;
....// Pengaturan lainnya.
// Atur konfigurasi untuk player.
[self.player setConfig:config];

Atur User-Agent

// Pertama, dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur User-Agent.
config.userAgent = userAgent;
....// Pengaturan lainnya.
// Atur konfigurasi untuk player.
[self.player setConfig:config];

Konfigurasikan waktu dan jumlah retry jaringan

// Pertama, dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Atur timeout jaringan dalam milidetik.
config.networkTimeout = 5000;
// Atur jumlah upaya retry saat timeout. Interval setiap retry adalah networkTimeout. networkRetryCount=0 berarti tidak ada retry, dan kebijakan retry ditentukan oleh aplikasi. Nilai default adalah 2.
config.networkRetryCount = 2;
....// Pengaturan lainnya.
// Atur konfigurasi untuk player.
[self.player setConfig:config];

Konfigurasikan kontrol cache dan latensi

// Pertama, dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Latensi maksimum. Catatan: Ini efektif untuk streaming langsung. Saat latensi tinggi, SDK player akan melakukan sinkronisasi frame untuk memastikan latensi berada dalam rentang ini.
config.maxDelayTime = 5000;
// Durasi buffer maksimum dalam milidetik. Player memuat paling banyak durasi data buffered ini setiap kali.
config.maxBufferDuration = 50000;
// Durasi buffer tinggi dalam milidetik. Saat data sedang dimuat karena kondisi jaringan buruk, jika durasi buffer yang dimuat mencapai nilai ini, status loading berakhir.
config.highBufferDuration = 3000;
// Durasi buffer awal dalam milidetik. Semakin pendek waktu ini diatur, semakin cepat frame pertama dimuat. Namun, juga dapat menyebabkan player memasuki status loading segera setelah pemutaran dimulai.
config.startBufferDuration = 500;
// Pengaturan lainnya.
// Atur konfigurasi untuk player.
[self.player setConfig:config];

Atur Header HTTP

// Pertama, dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Definisikan header.
NSMutableArray *httpHeaders = [[NSMutableArray alloc] init];
// Misalnya, saat menggunakan HTTPDNS, Anda perlu mengatur Host.
[httpHeaders addObject:@"Host:example.com"];
// Atur header.
config.httpHeaders = httpHeaders;
....// Pengaturan lainnya.
// Atur konfigurasi untuk player.
[self.player setConfig:config];

Picture-in-Picture (PiP)

Enable PiP

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

Set the PiP delegate

Bagian berikut hanya memberikan beberapa contoh kode umum untuk interaksi antara jendela Picture-in-Picture (PiP) dan jendela player. Contoh ini mencakup logika untuk tombol jeda, putar, maju cepat, dan mundur cepat di jendela PiP, serta pemutaran ulang. Untuk detail tentang metode delegate, lihat konten file header AliPlayerPictureInPictureDelegate.h di AliyunPlayer.framework folder SDK di Demo SDK Player.

1. Atur delegate PiP.

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

2. Tambahkan variabel dan implementasikan antarmuka delegate.

   1. Tambahkan variabel global untuk mengontrol perubahan status player.

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

      Catatan

      pipController harus dimodifikasi dengan weak atau assign. Jika Anda menggunakan assign, perhatikan kapan variabel diatur ke null.

   2. Saat mendengarkan callback antarmuka perubahan status event pemutaran, Anda harus secara aktif memanggil metode berikut untuk memperbarui status terkait controller PiP.

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

   3. Saat mendengarkan antarmuka callback event pemutaran, Anda harus secara aktif memanggil metode berikut untuk memperbarui status terkait controller 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) {
          // Seeking selesai.
            if (_pipController) {
             [self.pipController invalidatePlaybackState];
          }
        }
      }

   4. Atur listener.

      • Dengarkan callback yang dipanggil sebelum PiP dimulai.

        /**
         @brief PiP akan mulai.
         @param pictureInPictureController Controller PiP.
         */
        - (void)pictureInPictureControllerWillStartPictureInPicture:(AVPictureInPictureController *)pictureInPictureController {
            if (!_pipController) {
             self.pipController = pictureInPictureController;
          }
            self.isPipPaused = !(self.currentPlayerStatus == AVPStatusStarted);
          [pictureInPictureController invalidatePlaybackState];
        }

      • Dengarkan callback yang dipanggil sebelum PiP berhenti.

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

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

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

      • Dengarkan callback yang memberi tahu controller PiP tentang rentang waktu yang dapat diputar saat ini.

        /**
         @brief Memberi tahu controller PiP tentang rentang waktu yang dapat diputar saat ini.
         @param pictureInPictureController Controller PiP.
         @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);
            }
        }

      • Dengarkan callback yang menunjukkan apakah video dijeda dalam mode PiP.

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

        Catatan

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

      • Dengarkan callback yang dipanggil saat pengguna menekan tombol maju cepat atau mundur cepat dalam mode PiP dan sinkronkan status player.

        /**
         @brief Pengguna menekan tombol maju cepat atau mundur cepat.
         @param pictureInPictureController Controller PiP.
         @param skipInterval Interval waktu untuk maju cepat atau mundur cepat.
         @param completionHandler Closure yang harus dipanggil untuk menunjukkan bahwa operasi seeking 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 yang dipanggil saat pengguna menekan tombol jeda atau putar dalam mode PiP.

        /**
         @brief Pengguna menekan tombol jeda dalam mode PiP.
         @param pictureInPictureController Controller PiP.
         @param playing Apakah video 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 tambahan dalam pernyataan if berikut.
              if (self.currentPlayerStatus == AVPStatusCompletion) {
                 [self.player seekToTime:0 seekMode:AVP_SEEKMODE_ACCURATE];
              }
        
              [self.player start];
              self.isPipPaused = NO;
          }
          [pictureInPictureController invalidatePlaybackState];
        }

Picture-in-Picture dalam aplikasi

Saat menggunakan fitur PiP, secara default merupakan PiP di luar aplikasi. Untuk mengimplementasikan PiP dalam aplikasi, Anda dapat terlebih dahulu menggunakan operasi API berikut untuk menentukan apakah fitur PiP diaktifkan:

/**
 @brief Menunjukkan apakah PiP diaktifkan.
 @param pictureInPictureController Controller PiP.
 @param isEnable Apakah PiP diaktifkan.
 */
- (void)pictureInPictureControllerIsPictureInPictureEnable:(nullable AVPictureInPictureController *)pictureInPictureController isEnable:(BOOL)isEnable;

Saat fitur PiP diaktifkan, Anda dapat menonaktifkan start otomatis PiP dan mengontrol aktivasi fitur secara manual. Kode berikut memberikan contohnya:

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

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

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

// Parameter adalah data heksadesimal 8-bit. Data 8-bit dibagi menjadi kelompok dua, mewakili A (transparansi alpha), R (merah), G (hijau), dan B (biru) secara berurutan.
// Misalnya, 0x0000ff00 merepresentasikan hijau.
[self.player setVideoBackgroundColor:0x0000ff00]

/**
 @brief Putar menggunakan VID + PlayAuth. Untuk informasi selengkapnya, lihat https://www.alibabacloud.com/help/en/vod/user-guide/use-playback-credentials-to-play-videos
 @param source Tipe input AVPVidAuthSource.
 @see AVPVidAuthSource
 */
- (void)setAuthSource:(AVPVidAuthSource*)source;

VidPlayerConfigGenerator* gen = [[VidPlayerConfigGenerator alloc]init];
// Tambahkan bidang playDomain. Untuk bidang yang dapat ditambahkan, lihat
// https://www.alibabacloud.com/help/en/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 konsisten dengan nomor versi ApsaraVideo Player SDK.
pod 'AliPlayerSDK_iOS_VVC_CODEC_PLUGIN', 'x.x.x'

// x.x.x harus konsisten dengan nomor versi All-in-One SDK yang Anda gunakan.
pod 'AliVCSDK_Standard/AliPlayerSDK_iOS_VVC_CODEC', 'x.x.x'

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

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

 Metode ini dipicu saat player mendeteksi bahwa sumber VidAuth saat ini telah kedaluwarsa.
 Anda dapat menyegarkan 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 memberikan objek `VidAuth` yang valid untuk memperbarui player.
 */
-(void)setOnVidAuthExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

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

 Protokol ini memberi tahu developer saat player meminta penyegaran sumber pemutaran, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil penyegaran kepada developer,
 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 player saat operasi penyegaran berhasil.
 
 @param newSource Objek sumber pemutaran baru yang berisi informasi yang diperbarui.

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

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

 Metode ini menunjukkan bahwa operasi penyegaran 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]]) {

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

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

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

 @note Untuk informasi tentang mengonfigurasi mekanisme penandatanganan URL, lihat dokumentasi resmi 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.
 Gunakan callback ini untuk memberikan objek `URLSource` yang valid untuk memperbarui player.
 */
-(void)setOnURLSourceExpiredCallback:(void (^)(id expiredSource, id<AVPSourceRefreshCallback> callback))callback;

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

 Protokol ini memberi tahu developer saat player meminta penyegaran sumber pemutaran, seperti saat resource
 telah kedaluwarsa atau perlu diperbarui. Metode dalam protokol ini dipanggil untuk memberikan hasil penyegaran kepada developer,
 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 player saat operasi penyegaran berhasil.
 
 @param newSource Objek sumber pemutaran baru yang berisi informasi yang diperbarui.

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

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

 Metode ini menunjukkan bahwa operasi penyegaran 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 mengandung 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 penandatanganan 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 adalah 3600 detik
        NSTimeInterval newExpireTime = [[NSDate date] timeIntervalSince1970] + validTime;

         // 3. Gunakan CdnAuthUtil untuk menghasilkan URL bertanda tangan baru (Tipe 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 - Metode Auth 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 - Helper Pribadi: 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 - Helper Pribadi: Pencocokan Regex
+ (NSDictionary *)matchUri:(NSString *)uri {
    NSError *error = nil;
    NSRegularExpression *regex = [NSRegularExpression regularExpressionWithPattern:@"^(https?://)?([^/?]+)(/[^?]*)?(\\?.*)?$"
                                  options:0
                                  error:&error];
    if (error) {
        NSLog(@"Kesalahan regex: %@", 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

Performa

Atur skenario pemutaran

Mengatur skenario pemutaran secara otomatis mengonfigurasi parameter optimal, seperti pengaturan buffer dan toggle fitur, berdasarkan skenario tersebut. Pengaturan ini juga kompatibel dengan pengaturan parameter kustom yang dikonfigurasi menggunakan antarmuka setConfig. Pengaturan kustom memiliki prioritas lebih tinggi.

Contoh API

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

Skenario pemutaran

typedef enum _AVPScene {
    /**
     * Skenario: Tidak ada
     */
    SceneNone,
    /**
     * Skenario video panjang: berlaku untuk video lebih dari 30 menit
     */
    SceneLong,
    /**
     * Skenario video sedang: berlaku untuk video antara 5 hingga 30 menit
     */
    SceneMedium,
    /**
     * Skenario video pendek: berlaku untuk video antara 0 detik hingga 5 menit
     */
    SceneShort,
    /**
     * Skenario streaming langsung
     */
    SceneLive,
    /**
     * Skenario langsung RTS
     */
    SceneRTSLive
} AVPScene;

Petunjuk penggunaan

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

// Atur skenario video sedang.
[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

ApsaraVideo Player SDK untuk iOS menyediakan fitur cache lokal. Fitur ini meningkatkan kecepatan loading frame pertama, kecepatan seek, dan mengurangi tersendat saat pengguna memutar video berulang kali. Fitur ini juga membantu menghemat trafik.

Enable local caching

/**
 * Aktifkan cache lokal. Setelah diaktifkan, video akan di-cache ke file lokal.
 * @param enable: Sakelar fitur cache lokal. true: aktifkan, false: nonaktifkan. Default adalah false.
 * @param maxBufferMemoryKB: Ditinggalkan sejak V5.4.7.1, tidak berpengaruh.
 * @param localCacheDir: Harus diatur. 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: Ditinggalkan 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 akses terakhir item cache, hingga total kapasitas kurang dari atau sama dengan kapasitas maksimum.
 @param freeStorageMB: Ruang disk bebas 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 ruang bebas lebih besar dari atau sama dengan nilai ini atau semua cache dihapus.
 */
[AliPlayerGlobalSettings setCacheFileClearConfig:0 maxCapacityMB:0 freeStorageMB:0];

/**
 * Callback untuk mendapatkan nilai hash URL yang dimuat, digunakan sebagai ID unik untuk URL. Harus dipastikan bahwa setiap URL unik.
 */

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

[AliPlayerGlobalSettings setCacheUrlHashCallback:&CaheUrlHashHandle];

Enable or disable local caching for a single URL

// Pertama, dapatkan konfigurasi.
AVPConfig *config = [self.player getConfig];
// Apakah akan mengaktifkan cache lokal untuk URL pemutaran. Nilai default adalah true. Saat cache lokal diaktifkan di AliPlayerGlobalSettings, dan cache lokal juga diaktifkan di sini (diatur ke true), cache lokal untuk URL ini akan berlaku. Jika diatur ke false di sini, cache lokal untuk URL ini dinonaktifkan.
config.enableLocalCache = false;
....// Pengaturan lainnya.

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

[AliPlayerGlobalSettings enableLocalCache:true];

Preloading

ApsaraVideo Player SDK untuk iOS menyediakan fitur preloading, yang merupakan peningkatan dari fitur caching lokal. Dengan mengatur ukuran memori yang ditempati oleh cache video, Anda dapat lebih meningkatkan kecepatan loading frame pertama video.

[AliPlayerGlobalSettings enableNetworkBalance:false];

1. Aktifkan fitur caching lokal. Untuk informasi selengkapnya, lihat Caching lokal.

2. Atur sumber data.

   VidAuth (direkomendasikan)

   AVPVidAuthSource* vidAuthSource = [[AVPVidAuthSource alloc] init];
   [vidAuthSource setVid:@"Informasi Vid"]; // Wajib. ID video.
   [vidAuthSource setPlayAuth:@"<yourPlayAuth>"]; // Wajib. Kredensial pemutaran. Anda perlu memanggil operasi API GetVideoPlayAuth ApsaraVideo VOD untuk menghasilkannya.
   [vidAuthSource setRegion:@"Wilayah akses"]; // Untuk SDK player V5.5.5.0 ke atas, parameter ini ditinggalkan. Anda tidak perlu mengatur wilayah; player akan menguraikannya secara otomatis. Untuk SDK player sebelum V5.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.
   [vidStsSource setRegion:@"Wilayah akses"]; // Wajib. Wilayah akses ApsaraVideo VOD, default adalah cn-shanghai.
   [vidStsSource setSecurityToken: @"<yourSecurityToken>"]; // Wajib. Token STS. Anda perlu memanggil operasi API AssumeRole STS untuk menghasilkannya.
   [vidStsSource setAccessKeySecret: @"<yourAccessKeySecret>"]; // Wajib. Rahasia AccessKey pasangan AccessKey STS sementara. Anda perlu memanggil operasi API AssumeRole STS untuk menghasilkannya.
   [vidStsSource setAccessKeyId: @"<yourAccessKeyId>"]; // Wajib. ID AccessKey pasangan AccessKey STS sementara. Anda perlu memanggil operasi API AssumeRole STS untuk menghasilkannya.
   [vidStsSource setQuality:@"Definisi yang dipilih"]; // "AUTO" merepresentasikan bitrate adaptif.

   UrlSource

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

3. Atur parameter tugas.

   Catatan

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

   AVPPreloadConfig *config = [[AVPPreloadConfig alloc]init];
   // Atur bitrate preload untuk aliran multi-bitrate.
   [config setDefaultBandWidth:400000];
   // Atur resolusi preload untuk aliran multi-bitrate.
   [config setDefaultResolution:640 * 480];
   // Atur kualitas preload untuk aliran multi-bitrate.
   [config setDefaultQuality:@"FD"];
   // Atur 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 dan tambahkan ke instans MediaLoaderV2 untuk memulai 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. Opsional: 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. Opsional: Hapus file yang dimuat.

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

Preloading dinamis

Kebijakan preloading dinamis memungkinkan integrator mengontrol cache video yang sedang diputar dan jumlah serta cache video yang dipreloading, menyeimbangkan pengalaman pemutaran dengan overhead biaya untuk kebutuhan bisnis.

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

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

// Konfigurasikan jumlah preload, mendukung kedua arah.
// 1 adalah jumlah preload mundur, 3 adalah jumlah preload 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 {
    /**
     * Mode default, putar dan preload bitrate default aliran.
     */
    AVPMultiBitratesMode_Default = 0,
    /**
     * Prioritas biaya frame pertama (FC), kurangi biaya frame pertama. hanya putar bitrate aliran hls yang telah dipreloading.
     */
    AVPMultiBitratesMode_FCPrio = 1,
    /**
     * Seimbangkan biaya frame pertama dan kelancaran pemutaran, putar bitrate yang sama sebelum dan sesudah moveToNext.
     */
    AVPMultiBitratesMode_FC_AND_SMOOTH = 2,
    /**
     * Prioritas kelancaran pemutaran, putar bitrate yang sama sebelum dan sesudah moveToNext.
     */
    AVPMultiBitratesMode_SmoothPrio = 3,
} AVPMultiBitratesMode;

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

// (Opsional) Pilih bitrate awal.
[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 unduhan

- (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], di mana port opsional. Nama domain ganda dipisahkan dengan titik koma (;).
// Pengaturan global
// Antarmuka lengkap menggunakan string saat ini setiap kali diatur (lebih - tambah, kurang - hapus). String kosong menghentikan pra-koneksi.
[AliPlayerGlobalSettings setOption:SET_PRE_CONNECT_DOMAIN value: @"domain1;domain2"];

Unduhan video

ApsaraVideo Player SDK untuk iOS menyediakan fitur unduhan video untuk ApsaraVideo VOD. Fitur ini memungkinkan pengguna menyimpan video secara lokal untuk ditonton dengan ApsaraVideo Player. SDK menawarkan dua metode unduhan: unduhan standar dan unduhan aman.

• Unduhan standar: Data video yang diunduh tidak dienkripsi oleh Alibaba Cloud. Pengguna dapat memutarnya dengan player pihak ketiga.

• Unduhan aman: Data video yang diunduh dienkripsi oleh Alibaba Cloud. Player pihak ketiga tidak dapat memutarnya. Data hanya dapat diputar menggunakan ApsaraVideo Player.

Catatan penggunaan

• Fitur unduhan video hanya didukung untuk metode VidSts dan VidAuth.

• Untuk menggunakan fitur unduhan video player, Anda perlu mengaktifkan dan mengonfigurasi mode unduhan di konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Unduhan offline.

• Unduhan video mendukung unduhan yang dapat dilanjutkan.

Prosedur

1. Opsional: Konfigurasikan file verifikasi enkripsi untuk unduhan aman. Ini hanya diperlukan untuk unduhan aman, bukan untuk unduhan standar.

   Catatan

   Pastikan file verifikasi enkripsi yang dikonfigurasi konsisten dengan informasi aplikasi. Jika tidak, unduhan video gagal.

   Jika Anda mengatur metode unduhan ke unduhan aman, Anda harus mengonfigurasi file kunci yang dihasilkan di konsol ApsaraVideo VOD ke SDK player untuk dekripsi dan verifikasi selama unduhan dan pemutaran video. Untuk informasi selengkapnya tentang cara menghasilkan file kunci, lihat Aktifkan unduhan aman.

   Kami menyarankan Anda mengonfigurasi file kunci sekali di Application. Kode berikut memberikan contohnya:

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

2. Buat dan siapkan downloader.

   Kode berikut memberikan contohnya:

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

3. Atur listener event.

   Downloader menyediakan beberapa listener event. Kode berikut memberikan contohnya:

   -(void)onPrepared:(AliMediaDownloader *)downloader mediaInfo:(AVPMediaInfo *)info {
       // Item unduhan berhasil disiapkan.
   }
   -(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. Siapkan sumber unduhan.

   Anda dapat menggunakan metode prepare untuk menyiapkan sumber unduhan. Metode VidSts dan VidAuth didukung. Kode berikut memberikan contohnya:

   • VidSts

     // Buat VidSts.
     AVPVidStsSource* stsSource = [[AVPVidStsSource alloc] init];
     stsSource.region = @"Wilayah akses"; // Wilayah akses ApsaraVideo VOD. Default adalah cn-shanghai.
     stsSource.vid = @"Informasi Vid"; // ID video.
     stsSource.securityToken = @"<yourSecurityToken>"; // Token STS. Anda perlu memanggil operasi API AssumeRole STS untuk menghasilkannya.
     stsSource.accessKeySecret = @"<yourAccessKeySecret>"; // Rahasia AccessKey pasangan AccessKey STS sementara. Anda perlu memanggil operasi API AssumeRole STS untuk menghasilkannya.
     stsSource.accessKeyId = @"<yourAccessKeyId>"; // ID AccessKey pasangan AccessKey STS sementara. Anda perlu memanggil operasi API AssumeRole STS untuk menghasilkannya.
     
     // Jika Anda telah mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, dan nama parameter default adalah MtsHlsUriToken, Anda perlu mengatur config dan meneruskannya ke vid, seperti yang ditunjukkan di bawah.
     // Jika Anda belum mengaktifkan pass-through 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.
     authSource.playAuth = @"<yourPlayAuth>"; // Kredensial pemutaran. Anda perlu memanggil operasi API GetVideoPlayAuth ApsaraVideo VOD untuk menghasilkannya.
     authSource.region = @"Wilayah akses"; // Untuk SDK player V5.5.5.0 ke atas, parameter ini ditinggalkan. Anda tidak perlu mengatur wilayah; player akan menguraikannya secara otomatis. Untuk SDK player sebelum V5.5.5.0, parameter ini wajib. Wilayah akses ApsaraVideo VOD, default adalah cn-shanghai.
     // Jika Anda telah mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, dan nama parameter default adalah MtsHlsUriToken, Anda perlu mengatur config dan meneruskannya ke vid, seperti yang ditunjukkan di bawah.
     // Jika Anda belum mengaktifkan 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 telah mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, dan nama parameter default adalah MtsHIsUriToken (untuk informasi selengkapnya, lihat Pass-through parameter enkripsi standar HLS), harap atur nilai MtsHIsUriToken ke sumber VOD seperti yang ditunjukkan dalam kode di atas.

5. Setelah persiapan berhasil, pilih item unduhan.

   Setelah persiapan berhasil, metode onPrepared dipanggil balik. TrackInfo yang dikembalikan berisi informasi seperti definisi setiap aliran video. Anda dapat memilih track untuk diunduh. Kode berikut memberikan contohnya:

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

6. Perbarui sumber unduhan dan mulai unduhan.

   Untuk mencegah VidSts dan VidAuth kedaluwarsa, kami menyarankan Anda memperbarui informasi sumber unduhan sebelum memulai unduhan. Kode berikut memberikan contohnya:

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

7. Setelah unduhan berhasil atau gagal, lepaskan downloader.

   Setelah unduhan berhasil, Anda dapat memanggil destroy untuk melepaskan downloader.

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

Pemutaran video terenkripsi

ApsaraVideo VOD mendukung enkripsi HLS, enkripsi privat Alibaba Cloud, dan enkripsi DRM. Video streaming langsung hanya mendukung enkripsi DRM. Untuk informasi selengkapnya tentang pemutaran terenkripsi, lihat Pemutaran video terenkripsi.

Pemutaran Native RTS

ApsaraVideo Player SDK untuk iOS mengintegrasikan Native RTS SDK untuk mengimplementasikan fitur streaming langsung latensi rendah native. Untuk informasi selengkapnya, lihat Implementasikan penarikan aliran RTS di iOS.

Referensi

• Referensi API

• Kode kesalahan klien seluler

• FAQ untuk ApsaraVideo Player untuk iOS