ApsaraVideo VOD:Basic features of ApsaraVideo Player SDK for Android

VOD oynatma

VidAuth vidAuth = new VidAuth();
vidAuth.setVid("Vid");                 // Required. The video ID (VideoId).
vidAuth.setPlayAuth("<yourPlayAuth>"); // Required. The playback credential from GetVideoPlayAuth.
vidAuth.setRegion("region-id");        // Deprecated for SDK V5.5.5.0 and later. The player automatically parses the region. For earlier versions, this parameter is required. Default: cn-shanghai.
   // vidAuth.setAuthTimeout(3600);    // Optional. Set the validity period of the playback URL in seconds. This value overwrites the validity period configured in the ApsaraVideo VOD console. Default: 3600. Make sure that the value is greater than the video duration to prevent URL expiration during playback.
        
   // If you enable HLS encryption parameter pass-through in the ApsaraVideo VOD console, the default parameter is MtsHlsUriToken. Specify config and pass it with your VidAuth data source.
   VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
   vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
   vidAuth.setPlayerConfig(config);
   aliPlayer.setDataSource(vidAuth);

VidSts vidSts = new VidSts();
       vidSts.setVid("Vid");                               // Required. The video ID (VideoId).
       vidSts.setAccessKeyId("<yourAccessKeyId>");         // Required. The temporary AccessKey ID from STS (AssumeRole).
       vidSts.setAccessKeySecret("<yourAccessKeySecret>"); // Required. The temporary AccessKey secret from STS (AssumeRole).
       vidSts.setSecurityToken("<yourSecurityToken>");     // Required. The STS token from AssumeRole.
       vidSts.setRegion("RegionID");                       // Required. The ApsaraVideo VOD region. Default: cn-shanghai.
       // vidSts.setAuthTimeout(3600);                     // Optional. Set the validity period of the playback URL in seconds. This value overwrites the validity period configured in the ApsaraVideo VOD console. Default: 3600. Make sure that the value is greater than the video duration to prevent URL expiration during playback.
        
       // If you enable HLS encryption parameter pass-through in the ApsaraVideo VOD console, the default parameter is MtsHlsUriToken. Specify config and pass it with your vidSts data source.
       // If it is not enabled, the following configuration is not neccessary.
       VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
       vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
       vidSts.setPlayerConfig(config);
       aliPlayer.setDataSource(vidSts);

 UrlSource urlSource = new UrlSource();
        urlSource.setUri("your-playback-url"); // Required. A VOD URL, third-party URL, or local file path.
        aliPlayer.setDataSource(urlSource);

Canlı yayın oynatma

Canlı yayın oynatma hakkında bilgi edinmek için Standart canlı yayın oynatma konusuna bakın.

Oynatıcıyı hazırlama

Medya verilerini yüklemek ve ayrıştırmak için prepare yöntemini çağırın.

aliPlayer.prepare();

Oynatmayı başlatma

Oynatmayı başlatmak veya sürdürmek için start yöntemini çağırın.

aliPlayer.start();

Belirli bir konuma atlama

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

// Specify the target time in milliseconds.
aliPlayer.seekTo(long position);

prepare çağrısından önce oynatma başlangıç konumunu ayarlamak için setStartTime yöntemini kullanın. Bu ayar, her prepare çağrısında yalnızca bir kez etkili olur ve ardından otomatik olarak temizlenir.

// Set the start position in milliseconds. seekMode specifies accurate or inaccurate seeking.
aliPlayer.setStartTime(time, seekMode);

Oynatmayı duraklatma

Oynatmayı duraklatmak için pause yöntemini çağırın.

aliPlayer.pause();

Oynatmayı durdurma

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

aliPlayer.stop();

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

Oynatmayı durdurduktan ve oynatıcı örneğini yok etmeden önce, işleme 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ı kesin. Kullandığınız oynatıcı görünümü türüne göre uygun bağlantı kesme yöntemini seçin.

// Unbind the player view
aliPlayer.setSurface(null);

// Unbind the player view
aliPlayer.setDisplayView(null);

Oynatıcıyı yok etme

Oynatıcıyı eşzamanlı veya eşzamansız olarak yok edebilirsiniz.

// Synchronous destroy. Blocks until player resources are released. Automatically calls stop.
aliPlayer.release();
// Asynchronous destroy. Returns immediately. Automatically calls stop.
aliPlayer.releaseAsync();

Dinleyicileri ayarlama

Oynatıcı için birden çok dinleyici ayarlayabilirsiniz. OnErrorListener, OnCompletionListener, OnLoadingStatusListener ve OnInfoListener dinleyicilerini ayarlamanızı öneririz.

