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

在现代应用开发中，视频播放功能变得越来越普遍，特别是在短视频和应用内部视频列表页面中。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.");
        });
    }
  }
}

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

总结

HarmonyOS中的Video组件提供了从基础到高级的视频播放控制功能。通过本文的介绍，我们不仅了解了Video组件的基本使用方式，还探讨了自定义控制器的实现和事件处理的灵活性。掌握这些知识点，开发者可以在应用中实现更加丰富的视频播放效果，为用户带来更好的视觉体验。