IPlayer

All Known Subinterfaces:

AliLiveShiftPlayer
```
public interface IPlayer
```

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`IPlayer.AlphaRenderMode` Alpha rendering modes.
`static interface`	`IPlayer.ConvertURLCallback` URL conversion callback.
`static class`	`IPlayer.IPResolveType` IP resolve type
`static class`	`IPlayer.MirrorMode` Mirroring modes.
`static interface`	`IPlayer.OnAVNotSyncStatusListener` audio and video play not sync status callback.
`static interface`	`IPlayer.OnChooseTrackIndexListener`
`static interface`	`IPlayer.OnCompletionListener` Playback completion callback.
`static interface`	`IPlayer.OnErrorListener` Error callback.
`static interface`	`IPlayer.OnInfoListener` Notification callback.
`static interface`	`IPlayer.OnLoadingStatusListener` Loading status callback.
`static interface`	`IPlayer.OnNetworkStatsListener`
`static interface`	`IPlayer.OnPreparedListener` Preparation success callback.
`static interface`	`IPlayer.OnPreRenderFrameCallback` Pre-render frame callback interface.
`static interface`	`IPlayer.OnRenderFrameCallback` Render frame callback interface.
`static interface`	`IPlayer.OnRenderingStartListener` Rendering start callback.
`static interface`	`IPlayer.OnReportEventListener` report event listener
`static interface`	`IPlayer.OnSeekCompleteListener` Seeking completion callback.
`static interface`	`IPlayer.OnSeiDataListener` SEI data callback.
`static interface`	`IPlayer.OnSnapShotListener` Snapshot creation result callback.
`static interface`	`IPlayer.OnStateChangedListener` Player status update callback.
`static interface`	`IPlayer.OnStreamSwitchedListener` Stream switch by url result callback.
`static interface`	`IPlayer.OnSubtitleDisplayListener` Subtitle display callback.
`static interface`	`IPlayer.OnSubTrackReadyListener` SubStream preparation success callback.
`static interface`	`IPlayer.OnThumbnailListener` Thumbnail image retrieval callback.
`static interface`	`IPlayer.OnTrackChangedListener` Stream switchover callback.
`static interface`	`IPlayer.OnTrackReadyListener` Stream preparation success callback.
`static interface`	`IPlayer.OnUrlExpiredListener` URL expiration callback.
`static interface`	`IPlayer.OnVideoRenderedListener` video render callback
`static interface`	`IPlayer.OnVideoSizeChangedListener` Video size change callback.
`static class`	`IPlayer.Option` player available options
`static class`	`IPlayer.OutputAudioChannel` set output audio channel, support left channel, right channel
`static class`	`IPlayer.PropertyKey` The key to get property
`static class`	`IPlayer.RenderFrameCallbackConfig` Render frame callback configuration
`static class`	`IPlayer.RotateMode` Rotate modes
`static class`	`IPlayer.ScaleMode` Video scaling (rendering) modes.
`static class`	`IPlayer.SeekMode` Seeking modes
`static interface`	`IPlayer.UrlRefreshCallback` URL refresh callback interface.
`static class`	`IPlayer.UrlResult` URL refresh callback.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALLOW_PRE_RENDER` Android player SDK supports quick rendering of the first frame before starting playback, which can improve the playback speed.
`static int`	`completion` The player has completed playing the video or audio.
`static int`	`error` The player has an error.
`static int`	`idle` Blank.
`static int`	`initalized` Initialized.
`static int`	`LINE_FALLBACK_URL` Set backup stream for line priority.
`static int`	`paused` The player is paused.
`static int`	`PLAY_ALLOW_RESET_DISPLAY_VIEW` Android player SDK supports resetting the DisplayView during playback.
`static int`	`PLAYED_DURATION_INCLUDE_SPEED` Android player SDK supports getting the played duration, including playback speed.
`static int`	`PRE_RENDER_MAX_BUFFER_MS` Android player SDK supports setting the maximum cache duration for pre-rendering.
`static int`	`prepared` Prepared.
`static int`	`SET_MEDIA_TYPE`
`static int`	`started` The player is playing video or audio.
`static int`	`stopped` The player is stopped.
`static int`	`unknow` Unknown status.

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addExtSubtitle(java.lang.String url)` Add external subtitles
`void`	`clearScreen()` Clear the screen.
`TrackInfo`	`currentTrack(int type)` Deprecated. Since version 4.7.1, use `currentTrack(TrackInfo.Type)` instead
`TrackInfo`	`currentTrack(TrackInfo.Type type)` Get the currently playing track according to the specified track type.
`void`	`enableHardwareDecoder(boolean enable)` Enable or disable hardware decoding.
`IPlayer.AlphaRenderMode`	`getAlphaRenderMode()` Query the current alpha render mode.
`long`	`getBufferedPosition()` Query the current buffer progress.
`java.lang.String`	`getCacheFilePath(java.lang.String URL)` Deprecated. From 7.0.0, this interface is deprecated.Please use the `AliPlayerGlobalSettings.enableLocalCache(boolean, Context)` interface to enable and configure local cache.
`java.lang.String`	`getCacheFilePath(java.lang.String vid, java.lang.String format, java.lang.String definition, int previewTime)` Deprecated. From 7.0.0, this interface is deprecated. Please use the `AliPlayerGlobalSettings.enableLocalCache(boolean, Context)` interface to enable and configure local cache.
`PlayerConfig`	`getConfig()` Query the player configuration.
`long`	`getCurrentPosition()` Query the current playback position.
`java.lang.String`	`getCurrentVps()` Get the current Video Playback Session ID (VPS).
`long`	`getDuration()` Query the total length of the stream.
`MediaInfo`	`getMediaInfo()` Query media information.
`IPlayer.MirrorMode`	`getMirrorMode()` Query the current mirroring mode.
`long`	`getNativeContextAddr()`
`java.lang.Object`	`getOption(IPlayer.Option key)` gets the player's options parameters
`long`	`getPlayedDuration()` Get the actual play duration, which does not include the time spent in playback pauses, buffering, etc.
`java.lang.String`	`getPlayerName()` Gets the name of the player used when playing
`int`	`getPlayerStatus()` Get the current player status.
`java.lang.String`	`getPropertyString(IPlayer.PropertyKey key)` Get information by key.
`IPlayer.RotateMode`	`getRotateMode()` Query the current rotate mode.
`IPlayer.ScaleMode`	`getScaleMode()` Query the current zoom mode.
`float`	`getSpeed()` Query the playback speed.
`MediaInfo`	`getSubMediaInfo()` Query media information.
`java.lang.String`	`getUserData()` Get the UserData of the current player instance, which can be set via `setUserData(java.lang.String)` to differentiate between different player instances.
`int`	`getVideoHeight()` Query the height of the video.
`int`	`getVideoRotation()` Query the rotate angle of the video.
`int`	`getVideoWidth()` Query the width of the video.
`float`	`getVolume()` Query the volume of the player, which is set by `setVolume(float)`
`boolean`	`isAutoBandWidth()` Get whether adaptive selection of initial playback quality for multi-bitrate playback is enabled.
`boolean`	`isAutoPlay()` Query whether autoplay is enabled.
`boolean`	`isLoop()` Query whether loop playback is enabled.
`boolean`	`isMute()`
`void`	`pause()` Pause playback.
`void`	`prepare()` Prepare the player.
`void`	`redraw()` Deprecated. Deprecated.
`void`	`release()` sync release.
`void`	`releaseAsync()` async release.
`void`	`reload()` Reload.
`void`	`reset()` Reset.
`void`	`seekTo(long position)` Seek to the specified position using inaccurate mode.
`void`	`seekTo(long position, IPlayer.SeekMode seekMode)` Seek to the specified position.
`void`	`selectExtSubtitle(int trackIndex, boolean select)` Select external subtitles
`void`	`selectTrack(int trackInfoIndex)` Select a stream to play.
`void`	`selectTrack(int trackInfoIndex, boolean accurate)` Specify a stream to play.
`void`	`sendCustomEvent(java.lang.String args)` Sends a user-defined event, which will be called back via `IPlayer.OnReportEventListener`.
`void`	`setAlphaRenderMode(IPlayer.AlphaRenderMode alphaRenderMode)` Set alpha render mode, can be used on gift play on live stream, etc.
`void`	`setAutoBandWidth(boolean enable)` Enable or disable adaptive selection of initial playback quality for multi-bitrate playback.
`void`	`setAutoPlay(boolean on)` Enable autoplay.
`void`	`setCacheConfig(CacheConfig cacheConfig)` Deprecated. From version 7.0.0, this interface is deprecated.
`void`	`setConfig(PlayerConfig config)` Modify the player configuration.
`void`	`setDefaultAudioLanguage(java.lang.String language)` Set the default audio language for multi-track playback.
`void`	`setDefaultBandWidth(int bandWidth)` Set the default playback bitrate for multi-bitrate playback.
`void`	`setDefaultResolution(int resolutionProduct)` Set the default playback resolution for multi-bitrate playback.
`void`	`setDefaultSubtitleLanguage(java.lang.String language)` Set the default subtitle language for multi-track playback.
`void`	`setDisplay(android.view.SurfaceHolder holder)` Sets the `SurfaceHolder` used for video rendering.
`void`	`setDisplayView(AliDisplayView view)` Set the display view.
`void`	`setDrmCallback(DrmCallback callback)` set DRM request callback.
`void`	`setFastStart(boolean open)` Set the timing of decoder creation.
`void`	`setFilterConfig(FilterConfig filterConfig)` Set filter config.
`void`	`setFilterInvalid(java.lang.String target, boolean invalid)` disable/enable filter.
`void`	`setFilterValid(java.lang.String target, boolean valid)` enable/disable filter.
`void`	`setIPResolveType(IPlayer.IPResolveType type)` set IPv4/IPv6 resolve type
`void`	`setLoop(boolean on)` Enable loop playback.
`void`	`setMaxAccurateSeekDelta(int delta)` set the maximum interval of precision seek.
`void`	`setMirrorMode(IPlayer.MirrorMode mirrorMode)` Sets the video mirroring mode.
`void`	`setMute(boolean on)` Mute the player.
`void`	`setOnAVNotSyncStatusListener(IPlayer.OnAVNotSyncStatusListener l)` Set an audio and video not sync status callback.
`void`	`setOnChooseTrackIndexListener(IPlayer.OnChooseTrackIndexListener l)` Set a stream to play callback.
`void`	`setOnCompletionListener(IPlayer.OnCompletionListener l)` Set a playback completion callback.
`void`	`setOnErrorListener(IPlayer.OnErrorListener l)` Set an error callback.
`void`	`setOnInfoListener(IPlayer.OnInfoListener l)` Set a notification callback.
`void`	`setOnLoadingStatusListener(IPlayer.OnLoadingStatusListener l)` Set a loading status callback.
`void`	`setOnNetworkStatsListener(IPlayer.OnNetworkStatsListener l)` Set a network status listener.
`void`	`setOnPreparedListener(IPlayer.OnPreparedListener l)` Set a preparation success callback.
`void`	`setOnPreRenderFrameCallback(IPlayer.OnPreRenderFrameCallback callback)` Sets the pre-render frame callback.
`void`	`setOnRenderFrameCallback(IPlayer.OnRenderFrameCallback callback)` Sets the render frame callback.
`void`	`setOnRenderingStartListener(IPlayer.OnRenderingStartListener l)` Set a rendering start callback.
`void`	`setOnReportEventListener(IPlayer.OnReportEventListener onReportEventListener)` set report event listener
`void`	`setOnSeekCompleteListener(IPlayer.OnSeekCompleteListener l)` Set a seeking completion callback.
`void`	`setOnSeiDataListener(IPlayer.OnSeiDataListener l)` Set a SEI data callback.
`void`	`setOnSnapShotListener(IPlayer.OnSnapShotListener l)` Set a snapshot creation result callback.
`void`	`setOnStateChangedListener(IPlayer.OnStateChangedListener l)` Set a player status update callback.
`void`	`setOnStreamSwitchedListener(IPlayer.OnStreamSwitchedListener l)` Set a stream switch callback.
`void`	`setOnSubtitleDisplayListener(IPlayer.OnSubtitleDisplayListener l)` Set a subtitle display callback.
`void`	`setOnSubTrackReadyListener(IPlayer.OnSubTrackReadyListener l)` Set a subStream preparation success callback.
`void`	`setOnTrackChangedListener(IPlayer.OnTrackChangedListener l)` Set a stream switchover callback.
`void`	`setOnTrackReadyListener(IPlayer.OnTrackReadyListener l)` Set a stream preparation success callback.
`void`	`setOnUrlExpiredListener(IPlayer.OnUrlExpiredListener listener)` Set url expired listener
`void`	`setOnVideoRenderedListener(IPlayer.OnVideoRenderedListener l)` set the video render callback
`void`	`setOnVideoSizeChangedListener(IPlayer.OnVideoSizeChangedListener l)` Set a video size change callback.
`void`	`setOption(int key, int value)` Set specific option
`void`	`setOption(int key, java.lang.String value)` Set specific option
`void`	`setOutputAudioChannel(IPlayer.OutputAudioChannel outputAudioChannel)` Sets the audio output channel.
`void`	`setPlayerScene(PlayerScene scene)` Set the player scene.
`void`	`setPreferPlayerName(java.lang.String name)` Sets the preferred player kernel when playing, the default is the self-developed player core, can be switched to the system player, set before calling `prepare()`.
`void`	`setRenderFrameCallbackConfig(IPlayer.RenderFrameCallbackConfig config)` Set the render frame callback configuration.
`void`	`setRotateMode(IPlayer.RotateMode rotateMode)` Set a rotate mode.
`void`	`setScaleMode(IPlayer.ScaleMode scaleMode)` Sets the video scaling mode.
`void`	`setSpeed(float speed)` Set the playback speed.
`void`	`setStartTime(long position, IPlayer.SeekMode seekMode)` Set a specified position as play start.
`void`	`setStreamDelayTime(int index, int time)` Deprecated. set the delay time of the stream, default is 0 only support external subtitles
`void`	`setSurface(android.view.Surface surface)` Sets the `Surface` used for video rendering.
`void`	`setTraceId(java.lang.String traceId)` Set a trace ID for troubleshooting with the relevant log.
`void`	`setUserData(java.lang.String userData)` Set user data for the player instance, which can be used to distinguish different player instances in multi-instance scenarios.
`void`	`setVideoBackgroundColor(int color)` Set video background color
`void`	`setVideoTag(int[] tags)` Deprecated. Set the video tags. Values range from [0,99].
`void`	`setVolume(float gain)` Set the player's audio volume (not system volume).
`void`	`snapshot()` Create a snapshot for the current frame.
`void`	`start()` Start playback.
`void`	`stop()` Stop playback.
`void`	`surfaceChanged()` Surface changed.
`void`	`switchStream(java.lang.String url)` Multi definition stream switch by url.
`void`	`updateFilterConfig(java.lang.String target, FilterConfig.FilterOptions options)` update filter config.

