ApsaraVideo VOD:Gelişmiş özellikler

import com.aliyun.private_service.PrivateService;

PrivateService.setOnPremiumLicenseVerifyCallback(new PrivateService.OnPremiumLicenseVerifyCallback() {
    @Override
    public void onPremiumLicenseVerifyCallback(PrivateService.PremiumBizType type, boolean isValid, String errorMsg) {
        Log.d(TAG, "onPremiumLicenseVerifyCallback: " + type + " isValid: " + isValid + " errorMsg: " + errorMsg);
    }
});

Şeffaflığa sahip videoların oynatılması

/**
 * Set alpha render mode.
 *
 * @param alphaRenderMode The specified alpha render mode. See {@link AlphaRenderMode}.
 */
abstract public void setAlphaRenderMode(AlphaRenderMode alphaRenderMode);

//--------------View usage-------------
// For View, transparency must be set.
//TextureView
TextureView aliplayerView; // View used for playback.
aliplayerView.setOpaque(false);

//SurfaceView
SurfaceView aliplayerView; // View used for playback.
aliplayerView.getHolder().setFormat(PixelFormat.TRANSLUCENT);
aliplayerView.setZOrderOnTop(true); // Place SurfaceView at the top of the display window.

//-----------AliPlayer usage-----------
// Set alpha mode.
aliPlayer.setAlphaRenderMode(IPlayer.AlphaRenderMode.RENDER_MODE_ALPHA_AT_RIGHT);
// Set the asset corresponding to the alpha mode.
UrlSource urlSource = new UrlSource();
urlSource.setUri("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_right.mp4");
aliPlayer.setDataSource(urlSource);
aliPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
        // Optional: If transition issues occur after single-instance playback completes, clear the screen.
        aliPlayer.clearScreen();
    }
}
aliPlayer.setAutoPlay(true);
aliPlayer.prepare();

Android Oynatıcı SDK, SRT, SSA, ASS ve VTT formatlarında harici altyazı ekleme ve değiştirme desteği sunar.

1. Altyazıları görüntülemek için bir görünüm oluşturun.

   Altyazı formatına göre farklı görünümler oluşturun.

   Kodu görüntülemek için genişletin

   // For displaying SRT and VTT subtitles.
   SubtitleView subtitleView = new SubtitleView(getContext());
   // For player V7.6.0 and later, we recommend using VttSubtitleView to display SRT and VTT subtitles.
   VttSubtitleView vttSubtitleView = new VttSubtitleView(getContext());
   // For displaying ASS and SSA subtitles.
   AssSubtitleView assSubtitleView = new AssSubtitleView(getContext());
   // Add the subtitle view to the layout.
   viewGroup.addView(assSubtitleView);

   Oynatıcı V7.6.0 veya sonrasını entegre ederken ve SRT ile VTT altyazılarını görüntülemek için VttSubtitleView kullanırken aşağıdaki dinleyiciyi ayarlayın:

   // Required for player 7.6.0 and later.
   mAliPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
       @Override
       public void onVideoSizeChanged(int width, int height) {
           int viewWidth = getWidth();
           int viewHeight = getHeight();
           IPlayer.ScaleMode mode = mVideoListPlayer.getScaleMode();
           SubTitleBase.VideoDimensions videoDimensions = SubTitleBase.getVideoDimensionsWhenRenderChanged(width, height, viewWidth, viewHeight, mode);
           vttSubtitleView.setVideoRenderSize(videoDimensions.videoDisplayWidth, videoDimensions.videoDisplayHeight);
       }
   });

2. Altyazı ekleyin.

   Önemli

   Altyazı dosyalarını onPrepared geri çağırmasında ayarlayın.

   mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
       @Override
       public void onPrepared() {
           // Set subtitles (must be done in onPrepared).
           mAliPlayer.addExtSubtitle(EXT_SUBTITLE_URL);
       }
   });

3. Altyazı ile ilgili dinleyicileri ayarlayın.

   Kodu görüntülemek için genişletin

   mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
               @Override
               public void onSubtitleExtAdded(int trackIndex, String url) {
                   // trackIndex: subtitle index; true: show the subtitle; false: hide the subtitle.
                   mAliPlayer.selectExtSubtitle(trackIndex, true);
               }
   
               @Override
               public void onSubtitleShow(int trackIndex, long id, String data) {
                   // Subtitle.
                   SubtitleView.Subtitle subtitle = new SubtitleView.Subtitle();
                   subtitle.id = String.valueOf(id);
                   subtitle.content = data;
                   // Show subtitle.
                   mSubtitleView.show(subtitle);
               }
   
               @Override
               public void onSubtitleHide(int trackIndex, long id) {
                   // Remove subtitle.
                   mSubtitleView.dismiss(String.valueOf(id));
               }
   
               @Override
               public void onSubtitleHeader(int trackIndex, String header) {
               }
           }
       );

Harici altyazılar (işleme bileşenlerine dayalı özel işleme)

WebVTT harici altyazıları için tam destek, VttSubtitleView ve WebVttResolver kullanılarak uygulanır; bu, altyazı yazı tipi boyutu, rengi ve belirli yazı tiplerinin esnek şekilde özelleştirilmesine olanak tanır.

1. CustomStyleWebVttResolver oluşturun ve WebVttResolver uygulayın.

   public class CustomStyleWebVttResolver extends WebVttResolver {
   
       // Implement creation method.
       public CustomStyleWebVttResolver(Context context) {
           super(context);
           // Initialize fonts and other resources here later.
       }
   }

2. Stilleri özelleştirmek için applyTextSpans yöntemini geçersiz kılın.

   Bu yöntem, üst sınıf temel stilleri ayrıştırdıktan sonra çağrılır ve altyazıların ikincil işlenmesine olanak tanır.

   • Yöntem 1: VttContentAttribute değerini değiştirin ve üst sınıf yöntemini çağırın.

     /**
      * Override text style application logic to implement custom style effects.
      * This method is called after the parent class parses basic styles, allowing secondary processing of font size, color, and other attributes.
      *
      * @param spannableStringBuilder Used to build styled text.
      * @param vttContentAttribute Style attribute object for the current text segment (includes font, color, size, etc.).
      * @param start Start position for style application (inclusive).
      * @param end End position for style application (exclusive).
      */
     @Override
     protected void applyTextSpans(SpannableStringBuilder spannableStringBuilder, VttContentAttribute vttContentAttribute, int start, int end) {
         // Set.
         // Save original font size (in px) for later adjustment.
         // Default font size is 0.0533f times video height.
         double originalFontSizePx = vttContentAttribute.fontSizePx;
     
         // Double the font size.
         vttContentAttribute.fontSizePx = originalFontSizePx * 2;
         
         // Change font color to red.
         vttContentAttribute.mPrimaryColour = Color.argb(255, 255, 0, 0);
     
         // Call parent class method to apply text.
         super.applyTextSpans(spannableStringBuilder, vttContentAttribute, start, end);
     }

   • WebVTT stillerini doğrudan değiştirmek için SpannableStringBuilder üzerinde doğrudan işlem yapın.

     Önemli

     Bu yöntem, yerel WebVTT stillerinin kaybına neden olabilir.

     /**
      * Override text style application logic to implement custom style effects.
      * This method is called after the parent class parses basic styles, allowing secondary processing of font size, color, and other attributes.
      *
      * @param spannableStringBuilder Used to build styled text.
      * @param vttContentAttribute Style attribute object for the current text segment (includes font, color, size, etc.).
      * @param start Start position for style application (inclusive).
      * @param end End position for style application (exclusive).
      */
     @Override
     protected void applyTextSpans(SpannableStringBuilder spannableStringBuilder, VttContentAttribute vttContentAttribute, int start, int end) {
         // Set font color.
         spannableStringBuilder.setSpan(
             new ForegroundColorSpan(Color.RED),
             start, end,
             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         );
         
         // Set absolute size.
         spannableStringBuilder.setSpan(
             new AbsoluteSizeSpan(20), // Unit: px.
             start, end,
             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         );
         
         // Set relative size.
         // spannableStringBuilder.setSpan(
         //     new RelativeSizeSpan(2.0f), // Multiple of TextView default font size.
         //     start, end,
         //     Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         // );
     }

