1# Interface (NativeMediaPlayerBridge) 2<!--Kit: ArkWeb--> 3<!--Subsystem: Web--> 4<!--Owner: @zhangyao75477--> 5<!--Designer: @qiu-gongkai--> 6<!--Tester: @ghiker--> 7<!--Adviser: @HelloCrease--> 8 9[CreateNativeMediaPlayerCallback](./arkts-apis-webview-t.md#createnativemediaplayercallback12) 回调函数的返回值类型。 10接管网页媒体的播放器和 ArkWeb 内核之间的一个接口类。 11ArkWeb 内核通过该接口类的实例对象来控制应用创建的用来接管网页媒体的播放器。 12 13> **说明：** 14> 15> - 本模块首批接口从API version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 16> 17> - 本Interface首批接口从API version 12开始支持。 18> 19> - 示例效果请以真机运行为准，当前DevEco Studio预览器不支持。 20 21## updateRect<sup>12+<sup> 22 23updateRect(x: number, y: number, width: number, height: number): void 24 25更新 surface 位置信息。 26 27**系统能力：** SystemCapability.Web.Webview.Core 28 29**参数：** 30 31| 参数名 | 类型 | 必填 | 说明 | 32|--------|------|------|------| 33|x|number| 是 |surface相对于Web组件的x坐标信息。 | 34|y|number| 是 |surface相对于Web组件的y坐标信息。 | 35|width|number| 是 |surface的宽度。<br>单位：像素。 | 36|height|number| 是 |surface的高度。<br>单位：像素。 | 37 38**示例：** 39 40完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 41 42## play<sup>12+<sup> 43 44play(): void 45 46播放视频。 47 48**系统能力：** SystemCapability.Web.Webview.Core 49 50**示例：** 51 52完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 53 54## pause<sup>12+<sup> 55 56pause(): void 57 58暂停播放。 59 60**系统能力：** SystemCapability.Web.Webview.Core 61 62**示例：** 63 64完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 65 66## seek<sup>12+<sup> 67 68seek(targetTime: number): void 69 70播放跳转到某个时间点。 71 72**系统能力：** SystemCapability.Web.Webview.Core 73 74**参数：** 75 76| 参数名 | 类型 | 必填 | 说明 | 77|--------|------|------|------| 78| targetTime | number | 是 | 播放跳转到的时间点。<br>单位：秒。 | 79 80**示例：** 81 82完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 83 84## setVolume<sup>12+<sup> 85 86setVolume(volume: number): void 87 88设置播放器音量值。 89 90**参数：** 91 92| 参数名 | 类型 | 必填 | 说明 | 93|--------|------|------|------| 94| volume | number | 是 | 播放器的音量。<br>取值范围:[0, 1.0]，其中0表示静音，1.0表示最大音量。 | 95 96**系统能力：** SystemCapability.Web.Webview.Core 97 98**示例：** 99 100完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 101 102## setMuted<sup>12+<sup> 103 104setMuted(muted: boolean): void 105 106设置静音状态。 107 108**系统能力：** SystemCapability.Web.Webview.Core 109 110**参数：** 111 112| 参数名 | 类型 | 必填 | 说明 | 113|--------|------|------|------| 114| muted | boolean | 是 | 是否静音。<br>true表示静音，false表示未静音。 | 115 116**示例：** 117 118完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 119 120## setPlaybackRate<sup>12+<sup> 121 122setPlaybackRate(playbackRate: number): void 123 124设置播放速度。 125 126**系统能力：** SystemCapability.Web.Webview.Core 127 128**参数：** 129 130| 参数名 | 类型 | 必填 | 说明 | 131|--------|------|------|------| 132| playbackRate | number | 是 | 播放倍率。<br>取值范围: [0, 10.0]，其中1表示原速播放。 | 133 134**示例：** 135 136完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 137 138## release<sup>12+<sup> 139 140release(): void 141 142销毁播放器。 143 144**系统能力：** SystemCapability.Web.Webview.Core 145 146**示例：** 147 148完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 149 150## enterFullscreen<sup>12+<sup> 151 152enterFullscreen(): void 153 154播放器进入全屏。 155 156**系统能力：** SystemCapability.Web.Webview.Core 157 158**示例：** 159 160完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 161 162## exitFullscreen<sup>12+<sup> 163 164exitFullscreen(): void 165 166播放器退出全屏。 167 168**系统能力：** SystemCapability.Web.Webview.Core 169 170**示例：** 171 172完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 173 174## resumePlayer<sup>12+<sup> 175 176resumePlayer?(): void 177 178通知应用重建应用内播放器，并恢复应用内播放器的状态信息。 179 180**系统能力：** SystemCapability.Web.Webview.Core 181 182**示例：** 183 184完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 185 186## suspendPlayer<sup>12+<sup> 187 188suspendPlayer?(type: SuspendType): void 189 190通知应用销毁应用内播放器，并保存应用内播放器的状态信息。 191 192**系统能力：** SystemCapability.Web.Webview.Core 193 194**参数：** 195 196| 参数名 | 类型 | 必填 | 说明 | 197|--------|------|------|------| 198| type | [SuspendType](./arkts-apis-webview-e.md#suspendtype12) | 是 | 播放器挂起类型。| 199 200**示例：** 201 202完整示例代码参考[onCreateNativeMediaPlayer](./arkts-apis-webview-WebviewController.md#oncreatenativemediaplayer12)。 203