- Field Detail
  - SET_MEDIA_TYPE
```
static final int SET_MEDIA_TYPE
```
    See Also:
    
    Constant Field Values
  - ALLOW_PRE_RENDER
```
static final int ALLOW_PRE_RENDER
```
    Android player SDK supports quick rendering of the first frame before starting playback, which can improve the playback speed. You can enable this function by calling setOption(int, int).
    
    See Also:
    
    Constant Field Values
  - PLAYED_DURATION_INCLUDE_SPEED
```
static final int PLAYED_DURATION_INCLUDE_SPEED
```
    Android player SDK supports getting the played duration, including playback speed. You can enable this function by calling setOption(int, int).
    
    See Also:
    
    getPlayedDuration(), Constant Field Values
  - PLAY_ALLOW_RESET_DISPLAY_VIEW
```
static final int PLAY_ALLOW_RESET_DISPLAY_VIEW
```
    Android player SDK supports resetting the DisplayView during playback. It works only if AliDisplayView is used. You can enable this function by calling setOption(int, int).
    
    See Also:
    
    Constant Field Values
  - PRE_RENDER_MAX_BUFFER_MS
```
static final int PRE_RENDER_MAX_BUFFER_MS
```
    Android player SDK supports setting the maximum cache duration for pre-rendering. You can set it by calling setOption(int, int). The unit is ms.
    
    See Also:
    
    Constant Field Values
  - LINE_FALLBACK_URL