3. Özel yazı tipleri (Typeface) ayarlayın.

   1. Özel yazı tiplerini asset/fonts/ dizininden yükleyin.

      private Typeface mTypeface;
      
      public CustomStyleWebVttResolver(Context context) {
          super(context);
          initializeFonts(context);
      }
      
      private void initializeFonts(Context context) {
          try {
              // Load font from assets/fonts/.
              mTypeface = Typeface.createFromAsset(context.getAssets(), "fonts/LongCang.ttf");
          } catch (Exception e) {
              Log.e("Font", "Failed to load font", e);
              mTypeface = Typeface.DEFAULT; // Safe fallback.
          }
      }

   2. Özel yazı tiplerini altyazılara uygulayın.

      @Override
      protected void applyTextSpans(SpannableStringBuilder builder, VttContentAttribute attr, int start, int end) {
          // Apply custom font.
          // Must be placed after super.applyTextSpans() to override fonts possibly set by the parent class.
          // Calling super.applyTextSpans() is optional.
          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
              builder.setSpan(new TypefaceSpan(mTypeface), start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
          } else {
              builder.setSpan(new CustomTypefaceSpan(mTypeface), start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
          }
      }

      Eski Android sürümleriyle uyumluluk: Android P (API 28) ve öncesi sürümlerdeki TypefaceSpan, Typeface nesnesini doğrudan geçirmeyi desteklemediğinden özel bir MetricAffectingSpan oluşturmanız gerekir.

      /**
        * Custom Typeface Span class.
        * Inherits from MetricAffectingSpan to correctly apply Typeface during text drawing and measurement.
        * Solves the issue where standard TypefaceSpan cannot directly use a Typeface object.
      */
      private static class CustomTypefaceSpan extends MetricAffectingSpan {
      
          // Custom font to apply.
          private final Typeface typeface;
      
          /**
            * Constructor.
            *
            * @param typeface Typeface object to apply (must not be null).
            */
          public CustomTypefaceSpan(Typeface typeface) {
              this.typeface = typeface;
          }
      
          /**
            * Update text drawing state.
            * Called during actual text drawing to set the paint's font.
            *
            * @param tp TextPaint object used for drawing text.
            */
          @Override
          public void updateDrawState(TextPaint tp) {
              tp.setTypeface(typeface);
          }
      
          /**
            * Update text measurement state.
            * Called during text layout calculation (e.g., width, line breaks) to ensure measurement matches actual drawing.
            *
            * @param p TextPaint object used for measuring text.
            */
          @Override
          public void updateMeasureState(TextPaint p) {
              p.setTypeface(typeface);
          }
      }

4. Oynatıcı ile entegre edin.

   1. Altyazı görünümünü başlatın.

      // Initialize subtitleView.
      private void initSubtitleView() {
          // Get context.
          Context context = getContext();
      
          // Create CustomStyleWebVttResolver.
          CustomStyleWebVttResolver mResolver = new CustomStyleWebVttResolver(context);
      
          // Create VttSubtitleView and pass CustomStyleWebVttResolver.
          VttSubtitleView mVttSubtitleView = new VttSubtitleView(context, mResolver);
      
          // Add to video container.
          rootView.addView(mVttSubtitleView);
      }

   2. Harici altyazı geri çağırmalarını bağlayın.

      // Set subtitle listener.
      mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
          @Override
          public void onSubtitleExtAdded(int trackIndex, String url) {
              mAliPlayer.selectExtSubtitle(trackIndex, true);
          }
      
          @Override
          public void onSubtitleShow(int trackIndex, long id, String data) {
              if (mVttSubtitleView != null) {
                  // Show subtitle.
                  mVttSubtitleView.show(id, data); 
              }
          }
      
          @Override
          public void onSubtitleHide(int trackIndex, long id) {
              // Hide subtitle.
              mVttSubtitleView.dismiss(id);
          }
      
          @Override
          public void onSubtitleHeader(int i, String header) {
              if (!TextUtils.isEmpty(header)) {
                  // Apply WebVTT header styles.
                  mVttSubtitleView.setVttHeader(header);
              }
          }
      });

Yalnızca ses oynatma elde etmek için video oynatmayı devre dışı bırakın. Prepare çağrısından önce PlayerConfig'i yapılandırın.

PlayerConfig config = aliPlayer.getConfig();
config.mDisableVideo = true;  // Enable audio-only playback.
aliPlayer.setConfig(config);

Cihaz bulut tabanlı H.265 donanım kod çözme kara listesine ekliyse veya H.265 donanım kod çözme başarısız olursa uyarlamalı düşürme tetiklenir: Bir H.264 yedek akışı varsa oynatıcı bunu kullanır; yoksa H.265 yazılım kod çözmeye düşer.

// Maintain a Map at the application layer to store key-value pairs of original URLs and backup URLs. When switching, query the backup URL in the Map based on the original URL.
 AliPlayerGlobalSettings.setAdaptiveDecoderGetBackupURLCallback(new AliPlayerGlobalSettings.OnGetBackupUrlCallback() {
    @Override
    public String getBackupUrlCallback(int oriBizScene, int oriCodecType, String original_url) {
        String kurl = original_url;
        if (!H265toH264Map.get(kurl).isEmpty()) {
            return H265toH264Map.get(kurl);
        } else {
            return "";
        }
    }
});

Android oynatıcı SDK'sı, mevcut video için snapshot arayüzü tarafından uygulanan bir ekran görüntüsü özelliği sağlar. Orijinal veriyi yakalar ve bunu bitmap olarak döndürür. Geri çağrı arayüzü OnSnapShotListener'dir. Örnek:

// Set screenshot callback.
aliPlayer.setOnSnapShotListener(new OnSnapShotListener(){
    @Override
    public void onSnapShot(Bitmap bm, int with, int height){
        // Obtain the bitmap and image dimensions.
    }
});
// Capture the current playback frame.
aliPlayer.snapshot();

ApsaraVideo VOD'u yapılandırarak Android oynatıcı SDK'sı önizleme oynatmayı uygulayabilir; hem VidSts hem de VidAuth oynatma yöntemlerini destekler (VOD için VidAuth önerilir). Yapılandırma ve kullanım talimatları için Videoları önizleyin konusuna bakın.

VidSts vidSts = new VidSts;
....
VidPlayerConfigGen configGen = new VidPlayerConfigGen();
configGen.setPreviewTime(20);// 20-second preview.
vidSts.setPlayConfig(configGen);// Set for playback source.
...