aliPlayer.setOnErrorListener(new IPlayer.OnErrorListener() {
    // This callback is triggered if an error occurs when you use the player.

    @Override
    public void onError(ErrorInfo errorInfo) {
        ErrorCode errorCode = errorInfo.getCode(); // The error code.
        String errorMsg = errorInfo.getMsg(); // The error message.
        // errorExtra provides extra error information in a JSON string. For example:
        //{ "Url": "xxx",
   		//	"Module": "NetWork",
    	//	"ModuleCode": "-377",
   		//  "ModuleMessage": "Redirect to a url that is not a media"}
        // Note that the value of ModuleCode is not always the same as the value of errorCode.
        String errorExtra= errorInfo.getExtra();         
        // Stop the player after an error occurs.
        aliPlayer.stop();
    }
});
aliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    // After you call the aliPlayer.prepare() method, the player starts to read and parse data. This callback is triggered after the data is parsed.

    @Override
    public void onPrepared() {
        // The player is prepared.
    }
});
aliPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    // This callback is triggered after the playback is complete.
    @Override
    public void onCompletion() {
        // In most cases, you can call the stop method to stop the playback.
        aliPlayer.stop();
    }
});
aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    // The information about the player, such as the current playback position and the buffered position.
    @Override
    public void onInfo(InfoBean infoBean) {
        InfoCode code = infoBean.getCode(); // The information code.
        String msg = infoBean.getExtraMsg();// The information content.
        long value = infoBean.getExtraValue(); // The information value.

        // The current playback position: InfoCode.CurrentPosition.
        // The buffered position: InfoCode.BufferedPosition.
    }
});
aliPlayer.setOnLoadingStatusListener(new IPlayer.OnLoadingStatusListener() {
    // The loading status of the player. You can use this to display a loading screen when the network connection is poor.

    @Override
    public void onLoadingBegin() {
        // The player starts to load data. The video and audio are not ready for playback.
        // In most cases, you can display a circular loading indicator.
    }

    @Override
    public void onLoadingProgress(int percent, float netSpeed) {
        // The loading progress in percentage and the network speed.
        // The network speed is a reserved field. The value is 0.
    }

    @Override
    public void onLoadingEnd() {
        // The player stops loading data. The video and audio are ready for playback.
        // In most cases, you can hide the circular loading indicator.
    }
});

Oynatma durumu değişikliklerini izleme

Oynatıcı durum geçişlerini izlemek için onStateChanged geri aramasını kullanın.

aliPlayer.setOnStateChangedListener(new IPlayer.OnStateChangedListener() {
    @Override
    public void onStateChanged(int newState) {
        /*
          int idle = 0;
          int initalized = 1;
          int prepared = 2;
          int started = 3;
          int paused = 4;
          int stopped = 5;
          int completion = 6;
          int error = 7;
      */
    }
});

Ölçeklendirme modu

SDK üç ölçeklendirme modunu destekler:

// Scale to fit the view while maintaining the aspect ratio (letterboxing).
aliPlayer.setScaleMode(ScaleMode.SCALE_ASPECT_FIT);
// Scale to fill the view while maintaining the aspect ratio (cropping).
aliPlayer.setScaleMode(ScaleMode.SCALE_ASPECT_FILL);
// Stretch to fill the view. The aspect ratio is not maintained. Image distortion may occur.
aliPlayer.setScaleMode(ScaleMode.SCALE_TO_FILL);

Döndürme

Videoyu döndürmek için setRotateMode yöntemini çağırın. Mevcut döndürme açısını sorgulamak için getRotateMode yöntemini kullanabilirsiniz.

// No rotation.
aliPlayer.setRotateMode(RotateMode.ROTATE_0);
// 90° clockwise.
aliPlayer.setRotateMode(RotateMode.ROTATE_90);
// 180° clockwise.
aliPlayer.setRotateMode(RotateMode.ROTATE_180);
// 270° clockwise.
aliPlayer.setRotateMode(RotateMode.ROTATE_270);
// Query the current rotation angle.
aliPlayer.getRotateMode();

Yansıtma

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

// No mirroring.
aliPlayer.setMirrorMode(MirrorMode.MIRROR_MODE_NONE);
// Horizontal mirroring.
aliPlayer.setMirrorMode(MirrorMode.MIRROR_MODE_HORIZONTAL);
// Vertical mirroring.
aliPlayer.setMirrorMode(MirrorMode.MIRROR_MODE_VERTICAL);

Oynatma ilerlemesi

onInfo geri aramasında, milisaniye cinsinden mevcut oynatma konumunu almak için getExtraValue yöntemini çağırın.

aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            // The current playback position in milliseconds.
            long extraValue = infoBean.getExtraValue();
        }
    }
});

Toplam süre

Video süresi yalnızca medya yüklendikten sonra kullanılabilir hale gelir. onPrepared geri araması tetiklendikten sonra getDuration yöntemini çağırın.

long duration = aliPlayer.getDuration();

Gerçek oynatma süresi

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

long playedDuration = aliPlayer.getPlayedDuration(); 

Önbelleğe alma ilerlemesi

Mevcut önbelleğe alma ilerlemesini almak için onInfo geri aramasında InfoCode.BufferedPosition değerini kontrol edin.

aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.BufferedPosition){
            // The current buffering progress in milliseconds.
            long extraValue = infoBean.getExtraValue();
        }
    }
});

