ApsaraVideo VOD:Advanced features

ApsaraVideo Player SDK for Flutter supports hardware decoding for H.264 and H.265. It also provides the setEnableHardwareDecoder method, which is enabled by default. If hardware decoding fails to initialize, the player automatically switches to software decoding to ensure uninterrupted playback. The following code provides an example:

// Enable hardware decoding. This feature is enabled by default.
fAliplayer.setEnableHardwareDecoder(enable);

ApsaraVideo Player SDK for Flutter provides a snapshot capture feature, implemented through the setOnSnapShot method.

// The listener for successful snapshot capturing.
fAliplayer.setOnSnapShot((path,playerId) {

});
// Capture a snapshot. path specifies the path where the image is saved.
fAliplayer.snapshot(path);

After you configure the preview feature, call the previewTime method of the setVidAuth interface to set the preview duration. The following code provides an example:

// previewTime specifies the preview duration in seconds.
// VidAuth-based playback
fAliplayer.setVidAuth(
 vid: "Enter the VID of the resource",
 region: "Enter the region of the resource",
 playAuth: "Enter the PlayAuth of the resource",
 previewTime: "Enter the preview duration in seconds");

 // VidSts-based playback
 fAliplayer.setVidSts(
 vid: "Enter the VID of the resource",
 region: "Enter the region of the resource",
 accessKeyId: "Enter the AccessKey ID of the resource",
 accessKeySecret: "Enter the AccessKey secret of the resource",
 securityToken: "Enter the security token of the resource",
 previewTime: "Enter the preview duration in seconds");

You can configure additional playback settings for ApsaraVideo Player SDK for Flutter. Set these configurations before calling the prepare() method.

var configMap = {
 'mStartBufferDuration':_mStartBufferDurationController.text,// The buffer duration before playback starts. Unit: milliseconds.
 'mHighBufferDuration':_mHighBufferDurationController.text,// The high buffer duration. Unit: milliseconds.
 'mMaxBufferDuration':_mMaxBufferDurationController.text,// The maximum buffer duration. Unit: milliseconds.
 'mMaxDelayTime': _mMaxDelayTimeController.text,// The maximum latency for live streaming. Unit: milliseconds. Note: This parameter is valid only for live streaming.
 'mNetworkTimeout': _mNetworkTimeoutController.text,// The network timeout period. Unit: milliseconds.
 'mNetworkRetryCount':_mNetworkRetryCountController.text,// The number of retries after a network timeout.
 'mMaxProbeSize': _mMaxProbeSizeController.text,// The maximum probe size.
 'mReferrer': _mReferrerController.text,// The referrer.
 'mHttpProxy': _mHttpProxyController.text,// The HTTP proxy.
 'mEnableSEI': mEnableSEI,// Specifies whether to enable Supplemental Enhancement Information (SEI).
 'mClearFrameWhenStop': !mShowFrameWhenStop,// Specifies whether to clear the frame when playback stops.
 'mDisableVideo': mDisableVideo,// Specifies whether to disable video.
 'mDisableAudio': mDisableAudio,// Specifies whether to disable audio.
 'mUserAgent':mUserAgent,// The User-Agent.
};
// Apply the configuration.
fAliplayer.setConfig(configMap);

ApsaraVideo Player SDK for Flutter provides local caching to store videos during playback. This helps reduce traffic when users replay videos. To use this feature, enable enableLocalCache for the player before calling prepare. The following code provides an example:

/**
 *  Enable local caching. After this feature is enabled, videos are cached to local files.
 *
 *  @param enable - The switch for the local caching feature. true: enables local caching. false: disables local caching. Default value: false.
 *  @param maxBufferMemoryKB - This parameter is deprecated and has no effect in v5.4.7.1 and later.
 *  @param localCacheDir - The directory of the cached file. This must be an absolute path.
 *  @param mDocTypeForIOS - The type of the sandbox directory on your iOS device.
 */
FlutterAliplayer.enableLocalCache(bool enable,String maxBufferMemoryKB,String localCacheDir,DocTypeForIOS mDocTypeForIOS);

/**
  * Configurations for clearing local cache files.
  *
  * @param expireMin - This parameter is deprecated and has no effect in v5.4.7.1 and later.
  * @param maxCapacityMB - The maximum cache size. Unit: MB. Default value: 20 GB. When the system clears the cache, if the total cache size exceeds this limit, the system sorts cache items by their last access time and deletes the oldest cached files one by one until the total cache size is less than or equal to the limit.
  * @param freeStorageMB - The minimum free disk space. Unit: MB. Default value: 0. When the system clears the cache, if the current free disk space is less than this value, the system also deletes cached files one by one according to the rules until the free disk space is greater than or equal to this value or all cached files are cleared.
  */
FlutterAliplayer.setCacheFileClearConfig(String expireMin,String maxCapacityMB,String freeStorageMB);

ApsaraVideo Player SDK for Flutter supports downloading on-demand videos for offline playback. Two download modes are available: normal download and secure download.

• Normal download

  Videos downloaded in this mode are not encrypted by Alibaba Cloud and can be played using third-party players.

• Secure download

  Videos downloaded in this mode are encrypted by Alibaba Cloud and can be played only using ApsaraVideo Player SDK.