Android oynatıcı SDK'sı bir donanım kod çözme kara listesi mekanizması sağlar. Donanım kod çözmeyi açıkça kullanamayan cihazlar için etkisiz işlemlerden kaçınmak amacıyla doğrudan yazılım kod çözme kullanılır. Örnek:

DeviceInfo deviceInfo = new DeviceInfo();
deviceInfo.model="Lenovo K320t";
AliPlayerFactory.addBlackDevice(BlackType.HW_Decode_H264 ,deviceInfo );

PlayerConfig kullanarak istek Referer'ını ayarlayın. Konsoldaki Referer kara listesi/beyaz listesi ile birleştirildiğinde erişim izinlerini kontrol eder. Örnek:

// Get configuration first.
PlayerConfig config = aliPlayer.getConfig();
// Set referer, for example: http://example.aliyundoc.com. (Note: Include the protocol part when setting the referer.)
config.mReferrer = referrer;
....// Other settings.
  // Set configuration for the player.
aliPlayer.setConfig(config);

PlayerConfig kullanarak istek UserAgent'ini ayarlayın. Oynatıcı UA'yı isteklere dahil eder. Örnek:

// Get configuration first.
PlayerConfig config = aliPlayer.getConfig();
// Set UA.
config.mUserAgent = "UserAgent to set";
....// Other settings.
  // Set configuration for the player.
aliPlayer.setConfig(config);

PlayerConfig kullanarak ağ zaman aşımı ve yeniden deneme sayısını ayarlayın. Örnek:

// Get configuration first.
PlayerConfig config = aliPlayer.getConfig();
// Set network timeout duration, in milliseconds.
config.mNetworkTimeout = 5000;
// Set timeout retry count. The interval between retries is networkTimeout. networkRetryCount=0 means no retry; the retry policy is determined by the app. Default value is 2.
config.mNetworkRetryCount=2;
....// Other settings.
  // Set configuration for the player.
aliPlayer.setConfig(config);

Android oynatıcı SDK'sı PlayerConfig aracılığıyla önbelleği ve gecikmeyi kontrol etmek için arayüzler sağlar. Örnek:

// Get configuration first.
PlayerConfig config = aliPlayer.getConfig();
// Maximum latency. Note: Valid for live streaming. When latency is large, the player SDK internally synchronizes frames to keep latency within this range.
config.mMaxDelayTime = 5000;
// Maximum buffer duration, in ms. The player loads up to this duration of buffer data each time.
config.mMaxBufferDuration = 50000;
// High buffer duration, in ms. When poor network conditions cause data loading, loading stops when buffer duration reaches this value.
config.mHighBufferDuration = 3000;
// Startup buffer duration, in ms. Shorter duration means faster startup but may cause quick entry into loading state after playback starts.
config.mStartBufferDuration = 500;
....// Other settings.
// Maximum backward buffer duration, in ms. Default is 0.
config.mMaxBackwardBufferDurationMs = 0;

// Set configuration for the player.
aliPlayer.setConfig(config);

PlayerConfig yöntemini kullanarak oynatıcıdaki isteklere HTTP üst bilgi parametreleri ekleyebilirsiniz. Örnek:

// Get configuration first.
PlayerConfig config = aliPlayer.getConfig();
// Define headers.
String[] headers = new String[1];
headers[0]="Host:example.com";// For example, set Host in the header.
// Set headers.
config.setCustomHeaders(headers);
....// Other settings.
  // Set configuration for the player.
aliPlayer.setConfig(config);

Resim İçinde Resim

Yordam:

1. AndroidManifest.xml dosyasında Resim İçinde Resim izinlerini beyan edin.

   <activity
     android:name=".PictureInPictureActivity"
     android:exported="true"
     android:supportsPictureInPicture="true"
     android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation" />

2. Hedef Activity'yi Resim İçinde Resim moduna geçirin.

   Rational aspectRatio = new Rational(16, 9); // Aspect ratio for Picture-in-Picture; adjust based on your business needs.
   PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
   pipBuilder.setAspectRatio(aspectRatio);
   enterPictureInPictureMode(pipBuilder.build());

   Resim İçinde Resim modunu OnClick (tıklama olayı), uygulamadan çıkarken veya uygulamaya dönerken tetikleyebilirsiniz. Uygulama yöntemleri:

   OnClick (tıklama olayı) tetikleme

   button.setOnClickListener(new View.OnClickListener() {
       @Override
       public void onClick(View v) {
           Rational aspectRatio = new Rational(16, 9); // Aspect ratio for Picture-in-Picture.
           PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
           pipBuilder.setAspectRatio(aspectRatio);
           enterPictureInPictureMode(pipBuilder.build());
       }
   });

   Uygulamadan çıkarken tetikleme

   @Override
   protected void onUserLeaveHint() {
       super.onUserLeaveHint();
       Rational aspectRatio = new Rational(16, 9); // Aspect ratio for Picture-in-Picture.
       PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
       pipBuilder.setAspectRatio(aspectRatio);
       enterPictureInPictureMode(pipBuilder.build());
   
       Log.e(TAG, "Picture-in-Picture onUserLeaveHint");
   }

   Uygulamaya dönerken tetikleme

   @Override
   public void onBackPressed() {
       super.onBackPressed();
       // Trigger from back press.
       enterPictureInPictureMode();
   }

3. Resim İçinde Resim görünümünün/görünmemesinin kullanıcı arayüzünü işleyin.

   @Override
   public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig) {
       super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig);
       if (isInPictureInPictureMode) {
           // Handle entering Picture-in-Picture mode.
           // hide UI
           Log.e(TAG, "Entered Picture-in-Picture mode");
       } else {
           // Handle exiting Picture-in-Picture mode.
           // show UI 
           Log.e(TAG, "Exited Picture-in-Picture mode");
       }
   }

Canlı RTS düşürme

RTS canlı oynatma.

Android oynatıcı SDK'sı, çıktı ses kanalını ayarlamak için setOutputAudioChannel yöntemini sağlar. Giriş kaynağı stereo ise bu yöntemi kullanarak sol veya sağ kanala geçiş yapabilirsiniz. Giriş kaynağı mono ise ayarlamanın etkisi olmaz.

/*
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_LEFT switches to left channel playback,
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_RIGHT switches to right channel playback,
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_NONE does not switch channels, maintaining the input source channels.
*/
aliPlayer.setOutputAudioChannel();

Ses ve video akışı verilerini almak için bir dinleyici ayarlayın. Akışlar şifrelenmemiş olmalıdır çünkü şifreli akışlar ayrıştırılamaz.

// Optional configuration 1: Whether to return the address of underlying data.
IPlayer.RenderFrameCallbackConfig config = new IPlayer.RenderFrameCallbackConfig();
config.mVideoDataAddr = true;// Whether to return only the address of underlying video data.
config.mAudioDataAddr = true;// Whether to return only the address of underlying audio data.
aliPlayer.setRenderFrameCallbackConfig(config);

// Optional configuration 2: For hardware decoding, RenderFrame returns texture_oes_id; for software decoding, RenderFrame returns source data.
aliPlayer.enableHardwareDecoder(true);
// Set listener to obtain audio and video data.
aliPlayer.setOnRenderFrameCallback(frameInfo -> {
    if (frameInfo.frameType == FrameInfo.FrameType_video) {
        // Video data.
    } else {
        // Audio data.
    }
    return false;
});

Android oynatıcı SDK'sı, oynatıcı işlemesi için arka plan rengi ayarlamayı destekler. Arayüz ve kullanım talimatları:

Arayüz örneği

/**
 * Set video background color.
 *
 * @param color  ARGB
 */
abstract public void setVideoBackgroundColor(int color);

Kullanım talimatları

// Parameter is an 8-digit hexadecimal value. Each pair of digits represents A (alpha transparency), R (red), G (green), B (blue) in order.
// For example, 0x0000ff00 represents green.
aliPlayer.setVideoBackgroundColor(0x0000ff00);

vidAuthBelirtilen oynatma alanını ayarlama

vidAuth kullanarak vid için alan gibi alanları belirtebilirsiniz. Desteklenen alanlar için GetPlayInfo istek parametreleri konusuna bakın. Arayüz ve kullanım talimatları:

Arayüz örneği

/**
 * Set playback parameters.
 *
 * @param playConfig Playback parameters.
 */
public void setPlayConfig(VidPlayerConfigGen playConfig);

Kullanım talimatları

playDomain alanını eklemek için VidPlayerConfigGen'in addPlayerConfig yöntemini kullanın.

vidAuth = new VidAuth();
VidPlayerConfigGen configGen = new VidPlayerConfigGen();
// Add playDomain field. For other fields you can add, refer to
//https://www.alibabacloud.com/help/zh/vod/developer-reference/api-vod-2017-03-21-getplayinfo
configGen.addPlayerConfig("playDomain", "com.xxx.xxx");
vidAuth.setPlayConfig(configGen);

H.266 kod çözme eklentisi

H.266 (VVC/Versatile Video Coding), eşdeğer kalitede bit hızını önemli ölçüde azaltan bir sonraki nesil video kodlama standardıdır. H.266 kod çözme yeteneği, isteğe bağlı entegrasyon için bağımsız olarak bir eklenti olarak paketlenmiştir.

Ön koşullar

1. Oynatıcı/entegre SDK sürümü V7.6.0 veya üzeri.

2. Professional Edition lisans yetkilendirmesi tamamlandı. Oynatıcı SDK lisansı edinin.

3. H.266 kod çözme eklentisine sahip ApsaraVideo Player, yalnızca ApsaraVideo VOD ses ve video transkodlama tarafından transkodlanan H.266 videolarını destekler.

Eklentiyi entegre etme

// x.x.x matches the player SDK version number.
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x

// x.x.x matches the integrated SDK version number.
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x-aio

Eklentiyi etkinleştirme

AliPlayerGlobalSettings.enableCodecPlugin("vvc", true);

İlgili hata kodları

H.266 kod çözme eklentisi hata kodları için Tüm platformlardaki oynatıcılar için yaygın sorunlar konusuna bakın.

Oynatma kaynaklarını otomatik yenileme

Oynatma kaynakları için otomatik yenilemeyi etkinleştirmek, kimlik doğrulama mekanizmaları altında kaynak süresinin dolmasından kaynaklanan oynatma kesintilerini önler.

Ön koşullar

1. Oynatıcı/entegre SDK sürümü V7.9.0 veya üzeri.

2. VidAuth kaynağını kullanma veya işletmenizin URL imzalama yapılandırması bulunması.

/**
 * Set the listener for VidAuth source expiration events.
 *
 * This feature enables automated VidAuth source refresh to avoid playback interruptions
 * caused by expiration. When the listener is triggered, you can refresh the VidAuth source
 * and return the updated VidAuth using {@link SourceRefreshCallback#onSuccess}.
 *
 * @param listener The interface for listening to VidAuth source expiration events. See {@link OnVidAuthExpiredListener}.
 */
abstract public void setOnVidAuthExpiredListener(OnVidAuthExpiredListener listener);

/**
 * Listener for VidAuth source expiration notifications.
 * Handles events when a VidAuth source expires.
 */
public interface OnVidAuthExpiredListener {

    /**
     * Called when the player detects that the VidAuth source has expired.
     *
     * You can refresh the VidAuth source in this callback and return the new VidAuth
     * using {@link SourceRefreshCallback#onSuccess}.
     *
     * @param expiredSource The expired VidAuth source object. See {@link VidAuth}.
     * @param callback The callback used to provide the updated VidAuth source to the player. See {@link SourceRefreshCallback}.
     */
    void onVidAuthExpired(VidAuth expiredSource, SourceRefreshCallback<VidAuth> callback);
}

/**
 * A callback interface for handling playback source refresh results.
 *
 * This interface is applicable to playback source types that require dynamic updates,
 * such as URL source or VidAuth source. When the player triggers a refresh request,
 * the refresh result can be returned via this interface by invoking either the `onSuccess` or `onError` method.
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * Called by the player when the refresh operation succeeds.
     *
     * @param newSource The new playback source object containing the updated information. See {@link SourceBase}.
     *
     * This method indicates that the refresh operation was successfully completed. Developers should provide
     * the new playback source within this method so that the player can load the latest resource.
     */
    void onSuccess(T newSource);

    /**
     * Called by the player when the refresh operation fails.
     *
     * @param errorMsg A string describing the reason for the failure.
     *
     * This method indicates that the refresh operation has failed. Developers can use the `errorMsg`
     * to capture details of the failure and proceed with subsequent handling.
     */
    void onError(String errorMsg);
}

// Set VID playback credential expiration listener.
aliPlayer.setOnVidAuthExpiredListener(new AliPlayer.OnVidAuthExpiredListener() {
    @Override
    public void onVidAuthExpired(VidAuth vidAuth, UrlPlayer.SourceRefreshCallback<VidAuth> sourceRefreshCallback) {
        
        String vid = vidAuth.getVid();

        // ------------------- User implementation starts -------------------
        // Call your own function to get new PlayAuth from your app server.
        // clinetGetPlayAuthFunction is an example function name; replace it with your own implementation.
        clinetGetPlayAuthFunction(vid, new PlayAuthCallback() {
            
            /**
             * Callback when new credentials are successfully obtained.
             * @param newPlayAuth New playback credential string obtained from your server.
             */
            @Override
            public void onAuthSuccess(String newPlayAuth) {                
                // 1. Update the old vidAuth object with the new PlayAuth.
                vidAuth.setPlayAuth(newPlayAuth);
                
                // 2. Return the updated object to the player via the SDK callback.
                sourceRefreshCallback.onSuccess(vidAuth);
            }

            /**
             * Callback when obtaining new credentials fails.
             * @param errorMessage Detailed error message.
             */
            @Override
            public void onAuthError(String errorMessage) {                
                // Return the error message to the player via the SDK callback.
                sourceRefreshCallback.onError(errorMessage);
            }
        });
        // ------------------- User implementation ends -------------------
    }
});

/**
 * Set the listener for URL source expiration events.
 *
 * This feature enables URL refresh to avoid playback interruptions caused by
 * URL expiration due to authentication. When the listener is triggered,
 * you can refresh the URL source and return the updated URL source using {@link SourceRefreshCallback#onSuccess}.
 *
 * @param listener Listener for handling URL source expiration events. See {@link OnURLSourceExpiredListener}.
 *
 * <p>For more information on configuring URL authentication, see
 * <a href="https://www.alibabacloud.com/help/zh/vod/user-guide/configure-url-signing?spm=a2c4g.11186623.0.0.560c4140fGh8MW">URL authentication documentation</a>.</p>
 */
abstract public void setOnURLSourceExpiredListener(OnURLSourceExpiredListener listener);