```
static final int LINE_FALLBACK_URL
```
    Set backup stream for line priority. It can improve playback quality. You can set it by calling setOption(int, String).
    
    See Also:
    
    Constant Field Values
  - unknow
```
static final int unknow
```
    Unknown status.
    
    See Also:
    
    Constant Field Values
  - idle
```
static final int idle
```
    Blank. The player enters this state after it is created.
    
    See Also:
    
    Constant Field Values
  - initalized
```
static final int initalized
```
    Initialized. The player enters this state after a media source is specified for the player.
    
    See Also:
    
    Constant Field Values
  - prepared
```
static final int prepared
```
    Prepared.
    
    See Also:
    
    Constant Field Values
  - started
```
static final int started
```
    The player is playing video or audio.
    
    See Also:
    
    Constant Field Values
  - paused
```
static final int paused
```
    The player is paused.
    
    See Also:
    
    Constant Field Values
  - stopped
```
static final int stopped
```
    The player is stopped.
    
    See Also:
    
    Constant Field Values
  - completion
```
static final int completion
```
    The player has completed playing the video or audio.
    
    See Also:
    
    Constant Field Values
  - error
```
static final int error
```
    The player has an error.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - switchStream
```
void switchStream(java.lang.String url)
```
    Multi definition stream switch by url. You can get result from IPlayer.OnStreamSwitchedListener. Note: 1. Must be aliyun's live stream address. 2. Must be different definition of the same stream. 3. If switch to an unrelated address, switch may failed.
    
    Parameters:
    
    url - new url address
  - selectTrack
```
void selectTrack(int trackInfoIndex)
```
    Select a stream to play. The result of the selection can be obtained through IPlayer.OnTrackChangedListener callback.
    Note: Automatic bitrate switching is mutually exclusive with other track selections. Once another track is selected, automatic bitrate switching becomes ineffective.
    
    Parameters:
    
    trackInfoIndex - Stream information index. See TrackInfo.getIndex(). If automatic bitrate switching is needed, pass TrackInfo.AUTO_SELECT_INDEX
    
    See Also:
    
    IPlayer.OnTrackChangedListener, TrackInfo.getIndex(), TrackInfo.AUTO_SELECT_INDEX, setAutoBandWidth(boolean)
  - selectTrack
```
void selectTrack(int trackInfoIndex,
                 boolean accurate)
```
    Specify a stream to play. You can call IPlayer.OnTrackChangedListener to check whether the stream is played.
    Note: If you have specified a track, then automatic bitrate switchover does not take effect even if it is enabled.
    
    Parameters:
    
    trackInfoIndex - Stream information. See TrackInfo.getIndex(). If you want to enable automatic bitrate switchover, pass TrackInfo.AUTO_SELECT_INDEX.
    
    accurate - enable accurate select or not.
  - currentTrack
```
@Deprecated
TrackInfo currentTrack(int type)
```
    Deprecated. Since version 4.7.1, use currentTrack(TrackInfo.Type) instead
    
    Get the currently playing track according to the specified track type. From version 4.7.1, use currentTrack(TrackInfo.Type) instead.
    
    Parameters:
    
    type - The type of the track. See TrackInfo.Type .ordinal()
    
    Returns:
    
    The currently playing track. Returns null if no track is playing
    
    See Also:
    
    currentTrack(TrackInfo.Type), TrackInfo.Type
  - currentTrack
