ApsaraVideo VOD:Basic features of ApsaraVideo Player SDK for iOS

Oynatmaya hazırlanın

Videoyu oynatmaya hazırlamak için prepare yöntemini çağırın.

[self.player prepare];

Hazırlık tamamlandığında AVPEventPrepareDone ile onPlayerEvent geri çağrısı tetiklenir.

Oynatmayı başlatın

Videoyu oynatmaya başlamak için start yöntemini çağırın:

[self.player start];

Oynatmayı duraklatın

Videoyu duraklatmak için pause yöntemini çağırın:

[self.player pause];

Oynatmayı sürdürün

Duraklatmadan sonra oynatmayı sürdürmek için start yöntemini çağırın:

[self.player start];

Belirli bir konuma atlayın

Belirli bir konuma atlamak için seekToTime yöntemini çağırın. Bu yöntem, kullanıcılar ilerleme çubuğunu sürüklediğinde veya kaydedilmiş bir konumdan oynatmayı sürdürdüğünde kullanışlıdır.

// Seek to a specific position (in milliseconds)
// Accurate seek
[self.player seekToTime:position seekMode:AVP_SEEKMODE_ACCURATE];
// Inaccurate seek
[self.player seekToTime:position seekMode:AVP_SEEKMODE_INACCURATE];

Arama modları:

• Tam arama (AVP_SEEKMODE_ACCURATE): Tam konuma atlar. Daha yavaş ancak daha hassastır.

• Yaklaşık arama (AVP_SEEKMODE_INACCURATE): En yakın ana kareye atlar. Daha hızlı ancak daha az hassastır.

Belirli bir konumdan oynatmayı başlatın

(Oynatma sırasında atlamak yerine) belirli bir konumdan oynatmayı başlatmak için prepare yöntemini çağırmadan önce setStartTime yöntemini çağırın:

// Set the start time for the next prepare call (in milliseconds).
// This setting is only valid for the immediately following prepare call. The start time is automatically cleared after prepare is called.
// seekMode: accurate seek (AVP_SEEKMODE_ACCURATE) or inaccurate seek (AVP_SEEKMODE_INACCURATE).
[self.player setStartTime:time seekMode:seekMode];

Oynatmayı durdurun

Oynatmayı durdurmak için stop yöntemini çağırın:

[self.player stop];

Oynatıcı görünümünün bağlantısını kaldırın

Oynatmayı durdurduktan ve oynatıcı örneğini yok etmeden önce, oluşturma kaynaklarını serbest bırakmak ve bellek sızıntılarını önlemek için oynatıcı görünümünün bağlantısını kaldırın.

// Unbind the player view
self.player.playerView = nil;

Oynatıcıyı yok edin

Kaynakları serbest bırakmak için oynatıcıyı eşzamanlı veya eşzamansız olarak yok edebilirsiniz.

// Synchronous destroy. Blocks until player resources are released. Automatically calls stop.
[self.player destroy];
// Asynchronous destroy. Returns immediately. Automatically calls stop.
[self.player destroyAsync];

Öneriler:

• Hızlı yanıt sürelerine ihtiyaç duyuyorsanız destroyAsync yöntemini kullanın.

• Eşzamansız yok etme işlemi sırasında oynatıcı nesnesinde herhangi bir işlem gerçekleştirmeyin.

• Yok etme işlemi eşzamansız bir durdurma işlemi içerdiğinden destroyAsync yönteminden önce stop yöntemini çağırmanıza gerek yoktur.

Oynatıcı temsilcisini ayarlayın

Oynatıcı geri çağrılarını almak için görünümler denetleyicinizde AVPDelegate protokolünü uygulayın.

Önemli: Hataları işlemek ve oynatma durumu değişikliklerini izlemek için onError ve onPlayerEvent geri çağrılarını uygulayın.