/**
 * A callback interface for handling playback source refresh results.
 *
 * This interface is applicable to playback source types that require dynamic updates,
 * such as URL source or VidAuth source. When the player triggers a refresh request,
 * the refresh result can be returned via this interface by invoking either the `onSuccess` or `onError` method.
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * Called by the player when the refresh operation succeeds.
     *
     * @param newSource The new playback source object containing the updated information. See {@link SourceBase}.
     *
     * This method indicates that the refresh operation was successfully completed. Developers should provide
     * the new playback source within this method so that the player can load the latest resource.
     */
    void onSuccess(T newSource);

    /**
     * Called by the player when the refresh operation fails.
     *
     * @param errorMsg A string describing the reason for the failure.
     *
     * This method indicates that the refresh operation has failed. Developers can use the `errorMsg`
     * to capture details of the failure and proceed with subsequent handling.
     */
    void onError(String errorMsg);
}

/**
 * Listener for URL source expiration notifications.
 * This helps process expired sources and prevents playback interruptions.
 */
public interface OnURLSourceExpiredListener {

    /**
     * Called when the player detects that the URL source (UrlSource) has expired.
     *
     * You can refresh the URL source in this callback and return the new UrlSource
     * using {@link SourceRefreshCallback#onSuccess}.
     *
     * @param expiredSource The expired UrlSource object. See {@link UrlSource}.
     * @param callback The refresh callback used to return the updated UrlSource to the player. See {@link SourceRefreshCallback}.
     */
    void onUrlSourceExpired(UrlSource expiredSource, SourceRefreshCallback<UrlSource> callback);
}

// Set the player's URL expiration listener.
mAliyunVodPlayer.setOnURLSourceExpiredListener(new UrlPlayer.OnURLSourceExpiredListener() {
    @Override
    public void onUrlSourceExpired(UrlSource urlSource, UrlPlayer.SourceRefreshCallback<UrlSource> sourceRefreshCallback) {
        String expiredUrl = urlSource.getUri();
        Log.d(TAG, "[onUrlSourceExpired] Received expired URL: " + expiredUrl);

        // 1. Check if the authentication key is valid (assuming authenticationKey is a member variable of the class).
        if (authenticationKey == null || authenticationKey.trim().isEmpty()) {
            Log.e(TAG, "Refresh failed: Authentication key is empty.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Authentication key is missing.");
            return; // Exit early if the key is invalid.
        }

        // 2. Calculate the validity duration (expiration time) for the playback URL.
        // If the class member validTime is valid, use it; otherwise, default to 3600 seconds (1 hour).
        long validityDuration = (AliyunVodPlayerView.this.validTime > 0) ? validTime : 3600;
        long newExpireTime = (System.currentTimeMillis() / 1000) + validityDuration;

        // 3. Extract the original URL from the expired URL (using authentication type A as an example).
        // Restore the original resource address by removing URL parameters (e.g., "?auth_key=").
        int authKeyIndex = expiredUrl.indexOf("?auth_key=");
        if (authKeyIndex == -1) {
            authKeyIndex = expiredUrl.indexOf("&auth_key=");
        }
        // Safely handle cases where auth_key is not found.
        String originalUrl = (authKeyIndex != -1) ? expiredUrl.substring(0, authKeyIndex) : expiredUrl;

        // 4. Generate a new authenticated URL using a utility class.
        String newAuthUrl = CdnAuthUtil.aAuth(originalUrl, authenticationKey, newExpireTime);

        // 5. Check the generated authenticated URL and return the result via callback.
        if (newAuthUrl != null && !newAuthUrl.isEmpty()) {
            Log.i(TAG, "Refresh success, new URL: " + newAuthUrl);
            // Create a UrlSource object as required by the SDK and set the new URL.
            UrlSource resultSource = new UrlSource();
            resultSource.setUri(newAuthUrl);
            sourceRefreshCallback.onSuccess(resultSource);
        } else {
            Log.e(TAG, "Refresh failed: Failed to generate new authorized URL.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Failed to generate new URL.");
        }
    }
});

Ek yardımcı işlevler

kimlik doğrulama türü A örneği olarak kullanılır.

// Authenticated URL generation function.
private String generateAuthUrl(String uri, String key, long exp) {
    Pattern uriPattern = Pattern.compile("^(https?://)?([^/?]+)(/[^?]*)?(\\?.*)?$");
    Matcher m = uriPattern.matcher(uri);

    if (!m.matches()) {
        return null;
    }

    String scheme = (m.group(1) != null) ? m.group(1) : "http://";
    String host = m.group(2);
    String path = (m.group(3) != null) ? m.group(3) : "/";
    String args = (m.group(4) != null) ? m.group(4) : "";

    String rand = "0";
    String uid = "0";

    String sstring = String.format("%s-%d-%s-%s-%s", path, exp, rand, uid, key);
    String hashvalue = md5sum(sstring);
    String authKey = String.format("%d-%s-%s-%s", exp, rand, uid, hashvalue);

    if (!args.isEmpty()) {
        return String.format("%s%s%s%s&auth_key=%s", scheme, host, path, args, authKey);
    } else {
        return String.format("%s%s%s%s?auth_key=%s", scheme, host, path, args, authKey);
    }
}

// MD5 calculation utility function.
private String md5sum(String src) {
    try {
        MessageDigest md = MessageDigest.getInstance("MD5");
        md.update(src.getBytes(StandardCharsets.UTF_8));
        byte[] digest = md.digest();

        StringBuilder hexString = new StringBuilder();
        for (byte b : digest) {
            hexString.append(String.format("%02x", b));
        }
        return hexString.toString();
    } catch (NoSuchAlgorithmException e) {
        throw new RuntimeException("MD5 algorithm not found", e);
    }
}

Bağlı NIC'i değiştirme

Android oynatıcı SDK'sı, ağ anomalileri sırasında NIC'leri otomatik olarak değiştirmek ve kaynak oynatmanın kararlılığını sağlamak için AliPlayerGlobalSettings.enableSwitchNIC yöntemini sağlar. Örnek:

AliPlayerGlobalSettings.enableSwitchNIC(true);

Ses geliştirmesi

Android oynatıcı SDK'sı, ses oynatma deneyimini iyileştirmek için ses normalleştirme, ses geliştirmesi ve surround ses özelliklerine sahip bir ses geliştirme eklentisi sağlar.

Özellik tanıtımı

• Ses normalleştirme: Tüm ses içeriğini tutarlı bir ses seviyesine otomatik olarak ayarlar; aşırı düşük veya yüksek orijinal sese sahip videolar için oynatma deneyimini önemli ölçüde iyileştirir.

  • Desteklenen kanallar: Mono / Stereo / 5.1 / 7.1.

  • Desteklenen örneklem oranları: 16kHz / 44.1kHz / 48kHz.

• Ses geliştirmesi: Diyaloğu akıllıca geliştirirken orijinal tınıyı korur; gürültülü sahnelerde sesleri daha net ve parlak hale getirir.

  • Desteklenen kanallar: Stereo.

  • Desteklenen örneklem oranları: 44.1kHz / 48kHz.

• Surround ses: Çok kanallı ve stereo videolara sanal surround işlemesi uygular; kulaklıklarda veya standart cihazlarda sürükleyici bir deneyim sağlar. 3DSurround (stereo surround) ve MegaBass (süper bas) modlarını içerir.

  • Desteklenen kanallar: Mono / Stereo / 5.1 / 7.1.

  • Desteklenen örneklem oranları: 44.1kHz / 48kHz.