```
TrackInfo currentTrack(TrackInfo.Type type)
```
    Get the currently playing track according to the specified track type.
    
    Parameters:
    
    type - The type of the track. See TrackInfo.Type
    
    Returns:
    
    The currently playing track. Returns null if no track is playing
    
    See Also:
    
    TrackInfo.Type, selectTrack(int)
  - getBufferedPosition
```
long getBufferedPosition()
```
    Query the current buffer progress. Note: Pay close attention the difference between this method and IPlayer.OnLoadingStatusListener.
    
    Returns:
    
    The current buffer progress. Unit: milliseconds. This is an interface for actively getting the player's buffer progress. You can also get the buffer progress through IPlayer.OnInfoListener {@
  - getCurrentPosition
```
long getCurrentPosition()
```
    Query the current playback position.
    
    Returns:
    
    The current playback position. Unit: milliseconds. This is an interface for actively getting the player's current playback position. You can also get the playback position through IPlayer.OnInfoListener InfoCode.CurrentPosition
  - getPlayerStatus
```
int getPlayerStatus()
```
    Get the current player status.
    
    Returns:
    
    The current player status. The value is one of the following constants: idle, initalized, prepared, started, paused, stopped, completion, error, unknow This is an interface for actively getting the player status. You can also get the status change through IPlayer.OnStateChangedListener.
  - getCurrentVps
```
java.lang.String getCurrentVps()
```
    Get the current Video Playback Session ID (VPS). The playback session starts after calling prepare and ends when stop is called or when playback completes.
    
    Returns:
    
    The current VPS string.
  - getDuration
```
long getDuration()
```
    Query the total length of the stream.
    
    Returns:
    
    The total length of the stream. Unit: milliseconds.
  - getMediaInfo
```
MediaInfo getMediaInfo()
```
    Query media information. Note: Only if IPlayer.OnPreparedListener.onPrepared() is called back, the media information can be returned.
    
    Returns:
    
    The media information. See MediaInfo.
  - getSubMediaInfo
```
MediaInfo getSubMediaInfo()
```
    Query media information. Note: Only if IPlayer.OnPreparedListener.onPrepared() is called back, the media information can be returned. After selecting one sub m3u8 stream from multiStream m3u8, Only if IPlayer.OnSubTrackReadyListener.onSubTrackReady(MediaInfo) is called back, the media information can be returned.
    
    Returns:
    
    The media information. See MediaInfo.
  - getVideoWidth
```
int getVideoWidth()
```
    Query the width of the video.
    
    Returns:
    
    The width of the video.
  - getVideoHeight
```
int getVideoHeight()
```
    Query the height of the video.
    
    Returns:
    
    The height of the video.
  - getVideoRotation
```
int getVideoRotation()
```
    Query the rotate angle of the video.
    
    Returns:
    
    The rotate angle of the video.
  - setCacheConfig
```
@Deprecated
void setCacheConfig(CacheConfig cacheConfig)
```
    Deprecated. From version 7.0.0, this interface is deprecated.
    
    Configure cache settings.
    
    Parameters:
    
    cacheConfig - Cache settings. See CacheConfig.
  - setTraceId
```
void setTraceId(java.lang.String traceId)
```
    Set a trace ID for troubleshooting with the relevant log. Optional: We recommend using the `Player Single Point Trace` function to trace the playback behavior of a specific user or playback session. If playback exceptions occur when using the Aliyun Player SDK to play videos, you can use the single point trace function to trace the playback behavior of a specific user or playback session to help you quickly diagnose the problem and improve the playback experience governance efficiency. The traceId value is defined by you, which must be a unique identifier for your user or device. For example, you can pass in your user's userid or IMEI, IDFA, etc. as the unique identifier for your user. setTraceId parameter not passed (default): Cannot use the single point trace function.
    
    Parameters:
    
    traceId - The specified trace ID.
  - setOutputAudioChannel
```
void setOutputAudioChannel(IPlayer.OutputAudioChannel outputAudioChannel)
```
    Sets the audio output channel.
    When the input audio source is stereo, you can choose to output only the left or right channel. If the input is mono, this setting has no effect, and audio plays normally.
    This setting affects both audio rendering output and PCM data callback content.
    
    Parameters:
    
    outputAudioChannel - Channel selection: IPlayer.OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_NONE (default, unspecified), IPlayer.OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_LEFT (left channel), IPlayer.OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_RIGHT (right channel)
    
    See Also:
    
    IPlayer.OutputAudioChannel
  - setVolume
```
void setVolume(float gain)
```
    Set the player's audio volume (not system volume).
    Valid range is [0.0, 2.0]:
    - Recommended range: [0.0, 1.0] to avoid distortion;
    - Values above 1.0 may cause audio distortion or noise and are not recommended.
    Parameters:
    
    gain - The volume gain. Valid range: [0.0, 2.0].
  - getVolume
```
float getVolume()
```
    Query the volume of the player, which is set by setVolume(float)
    
    Returns:
    
    Valid values: [0, 2].
  - setMute
```
void setMute(boolean on)
```
    Mute the player.
    
    Parameters:
    
    on - Set to true to mute the player. Default: false.
  - isMute
```
boolean isMute()
```
  - setLoop
```
void setLoop(boolean on)
```
    Enable loop playback. If the media file is already downloaded to the local host, then the downloaded media file will be used for loop playback.
    
    Parameters:
    
    on - true：Enable loop playback. Default: disabled.
  - isLoop
```
boolean isLoop()
```
    Query whether loop playback is enabled.
    
    Returns:
    
    Value true indicates that loop playback is enabled. Default: disabled.
  - setAutoPlay
```
void setAutoPlay(boolean on)
```
    Enable autoplay. If autoplay is enabled, then the IPlayer.OnPreparedListener callback is not returned.
    
    Parameters:
    
    on - Value true indicates that autoplay is enabled. Default: disabled.
  - isAutoPlay
```
boolean isAutoPlay()
```
    Query whether autoplay is enabled.
    
    Returns:
    
    Value true indicates that autoplay is enabled. Default: disabled.
  - setSpeed
```
void setSpeed(float speed)
```
    Set the playback speed.
    
    Parameters:
    
    speed - The playback speed.
  - getSpeed
```
float getSpeed()
```
    Query the playback speed.
    
    Returns:
    
    The playback speed
  - setMirrorMode