Gerçek zamanlı işleme ve bit hızı ölçümleri

İşleme kare hızını, ses ve video bit hızını ve ağ indirme bit hızını gerçek zamanlı olarak alın.

// Video rendering frame rate. Returns a float value.
aliPlayer.getOption(IPlayer.Option.RenderFPS);
// Video bitrate. Returns a float value in bit/s.
aliPlayer.getOption(IPlayer.Option.VideoBitrate);
// Audio bitrate. Returns a float value in bit/s.
aliPlayer.getOption(IPlayer.Option.AudioBitrate);
// Network downstream bitrate. Returns a float value in bit/s.
aliPlayer.getOption(IPlayer.Option.DownloadBitrate);

Ses düzeyini değiştirme

Ses düzeyini değiştirmek için setVolume yöntemini çağırın. Geçerli değerler 0 ile 2 arasındadır; burada 1 orijinal 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 değerinden yüksek ayarlamanızı önermiyoruz.

// Set the volume. Valid values: 0 to 2.
aliPlayer.setVolume(1f);
// Get the current volume.
aliPlayer.getVolume();

Oynatıcıyı sessize alma

Oynatıcıyı sessize almak veya sesi açmak için setMute yöntemini çağırın.

aliPlayer.setMute(true); 

UrlSource tabanlı canlı yayın

Daha fazla bilgi için Standart canlı yayın oynatma konusuna bakın.

VidAuth veya VidSts tabanlı oynatma

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

// Retrieve all available track.
List<TrackInfo> trackInfos = aliPlayer.getMediaInfo().getTrackInfos();
//Retrieve the available definitions.
for (TrackInfo trackInfo : trackInfos) {
     if(trackInfo.getType() == TrackInfo.Type.TYPE_VOD){
             // Get video definition. 
        String vodDefinition = trackInfo.getVodDefinition();
     }
}

aliPlayer.selectTrack(index);

aliPlayer.setOnTrackChangedListener(new IPlayer.OnTrackChangedListener() {
    @Override
    public void onChangedSuccess(TrackInfo trackInfo) { }

    @Override
    public void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo) { }
});

PlayerConfig config = aliPlayer.getConfig();
config.mSelectTrackBufferMode = 1;
aliPlayer.setConfig(config)

Desteklenen akış türleri

Aşağıdaki akış türlerinde ses parçalarını değiştirebilirsiniz. Değiştirme davranışı akış türüne göre değişir.

Kullanım örneği

1. onSubTrackReady geri aramasını ayarlayın. Bu geri arama genellikle onPrepared geri aramasından önce tetiklenir.

   aliPlayer.setOnSubTrackReadyListener(new IPlayer.OnSubTrackReadyListener() {
       @Override
       //onSubTrackReady. Typically triggered before the onPrepared callback.
       public void onSubTrackReady(MediaInfo mediaInfo) {
           if (mPlayerTrackFragment != null) {
               //mPlayerTrackFragment.showMediaInfo();
               // Call getSubMediaInfo after this callback is triggered. Calling it before this callback returns an empty result.
               MediaInfo subMediaInfo = aliPlayer.getSubMediaInfo();
               TrackInfos = subMediaInfo.getTrackInfos();
               // Find the target audio track from the track list.
               myTrack = myfunc(TrackInfos)
           }
       }
   });

2. Hedef ses parçasına geçin.

   index = myTrack.getIndex();
   aliPlayer.selectTrack(index);

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

Sorunu cihazınızda güvenilir bir şekilde yeniden üretebildiğinizde bu yöntemi kullanın.

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

   // Logs are stored under com.cicada.player.utils.
   Logger.getInstance(context).enableConsoleLog(true);
   // Default: AF_LOG_LEVEL_INFO. Use AF_LOG_LEVEL_TRACE for troubleshooting.
   Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_INFO);

2. (İsteğe bağlı) Sorun giderme için kare düzeyinde günlük kaydını etkinleştirin.

   // 0: disabled, 1: enabled.
   Logger.getInstance(this).setLogOption(Logger.LogOption.FRAME_LEVEL_LOGGING_ENABLED, value);

3. Sorunu yeniden üretin ve hata günlüğünü Logcat'ten veya geliştirme aracı konsolunuzdan alın.

Yöntem 2: Günlükleri programatik olarak almak için LogCallback ayarlama

Sorunu cihazınızda güvenilir bir şekilde yeniden üretemediğinizde bu yöntemi kullanın. Geri arama, 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.

   // Logs are stored under com.cicada.player.utils.
   // Default: AF_LOG_LEVEL_INFO. Use AF_LOG_LEVEL_TRACE for troubleshooting.
   Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_INFO);
   Logger.getInstance(mContext).setLogCallback(newLogger.OnLogCallback(){
           @Override
           public void onLog(Logger.LogLevel logLevel,Strings){
               // Process the log entry.
           }
   });

2. Bir hata oluştuğunda SDK hata günlüğünü otomatik olarak uygulamanızın günlük kanalına aktarır.