@interface SimplePlayerViewController ()<AVPDelegate>
@end
- (void)viewDidLoad {
    self.player = [[AliPlayer alloc] init];
    self.player.playerView = self.avpPlayerView.playerView;
    self.player.delegate = self;
    //...
}
/**
 @brief Delegate callback for player errors.
 @param player The player instance.
 @param errorModel Contains the error details.
 */
- (void)onError:(AliPlayer*)player errorModel:(AVPErrorModel *)errorModel {
    // Handle the error (e.g., show an alert) and stop playback.
}
/**
 @brief Delegate callback for player events.
 @param player The player instance.
 @param eventType The type of the event. See AVPEventType.
 */
-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType{
    switch(eventType){
        case AVPEventPrepareDone:{
            // Triggered when the media has been prepared and is ready to play.
        }
            break;
        case AVPEventAutoPlayStart:
            // Triggered when autoplay begins.
            break;
        case AVPEventFirstRenderedStart:
            // Triggered when the first frame is rendered.
            break;
        case AVPEventCompletion:
            // Triggered when playback completes.
            break;
        case AVPEventLoadingStart:
            // Triggered when buffering starts.
            break;
        case AVPEventLoadingEnd:
            // Triggered when buffering finishes.
            break;
        case AVPEventSeekEnd:
            // Triggered when a seek operation completes.
            break;
        case AVPEventLoopingStart:
            // Triggered when a new loop begins.
            break;
        default:
            break;
    }
}
/**
 @brief Callback for the current playback position.
 @param player The player instance.
 @param position The current playback position in milliseconds.
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // Update the progress bar.
}
/**
 @brief Callback for the current buffered position.
 @param player The player instance.
 @param position The current buffered position in milliseconds.
 */
- (void)onBufferedPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // Update the buffer progress indicator.
}
/**
 @brief Callback for when track information is ready.
 @param player The player instance.
 @param info An array of AVPTrackInfo objects for the available streams.
 */
- (void)onTrackReady:(AliPlayer*)player info:(NSArray<AVPTrackInfo*>*)info {
    // Retrieve information for available bitrates/tracks.
}
/**
 @brief Callback for when a subtitle should be displayed.
 @param player The player instance.
 @param index The index of the subtitle entry.
 @param subtitle The subtitle text to be displayed.
 */
- (void)onSubtitleShow:(AliPlayer*)player index:(int)index subtitle:(NSString *)subtitle {
    // Get and display the subtitle text.
}
/**
 @brief Callback for when a subtitle should be hidden.
 @param player The player instance.
 @param index The index of the subtitle entry that was shown.
 */
- (void)onSubtitleHide:(AliPlayer*)player index:(int)index {
    // Hide the subtitle.
}
/**
 @brief Callback for a screen capture request.
 @param player The player instance.
 @param image The captured screenshot as a UIImage.
 */
- (void)onCaptureScreen:(AliPlayer *)player image:(UIImage *)image {
    // Preview or save the captured image.
}
/**
 @brief Callback for when a track change is complete.
 @param player The player instance.
 @param info The AVPTrackInfo object for the new, active track.
 */
- (void)onTrackChanged:(AliPlayer*)player info:(AVPTrackInfo*)info {
    // Notification that the bitrate/track has changed.
}

Oynatıcı durumu değişikliklerini dinleyin

Oynatıcı durumu değiştiğinde onPlayerStatusChanged geri çağrısı tetiklenir:

- (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus {
    switch (newStatus) {
    case AVPStatusIdle:{
           // Player is idle
        }
 break;
        case AVPStatusInitialzed:{
           // Player is initialized
        }
 break;
        case AVPStatusPrepared:{
           // Player prepared
        }
 break;
        case AVPStatusStarted:{
           // Playback started
        }
 break;
case AVPStatusPaused:{
           // Playback paused
        }
 break;
case AVPStatusStopped:{
           // Playback stopped
        }
 break;
case AVPStatusCompletion:{
           // Playback completed
        }
 break;
case AVPStatusError:{
           // Player error occurred
        }
 break;
        default:
            break;
    }
}

Ölçeklendirme modları

SDK üç ölçeklendirme modunu destekler:

// Scale to fit the view while maintaining the aspect ratio (letterboxing).
self.player.scalingMode = AVP_SCALINGMODE_SCALEASPECTFIT;
// Scale to fill the view while maintaining the aspect ratio (cropping).
self.player.scalingMode = AVP_SCALINGMODE_SCALEASPECTFILL;
// Stretch to fill the view. The aspect ratio is not maintained. Image distortion may occur.
self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

Döndürme

Videoyu belirtilen açı kadar saat yönünde döndürün:

// No rotation
self.player.rotateMode = AVP_ROTATE_0;
// Rotate 90 degrees clockwise
self.player.rotateMode = AVP_ROTATE_90;
// Rotate 180 degrees clockwise
self.player.rotateMode = AVP_ROTATE_180;
// Rotate 270 degrees clockwise
self.player.rotateMode = AVP_ROTATE_270;

Yansıtma

Videoyu yansıtmak için setMirrorMode yöntemini çağırın. SDK yatay ve dikey yansıtmayı destekler:

// No mirroring
self.player.mirrorMode = AVP_MIRRORMODE_NONE;
// Horizontal mirroring
self.player.mirrorMode = AVP_MIRRORMODE_HORIZONTAL;
// Vertical mirroring
self.player.mirrorMode = AVP_MIRRORMODE_VERTICAL;

Oynatma ilerlemesi

Geçerli oynatma konumu onCurrentPositionUpdate geri çağrısında döndürülür:

- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
// position is in milliseconds
NSString *position = [NSString stringWithFormat:@"%lld, position"];
}

Toplam süre

Video yüklendikten sonra (örneğin, AVPEventPrepareDone olayından sonra) videonun toplam süresini alın:

-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
  switch (eventType) {
    case AVPEventPrepareDone: {
      if (self.player.duration >= 0) {
       NSString *duration  = self.player.duration;
      }
    }
      break;
    default:
      break;
  }
}

Gerçek oynatma süresi

Gerçek zamanlı olarak gerçek oynatma süresini alın. Bu değer, oynatmanın duraklatıldığı veya arabelleğe alındığı süreleri hariç tutar.

 NSString *duration = [player getPlayedDuration];

Arabelleğe alma ilerlemesi

Geçerli arabelleğe alma ilerlemesi onBufferedPositionUpdate geri çağrısında döndürülür:

- (void)onBufferedPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    NSString *bufferPosition = position;
}

Gerçek zamanlı oluşturma ve bit hızı ölçümleri

Oluşturma kare hızını, ses ve video bit hızını ve ağ aşağı yönlü bit hızını gerçek zamanlı olarak edinin.

// Video rendering frame rate. Returns a float value.
[self.player getOption:AVP_OPTION_RENDER_FPS]
// Video bitrate. Returns a float value in bit/s.
[self.player getOption:AVP_OPTION_VIDEO_BITRATE]
// Audio bitrate. Returns a float value in bit/s.
[self.player getOption:AVP_OPTION_AUDIO_BITRATE]
// Network downstream bitrate. Returns a float value in bit/s.
[self.player getOption:AVP_OPTION_DOWNLOAD_BITRATE]

Ses düzeyini ayarlayın

Ses düzeyini değiştirmek için volume yöntemini çağırın. Geçerli değerler: 0 ile 2 arasındadır; burada 1 özgün ses düzeyidir. 1 değerinden büyük değerler sesi yükseltir ve gürültüye neden olabilir. Ses düzeyini 1 veya altında tutmanızı öneririz.

// Set the volume. Valid values: 0 to 2.
self.player.volume = 1.0f;
// Get the current volume.
self.player.volume

Videoyu sessize alın

Sesi kapatın veya açın:

self.player.muted = YES;

// We recommend using multiples of 0.5 (e.g., 0.5, 1.0, 1.5, 2.0)
self.player.rate = 1.0f;

VidAuth veya VidSts tabanlı oynatma

VOD oynatma için VidAuth veya VidSts kullanıyorsanız SDK video tanımlarını ApsaraVideo VOD'dan otomatik olarak alır. Ek yapılandırma gerekmez.

- (void)onTrackReady:(AliPlayer*)player info:(NSArray<AVPTrackInfo*>*)info {
    for (int i=0; i<info.count; i++) {
        AVPTrackInfo* track = [info objectAtIndex:i];
        switch (track.trackType) {
            case AVPTRACK_TYPE_VIDEO: {
                int trackBitrate = track.trackBitrate;
            }
                break;
        }
    }
}

[self.player selectTrack:index];

- (void)onTrackChanged:(AliPlayer*)player info:(AVPTrackInfo*)info {
 // Definition switched.
}

AVPConfig *config = [self.player getConfig];
config.selectTrackBufferMode = 1;
[self.player setConfig:config];

UrlSource tabanlı canlı yayın

Ayrıntılar için Standart canlı yayın oynatma konusuna bakın.

self.player.loop = YES;

- (void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventLoopingStart:
            break;
    }
}

Desteklenen akış türleri

Aşağıdaki akış türleri ses parçası değiştirmeyi destekler. Değiştirme davranışı akış türüne göre değişir.

Kullanılabilir ses parçalarını alın

Ses parçası bilgileri mevcut olduğunda onSubTrackReady geri çağrısı tetiklenir:

  // onSubTrackReady. Typically triggered before the AVPEventPrepareDone event.
- (void)onSubTrackReady:(AliPlayer*)player info:(NSArray<AVPTrackInfo*>*)info {
    // Call getSubMediaInfo after this callback is triggered. Calling it before this callback returns an empty result.
    AVPMediaInfo* subMediaInfo = [player getSubMediaInfo];
    // Iterate through available audio tracks
    for (int i=0; i<subMediaInfo.tracks.count; i++) {
    	AVPTrackInfo* track = [mediaInfo.tracks objectAtIndex:i];
        // Find the target audio track from the track list.
    }
}

Ses parçasını değiştirin

Farklı bir ses parçasına geçmek için selectTrack yöntemini çağırın:

[self.player selectTrack:myTrack.trackIndex accurate:YES]

/**
 A flag indicating whether the current track has thumbnails. If false, thumbnail previews will not be displayed during seeking.
 */
@property (nonatomic,assign)BOOL trackHasThumbnai;

/**
 The custom UIImageView used to display the thumbnail preview image.
 */
@property (nonatomic,strong)UIImageView *thumbnaiView;

/**
  onPrepare
 */