```
void setMirrorMode(IPlayer.MirrorMode mirrorMode)
```
    Sets the video mirroring mode.
    Note: When playing HDR videos with SurfaceView, the mirroring mode only takes effect if set using AliDisplayView. If you use SurfaceView directly, this setting has no effect, and you must implement the mirroring transformation at the View layer yourself.
    
    Parameters:
    
    mirrorMode - The mirroring mode. See IPlayer.MirrorMode.
  - getMirrorMode
```
IPlayer.MirrorMode getMirrorMode()
```
    Query the current mirroring mode.
    
    Returns:
    
    The current mirroring mode. See IPlayer.MirrorMode.
  - setAlphaRenderMode
```
void setAlphaRenderMode(IPlayer.AlphaRenderMode alphaRenderMode)
```
    Set alpha render mode, can be used on gift play on live stream, etc. Detail usage: doc
    
    Parameters:
    
    alphaRenderMode - The specified alpha render mode. See IPlayer.AlphaRenderMode.
  - getAlphaRenderMode
```
IPlayer.AlphaRenderMode getAlphaRenderMode()
```
    Query the current alpha render mode. Can be set by setAlphaRenderMode(com.aliyun.player.IPlayer.AlphaRenderMode).
    
    Returns:
    
    The current alpha render mode. See IPlayer.AlphaRenderMode.
  - setRotateMode
```
void setRotateMode(IPlayer.RotateMode rotateMode)
```
    Set a rotate mode.
    Note: When playing HDR videos with SurfaceView, the scaling mode only takes effect if set using AliDisplayView. If you use SurfaceView directly, this setting has no effect, and you must handle the scaling transformation at the View layer yourself.
    
    Parameters:
    
    rotateMode - The specified rotate mode. See IPlayer.RotateMode.
  - getRotateMode
```
IPlayer.RotateMode getRotateMode()
```
    Query the current rotate mode.
    
    Returns:
    
    The current rotate mode. See IPlayer.RotateMode.
  - setScaleMode
```
void setScaleMode(IPlayer.ScaleMode scaleMode)
```
    Sets the video scaling mode.
    Note: When playing HDR videos with SurfaceView, the scaling mode only takes effect if set using AliDisplayView. If you use SurfaceView directly, this setting has no effect, and you must handle the scaling transformation at the View layer yourself.
    
    Parameters:
    
    scaleMode - The scaling mode. Default is IPlayer.ScaleMode.SCALE_TO_FILL. See IPlayer.ScaleMode.
  - getScaleMode
```
IPlayer.ScaleMode getScaleMode()
```
    Query the current zoom mode.
    
    Returns:
    
    The current zoom mode. Default: IPlayer.ScaleMode.SCALE_TO_FILL.
  - snapshot
```
void snapshot()
```
    Create a snapshot for the current frame. You can call IPlayer.OnSnapShotListener to return the snapshot creation result.
  - setSurface
```
void setSurface(android.view.Surface surface)
```
    Sets the Surface used for video rendering. Works with both TextureView and SurfaceView. - For TextureView: create a Surface from SurfaceTexture. mPlayer.setSurface(new Surface(surfaceTexture)); - For SurfaceView: obtain the Surface via SurfaceHolder.getSurface(). mPlayer.setSurface(surfaceView.getHolder().getSurface()); Re-invoke this method whenever the Surface is destroyed or recreated. Safe to call during playback. Pass null before releasing the player to unbind and free graphic resources.
    
    Parameters:
    
    surface - The target rendering Surface, or null
  - setDisplay
```
void setDisplay(android.view.SurfaceHolder holder)
```
    Sets the SurfaceHolder used for video rendering. Intended only for SurfaceView. mPlayer.setDisplay(surfaceView.getHolder()); Internally, this method retrieves the Surface via holder.getSurface(). Not supported for TextureView, as it does not expose a SurfaceHolder. Passing a non-SurfaceView holder may cause runtime exceptions or undefined behavior. Prefer setSurface(Surface) for better compatibility across view types. Re-invoke when the surface changes, and set to null before releasing the player.
    
    Parameters:
    
    holder - The target rendering SurfaceHolder, or null
  - setDisplayView
```
void setDisplayView(AliDisplayView view)
```
    Set the display view. AliDisplayView
    
    Parameters:
    
    view, - AliDisplayView
  - surfaceChanged
```
void surfaceChanged()
```
    Surface changed.
  - prepare
```
void prepare()
```
    Prepare the player. Call IPlayer.OnPreparedListener to return success messages. Call IPlayer.OnErrorListener to return error messages. The time to prepare to prepare complete is related to PlayerConfig.mStartBufferDuration.
    
    See Also:
    
    getPlayerStatus()
  - start
```
void start()
```
    Start playback. The player status change is notified via IPlayer.OnStateChangedListener. If already playing, this call has no effect. You must call this API after prepare().
    
    See Also:
    
    IPlayer.OnStateChangedListener, getPlayerStatus()
  - pause
```
void pause()
```
    Pause playback. The player status change is notified via IPlayer.OnStateChangedListener. If already paused or stopped, this call has no effect. To resume playback, call start().
    
    See Also:
    
    start(), IPlayer.OnStateChangedListener, getPlayerStatus()
  - stop
```
void stop()
```
    Stop playback. the player status change is notified via IPlayer.OnStateChangedListener. This does not release resources; call release() or releaseAsync() to clean up.
    
    See Also:
    
    IPlayer.OnStateChangedListener, getPlayerStatus(), release(), releaseAsync()
  - setStartTime
```
void setStartTime(long position,
                  IPlayer.SeekMode seekMode)
```
    Set a specified position as play start. Call this API before prepare, only take effect once.
    
    Parameters:
    
    position - The specified position. Unit: millisecond.
    
    seekMode - The specified seeking mode. See IPlayer.SeekMode.
  - seekTo
```
void seekTo(long position)
```
    Seek to the specified position using inaccurate mode.
    Upon completion, the IPlayer.OnSeekCompleteListener will be triggered.
    
    Parameters:
    
    position - The target position in milliseconds.
    
    See Also:
    
    IPlayer.OnSeekCompleteListener, seekTo(long, SeekMode)
  - seekTo
```
void seekTo(long position,
            IPlayer.SeekMode seekMode)
```
    Seek to the specified position.
    Upon completion, the IPlayer.OnSeekCompleteListener will be triggered.
    
    Parameters:
    
    position - The target position in milliseconds.
    
    seekMode - The seeking mode. See IPlayer.SeekMode.
    
    See Also:
    
    IPlayer.OnSeekCompleteListener, IPlayer.SeekMode
  - setMaxAccurateSeekDelta
```
void setMaxAccurateSeekDelta(int delta)
```
    set the maximum interval of precision seek.
    
    Parameters:
    
    delta - interval in milliseconds
  - reset