Ön koşullar

1. Oynatıcı SDK sürümü V7.13.0 veya üzeri.

2. Professional Edition Lisans yetkilendirmesi alındı. Oynatıcı SDK lisansı edinin.

Eklentiyi entegre etme

// x.x.x matches the player SDK version number.
implementation 'com.aliyun.sdk.android:AlivcAudioEnhanceFilter:x.x.x'

Özellik arayüzleri

player.setFilterValid("audioEnhance", true);   // Enable.
player.setFilterValid("audioEnhance", false);  // Disable.

FilterConfig filterConfig = new FilterConfig();
FilterConfig.Filter filterItem = new FilterConfig.Filter("audioEnhance");
FilterConfig.FilterOptions opts = new FilterConfig.FilterOptions();
// Surround sound.
opts.setOption("enable_surround", true);
opts.setOption("surround_effect_type", "3DSurround"); // Type must be set together with enable_surround on first use.
// Voice enhancement.
opts.setOption("enable_dialoguenhance", true);
opts.setOption("dialoguenhance_voice", 1.0f); // 1.0 ~ 10.0. Voice must be set together with enable_dialoguenhance on first use.
// Volume normalization.
opts.setOption("enable_normalizer", true);

filterItem.setOptions(opts);
filterConfig.addFilter(filterItem);
player.setFilterConfig(filterConfig);

AVPFilterOptions *opts = [[AVPFilterOptions alloc] init];
[opts setOptions:@"enable_surround" value:@YES];
[opts setOptions:@"surround_effect_type" value:@"3DSurround"]; // If not the first time enabling surround, this Type setting is invalid because initialization is already complete.
[player updateFilterConfig:@"audioEnhance" options:opts];

/**
 * Set the player scenario.
 *
 * @param scene 
 */
abstract public void setPlayerScene(PlayerScene scene);

public enum PlayerScene {
    /**
     * Scenario: none.
     */
    NONE,
    /**
     * Long video scenario: applies to videos longer than 30 minutes.
     */
    LONG,
    /**
     * Medium video scenario: applies to videos between 5 and 30 minutes.
     */
    MEDIUM,
    /**
     * Short video scenario: applies to videos up to 5 minutes.
     */
    SHORT,
    /**
     * Live scenario.
     */
    LIVE,
    /**
     * Ultra-low latency live scenario.
     */
    RTS_LIVE
}

// Set short video scenario.
aliPlayer.setPlayerScene(PlayerScene.SHORT)

// Set medium video scenario.
aliPlayer.setPlayerScene(PlayerScene.MEDIUM)

// Set long video scenario.
aliPlayer.setPlayerScene(PlayerScene.LONG)

// Set live scenario.
aliPlayer.setPlayerScene(PlayerScene.LIVE)

Android oynatıcı SDK'sı, oynatma başlamadan önce ilk karenin hızlı bir şekilde işlenmesini destekler; bu, başlatma hızını iyileştirebilir.

aliPlayer.setOption(ALLOW_PRE_RENDER, 1);

Yerel önbellek, tekrarlanan oynatma için başlatma hızını ve atlama hızını iyileştirir, takılmayı azaltır ve bant genişliğinden tasarruf sağlar.

Yerel önbelleği etkinleştirme

// Enable local cache (default path).
AliPlayerGlobalSettings.enableLocalCache(true, this);

/**
 * You can also use the following code for cache settings.
 * Enable local cache. After enabling, content is cached to local files.
 * @param enable: Local cache feature switch. true: enable, false: disable. Disabled by default.
 * @param maxBufferMemoryKB: Deprecated since version 5.4.7.1, currently has no effect.
 * @param localCacheDir: Must be set. Local cache directory as an absolute path.
 * AliPlayerGlobalSettings.enableLocalCache(enable, maxBufferMemoryKB, localCacheDir);
 */

/**
 * Local cache file cleanup configuration.
 * @param expireMin - Deprecated since version 5.4.7.1, currently has no effect.
 * @param maxCapacityMB - Maximum cache capacity in MB. Default is 20 GB. During cleanup, if total cache size exceeds this value, cache items are deleted one by one from oldest to newest until size is ≤ maxCapacityMB.
 * @param freeStorageMB - Minimum free disk space in MB. Default is 0. During cleanup, if current disk space is less than this value, cache items are deleted one by one until free space ≥ this value or all cache is cleared.
 * public static void setCacheFileClearConfig(long expireMin,
 *         long maxCapacityMB,
 *         long freeStorageMB)
 */

 /**
  * Set callback for loading URL hash value. If not set, SDK uses MD5 algorithm.
  * public static void setCacheUrlHashCallback(AliPlayerGlobalSettings.OnGetUrlHashCallback cb)
  */

Tek bir URL için yerel önbelleği etkinleştirme veya devre dışı bırakma

// Get configuration first.
PlayerConfig config = aliPlayer.getConfig();
// Whether to enable local cache for the playback URL. Default is true. When global local cache is enabled and this is set to true, local cache takes effect for this URL. If set to false, local cache is disabled for this URL.
config.mEnableLocalCache = false;
....// Other settings.

// Set configuration for the player.
aliPlayer.setConfig(config);

Ön yükleme, video önbellekleme için bellek kullanımını ayarlayarak video başlatma hızını iyileştiren yerel önbelleğin yükseltmesidir.

AliPlayerGlobalSettings.enableNetworkBalance(false);

1. Yerel önbelleği etkinleştirin. Ayrıntılı adımlar için Yerel önbellek konusuna bakın.

2. Veri kaynağını ayarlayın.

   VidAuth (önerilir)

   VidAuth vidAuth = new VidAuth();
   vidAuth.setVid("Vid info");// Required parameter: Video ID.
   vidAuth.setPlayAuth("<yourPlayAuth>");// Required parameter: Playback credential, generated by calling the GetVideoPlayAuth API of VOD.
   vidAuth.setRegion("Access region");// For player SDK version 5.5.5.0 and later, this parameter is deprecated and not required; the player automatically parses the region. For versions before 5.5.5.0, this parameter is required; the default VOD access region is cn-shanghai.
   vidAuth.setQuality("Selected definition") //"AUTO" represents adaptive bitrate.

   VidSts

   VidSts vidSts = new VidSts();
   vidSts.setVid("Vid info");// Required parameter: Video ID. vidSts.setAccessKeyId("<yourAccessKeyId>");// Required parameter: Access key ID of the STS temporary AK pair, generated by calling the AssumeRole API of STS.  vidSts.setAccessKeySecret("<yourAccessKeySecret>");// Required parameter: Access key of the STS temporary AK pair, generated by calling the AssumeRole API of STS.  vidSts.setSecurityToken("<yourSecurityToken>");// Required parameter: STS security token, generated by calling the AssumeRole API of STS.  vidSts.setRegion("Access region");// Required parameter: VOD access region; default is cn-shanghai.
   vidSts.setQuality("Selected definition") //"AUTO" represents adaptive bitrate.

   UrlSource

   UrlSource urlSource = new UrlSource();
   urlSource.setUri("Playback address");// Required parameter: Playback address, which can be a third-party VOD address or an Alibaba Cloud VOD playback address.

