ApsaraVideo VOD:Basic features

To start playing a video, call the play method. The following sample code shows how to start playback:

 fAliplayer.play();

To play a video from a specific time, call the seek method. This is useful in scenarios such as dragging the progress bar or resuming playback. The following sample code shows how to start playback from a specific time:

//// The position parameter specifies the time in milliseconds. The seekMode parameter can be set to FlutterAvpdef.ACCURATE for accurate seeking or FlutterAvpdef.INACCURATE for inaccurate seeking.
fAliplayer.seek(position,seekMode);

To pause video playback, call the pause method. The following sample code shows how to pause playback:

fAliplayer.pause();

To resume video playback, call the play method. The following sample code shows how to resume playback:

fAliplayer.play();

To stop video playback, call the stop method. The following sample code shows how to stop playback:

fAliplayer.stop();

You can synchronously or asynchronously destroy the player. Sample code:

// Synchronously destroy the player. The system automatically calls the stop method.
fAliplayer.destroy();
// Asynchronously destroy the player. The system automatically calls the stop method.
fAliplayer.releaseAsync();

To monitor the status of the player, you can use the `onStateChanged` callback. The parameter of the callback indicates the current status of the player. The following sample code shows how to monitor the player status:

fAliplayer.setOnStateChanged((newState, playerId) {
  // The newState parameter indicates the playback status.
  switch (newState) {
    case FlutterAvpdef.AVPStatus_AVPStatusIdle: // The player is idle.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusInitialzed: // The player is initialized.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusPrepared: // The player is prepared.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusStarted: // Playback is in progress.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusPaused: // Playback is paused.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusStopped: // Playback is stopped.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusCompletion: // Playback is complete.
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusError: // An error occurs during playback.
      break;
    default:
  }
});

You can set one of the following three scaling modes for the video by calling the setScalingMode method: aspect fit, aspect fill, or scale to fill. The following sample code shows how to set the scaling mode:

// Set the mode to aspect fit. The video is scaled down to fit within the view without changing the aspect ratio. No image distortion occurs.
fAliplayer.setScalingMode(FlutterAvpdef.AVP_SCALINGMODE_SCALEASPECTFIT);
// Set the mode to aspect fill. The video is scaled up to fill the view without changing the aspect ratio. No image distortion occurs.
fAliplayer.setScalingMode(FlutterAvpdef.AVP_SCALINGMODE_SCALEASPECTFILL);
// Set the mode to scale to fill. The video is stretched to fill the view. If the aspect ratio of the video is different from that of the view, the image may be distorted.
fAliplayer.setScalingMode(FlutterAvpdef.AVP_SCALINGMODE_SCALETOFILL);

To rotate the video by a specified angle, call the setRotateMode method. After you set the rotation angle, you can query the current angle. The following sample code shows how to rotate the video:

// Set the clockwise rotation to 0 degrees.
fAliplayer.setRotateMode(FlutterAvpdef.AVP_ROTATE_0);
// Set the clockwise rotation to 90 degrees.
fAliplayer.setRotateMode(FlutterAvpdef.AVP_ROTATE_90);
// Set the clockwise rotation to 180 degrees.
fAliplayer.setRotateMode(FlutterAvpdef.AVP_ROTATE_180);
// Set the clockwise rotation to 270 degrees.
fAliplayer.setRotateMode(FlutterAvpdef.AVP_ROTATE_270);
// Get the rotation angle.
fAliplayer.getRotateMode();

You can set the mirroring mode to horizontal, vertical, or none by calling the setMirrorMode method. The following sample code shows how to set the mirroring mode:

// Set the mode to no mirroring.
fAliplayer.setMirrorMode(FlutterAvpdef.AVP_MIRRORMODE_NONE);
// Set the mode to horizontal mirroring.
fAliplayer.setMirrorMode(FlutterAvpdef.AVP_MIRRORMODE_HORIZONTAL);
// Set the mode to vertical mirroring.
fAliplayer.setMirrorMode(FlutterAvpdef.AVP_MIRRORMODE_VERTICAL); 

You can obtain the current playback position from the `onInfo` callback. The value is returned in milliseconds. The following sample code shows how to obtain the current playback progress:

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

You can obtain the total duration of a video. The video duration can be obtained only after the video is loaded. You can obtain the duration after the `AVPEventPrepareDone` event occurs. The following sample code shows how to obtain the video duration:

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

To adjust the volume, call the setVolume method. The volume can be set to a value from 0 to 2. If the value is greater than 1, noise may occur. We do not recommend that you set the value to be greater than 1. After you set the volume, you can also obtain the current volume. The following sample code shows how to adjust the volume:

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

To mute a video that is being played, call the setMute method. The following sample code shows how to mute a video:

fAliplayer.setMute(true);

ApsaraVideo Player SDK for Flutter provides a fast-forward playback feature. By calling the setRate method, you can play a video at a speed of 0.5× to 5×. The audio pitch remains unchanged. The following sample code shows how to set the playback speed:

// Set the playback speed. Speeds from 0.5x to 5x are supported. The speed is usually set to a multiple of 0.5, such as 0.5x, 1x, or 1.5x.
fAliplayer.setRate(1.0);

After a video is loaded, you can obtain the available definitions for the video.

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;
          }
        });
      });    
});

To switch the definition, call the selectTrack method and pass the index of the corresponding `TrackInfo` object.

fAliplayer.selectTrack(trackIdx);

The following callback is triggered after the definition is successfully switched.

fAliplayer.setOnTrackChanged((value,playerId){
 // A callback indicates that the definition is switched successfully. No method is provided for a switching failure.
});

ApsaraVideo Player SDK for Flutter provides a loop playback feature. Call setLoop to enable loop playback. After the video finishes playing, it automatically starts playing again from the beginning. The following sample code shows how to enable loop playback:

fAliplayer.setLoop(true);

The onInfo callback is used to notify you when the loop playback starts. The following sample code shows how to use the callback:

fAliplayer.setOnInfo((infoCode, extraValue, extraMsg, playerId) {
 if(infoCode == FlutterAvpdef.LOOPINGSTART){
 // The notification for the start of loop playback.
 }
});