```
void reset()
```
    Reset. Not recommended for use
  - release
```
void release()
```
    sync release.
  - releaseAsync
```
void releaseAsync()
```
    async release. When instance is not needed, skip calling stop api and call this releaseAsync api can speed up view response. Once called, don't call prepare to start new play.
  - redraw
```
@Deprecated
void redraw()
```
    Deprecated. Deprecated.
  - clearScreen
```
void clearScreen()
```
    Clear the screen.
  - setOnPreparedListener
```
void setOnPreparedListener(IPlayer.OnPreparedListener l)
```
    Set a preparation success callback. If the preparation failed, the IPlayer.OnErrorListener is triggered.
    
    Parameters:
    
    l - Preparation success notification.
  - setOnRenderingStartListener
```
void setOnRenderingStartListener(IPlayer.OnRenderingStartListener l)
```
    Set a rendering start callback. You can use this callback to listen to first frame display events and hide the album cover.
    
    Parameters:
    
    l - Rendering start notification.
    
    See Also:
    
    IPlayer.OnRenderingStartListener
  - setOnStateChangedListener
```
void setOnStateChangedListener(IPlayer.OnStateChangedListener l)
```
    Set a player status update callback.
    
    Parameters:
    
    l - Player status update notification.
    
    See Also:
    
    IPlayer.OnStateChangedListener
  - setOnCompletionListener
```
void setOnCompletionListener(IPlayer.OnCompletionListener l)
```
    Set a playback completion callback. Note: No notification is returned if loop playback is enabled.
    
    Parameters:
    
    l - Playback completion notification.
    
    See Also:
    
    IPlayer.OnCompletionListener
  - setOnLoadingStatusListener
```
void setOnLoadingStatusListener(IPlayer.OnLoadingStatusListener l)
```
    Set a loading status callback.
    
    Parameters:
    
    l - Loading status notification.
    
    See Also:
    
    IPlayer.OnLoadingStatusListener
  - setOnAVNotSyncStatusListener
```
void setOnAVNotSyncStatusListener(IPlayer.OnAVNotSyncStatusListener l)
```
    Set an audio and video not sync status callback.
    
    Parameters:
    
    l - Audio and video not sync status callback.
    
    See Also:
    
    IPlayer.OnAVNotSyncStatusListener
  - setOnNetworkStatsListener
```
void setOnNetworkStatsListener(IPlayer.OnNetworkStatsListener l)
```
    Set a network status listener.
    
    Parameters:
    
    l - The callback listener for network status.
    
    See Also:
    
    IPlayer.OnNetworkStatsListener
  - setOnErrorListener
```
void setOnErrorListener(IPlayer.OnErrorListener l)
```
    Set an error callback.
    
    Parameters:
    
    l - Error message.
    
    See Also:
    
    IPlayer.OnErrorListener
  - setOnChooseTrackIndexListener
```
void setOnChooseTrackIndexListener(IPlayer.OnChooseTrackIndexListener l)
```
    Set a stream to play callback.
    
    Parameters:
    
    l - The callback. See IPlayer.OnChooseTrackIndexListener.
  - setOnTrackReadyListener
```
void setOnTrackReadyListener(IPlayer.OnTrackReadyListener l)
```
    Set a stream preparation success callback.
    
    Parameters:
    
    l - Stream preparation success notification.
  - setOnSubTrackReadyListener
```
void setOnSubTrackReadyListener(IPlayer.OnSubTrackReadyListener l)
```
    Set a subStream preparation success callback.
    
    Parameters:
    
    l - SubStream preparation success notification.
  - setOnInfoListener
```
void setOnInfoListener(IPlayer.OnInfoListener l)
```
    Set a notification callback.
    
    Parameters:
    
    l - The notification.
  - setOnVideoSizeChangedListener
```
void setOnVideoSizeChangedListener(IPlayer.OnVideoSizeChangedListener l)
```
    Set a video size change callback.
    
    Parameters:
    
    l - Video size change notification.
  - setOnSeekCompleteListener
```
void setOnSeekCompleteListener(IPlayer.OnSeekCompleteListener l)
```
    Set a seeking completion callback.
    
    Parameters:
    
    l - Seeking completion notification.
    
    See Also:
    
    seekTo(long), seekTo(long, SeekMode)
  - setOnStreamSwitchedListener
```
void setOnStreamSwitchedListener(IPlayer.OnStreamSwitchedListener l)
```
    Set a stream switch callback. 适用于直播流，switchStream(String)
    
    Parameters:
    
    l - Stream switch notification.
  - setOnTrackChangedListener
```
void setOnTrackChangedListener(IPlayer.OnTrackChangedListener l)
```
    Set a stream switchover callback.
    
    Parameters:
    
    l - Stream switchover notification. selectTrack(int) IPlayer.OnTrackChangedListener
  - setOnSeiDataListener
```
void setOnSeiDataListener(IPlayer.OnSeiDataListener l)
```
    Set a SEI data callback.
    
    Parameters:
    
    l - SEI data callback.
    
    See Also:
    
    IPlayer.OnSeiDataListener
  - addExtSubtitle
```
void addExtSubtitle(java.lang.String url)
```
    Add external subtitles
    
    Parameters:
    
    url - subtitle address
  - selectExtSubtitle
```
void selectExtSubtitle(int trackIndex,
                       boolean select)
```
    Select external subtitles
    
    Parameters:
    
    trackIndex - caption index
    
    select - true: select, false: close
  - setStreamDelayTime
```
@Deprecated
void setStreamDelayTime(int index,
                                    int time)
```
    Deprecated. set the delay time of the stream, default is 0 only support external subtitles
    
    Parameters:
    
    index - steam index
    
    time - ms
  - setOnSubtitleDisplayListener
```
void setOnSubtitleDisplayListener(IPlayer.OnSubtitleDisplayListener l)
```
    Set a subtitle display callback.
    
    Parameters:
    
    l - Subtitle display notification.
    
    See Also:
    
    IPlayer.OnSubtitleDisplayListener
  - setConfig
```
void setConfig(PlayerConfig config)
```
    Modify the player configuration.
    
    Parameters:
    
    config - The configuration of the player. See PlayerConfig.
  - getConfig
```
PlayerConfig getConfig()
```
    Query the player configuration.
    
    Returns:
    
    The player configuration.
  - setPlayerScene
```
void setPlayerScene(PlayerScene scene)
```
    Set the player scene.
    
    Parameters:
    
    scene - . See PlayerScene.
  - setOnSnapShotListener
