程序包 ohos.media.player

接口 Player.IPlayerCallback

封闭类:

Player

public static interface Player.IPlayerCallback

Provides media player callbacks upon completion of playback, playback position changes, and video size changes.

从以下版本开始:

3

另请参阅:

Player.setPlayerCallback(IPlayerCallback)

方法概要

限定符和类型	方法	说明
void	onBufferingChange(int percent)	Called when the buffering percentage updates.
void	onError(int errorType, int errorCode)	Called when a player error message is received.
void	onMediaTimeIncontinuity(Player.MediaTimeInfo info)	Called when the media time continuity is broken, for example, when an error occurs during the playback, the playback position is changed by Player.rewindTo(long), or the playback speed changes suddenly.
void	onMessage(int type, int extra)	Called when a player message or alarm is received.
void	onNewTimedMetaData(Player.MediaTimedMetaData data)	Called when there is new timed metadata available.
void	onPlayBackComplete()	Called when the playback is complete.
void	onPrepared()	Called when the media file is ready for playback.
void	onResolutionChanged(int width, int height)	Called when the video size changes.
void	onRewindToComplete()	Called when the playback position is changed by Player.rewindTo(long).

方法详细资料

onPrepared

void onPrepared()

Called when the media file is ready for playback.

从以下版本开始:

3

onMessage

void onMessage(int type,
               int extra)

Called when a player message or alarm is received.

参数:

type - Indicates the message type, which can be one of the following:

• Player.PLAYER_INFO_UNKNOWN
• Player.PLAYER_INFO_VIDEO_TRACK_LAGGING
• Player.PLAYER_INFO_VIDEO_RENDERING_START
• Player.PLAYER_INFO_BUFFERING_START
• Player.PLAYER_INFO_BUFFERING_END
• Player.PLAYER_INFO_NETWORK_BANDWIDTH
• Player.PLAYER_INFO_BAD_INTERLEAVING
• Player.PLAYER_INFO_NOT_SEEKABLE
• Player.PLAYER_INFO_METADATA_UPDATE
• Player.PLAYER_INFO_UNSUPPORTED_SUBTITLE
• Player.PLAYER_INFO_SUBTITLE_TIMED_OUT

extra - Indicates the extra code for the message type. The meaning is subject to the implementation.

从以下版本开始:

3

onError

void onError(int errorType,
             int errorCode)

Called when a player error message is received.

参数:

errorType - Indicates the error type, which can be one of the following:

• Player.PLAYER_ERROR_UNKNOWN
• Player.PLAYER_ERROR_SERVER_DIED

errorCode - Indicates the error code, which can be one of the following:

• Player.PLAYER_ERROR_IO
• Player.PLAYER_ERROR_MALFORMED
• Player.PLAYER_ERROR_UNSUPPORTED
• Player.PLAYER_ERROR_TIMED_OUT
• Player.PLAYER_ERROR_SYSTEM

从以下版本开始:

3

onResolutionChanged

void onResolutionChanged(int width,
                         int height)

Called when the video size changes.

参数:

width - Indicates the video width.

height - Indicates the video height.

从以下版本开始:

3

onPlayBackComplete

void onPlayBackComplete()

Called when the playback is complete.

从以下版本开始:

3

onRewindToComplete

void onRewindToComplete()

Called when the playback position is changed by Player.rewindTo(long).

从以下版本开始:

3

onBufferingChange

void onBufferingChange(int percent)

Called when the buffering percentage updates. The percentage indicates how much data has been buffered, for example, 80 means that 80% of the content has been buffered.

参数:

percent - Indicates the media stream buffering percentage. The value ranges from 0 to 100.

从以下版本开始:

3

onNewTimedMetaData

void onNewTimedMetaData(Player.MediaTimedMetaData data)

Called when there is new timed metadata available.

参数:

data - Indicates the information about timed metadata .

从以下版本开始:

3

onMediaTimeIncontinuity

void onMediaTimeIncontinuity(Player.MediaTimeInfo info)

Called when the media time continuity is broken, for example, when an error occurs during the playback, the playback position is changed by Player.rewindTo(long), or the playback speed changes suddenly.

参数:

info - Indicates the time information.

从以下版本开始:

3