当前位置：首页 > news >正文

在HarmonyOS中灵活运用Video组件实现视频播放

news 来源：原创 2024/9/20 5:31:29

在现代应用开发中，视频播放功能变得越来越普遍，特别是在短视频和应用内部视频列表页面中。HarmonyOS提供的Video组件让开发者能够轻松集成视频播放功能，同时具备丰富的自定义选项和控制功能。在本文中，我们将深入探讨如何在HarmonyOS中灵活运用Video组件，从基础的播放控制到更高级的自定义功能。

1. Video组件的基础使用

Video组件是通过调用Video接口来创建的，接口的形式如下：

Video(value: VideoOptions)

VideoOptions对象包含多个参数，其中包括：

src: 指定视频播放源的路径。
currentProgressRate: 设置视频播放倍速。
previewUri: 指定视频未播放时的预览图片路径。
controller: 设置视频控制器，用于自定义视频控制。

加载视频资源

Video组件支持加载本地视频、沙箱路径视频和网络视频。

加载本地视频

加载本地视频时，首先在应用的rawfile目录中放置视频文件，然后通过资源访问符$rawfile()引用该视频资源。

@Component
export struct VideoPlayer {private controller: VideoController | undefined;private previewUris: Resource = $r('app.media.preview');private innerResource: Resource = $rawfile('videoTest.mp4');build() {Column() {Video({src: this.innerResource,previewUri: this.previewUris,controller: this.controller})}}
}

加载沙箱路径视频

沙箱路径视频支持file:///data/storage前缀的字符串，用于读取应用沙箱路径内的资源。

@Component
export struct VideoPlayer {private controller: VideoController | undefined;private videoSrc: string = 'file:///data/storage/el2/base/haps/entry/files/show.mp4'build() {Column() {Video({src: this.videoSrc,controller: this.controller})}}
}

加载网络视频

加载网络视频时，需要申请ohos.permission.INTERNET权限。此时，src属性应设置为网络视频的链接。

@Component
export struct VideoPlayer {private controller: VideoController | undefined;private previewUris: Resource = $r('app.media.preview');private videoSrc: string = 'https://www.example.com/example.mp4';build() {Column() {Video({src: this.videoSrc,previewUri: this.previewUris,controller: this.controller})}}
}

2. 视频组件属性与自定义控制

在Video组件中，我们可以通过设置多个属性来控制视频的播放行为。例如，是否静音、是否显示控制条、是否自动播放、是否循环播放等。

@Component
export struct VideoPlayer {private controller: VideoController | undefined;build() {Column() {Video({controller: this.controller}).muted(false).controls(false).autoPlay(false).loop(false).objectFit(ImageFit.Contain)}}
}

新知识点：自定义播放控制器

除了使用默认的控制器外，HarmonyOS还支持自定义视频控制器。开发者可以关闭默认的控制条，然后使用自定义的Button和Slider组件来控制视频的播放状态和进度。这对于需要高度定制化的视频播放场景非常有用。

@Entry
@Component
struct CustomVideoPlayer {@State videoSrc: Resource = $rawfile('videoTest.mp4');@State previewUri: string = 'common/videoIcon.png';@State currentRate: PlaybackSpeed = PlaybackSpeed.Speed_Forward_1_00_X;@State currentTime: number = 0;@State durationTime: number = 0;controller: VideoController = new VideoController();build() {Row() {Column() {Video({src: this.videoSrc,previewUri: this.previewUri,currentProgressRate: this.currentRate,controller: this.controller}).controls(false).autoPlay(true).onPrepared((event) => {this.durationTime = event.duration;}).onUpdate((event) => {this.currentTime = event.time;});Row() {Text(`${this.currentTime}s`);Slider({value: this.currentTime,min: 0,max: this.durationTime}).onChange((value: number) => {this.controller.setCurrentTime(value);}).width("90%");Text(`${this.durationTime}s`);}.opacity(0.8).width("100%");}.width('100%')}.height('40%');}
}

在这个例子中，开发者自定义了一个简单的控制器，能够实现视频的进度调整，同时可以实时显示当前播放时间和视频总时长。这种自定义控制器的实现方式大大增加了应用的灵活性，使得开发者可以根据具体需求调整视频播放的控制方式。

3. 视频事件处理

Video组件还提供了丰富的事件回调，例如播放开始、暂停、结束、失败、停止以及播放进度更新等。通过这些事件，开发者可以在不同的播放状态下执行相应的逻辑处理，提升用户体验。

@Entry
@Component
struct EventHandlingVideoPlayer {private controller: VideoController | undefined;private previewUris: Resource = $r('app.media.preview');private innerResource: Resource = $rawfile('videoTest.mp4');build() {Column() {Video({src: this.innerResource,previewUri: this.previewUris,controller: this.controller}).onUpdate((event) => {console.info("Video update.");}).onPrepared((event) => {console.info("Video prepared.");}).onError(() => {console.info("Video error.");}).onStop(() => {console.info("Video stopped.");});}}
}

这些事件回调为开发者提供了在播放过程中动态响应的能力，从而实现更加智能和互动的播放体验。