Basic features

Use the play method to start playback. Example:

 fAliplayer.play();

Use the seek method to jump to a specific time. This is useful for progress bar dragging or resuming playback from a saved position. Example:

// position is the specified time in milliseconds. Valid values for seekMode: FlutterAvpdef.ACCURATE (accurate seek) and FlutterAvpdef.INACCURATE (inaccurate seek).
fAliplayer.seek(position,seekMode);

Use the pause method to pause playback. Example:

fAliplayer.pause();

Use the play method to resume playback. Example:

fAliplayer.play();

Use the stop method to stop playback. Example:

fAliplayer.stop();

Destroy the player instance synchronously or asynchronously. Example:

// Synchronous destruction. The stop method is automatically called internally.
fAliplayer.destroy();
// Asynchronous destruction. The stop method is automatically called internally.
fAliplayer.releaseAsync();

Listen for changes in the player status. The `onStateChanged` callback provides the current status. Example:

fAliplayer.setOnStateChanged((newState, playerId) {
  // newState is the playback status.
  switch (newState) {
    case FlutterAvpdef.AVPStatus_AVPStatusIdle: // Idle
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusInitialzed: // Initialization is complete.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusPrepared: // Preparation is complete.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusStarted: // Playing.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusPaused: // Paused.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusStopped: // Stopped.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusCompletion: // Playback is complete.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusError: // An error occurred.
      break;
    default:
  }
});

The SDK supports three fill modes: aspect fit, aspect fill, and scale to fill. Use the setScalingMode method to set the fill mode. Example:

// Set the mode to aspect fit. The video is scaled down proportionally to fit within the view without distortion.
fAliplayer.setScalingMode(ScaleMode.SCALE_ASPECT_FIT);
// Set the mode to aspect fill. The video is scaled up proportionally to fill the view without distortion.
fAliplayer.setScalingMode(ScaleMode.SCALE_ASPECT_FILL);
// Set the mode to scale to fill. The video may be distorted if its aspect ratio does not match the view's aspect ratio.
fAliplayer.setScalingMode(ScaleMode.SCALE_TO_FILL);

Use the setRotateMode method to rotate the video by a specified angle. You can also retrieve the rotation angle after setting it. Example:

// Rotate the video 0 degrees clockwise.
fAliplayer.setRotateMode(RotateMode.ROTATE_0);
// Rotate the video 90 degrees clockwise.
fAliplayer.setRotateMode(RotateMode.ROTATE_90);
// Rotate the video 180 degrees clockwise.
fAliplayer.setRotateMode(RotateMode.ROTATE_180);
// Rotate the video 270 degrees clockwise.
fAliplayer.setRotateMode(RotateMode.ROTATE_270);
// Get the rotation angle.
fAliplayer.getRotateMode();

The SDK supports horizontal mirroring, vertical mirroring, and no mirroring. Use the setMirrorMode method to configure mirroring. Example:

// Set no mirroring.
fAliplayer.setMirrorMode(MirrorMode.MIRROR_MODE_NONE);
// Set horizontal mirroring.
fAliplayer.setMirrorMode(MirrorMode.MIRROR_MODE_HORIZONTAL);
// Set vertical mirroring.
fAliplayer.setMirrorMode(MirrorMode.MIRROR_MODE_VERTICAL);

Obtain the current playback time in milliseconds from the `onInfo` callback. Example:

fAliplayer.setOnInfo((infoCode,extraValue,extraMsg,playerId){
 if(infoCode==FlutterAvpdef.CURRENTPOSITION){
 // extraValue is the current playback progress.
}
});

Obtain the total video duration after the video is loaded, such as after the `AVPEventPrepareDone` event. Example:

fAliplayer.getMediaInfo().then((value){
 _videoDuration=value['duration'];
});

Adjust the volume using the setVolume method. The supported range is 0 to 2. Values greater than 1 are not recommended because they may cause noise. Example:

// The value of volume is a real number from 0 to 2.
fAliPlayer.setVolume(1);
// Get the volume information.
fAliPlayer.getVolume();

Use the setMute method to mute the player. Example:

fAliplayer.setMute(true);

ApsaraVideo Player SDK for Flutter lets you change the playback speed. Use the setSpeed method to play at 0.5x to 5x the normal speed. The audio pitch remains unchanged. Example:

// Set the playback speed. Speeds from 0.5x to 5x are supported. The speed is usually set in multiples of 0.5, such as 0.5x, 1x, and 1.5x.
fAliplayer.setSpeed(1.0);

After the video is loaded, retrieve the video definition.

fAliplayer.setOnPrepared((playerId) {
  fAliplayer.getMediaInfo().then((value){
        AVPMediaInfoinfo info=AVPMediaInfo.fromJson(value);
        info.tracks.forEach((element){
          if(element.trackType==3){
            // Definition
            String definition=element.trackDefinition;
            // Stream index
            int index=element.trackIndex;
          }
        });
      });    
});

Use the selectTrack method to switch the definition. Pass the index of the corresponding TrackInfo.

fAliplayer.selectTrack(trackIdx);

This callback is triggered after a successful definition switch.

fAliplayer.setOnTrackChanged((value,playerId){
 // A callback indicates that the switch is successful. A method for a failed switch is not yet available.
});

ApsaraVideo Player SDK for Flutter provides loop playback. Call setLoop to enable loop playback. After the video finishes, it automatically restarts from the beginning. Example:

fAliplayer.setLoop(true);

The loop start callback sends notifications through onInfo. Example:

fAliplayer.setOnInfo((infoCode, extraValue, extraMsg, playerId) {
 if(infoCode == FlutterAvpdef.LOOPINGSTART){
 // Loop playback start notification
 }
});