• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Video
2
3用于播放视频文件并控制其播放状态的组件。
4
5>  **说明:**
6>
7>  该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。<br/>
8>  Video组件只提供简单的视频播放功能,无法支撑复杂的视频播控场景。复杂开发场景推荐使用[AVPlayer播控API](../../apis-media-kit/js-apis-media.md#avplayer9)和[XComponent](ts-basic-components-xcomponent.md)组件开发。
9
10## 权限列表
11
12使用网络视频时,需要申请权限ohos.permission.INTERNET。具体申请方式请参考[声明权限](../../../security/AccessToken/declare-permissions.md)。
13
14
15## 子组件
16
17不支持子组件。
18
19
20## 接口
21
22### Video
23
24Video(value: VideoOptions)
25
26**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
27
28**系统能力:** SystemCapability.ArkUI.ArkUI.Full
29
30**参数:**
31
32| 参数名 | 类型 | 必填 | 说明 |
33| -------- | -------- | -------- | -------- |
34| value | [VideoOptions](#videooptions对象说明) | 是 | 视频信息。 |
35
36##  VideoOptions对象说明
37
38**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
39
40**系统能力:** SystemCapability.ArkUI.ArkUI.Full
41
42| 名称              | 类型                                                     | 必填 | 说明                                                     |
43| ------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
44| src                 | string \| [Resource](ts-types.md#resource)                            | 否   | 视频的数据源,支持本地视频和网络视频。<br>Resource格式可以跨包/跨模块访问资源文件,常用于访问本地视频。<br/>- 支持rawfile文件下的资源,即通过\$rawfile引用视频文件。<br/>string格式可用于加载网络视频和本地视频,常用于加载网络视频。<br/>- 支持网络视频地址。<br/>- 支持file://路径前缀的字符串,即[应用沙箱URI](../../apis-core-file-kit/js-apis-file-fileuri.md#constructor10):file://\<bundleName>/\<sandboxPath>。用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。<br/>**说明:**<br/>视频支持的格式是:mp4、mkv、TS。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
45| currentProgressRate | number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[PlaybackSpeed<sup>8+</sup>](#playbackspeed8枚举说明) | 否   | 视频播放倍速。<br/>**说明:**<br/>number格式取值仅支持:0.75,1.0,1.25,1.75,2.0。<br/>string格式支持number格式取值的字符串形式:"0.75","1.0","1.25","1.75","2.0"。<br/>默认值:1.0 \| PlaybackSpeed.Speed_Forward_1_00_X<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
46| previewUri          | string&nbsp;\| [PixelMap](../../apis-image-kit/js-apis-image.md#pixelmap7)&nbsp;\|&nbsp;[Resource](ts-types.md#resource)  | 否   | 视频未播放时的预览图片路径,默认不显示图片。<br/>string格式可用于加载本地图片和网络图片,<br/>- 支持网络图片地址。<br/>- 支持相对路径引用本地图片,例如:previewUri: “common/test.jpg”。当使用相对路径引用本地图片时,不支持跨包/跨模块调用。<br/>- 支持file://路径前缀的字符串,即[应用沙箱URI](../../apis-core-file-kit/js-apis-file-fileuri.md#constructor10):file://\<bundleName>/\<sandboxPath>。用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。<br/>Resource格式可以跨包/跨模块访问资源文件。<br/>- 支持rawfile文件下的资源,即通过\\$rawfile引用图片。<br/>- 支持通过\\$r引用系统资源或者应用资源中的图片。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。                 |
47| controller          | [VideoController](#videocontroller)                          | 否   | 设置视频控制器,可以控制视频的播放状态。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。                     |
48| imageAIOptions<sup>12+</sup>  | [ImageAIOptions](ts-image-common.md#imageaioptions) | 否   | 设置图像AI分析选项,可配置分析类型或绑定一个分析控制器。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 |
49
50## PlaybackSpeed<sup>8+</sup>枚举说明
51
52**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
53
54**系统能力:** SystemCapability.ArkUI.ArkUI.Full
55
56| 名称                 | 说明           |
57| -------------------- | -------------- |
58| Speed_Forward_0_75_X | 0.75倍速播放。 |
59| Speed_Forward_1_00_X | 1倍速播放。    |
60| Speed_Forward_1_25_X | 1.25倍速播放。 |
61| Speed_Forward_1_75_X | 1.75倍速播放。 |
62| Speed_Forward_2_00_X | 2倍速播放。    |
63
64## 属性
65
66除支持[通用属性](ts-component-general-attributes.md)外,还支持以下属性:
67
68### muted
69
70muted(value: boolean)
71
72设置是否静音。
73
74**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
75
76**系统能力:** SystemCapability.ArkUI.ArkUI.Full
77
78**参数:**
79
80| 参数名 | 类型    | 必填 | 说明                         |
81| ------ | ------- | ---- | ---------------------------- |
82| value  | boolean | 是   | 是否静音。<br/>默认值:false |
83
84### autoPlay
85
86autoPlay(value: boolean)
87
88设置是否自动播放。
89
90**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
91
92**系统能力:** SystemCapability.ArkUI.ArkUI.Full
93
94**参数:**
95
96| 参数名 | 类型    | 必填 | 说明                             |
97| ------ | ------- | ---- | -------------------------------- |
98| value  | boolean | 是   | 是否自动播放。<br/>默认值:false |
99
100### controls
101
102controls(value: boolean)
103
104设置控制视频播放的控制栏是否显示。
105
106**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
107
108**系统能力:** SystemCapability.ArkUI.ArkUI.Full
109
110**参数:**
111
112| 参数名 | 类型    | 必填 | 说明                                            |
113| ------ | ------- | ---- | ----------------------------------------------- |
114| value  | boolean | 是   | 控制视频播放的控制栏是否显示。<br/>默认值:true |
115
116### objectFit
117
118objectFit(value: ImageFit)
119
120设置视频显示模式。
121
122**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
123
124**系统能力:** SystemCapability.ArkUI.ArkUI.Full
125
126**参数:**
127
128| 参数名 | 类型                                      | 必填 | 说明                             |
129| ------ | ----------------------------------------- | ---- | -------------------------------- |
130| value  | [ImageFit](ts-appendix-enums.md#imagefit) | 是   | 视频显示模式。<br/>默认值:Cover |
131
132### loop
133
134loop(value: boolean)
135
136设置是否单个视频循环播放。
137
138**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
139
140**系统能力:** SystemCapability.ArkUI.ArkUI.Full
141
142**参数:**
143
144| 参数名 | 类型    | 必填 | 说明                                     |
145| ------ | ------- | ---- | ---------------------------------------- |
146| value  | boolean | 是   | 是否单个视频循环播放。<br/>默认值:false |
147
148### enableAnalyzer<sup>12+</sup>
149
150enableAnalyzer(enable: boolean)
151
152设置组件支持AI分析,当前支持主体识别、文字识别和对象查找等功能。
153使能后,视频播放暂停时自动进入分析状态,开始分析当前画面帧,视频继续播放后自动退出分析状态。
154不能和[overlay](ts-universal-attributes-overlay.md)属性同时使用,两者同时设置时[overlay](ts-universal-attributes-overlay.md)中[CustomBuilder](ts-types.md#custombuilder8)属性将失效。
155
156**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
157
158**系统能力:** SystemCapability.ArkUI.ArkUI.Full
159
160**参数:**
161
162| 参数名 | 类型 | 必填 | 说明 |
163| -------- | -------- | -------- | -------- |
164| enable | boolean | 是 | 是否启用AI分析功能 |
165
166> **说明:**
167>
168> 当前仅在使用自定义控制栏([controls](#controls)属性设置为false)时支持该功能。
169> 该特性依赖设备能力。
170
171### analyzerConfig<sup>12+</sup>
172
173analyzerConfig(config: ImageAnalyzerConfig)
174
175设置AI分析识别类型,包括主体识别、文字识别和对象查找等功能。
176
177**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
178
179**系统能力:** SystemCapability.ArkUI.ArkUI.Full
180
181| 参数名 | 类型 | 必填 | 说明 |
182| -------- | -------- | -------- | -------- |
183| config | [ImageAnalyzerConfig](ts-image-common.md#imageanalyzerconfig) | 是 | 设置AI分析识别类型 |
184
185### enableShortcutKey<sup>15+</sup>
186
187enableShortcutKey(enabled: boolean)
188
189设置组件支持快捷键响应。
190
191目前支持在组件获焦后响应空格键播放/暂停、上下方向键调整视频音量、左右方向键快进/快退。
192
193**原子化服务API:** 从API version 15开始,该接口支持在原子化服务中使用。
194
195**系统能力:** SystemCapability.ArkUI.ArkUI.Full
196
197| 参数名  | 类型    | 必填 | 说明                                   |
198| ------- | ------- | ---- | -------------------------------------- |
199| enabled | boolean | 是   | 是否启用快捷键响应。<br/>默认值:false |
200
201## 事件
202
203除支持[通用事件](ts-component-general-events.md)外,还支持以下事件:
204
205### onStart
206
207onStart(event: () => void)
208
209播放时触发该事件。
210
211**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
212
213**系统能力:** SystemCapability.ArkUI.ArkUI.Full
214
215### onPause
216
217onPause(event: () => void)
218
219暂停时触发该事件。
220
221**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
222
223**系统能力:** SystemCapability.ArkUI.ArkUI.Full
224
225### onFinish
226
227onFinish(event: () => void)
228
229播放结束时触发该事件。
230
231**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
232
233**系统能力:** SystemCapability.ArkUI.ArkUI.Full
234
235### onError
236
237onError(event: () => void)
238
239播放失败时触发该事件。
240
241**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
242
243**系统能力:** SystemCapability.ArkUI.ArkUI.Full
244
245### onStop<sup>12+</sup>
246
247onStop(event: Callback&lt;void&gt;)
248
249播放停止时触发该事件(当stop()方法被调用后触发)。
250
251**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
252
253**系统能力:** SystemCapability.ArkUI.ArkUI.Full
254
255### onPrepared
256
257onPrepared(callback: (event: { duration: number }) => void)
258
259视频准备完成时触发该事件。
260
261**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
262
263**系统能力:** SystemCapability.ArkUI.ArkUI.Full
264
265**参数:**
266
267| 参数名   | 类型   | 必填 | 说明                       |
268| -------- | ------ | ---- | -------------------------- |
269| duration | number | 是   | 当前视频的时长,单位为秒。 |
270
271### onSeeking
272
273onSeeking(callback: (event: { time: number }) => void)
274
275操作进度条过程时上报时间信息。
276
277**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
278
279**系统能力:** SystemCapability.ArkUI.ArkUI.Full
280
281**参数:**
282
283| 参数名 | 类型   | 必填 | 说明                           |
284| ------ | ------ | ---- | ------------------------------ |
285| time   | number | 是   | 当前视频播放的进度,单位为秒。 |
286
287### onSeeked
288
289onSeeked(callback: (event: { time: number }) => void)
290
291操作进度条完成后,上报播放时间信息。
292
293**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
294
295**系统能力:** SystemCapability.ArkUI.ArkUI.Full
296
297**参数:**
298
299| 参数名 | 类型   | 必填 | 说明                           |
300| ------ | ------ | ---- | ------------------------------ |
301| time   | number | 是   | 当前视频播放的进度,单位为秒。 |
302
303### onUpdate
304
305onUpdate(callback: (event: { time: number }) => void)
306
307播放进度变化时触发该事件。
308
309**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
310
311**系统能力:** SystemCapability.ArkUI.ArkUI.Full
312
313**参数:**
314
315| 参数名 | 类型   | 必填 | 说明                           |
316| ------ | ------ | ---- | ------------------------------ |
317| time   | number | 是   | 当前视频播放的进度,单位为秒。 |
318
319### onFullscreenChange
320
321onFullscreenChange(callback: (event: { fullscreen: boolean }) => void)
322
323在全屏播放与非全屏播放状态之间切换时触发该事件。
324
325**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
326
327**系统能力:** SystemCapability.ArkUI.ArkUI.Full
328
329**参数:**
330
331| 参数名     | 类型    | 必填 | 说明                                                  |
332| ---------- | ------- | ---- | ----------------------------------------------------- |
333| fullscreen | boolean | 是   | 为true表示进入全屏播放状态,为false则表示非全屏播放。 |
334
335## VideoController
336
337一个VideoController对象可以控制一个或多个video,可用视频播放实例请参考[@ohos.multimedia.media](../../apis-media-kit/js-apis-media.md)。
338
339**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
340
341**系统能力:** SystemCapability.ArkUI.ArkUI.Full
342
343### 导入对象
344
345```ts
346let controller: VideoController = new VideoController()
347```
348
349### constructor
350
351constructor()
352
353VideoController的构造函数。
354
355**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
356
357**系统能力:** SystemCapability.ArkUI.ArkUI.Full
358
359### start
360
361start()
362
363开始播放。
364
365**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
366
367**系统能力:** SystemCapability.ArkUI.ArkUI.Full
368
369### pause
370
371pause()
372
373暂停播放,显示当前帧,再次播放时从当前位置继续播放。
374
375**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
376
377**系统能力:** SystemCapability.ArkUI.ArkUI.Full
378
379### stop
380
381stop()
382
383停止播放,显示当前帧,再次播放时从头开始播放。
384
385**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
386
387**系统能力:** SystemCapability.ArkUI.ArkUI.Full
388
389### reset<sup>12+</sup>
390
391reset(): void
392
393video组件重置AVPlayer。显示当前帧,再次播放时从头开始播放。
394
395**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
396
397**系统能力:** SystemCapability.ArkUI.ArkUI.Full
398
399### setCurrentTime
400
401setCurrentTime(value: number)
402
403指定视频播放的进度位置。
404
405**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
406
407**系统能力:** SystemCapability.ArkUI.ArkUI.Full
408
409**参数:**
410
411| 参数名   | 类型   | 必填   | 说明           |
412| ----- | ------ | ---- | -------------- |
413| value | number | 是    | 视频播放进度位置,取值范围:[0, 视频时长],单位:秒。 |
414
415### requestFullscreen
416
417requestFullscreen(value: boolean)
418
419请求全屏播放。
420
421**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
422
423**系统能力:** SystemCapability.ArkUI.ArkUI.Full
424
425**参数:**
426
427| 参数名 | 类型 | 必填 | 说明                         |
428| ------ | -------- | ---- | -------------------------------- |
429| value  | boolean  | 是   | 是否全屏(填充满应用窗口)播放。 |
430
431### exitFullscreen
432
433exitFullscreen()
434
435退出全屏播放。
436
437**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
438
439**系统能力:** SystemCapability.ArkUI.ArkUI.Full
440
441### setCurrentTime<sup>8+</sup>
442
443setCurrentTime(value: number, seekMode: SeekMode)
444
445指定视频播放的进度位置,并指定跳转模式。
446
447**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
448
449**系统能力:** SystemCapability.ArkUI.ArkUI.Full
450
451**参数:**
452
453| 参数名      | 类型     | 必填   | 说明           |
454| -------- | -------- | ---- | -------------- |
455| value    | number   | 是    | 视频播放进度位置,单位为s。 |
456| seekMode | [SeekMode](#seekmode8枚举说明) | 是    | 跳转模式。          |
457
458## SeekMode<sup>8+</sup>枚举说明
459
460**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
461
462**系统能力:** SystemCapability.ArkUI.ArkUI.Full
463
464| 名称             | 说明                         |
465| ---------------- | ---------------------------- |
466| PreviousKeyframe | 跳转到前一个最近的关键帧。   |
467| NextKeyframe     | 跳转到后一个最近的关键帧。   |
468| ClosestKeyframe  | 跳转到最近的关键帧。         |
469| Accurate         | 精准跳转,不论是否为关键帧。 |
470
471## 示例
472
473### 示例1(视频播放基础用法)
474
475基础用法,包括控制栏、预览图、自动播放、播放速度、响应快捷键、控制器(开始播放、暂停播放、停止播放、重置avPlayer、跳转等)以及一些状态回调方法。
476
477```ts
478// xxx.ets
479@Entry
480@Component
481struct VideoCreateComponent {
482  @State videoSrc: Resource = $rawfile('video1.mp4')
483  @State previewUri: Resource = $r('app.media.poster1')
484  @State curRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X
485  @State isAutoPlay: boolean = false
486  @State showControls: boolean = true
487  @State isShortcutKeyEnabled: boolean = false
488  controller: VideoController = new VideoController()
489
490  build() {
491    Column() {
492      Video({
493        src: this.videoSrc,
494        previewUri: this.previewUri,
495        currentProgressRate: this.curRate,
496        controller: this.controller
497      })
498        .width('100%')
499        .height(600)
500        .autoPlay(this.isAutoPlay)
501        .controls(this.showControls)
502        .enableShortcutKey(this.isShortcutKeyEnabled)
503        .onStart(() => {
504          console.info('onStart')
505        })
506        .onPause(() => {
507          console.info('onPause')
508        })
509        .onFinish(() => {
510          console.info('onFinish')
511        })
512        .onError(() => {
513          console.info('onError')
514        })
515        .onStop(() => {
516          console.info('onStop')
517        })
518        .onPrepared((e?: DurationObject) => {
519          if (e != undefined) {
520            console.info('onPrepared is ' + e.duration)
521          }
522        })
523        .onSeeking((e?: TimeObject) => {
524          if (e != undefined) {
525            console.info('onSeeking is ' + e.time)
526          }
527        })
528        .onSeeked((e?: TimeObject) => {
529          if (e != undefined) {
530            console.info('onSeeked is ' + e.time)
531          }
532        })
533        .onUpdate((e?: TimeObject) => {
534          if (e != undefined) {
535            console.info('onUpdate is ' + e.time)
536          }
537        })
538        .onFullscreenChange((e?: FullscreenObject) => {
539          if (e != undefined) {
540            console.info('onFullscreenChange is ' + e.fullscreen)
541          }
542        })
543
544      Row() {
545        Button('src').onClick(() => {
546          this.videoSrc = $rawfile('video2.mp4') // 切换视频源
547        }).margin(5)
548        Button('previewUri').onClick(() => {
549          this.previewUri = $r('app.media.poster2') // 切换视频预览海报
550        }).margin(5)
551        Button('controls').onClick(() => {
552          this.showControls = !this.showControls // 切换是否显示视频控制栏
553        }).margin(5)
554      }
555
556      Row() {
557        Button('start').onClick(() => {
558          this.controller.start() // 开始播放
559        }).margin(2)
560        Button('pause').onClick(() => {
561          this.controller.pause() // 暂停播放
562        }).margin(2)
563        Button('stop').onClick(() => {
564          this.controller.stop() // 结束播放
565        }).margin(2)
566        Button('reset').onClick(() => {
567          this.controller.reset() // 重置AVPlayer
568        }).margin(2)
569        Button('setTime').onClick(() => {
570          this.controller.setCurrentTime(10, SeekMode.Accurate) // 精准跳转到视频的10s位置
571        }).margin(2)
572      }
573
574      Row() {
575        Button('rate 0.75').onClick(() => {
576          this.curRate = PlaybackSpeed.Speed_Forward_0_75_X // 0.75倍速播放
577        }).margin(5)
578        Button('rate 1').onClick(() => {
579          this.curRate = PlaybackSpeed.Speed_Forward_1_00_X // 原倍速播放
580        }).margin(5)
581        Button('rate 2').onClick(() => {
582          this.curRate = PlaybackSpeed.Speed_Forward_2_00_X // 2倍速播放
583        }).margin(5)
584      }
585    }
586  }
587}
588
589interface DurationObject {
590  duration: number;
591}
592
593interface TimeObject {
594  time: number;
595}
596
597interface FullscreenObject {
598  fullscreen: boolean;
599}
600```
601
602### 示例2(图像分析功能)
603
604使用enableAnalyzer属性开启图像AI分析。
605
606```ts
607// xxx.ets
608@Entry
609@Component
610struct ImageAnalyzerExample {
611  @State videoSrc: Resource = $rawfile('video1.mp4')
612  @State previewUri: Resource = $r('app.media.poster1')
613  @State showControls: boolean = true
614  controller: VideoController = new VideoController()
615  config: ImageAnalyzerConfig = {
616    types: [ImageAnalyzerType.SUBJECT, ImageAnalyzerType.TEXT]
617  }
618  private aiController: ImageAnalyzerController = new ImageAnalyzerController()
619  private options: ImageAIOptions = {
620    types: [ImageAnalyzerType.SUBJECT, ImageAnalyzerType.TEXT],
621    aiController: this.aiController
622  }
623
624  build() {
625    Column() {
626      Video({
627        src: this.videoSrc,
628        previewUri: this.previewUri,
629        controller: this.controller,
630        imageAIOptions: this.options
631      })
632        .width('100%')
633        .height(600)
634        .controls(false)
635        .enableAnalyzer(true)
636        .analyzerConfig(this.config)
637        .onStart(() => {
638          console.info('onStart')
639        })
640        .onPause(() => {
641          console.info('onPause')
642        })
643
644      Row() {
645        Button('start').onClick(() => {
646          this.controller.start() // 开始播放
647        }).margin(5)
648        Button('pause').onClick(() => {
649          this.controller.pause() // 暂停播放
650        }).margin(5)
651        Button('getTypes').onClick(() => {
652            this.aiController.getImageAnalyzerSupportTypes()
653        }).margin(5)
654      }
655    }
656  }
657}
658```
659
660### 示例3(播放拖入的视频)
661
662以下示例展示了如何使Video组件能够播放拖入的视频。
663
664```ts
665// xxx.ets
666import { unifiedDataChannel, uniformTypeDescriptor } from '@kit.ArkData';
667
668@Entry
669@Component
670struct Index {
671  @State videoSrc: Resource | string = $rawfile('video1.mp4');
672  private controller: VideoController = new VideoController();
673
674  build() {
675    Column() {
676      Video({
677        src: this.videoSrc,
678        controller: this.controller
679      })
680        .width('100%')
681        .height(600)
682        .onPrepared(() => {
683          // 在onPrepared回调中执行controller的start方法,确保视频源更换后直接开始播放。
684          this.controller.start();
685        })
686        .onDrop((e: DragEvent) => {
687          // 外部视频拖入应用Video组件范围,松手后触发通过onDrop注册的回调。
688          // 在DragEvent中会包含拖入的视频源信息,取出后赋值给状态变量videoSrc即可改变Video的视频源。
689          let record = e.getData().getRecords()[0];
690          if (record.getType() == uniformTypeDescriptor.UniformDataType.VIDEO) {
691            let videoInfo = record as unifiedDataChannel.Video;
692            this.videoSrc = videoInfo.videoUri;
693          }
694        })
695    }
696  }
697}
698```