ApsaraVideo VOD:Basic features

You can use the play method to start video playback. The following code provides an example:

 fAliplayer.play();

You can use the seek method to jump to a specific time for playback. This is useful for scenarios such as dragging the progress bar or resuming playback from a specific point. The following code provides an 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);

You can use the pause method to pause video playback. The following code provides an example:

fAliplayer.pause();

You can use the play method to resume video playback. The following code provides an example:

fAliplayer.play();

You can use the stop method to stop video playback. The following code provides an example:

fAliplayer.stop();

You can destroy the player instance synchronously or asynchronously. The following code provides an example:

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

You can listen for changes in the player status. The `onStateChanged` callback provides the current status of the player. The following code provides an 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. You can use the setScalingMode method to set the fill mode. The following code provides an 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);

You can use the setRotateMode method to rotate the video by a specified angle. After you set the rotation, you can also retrieve the rotation angle. The following code provides an 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. Call the setMirrorMode method to configure the mirror mode. The following code provides an 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);

You can obtain the current playback time in milliseconds from the `onInfo` callback. The following code provides an example:

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

You can obtain the total duration of the video after the video is loaded, such as after the `AVPEventPrepareDone` event. The following code provides an example:

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

You can adjust the volume using the setVolume method. The supported value range is 0 to 2. Setting the volume to a value greater than 1 is not recommended because it may cause noise. After setting the volume, you can also retrieve the volume information. The following code provides an example:

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

You can use the setMute method to mute the playing video. The following code provides an example:

fAliplayer.setMute(true);

The ApsaraVideo Player SDK for Flutter lets you change the video playback speed. You can use the setSpeed method to play the video at 0.5× to 5× the normal speed. The pitch of the audio remains unchanged. The following code provides an 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, you can 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.
});

The ApsaraVideo Player SDK for Flutter provides a loop playback feature. Call setLoop to enable loop playback. After the video finishes playing, it automatically restarts from the beginning. The following code provides an example:

fAliplayer.setLoop(true);

The loop start callback also sends notifications through onInfo. The following is an example:

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