- (void)onPlayerStatusChanged:(AliPlayer*)player oldStatus:(AVPStatus)oldStatus newStatus:(AVPStatus)newStatus {
  if(newStatus == AVPStatusPrepared){
       [self.player setThumbnailUrl:[URL];// When the player is prepared, set the thumbnail URL.
       self.trackHasThumbnai = YES;
  }
}
/**
 Callback triggered when the progress slider's value changes.
 @param playerView The player view instance.
 @param value The new progress value.
 */
- (void)AVPPlayerView:(AVPPlayerView *)playerView progressSliderValueChanged:(CGFloat)value {
    if (self.trackHasThumbnai) {
        [self.player getThumbnail:self.player.duration*value];
    }
}

/**
 @brief: Callback triggered upon successful retrieval of a thumbnail.
 @param positionMs: The requested time position for the thumbnail, in milliseconds.
 @param fromPos: The start time of the segment this thumbnail represents, in milliseconds.
 @param toPos: The end time of the segment this thumbnail represents, in milliseconds.
 @param image: The retrieved thumbnail image (`UIImage` on iOS, `NSImage` on macOS).
 */
- (void)onGetThumbnailSuc:(int64_t)positionMs fromPos:(int64_t)fromPos toPos:(int64_t)toPos image:(id)image {
    self.thumbnaiView.hidden = NO;
    [self.thumbnaiView setImage:(UIImage *)image];
}

/**
 @brief: Callback triggered when thumbnail retrieval fails.
 @param positionMs: The time position for which the thumbnail request failed, in milliseconds.
 */
- (void)onGetThumbnailFailed:(int64_t)positionMs {
    self.thumbnaiView.hidden = YES;
}

Yöntem 1: Günlükleri geliştirme aracı konsolunda görüntüleyin

Bu yöntem, sorunu yerel olarak çoğaltabildiğiniz senaryolar için uygundur.

1. Günlük kaydını etkinleştirin ve günlük düzeyini ayarlayın:

   // Enable SDK logging
   [AliPlayer setEnableLog:YES];
   // Set the log level (default: LOG_LEVEL_INFO). Use LOG_LEVEL_TRACE for detailed troubleshooting.
   [AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

2. Kare düzeyinde günlük kaydını etkinleştirin (isteğe bağlı):

   // Enable frame-level logging for detailed troubleshooting
   // 0 = disabled, 1 = enabled
   [AliPlayer setLogOption:FRAME_LEVEL_LOGGING_ENABLED value:value];

   Not

   Kare düzeyinde günlük kaydı büyük hacimde günlük üretir ve öncelikli olarak oynatma sorunlarını gidermek için kullanılır.

3. Günlükleri toplayın:

   Seçenek A: Günlükleri konsolda görüntüleyin

   Sorunu çoğalttıktan sonra günlükleri XCode gibi geliştirme aracı konsolunuzdan alın.

   Seçenek B: Günlükleri bir dosyaya yazın

   Uygulamanın korumalı alanı içinde günlük dosyanız için tam yolu ayarlayın.

   NSArray *paths =NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES);
   NSString *documentDirectory = [paths objectAtIndex:0];
   // Define your custom log file path. For example, create a file named 'xxxx.log'.
   NSString *logFilePath = [documentDirectory stringByAppendingPathComponent:@"xxxx.log"];

   Günlükleri uygulamanın korumalı alanındaki özel bir dosyaya yönlendirin:

   freopen([logFilePath cStringUsingEncoding:NSASCIIStringEncoding],"a+", stdout);
   freopen([logFilePath cStringUsingEncoding:NSASCIIStringEncoding],"a+", stderr);

   Sorunu çoğalttıktan sonra .log dosyasını özel dizinden alın.

Yöntem 2: Günlükleri programlı olarak almak için LogCallback ayarlayın

Sorunu cihazınızda güvenilir bir şekilde çoğaltamadığınızda bu yöntemi kullanın. Geri çağrı, günlükleri uygulamanızın günlük kanalına aktarır.

1. Günlük kaydını etkinleştirin ve günlük düzeyini ayarlayın.

   // Enable SDK logging
   [AliPlayer setEnableLog:YES];
   // Set the log level. Default value: LOG_LEVEL_INFO. For troubleshooting, set it to LOG_LEVEL_TRACE.
   [AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:^(AVPLogLevel logLevel, NSString *strLog) {
    NSLog(@"strLog:%@", strLog);
   }];

2. Günlükleri toplayın:

   Sorunu çoğalttıktan sonra günlükler otomatik olarak uygulamanızın günlük sistemine iletilir.

Sorun giderme

Başvurular

• Gelişmiş özellikler: Resim içinde Resim (PiP), zaman kaydırma ve adaptif bit hızı akışı gibi gelişmiş özellikler hakkında bilgi edinin.

• API başvurusu: ApsaraVideo Player SDK for iOS için eksiksiz API başvurusunu keşfedin.

• Mobil hata kodları: Sorun giderme için bu konuya bakın.