harmony 鸿蒙Interface (NativeMediaPlayerHandler)

  • 2025-06-12
  • 浏览 (4)

Interface (NativeMediaPlayerHandler)

CreateNativeMediaPlayerCallback 回调函数的参数。 应用通过该对象,将播放器的状态报告给ArkWeb内核。

说明:

  • 本模块接口从API version 12开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

  • 示例效果请以真机运行为准,当前IDE预览器不支持。

handleStatusChanged12+

handleStatusChanged(status: PlaybackStatus): void

当播放器的播放状态发生变化时,调用该方法将播放状态通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
status PlaybackStatus 播放器的播放状态。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleVolumeChanged12+

handleVolumeChanged(volume: number): void

当播放器的音量发生变化时,调用该方法将音量通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
volume number 播放器的音量。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleMutedChanged12+

handleMutedChanged(muted: boolean): void

当播放器的静音状态发生变化时,调用该方法将静音状态通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
muted boolean 当前播放器是否静音。
true表示当前播放器静音,false表示当前播放器未静音。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handlePlaybackRateChanged12+

handlePlaybackRateChanged(playbackRate: number): void

当播放器的播放速度发生变化时,调用该方法将播放速度通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
playbackRate number 播放速率。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleDurationChanged12+

handleDurationChanged(duration: number): void

当播放器解析出媒体的总时长时,调用该方法将媒体的总时长通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
duration number 媒体的总时长。
单位:秒。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleTimeUpdate12+

handleTimeUpdate(currentPlayTime: number): void

当媒体的播放进度发生变化时,调用该方法将媒体的播放进度通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
currentPlayTime number 当前播放时间。单位: 秒。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleBufferedEndTimeChanged12+

handleBufferedEndTimeChanged(bufferedEndTime: number): void

当媒体的缓冲时长发生变化时,调用该方法将媒体的缓冲时长通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
bufferedEndTime number 媒体缓冲的时长。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleEnded12+

handleEnded(): void

当媒体播放结束时,调用该方法通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleNetworkStateChanged12+

handleNetworkStateChanged(state: NetworkState): void

当播放器的网络状态发生变化时,调用该方法将播放器的网络状态通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
state NetworkState 播放器的网络状态。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleReadyStateChanged12+

handleReadyStateChanged(state: ReadyState): void

当播放器的缓存状态发生变化时,调用该方法将播放器的缓存状态通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
state ReadyState 播放器的缓存状态。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleFullscreenChanged12+

handleFullscreenChanged(fullscreen: boolean): void

当播放器的全屏状态发生变化时,调用该方法将播放器的全屏状态通知给 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
fullscreen boolean 是否全屏。
true表示全屏,false表示未全屏。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleSeeking12+

handleSeeking(): void

当播放器进入seek 状态时,调用该方法通知 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleSeekFinished12+

handleSeekFinished(): void

当播放器 seek 完成后,调用该方法通知 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleError12+

handleError(error: MediaError, errorMessage: string): void

当播放器发生错误时, 调用该方法通知 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
error MediaError 错误类型。
errorMessage string 错误的详细描述。

示例:

完整示例代码参考onCreateNativeMediaPlayer

handleVideoSizeChanged12+

handleVideoSizeChanged(width: number, height: number): void

当播放器解析出视频的尺寸时, 调用该方法通知 ArkWeb 内核。

系统能力: SystemCapability.Web.Webview.Core

参数:

参数名 类型 必填 说明
width number 视频的宽。
height number 视频的高。

示例:

完整示例代码参考onCreateNativeMediaPlayer

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkWeb(方舟Web)

harmony 鸿蒙ArkWeb_AnyNativeAPI

harmony 鸿蒙ArkWeb_ComponentAPI

harmony 鸿蒙ArkWeb_ControllerAPI

harmony 鸿蒙ArkWeb_CookieManagerAPI

harmony 鸿蒙ArkWeb_JavaScriptBridgeData

harmony 鸿蒙ArkWeb_JavaScriptObject

harmony 鸿蒙ArkWeb_JavaScriptValueAPI

harmony 鸿蒙ArkWeb_ProxyMethod

harmony 鸿蒙ArkWeb_ProxyMethodWithResult

0  赞