```
void setOnSnapShotListener(IPlayer.OnSnapShotListener l)
```
    Set a snapshot creation result callback. Triggered by snapshot().
    
    Parameters:
    
    l - Snapshot creation notification.See IPlayer.OnSnapShotListener
    
    See Also:
    
    IPlayer.OnSnapShotListener
  - enableHardwareDecoder
```
void enableHardwareDecoder(boolean enable)
```
    Enable or disable hardware decoding. Default is enable.
    
    Parameters:
    
    enable - Set to true to enable hardware decoding, or false to disable it. If hardware decoding fails, it will fall back to software decoding. If adaptive fallback is configured using AliPlayerGlobalSettings.setAdaptiveDecoderGetBackupURLCallback(com.aliyun.player.AliPlayerGlobalSettings.OnGetBackupUrlCallback), the player can switch to play videos with different encodings, such as H265 to H264.
  - getCacheFilePath
```
@Deprecated
java.lang.String getCacheFilePath(java.lang.String URL)
```
    Deprecated. From 7.0.0, this interface is deprecated.Please use the AliPlayerGlobalSettings.enableLocalCache(boolean, Context) interface to enable and configure local cache.
    
    Query the name of a cached file with the specified URL. You must first call setCacheConfig.
    
    Parameters:
    
    URL - The URL of the cached file.
    
    Returns:
    
    The absolute path of the cached file.
  - getCacheFilePath
```
@Deprecated
java.lang.String getCacheFilePath(java.lang.String vid,
                                              java.lang.String format,
                                              java.lang.String definition,
                                              int previewTime)
```
    Deprecated. From 7.0.0, this interface is deprecated. Please use the AliPlayerGlobalSettings.enableLocalCache(boolean, Context) interface to enable and configure local cache.
    
    Query the name of a cached file with the specified VID. You must first call setCacheConfig.
    
    Parameters:
    
    vid - The ID of the video.
    
    format - The format of the video.
    
    definition - The definition of the video.
    
    previewTime - The preview duration for the video.
    
    Returns:
    
    The absolute path of the cached file.
  - reload
```
void reload()
```
    Reload. Call this method when the network connection times out.
  - getPropertyString
```
java.lang.String getPropertyString(IPlayer.PropertyKey key)
```
    Get information by key.
    
    Parameters:
    
    key - The enum of key
    
    Returns:
    
    corresponding information, return "" if doesn't exist.
    
    See Also:
    
    IPlayer.PropertyKey
  - setDefaultBandWidth
```
void setDefaultBandWidth(int bandWidth)
```
    Set the default playback bitrate for multi-bitrate playback. The stream with the closest bitrate will be selected for playback.
    
    Parameters:
    
    bandWidth - The bitrate for playback, unit: bps
  - setDefaultAudioLanguage
```
void setDefaultAudioLanguage(java.lang.String language)
```
    Set the default audio language for multi-track playback. The audio stream with an exact match will be selected for playback. The audio language can be obtained through the audioLang field in trackInfo.
    
    Parameters:
    
    language - The audio language string
    
    See Also:
    
    TrackInfo.audioLang
  - setDefaultSubtitleLanguage
```
void setDefaultSubtitleLanguage(java.lang.String language)
```
    Set the default subtitle language for multi-track playback. The subtitle stream with an exact match will be selected for playback. The subtitle language can be obtained through the subtitleLang field in trackInfo.
    
    Parameters:
    
    language - The subtitle language string
    
    See Also:
    
    TrackInfo.subtitleLang
  - setAutoBandWidth
```
void setAutoBandWidth(boolean enable)
```
    Enable or disable adaptive selection of initial playback quality for multi-bitrate playback. Note: This interface only adaptively selects the initial playback quality, and will not adaptively select quality dynamically after playback starts. The maximum resolution for adaptive selection can be limited by PlayerConfig.mMaxAllowedAbrVideoPixelNumber.
    
    Parameters:
    
    enable - true to enable adaptive initial quality selection, false to disable
    
    See Also:
    
    isAutoBandWidth(), setDefaultBandWidth(int), PlayerConfig.mMaxAllowedAbrVideoPixelNumber
  - isAutoBandWidth
```
boolean isAutoBandWidth()
```
    Get whether adaptive selection of initial playback quality for multi-bitrate playback is enabled.
    
    Returns:
    
    true if adaptive initial quality selection is enabled, false otherwise
    
    See Also:
    
    setAutoBandWidth(boolean)
  - setDefaultResolution
```
void setDefaultResolution(int resolutionProduct)
```
    Set the default playback resolution for multi-bitrate playback. The stream with the closest resolution will be selected for playback.
    
    Parameters:
    
    resolutionProduct - The product of width and height for the default resolution of multi-bitrate video, unit: pixels. The closest resolution will be selected. For example, if the value 1920 * 1080 = 2073600 is provided, playback will start with the resolution closest to 1920x1080
    
    See Also:
    
    setDefaultBandWidth(int)
  - getOption
```
java.lang.Object getOption(IPlayer.Option key)
```
    gets the player's options parameters
    
    Parameters:
    
    key - parameter value See IPlayer.Option
    
    Returns:
    
    parameter value
  - setOnVideoRenderedListener
```
void setOnVideoRenderedListener(IPlayer.OnVideoRenderedListener l)
```
    set the video render callback
    
    Parameters:
    
    l - video render callback. See IPlayer.OnVideoRenderedListener
    
    See Also:
    
    IPlayer.OnVideoRenderedListener
  - setVideoBackgroundColor
```
void setVideoBackgroundColor(int color)
```
    Set video background color
    
    Parameters:
    
    color - ARGB, default value 0xFF000000
  - setIPResolveType
```
void setIPResolveType(IPlayer.IPResolveType type)
```
    set IPv4/IPv6 resolve type
    
    Parameters:
    
    type - See IPlayer.IPResolveType， default value all support, who responds quickly, will use it first
  - setFastStart
```
void setFastStart(boolean open)
```
    Set the timing of decoder creation. When set to true, the decoder is created by the time IPlayer.OnPreparedListener is called, allowing start() to begin playback quickly. When set to false, the decoder is created when start() is called, which can accelerate IPlayer.OnPreparedListener callback time. For autoplay scenarios, there is no difference in overall first-frame performance.
    
    Parameters:
    
    open - Default value is true.
  - setOnReportEventListener
```
void setOnReportEventListener(IPlayer.OnReportEventListener onReportEventListener)
```
    set report event listener
    
    Parameters:
    
    onReportEventListener - event listener
  - setDrmCallback
```
void setDrmCallback(DrmCallback callback)
```
    set DRM request callback. This callback will be triggered only when play with UrlSource, not VidAuth and VidSts play. Only Widevine is supported.
    
    Parameters:
    
    callback - DrmCallback callback.
  - sendCustomEvent
