应用ArkTS侧如何通过代码手动控制H5中视频

问题现象

H5网页集成到应用中,需要通过ArkTS控制H5中video视频播放暂停及倍速播放等,请问如何实现?

背景知识

解决方案

  1. 对于有声视频,需为Web组件设置mediaPlayGestureAccess属性。
  2. 页面加载完成,通过元素选择器document.querySelector('video')获取页面video元素。
  3. 应用侧设置暂停/播放/倍速播放按钮,通过runJavaScript函数,触发H5页面执行JavaScript脚本,控制video组件暂停与播放及倍速播放等。
    示例代码如下:
    import { webview } from '@kit.ArkWeb';
    
    @Entry
    @Component
    struct VideoControlExample {
      private controller: webview.WebviewController = new webview.WebviewController();
      @State isPlaying: boolean = false;
    
      build() {
        Column() {
          // Web组件加载视频页面
          Web({
            src: '******', // H5页面地址
            controller: this.controller
          })
            // 页面加载完成后初始化视频控制
            .onPageEnd(() => {
              this.controller.runJavaScript(
                // 获取页面video元素,并设置video.controls为false,设置video播放控件不显示
                "window.videoElement = document.querySelector('video');"
                  + "window.videoElement.controls = false;"
              );
            })
            .mediaPlayGestureAccess(false)  // 允许有声视频用户手动点击播放
            .fileAccess(true)
            .geolocationAccess(false)
            .width('100%')
            .height('85%')
    
          // 播放/暂停控制按钮
          Button(this.isPlaying ? '暂停' : '播放')
            .onClick(() => {
              this.isPlaying = !this.isPlaying;
              if (this.isPlaying) {
                this.controller.runJavaScript('window.videoElement.play();');
              } else {
                this.controller.runJavaScript('window.videoElement.pause();');
              }
            })
            .margin({top: 10})
            .width('90%')
            .height('5%')
    
          // 倍速控制按钮组
          Row() {
            Button('0.75x').onClick(() => this.setPlaybackSpeed(0.75))
            Button('1.0x').onClick(() => this.setPlaybackSpeed(1.0))
            Button('1.5x').onClick(() => this.setPlaybackSpeed(1.5))
          }
          .margin({top: 10})
        }
        .width('100%')
        .height('100%')
      }
    
      // 倍速控制按钮触发
      setPlaybackSpeed(speed: number) {
        const script = `document.querySelector('video').playbackRate = ${speed};`;
        this.controller.runJavaScript(
          script,
          (error, result) => {
            if (error) {
              console.info(`Speed set failed, error code: ${error.code}, error message: ${error.message}`);
            }
            if (result) {
              console.info(`Speed set success: ${speed}x`);
            }
          });
      }
    }

常见FAQ

Q:ArkTS侧如何设置H5中视频的播放控件不显示?

A:video的播放控件由controls属性进行控制,网页加载完成后,设置controls属性为false,播放控件就不会显示。示例代码:

// Web组件加载视频页面
Web({
  src: '******', // H5页面地址
  controller: this.controller
})
  // 页面加载完成后初始化视频控制
  .onPageEnd(() => {
    this.controller.runJavaScript(
      // 获取页面video元素,并设置video.controls为false,设置video播放控件不显示
      "window.videoElement = document.querySelector('video');"
        + "window.videoElement.controls = false;"
    );
  })