3. Görev parametrelerini ayarlayın.

   Not

   Yalnızca çoklu bit hızlı videolar için geçerlidir. setDefaultBandWidth, setDefaultResolution veya setDefaultQuality seçeneklerinden birini seçin.

   PreloadConfig preloadConfig = new PreloadConfig();
   // Set preloading bitrate for multi-bitrate streams.
   preloadConfig.setDefaultBandWidth(400000);
   // Set preloading resolution for multi-bitrate streams.
   preloadConfig.setDefaultResolution(640 * 480);
   // Set preloading quality for multi-bitrate streams.
   preloadConfig.setDefaultQuality("FD");
   // Set preloading duration.
   preloadConfig.setDuration(1000);

4. Görev dinleyicisi ekleyin.

   Kodu görüntülemek için genişletin

   /**
    * Preloading listener implementation.
    */
   private static class PreloadListenerImpl extends OnPreloadListener {
   
       @Override
       public void onError(@NonNull String taskId, @NonNull String urlOrVid, @NonNull ErrorInfo errorInfo) {
           // Loading error.
       }
   
       @Override
       public void onCompleted(@NonNull String taskId, @NonNull String urlOrVid) {
           // Loading completed.
       }
   
       @Override
       public void onCanceled(@NonNull String taskId, @NonNull String urlOrVid) {
          // Loading canceled.
       }
   }

5. Görevi oluşturun ve ön yüklemeyi başlatmak için MediaLoaderV2 örneğine ekleyin.

   VidAuth (önerilir)

   // Build preloading.
   PreloadTask mPreloadTask = new PreloadTask(vidAuth, preloadConfig);
   // Get MediaLoaderV2 instance.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Add task and start preloading.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

   VidSts

   // Build preloading.
   PreloadTask mPreloadTask = new PreloadTask(vidSts, preloadConfig);
   // Get MediaLoaderV2 instance.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Add task and start preloading.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl);

   UrlSource

   // Build preloading.
   PreloadTask mPreloadTask = new PreloadTask(urlSource, preloadConfig);
   // Get MediaLoaderV2 instance.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Add task and start preloading.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

6. İsteğe bağlı: Görevleri yönetin.

   mediaLoaderV2.cancelTask(taskId);// Cancel preloading task with specified task ID.
   mediaLoaderV2.pauseTask(taskId);// Pause preloading task with specified task ID.
   mediaLoaderV2.resumeTask(taskId);// Resume preloading task with specified task ID.

7. İsteğe bağlı: Yüklenen dosyaları silin.

   Alan tasarrufu sağlamak için gerektiğinde yüklenen dosyaları silin. Android oynatıcı SDK'sı bir silme arayüzü sağlamaz; dosyaları uygulamanızdaki yükleme dizininden silin.

Dinamik ön yükleme stratejisi, entegratörlerin hem şu anda oynatılan videonun önbelleğini hem de ön yüklenen öğelerin sayısını ve önbelleğini kontrol etmesine olanak tanır; bu, oynatma deneyimi ile maliyet yükü arasında denge kurar.

// Enable recommended configuration and dynamic preloading.
aliListPlayer.setPreloadScene(IListPlayer.SceneType.SCENE_SHORT);

// Configure baseline preloading duration.
// Set preloading duration to 1000ms.
PreloadConfig config = new PreloadConfig();
config.mPreloadDuration = 1000;
aliListPlayer.updatePreloadConfig(config);

// Configure number of preloads, supporting bidirectional.
// 1 for forward preloads, 3 for backward preloads.
aliListPlayer.setPreloadCount(1, 3);

// Configure dynamic preloading decrement offset.
aliListPlayer.enablePreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, true);
aliListPlayer.setPreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, "{\"algorithm\": \"sub\",\"offset\": \"200\"}");

Çoklu bit hızlı HLS videolarının ön yüklenmesi

listPlayer + çoklu bit hızlı HLS video oynatma senaryolarında entegratörler mevcut oynatma tanımıyla eşleşen akışları ön yükleyebilir ve iş ihtiyaçlarına göre ön yükleme modlarını seçebilir.

  /**
   * Default configuration, play and preload default bitrate.
   */
  MultiBitratesMode_Default(0),

  /**
   * First frame priority configuration, decrease first frame cost. Only play bitrate of the HLS stream which has been preloaded.
   */
  MultiBitratesMode_FCPrio(1),

  /**
   * Balance first frame and playback smoothness, play the same bitrate before and after moveToNext, and prioritize first frame performance.
   */
  MultiBitratesMode_FC_AND_SMOOTH(2),

  /**
   * Playback smoothness priority configuration, play the same bitrate before and after moveToNext.
   */
  MultiBitratesMode_SmoothPrio(3);

// Select multi-bitrate loading mode.
aliListPlayer.SetMultiBitratesMode(preLoadMode);

// (Optional) Select startup bitrate.
aliListPlayer.setDefaultBandWidth(defaultBandWidth)

// (Optional) In onPrepared callback, select ABR mode.
aliListPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        // ABR only affects multi-bitrate m3u8.
        aliListPlayer.selectTrack(-1);
    }
});

getExtraValue arayüzü tarafından uygulanan onInfo geri çağrısı aracılığıyla mevcut video indirme hızını alın. Örnek:

aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentDownloadSpeed){
            // Current download speed.
            long extraValue = infoBean.getExtraValue();
        }
    }
});

HTTPDNS

// Enable enhanced HTTPDNS.
AliPlayerGlobalSettings.enableEnhancedHttpDns(true);
// Optional: Add HTTPDNS pre-resolution domains.
DomainProcessor.getInstance().addPreResolveDomain("player.***alicdn.com");

HTTP/2

AliPlayerGlobalSettings.setUseHttp2(true);

HTTP ön bağlantılı TCP

HTTP video oynatma istekleri (HTTPS olmayan) için TCP bağlantılarını önceden kurmak kullanıcı deneyimini önemli ölçüde iyileştirir, ağ bağlantı süresini azaltır, anında ve sürekli oynatma sağlar ve ağ ile sistem kaynağı kullanımını optimize eder. Kullanım:

// Domain format is host[:port]; port is optional. Separate multiple domains with semicolons (;).
// Global setting.
// Full interface uses the current string each time it's set (more - add, less - remove). Empty string stops pre-connection.
AliPlayerGlobalSettings.setOption(AliPlayerGlobalSettings.SET_PRE_CONNECT_DOMAIN, "domain1;domain2");

Android oynatıcı SDK'sı, VOD hizmetleri için bir video indirme özelliği sağlar; kullanıcıların ApsaraVideo Player kullanarak videoları yerel olarak önbelleğe almalarına olanak tanır. Standart indirme ve güvenli indirme olmak üzere iki indirme yöntemi sunar.

• Standart indirme

  İndirilen video verileri Alibaba Cloud tarafından şifrelenmez ve üçüncü taraf oynatıcılar tarafından oynatılabilir.

• Güvenli indirme

  İndirilen video verileri Alibaba Cloud tarafından şifrelenir. Üçüncü taraf oynatıcılar bunu oynatamaz. Yalnızca ApsaraVideo Player bunu oynatabilir.

Kullanım talimatları

• Yalnızca VidSts ve VidAuth yöntemleri video indirmeyi destekler.

• Oynatıcının video indirme özelliğini kullanmak için VOD konsolunda indirme modunu etkinleştirin ve yapılandırın. Ayrıntılı adımlar için Çevrimdışı indirme konusuna bakın.