```
void sendCustomEvent(java.lang.String args)
```
    Sends a user-defined event, which will be called back via IPlayer.OnReportEventListener. This is used to unify business events/metrics through the player's reporting callback for consistent business flow. User-defined event code is 5001, and args is the transparently transmitted parameter.
    
    Parameters:
    
    args - The parameter passed in for the user-defined event.
  - setVideoTag
```
@Deprecated
void setVideoTag(int[] tags)
```
    Deprecated. Set the video tags. Values range from [0,99].
    
    Parameters:
    
    tags -
  - setPreferPlayerName
```
void setPreferPlayerName(java.lang.String name)
```
    Sets the preferred player kernel when playing, the default is the self-developed player core, can be switched to the system player, set before calling prepare().
    
    Parameters:
    
    name - Player name, such as "MediaPlayer", "ExoPlayer", the default value is ""
  - getPlayerName
```
java.lang.String getPlayerName()
```
    Gets the name of the player used when playing
    
    Returns:
    
    Inner player name
  - setRenderFrameCallbackConfig
```
void setRenderFrameCallbackConfig(IPlayer.RenderFrameCallbackConfig config)
```
    Set the render frame callback configuration.
    
    Parameters:
    
    config - See IPlayer.RenderFrameCallbackConfig
  - setOnRenderFrameCallback
```
void setOnRenderFrameCallback(IPlayer.OnRenderFrameCallback callback)
```
    Sets the render frame callback.
    This callback is triggered before frame rendering completes, and can be used for frame-level monitoring, performance analysis, or post-processing.
    Note: The callback may run on the rendering thread. Avoid time-consuming or blocking operations.
    
    Parameters:
    
    callback - Render frame callback instance; set to null to unregister
    
    See Also:
    
    IPlayer.OnRenderFrameCallback, FrameInfo
  - setUserData
```
void setUserData(java.lang.String userData)
```
    Set user data for the player instance, which can be used to distinguish different player instances in multi-instance scenarios. Can get the user data through getUserData().
    
    Parameters:
    
    userData - User-defined data
  - setOption
```
void setOption(int key,
               java.lang.String value)
```
    Set specific option
    
    Parameters:
    
    key - key option
    
    value - value of key
  - setOption
```
void setOption(int key,
               int value)
```
    Set specific option
    
    Parameters:
    
    key - key option
    
    value - value of key
  - getUserData
```
java.lang.String getUserData()
```
    Get the UserData of the current player instance, which can be set via setUserData(java.lang.String) to differentiate between different player instances.
    
    Parameters:
    
    -
    
    Returns:
    
    The user data string.
  - setFilterConfig
```
void setFilterConfig(FilterConfig filterConfig)
```
    Set filter config. call this before prepare. If want update filter config, call updateFilterConfig(String, FilterConfig.FilterOptions) Only take effect when the filter config is valid, call setFilterInvalid(String, boolean)
    
    Parameters:
    
    filterConfig - filter config, see FilterConfig
  - updateFilterConfig
```
void updateFilterConfig(java.lang.String target,
                        FilterConfig.FilterOptions options)
```
    update filter config.
    
    Parameters:
    
    target - filter target
    
    options - filter options, seeFilterConfig.FilterOptions
  - setFilterInvalid
```
void setFilterInvalid(java.lang.String target,
                      boolean invalid)
```
    disable/enable filter. Note: the value represents whether the filter is invalid, true: invalid, false: valid
    
    Parameters:
    
    target - Filter name, if empty , disable all filters.
    
    invalid - true: disable(default); false: enable
  - setFilterValid
```
void setFilterValid(java.lang.String target,
                    boolean valid)
```
    enable/disable filter. Note: the value represents whether the filter is valid, true: valid, false: invalid
    
    Parameters:
    
    target - Filter name
    
    valid - false: disable (default); true: enable
  - setOnPreRenderFrameCallback
```
void setOnPreRenderFrameCallback(IPlayer.OnPreRenderFrameCallback callback)
```
    Sets the pre-render frame callback.
    This callback allows the application to perform custom processing (e.g., filtering, analysis) before the video frame is submitted to the GPU or display system.
    Note: This callback is executed on the rendering thread. Avoid time-consuming operations to prevent stuttering.
    
    Parameters:
    
    callback - The pre-render frame callback instance; pass null to unregister
    
    See Also:
    
    IPlayer.OnPreRenderFrameCallback, FrameInfo
  - getPlayedDuration
```
long getPlayedDuration()
```
    Get the actual play duration, which does not include the time spent in playback pauses, buffering, etc. Unit: microseconds
    
    Returns:
    
    played duration can be set by setOption(PLAYED_DURATION_INCLUDE_SPEED,int) to set whether the played duration considers playback speed
  - getNativeContextAddr
```
long getNativeContextAddr()
```
  - setOnUrlExpiredListener
```
void setOnUrlExpiredListener(IPlayer.OnUrlExpiredListener listener)
```
    Set url expired listener
    
    Parameters:
    
    listener -
    
    See Also:
    
    IPlayer.OnUrlExpiredListener

Interface IPlayer

Nested Class Summary

Field Summary

Method Summary

Field Detail

SET_MEDIA_TYPE

ALLOW_PRE_RENDER

PLAYED_DURATION_INCLUDE_SPEED

PLAY_ALLOW_RESET_DISPLAY_VIEW

PRE_RENDER_MAX_BUFFER_MS

LINE_FALLBACK_URL

unknow

idle

initalized

prepared

started

paused

stopped

completion

error

Method Detail

switchStream

selectTrack

selectTrack

currentTrack

currentTrack

getBufferedPosition

getCurrentPosition

getPlayerStatus

getCurrentVps

getDuration

getMediaInfo

getSubMediaInfo

getVideoWidth

getVideoHeight

getVideoRotation

setCacheConfig

setTraceId

setOutputAudioChannel

setVolume

getVolume

setMute

isMute

setLoop

isLoop

setAutoPlay

isAutoPlay

setSpeed

getSpeed

setMirrorMode

getMirrorMode

setAlphaRenderMode

getAlphaRenderMode

setRotateMode

getRotateMode

setScaleMode

getScaleMode

snapshot

setSurface

setDisplay

setDisplayView

surfaceChanged

prepare

start

pause

stop

setStartTime

seekTo

seekTo

setMaxAccurateSeekDelta

reset

release

releaseAsync

redraw

clearScreen

setOnPreparedListener

setOnRenderingStartListener

setOnStateChangedListener

setOnCompletionListener

setOnLoadingStatusListener