Android player FAQ

The player SDK reports playback progress every 500 ms by default. Adjust the callback interval as needed:

// Modify the callback interval.
PlayerConfig config = mAliyunLivePlayer.getConfig();
config.mPositionTimerIntervalMs = 100;// The callback interval in ms.
mAliyunLivePlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            // The current playback progress.
            long currentPosition = infoBean.getExtraValue();
        }
    }
});

To retrieve raw audio and video data, switch to software decoding and play an unencrypted video:

// Switch to software decoding.
mAliPlayer.enableHardwareDecoder(false);
IPlayer.RenderFrameCallbackConfig renderFrameCallbackConfig = new IPlayer.RenderFrameCallbackConfig();
// Specifies whether to return only the underlying video data address. Default value: true.
renderFrameCallbackConfig.mVideoDataAddr = false;
// Specifies whether to return only the underlying audio data address. Default value: false.
renderFrameCallbackConfig.mAudioDataAddr = false;
mAliPlayer.setRenderFrameCallbackConfig(renderFrameCallbackConfig);

mAliPlayer.setOnRenderFrameCallback(new IPlayer.OnRenderFrameCallback() {
    @Override
    public boolean onRenderFrame(FrameInfo frameInfo) {
        return false;
    }
});

Retrieve the video width and height using one of these methods:

• After the AliPlayer instance enters the `prepared` state:

  mAliyunPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
      @Override
      public void onPrepared() {
            mAliyunPlayer.getVideoWidth();
                mAliyunPlayer.getVideoHeight();
      }
  });

• Listen for the video size change callback:

  mAliyunPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
      @Override
      public void onVideoSizeChanged(int width, int height) {
  
      }
  });

• Use the track info:

  mAliyunPlayer.setOnTrackReadyListener(new IPlayer.OnTrackReadyListener() {
      @Override
      public void onTrackReady(MediaInfo mediaInfo) {
      List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
          for (TrackInfo trackInfo : trackInfos) {
          if(trackInfo.getType() == TrackInfo.Type.TYPE_VIDEO){
          trackInfo.getVideoWidth();
          trackInfo.getVideoHeight();
          }
      }
      }
  });

When you call mAliPlayer.selectTrack(TrackInfo.AUTO_SELECT_INDEX) to enable automatic bitrate switching, the player SDK calculates network speed. If the speed sustains the next bitrate level for 10 seconds, the player switches. Otherwise, it stays at the current bitrate.

• High to low: if the network speed reaches the next bitrate level within 10 seconds, the player finishes cached high-bitrate content before switching.

• Low to high: the player switches immediately once the speed sustains the higher bitrate for 10 seconds.

To use automatic bitrate switching, transcode the video into an adaptive bitrate stream in the console, then configure the player to retrieve it. Example with VidAuth:

VidAuth vidAuth = new VidAuth();
List<Definition> list = new ArrayList<>();
list.add(Definition.DEFINITION_AUTO);
vidAuth.setDefinition(list);

To customize retry logic, set the retry count to 0 and handle retry events externally:

PlayerConfig config = mAliPlayer.getConfig();
// 1. Set the number of retries. In this example, it is set to 0.
config.mNetworkRetryCount = 0;
mAliPlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        // 2. Listen for the retry event.
       if(infoBean.getCode() == InfoCode.NetworkRetry){
            // TODO: Process the logic as needed.
        }
    }
});

Switch between seek modes:

// Inaccurate seek.
mAliPlayer.seekTo(1000);
mAliPlayer.seekTo(1000, IPlayer.SeekMode.Inaccurate);
// Accurate seek.
mAliPlayer.seekTo(1000,IPlayer.SeekMode.Accurate);

Solution: Increase the maximum accurate seek interval to reduce fallback to inaccurate seek. A longer interval improves accuracy but may increase seek time:

// Unit: ms.
mAliPlayer.setMaxAccurateSeekDelta(10000);

Troubleshoot the issue as follows:

1. Check whether the CPU architecture is x86.

   The player SDK supports only the arm64-v8a and armeabi-v7a architectures. It does not support the x86 architecture.

2. Check whether both the .so files and Maven dependencies for the player SDK are integrated in the project.

   For example, you may have integrated the player SDK using a Maven dependency in `build.gradle` and also integrated the player-related dynamic libraries in the `libs` directory of the project's module.

   Recommended: Remove the dynamic libraries and use only the Maven dependency. If you must use dynamic libraries, ensure all .so files are from the same version. Integrate the SDK. The following figure shows the player-related dynamic libraries:

3. If you integrated a partial package, confirm that the AlivcFFmpeg version dependency is correct.

   For information about AlivcFFmpeg version dependencies, see AlivcFFmpeg version dependencies.

Troubleshoot the issue as follows:

1. Confirm whether the crash occurred in the player SDK.

   Check for a crash stack with the AliyunPlayer prefix. If a stack with this prefix exists, the issue is in the player SDK.

2. Upgrade to the latest version of the player SDK and verify whether the issue is fixed.

3. If the issue persists, collect crash files (including all threads), crash logs, and scenario details. How to retrieve issue logs.

Troubleshoot the issue as follows:

1. Check whether the source video itself has black bars.

2. You can adjust the player's scaling mode using the following interface.

   /*
   SCALE_ASPECT_FILL: Fills the screen proportionally. The video is cropped.
   SCALE_ASPECT_FIT: Scales the video proportionally. Black bars may appear.
   SCALE_TO_FILL: Fills the screen without maintaining proportions. The video is distorted.
   */
   mAliPlayer.setScaleMode();

3. If the scaling mode does not meet your needs, you can adjust the size of the SurfaceView or TextureView at the application layer.

Troubleshoot the issue as follows:

1. Play the video with another player to check whether it is an audio-only file.

2. Verify that the display view is correctly configured and not removed from the playback interface. Set the display view as described in Step 4 of Basic features.

Troubleshoot the issue as follows:

1. Check whether the CPU architecture meets the requirements.

   The player SDK supports dynamic libraries for only the arm64-v8a and armeabi-v7a architectures.

2. Check whether the player SDK version is too old.

   If you are using player SDK V5.4.6.0-full or earlier, upgrade to V5.4.6.0-full-15467853 or later. Android SDK release notes.

The list player AliListPlayer supports HLS (m3u8) videos starting from V5.4.5.0, but local caching must be enabled. Local cache.

Example:

// The VidSts playback method is used as an example.
VidSts vidSts = new VidSts();
// The code for setting parameters such as vid, AccessKeyId, AccessKeySecret, and token is omitted. For more information, see the player creation settings in the Basic Features topic.
/*
    Parameter 1: The desired playback definition. Valid values: FD, LD, SD, HD, 2K, 4K, and OD.
    Parameter 2: Specifies whether to enforce playback of the desired definition. false: Does not enforce playback of the desired definition. The player SDK searches for a definition to play based on the default order. true: Enforces playback of the desired definition. If the desired definition is not found, the video is not played.
*/
vidSts.setQuality("",false);