• Video indirme kaldığı yerden indirmeyi destekler.

Yordam

1. İsteğe bağlı: Güvenli indirme için şifreleme doğrulama dosyasını yapılandırın. Yalnızca güvenli indirme için gereklidir; standart indirme için gerekli değildir.

   Not

   Yapılandırılan şifreleme doğrulama dosyasının uygulama bilgilerinizle eşleştiğinden emin olun; aksi takdirde video indirme başarısız olur.

   Güvenli indirme için VOD konsolunda oluşturulan anahtar dosyasını video indirme ve oynatma sırasında şifre çözme doğrulaması için oynatıcı SDK'sında yapılandırın. Anahtar dosyası oluşturma için Güvenli indirmeyi etkinleştir konusuna bakın.

   Bunu Application'da bir kez yapılandırmanızı öneririz. Örnek:

   PrivateService.initService(getApplicationContext(),  "Path to encryptedApp.dat file"); // We recommend storing the encryptedApp.dat verification file on the phone and setting its local file path here.

2. İndiriciyi oluşturun ve ayarlayın.

   AliDownloaderFactory kullanarak bir indirici oluşturun. Örnek:

   AliMediaDownloader mAliDownloader = null;
   ......
   // Create downloader.
   mAliDownloader = AliDownloaderFactory.create(getApplicationContext());
   // Configure download save path.
   mAliDownloader.setSaveDir("Save folder path");

3. Olay dinleyicilerini ayarlayın.

   İndirici birden çok olay dinleyicisi sağlar. Örnek:

   Kodu görüntülemek için genişletin

   mAliDownloader.setOnPreparedListener(new AliMediaDownloader.OnPreparedListener() {
      @Override
      public void onPrepared(MediaInfo mediaInfo) {
          // Download item prepared successfully.
      }
   });
   mAliDownloader.setOnProgressListener(new AliMediaDownloader.OnProgressListener() {
      @Override
      public void onDownloadingProgress(int percent) {
          // Download progress percentage.
      }
      @Override
      public void onProcessingProgress(int percent) {
          // Processing progress percentage.
      }
   });
   mAliDownloader.setOnErrorListener(new AliMediaDownloader.OnErrorListener() {
      @Override
      public void onError(ErrorInfo errorInfo) {
          // Download error.
      }
   });
   mAliDownloader.setOnCompletionListener(new AliMediaDownloader.OnCompletionListener() {
      @Override
      public void onCompletion() {
          // Download successful.
      }
   });

4. İndirme kaynağını hazırlayın.

   prepare yöntemini kullanarak indirme kaynağını hazırlayın. İndirme kaynakları VidSts ve VidAuth yöntemlerini destekler. Örnekler:

   • VidSts

     // Create VidSts
     VidSts aliyunVidSts = new VidSts();
     aliyunVidSts.setVid("Vid information"); // Video ID (VideoId).
     aliyunVidSts.setAccessKeyId("<yourAccessKeyId>"); // AccessKey ID of the temporary STS AccessKey pair, generated by calling the AssumeRole operation of the Security Token Service (STS).
     aliyunVidSts.setAccessKeySecret("<yourAccessKeySecret>"); // AccessKey secret of the temporary STS AccessKey pair, generated by calling the AssumeRole operation of the Security Token Service (STS).
     aliyunVidSts.setSecurityToken("<yourSecurityToken>"); // Security Token Service (STS) token, generated by calling the AssumeRole operation of the Security Token Service (STS).
     aliyunVidSts.setRegion("region"); // The region of the video-on-demand (VOD) service. Default value: cn-shanghai.
     // If you have enabled HLS encryption parameter pass-through in the VOD console and the default parameter name is MtsHlsUriToken,
     // you must set the config and pass it into the vid, as shown below.
     // If you have not enabled HLS encryption parameter pass-through in the VOD console, skip the following code.
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     aliyunVidSts.setPlayerConfig(vidConfig);
             
     
     // Prepare the download source
     mAliDownloader.prepare(aliyunVidSts)

   • VidAuth

     // Create VidAuth.
     VidAuth vidAuth = new VidAuth();
     vidAuth.setVid("Vid info");// Video ID.
     vidAuth.setPlayAuth("<yourPlayAuth>");// Playback credential, generated by calling VOD GetVideoPlayAuth API.
     vidAuth.setRegion("Access region");// For player SDK version 5.5.5.0 and later, this parameter is deprecated and not required; the player automatically parses the region. For versions before 5.5.5.0, this parameter is required; VOD access region default is cn-shanghai.
     // If you enabled HLS standard encryption parameter pass-through in VOD console with default parameter name MtsHlsUriToken, set config and pass it to vid as follows.
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     vidAuth.setPlayerConfig(config);
     // Prepare download source.
     mAliDownloader.prepare(vidAuth);

   Not

   • Kaynak dosya formatı indirilen dosya formatıyla eşleşir; değiştirilmesi desteklenmez.

   • VOD konsolunda HLS standart şifreleme parametre passthrough'unu varsayılan parametre adı MtsHlsUriToken ile etkinleştirdiyseniz HLS standart şifreleme parametre passthrough'u konusuna bakın, ardından yukarıda gösterildiği gibi VOD kaynağında MtsHlsUriToken değerini ayarlayın.

5. Hazırlık başarılı olduktan sonra indirme öğesini seçin ve indirmeyi başlatın.

   Hazırlık başarılı olduktan sonra OnPreparedListener yöntemi çağrılır. Dönen TrackInfo, video akışı tanımı gibi bilgileri içerir. İndirmek için bir Track seçin. Örnek:

   public void onPrepared(MediaInfo mediaInfo) {
       // Download item prepared successfully.
       List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
       // For example: download the first TrackInfo.
       mAliDownloader.selectItem(trackInfos.get(0).getIndex());
       // Start download.
       mAliDownloader.start();
   }

6. (İsteğe bağlı) İndirme kaynağını güncelleyin.

   VidSts ve VidAuth süresinin dolmasını önlemek için indirme kaynağı bilgilerini güncelleyebilir ve indirmeyi başlatabilirsiniz. Örnek:

   // Update download source.
   mAliDownloader.updateSource(VidSts);
   // Start download.
   mAliDownloader.start();

7. İndirme başarılı veya başarısız olduktan sonra indiriciyi serbest bırakın.

   İndirme başarılı olduktan sonra indiriciyi serbest bırakmak için release veya onCompletion geri çağrısında onError yöntemini çağırın. Örnek:

   mAliDownloader.stop();
   mAliDownloader.release();

8. İsteğe bağlı: İndirilen dosyaları silin.

   İndirme sırasında veya sonrasında indirilen dosyaları silebilirsiniz. Örnek:

   // Delete file via object.
   mAliDownloader.deleteFile();
   // Delete via static method; returns 0 if successful.
   AliDownloaderFactory.deleteFile("Path to download folder","Video ID","Video format","Downloaded video index");

Sonraki adımlar

İndirilen videolar ApsaraVideo Player kullanılarak oynatılabilir. Adımlar:

1. İndirme tamamlandıktan sonra video dosyasının mutlak yolunu alın.

   String path = mAliDownloader.getFilePath();

2. Oynatma için VOD UrlSource aracılığıyla mutlak yolu ayarlayın.

    UrlSource urlSource = new UrlSource();
           urlSource.setUri("Playback address");// Set absolute path of downloaded video.
           aliPlayer.setDataSource(urlSource);