如何解决Video组件全屏播放时，自定义控制器显示异常的问题
==============================

#### 问题现象

自定义Video组件控制条样式，当Video组件横屏全屏时，发现自定义的控制器被隐藏。

通过Text组件定义一个名为“这是一个全屏按钮”的视频控制器。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/83/v3/VGnl-t3yRGGJ_vzde1_u5A/zh-cn_image_0000002658791779.png?HW-CC-KV=V1&HW-CC-Date=20260709T133907Z&HW-CC-Expire=86400&HW-CC-Sign=6EAE3EF01079BAE4C16B442B44351915A63C1BDC308A206BE7A3CAC5A00DA0A6 "点击放大")

点击“这是一个全屏按钮”视频控制器，将视频进行横屏全屏播放。横屏后“这是一个全屏按钮”控制器会消失。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/57/v3/4H0xXu5USaScbB3wjgu7Jg/zh-cn_image_0000002628552402.png?HW-CC-KV=V1&HW-CC-Date=20260709T133907Z&HW-CC-Expire=86400&HW-CC-Sign=B66F700193CBAF53480269BA7F5B582004CCCAA44ED04030BC0FDBEF3A6AEF1C "点击放大")

问题代码示例参考如下：

import { window } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  @State private isFullScreen: boolean = false;
  @State videoSrc: Resource = $rawfile('videoTest.mp4');
  @State previewUri: Resource = $r('app.media.img\_1');
  private controller = new VideoController();

  build() {
    Stack() {
      Video({
        src: this.videoSrc,
        previewUri: this.previewUri,
        controller: this.controller
      })
        .width('100%')
        .height('100%')
        .loop(false)
        .controls(false)
        .onFullscreenChange((event) => {
          this.isFullScreen = event.fullscreen;
          this.changeOrientation(this.isFullScreen);
        })
        .objectFit(ImageFit.Contain)
        .autoPlay(false)
        .id('video\_news\_detail')
        .alignRules({
          top: { anchor: '\_\_container\_\_', align: VerticalAlign.Top }
        });
     _ // 期望自定义的控制组件在全屏状态下保持可见_
      Text('这是一个全屏按钮')
        .fontColor(Color.White)
        .onClick(() => {
          if (this.isFullScreen) {
            this.controller.exitFullscreen();
          } else {
            this.controller.requestFullscreen(true);
          }
        })
        .id('a')
        .alignRules({
          top: { anchor: '\_\_container\_\_', align: VerticalAlign.Top }
        });
    }
    .align(Alignment.Bottom)
    .width('100%')
    .aspectRatio(16 / 9);
  }

 _ // 更改屏幕方向landscape为true横屏，false竖屏_
  changeOrientation(landscape: boolean) {
    window.getLastWindow(this.getUIContext().getHostContext()).then((lastWindow) => {
      lastWindow.setPreferredOrientation(landscape ? window.Orientation.LANDSCAPE : window.Orientation.PORTRAIT);
    });
  }
}

#### 效果预览

修改完成后，竖屏播放效果：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ba/v3/N0-M6xvcTrabmzgjB3M9dA/zh-cn_image_0000002628392512.png?HW-CC-KV=V1&HW-CC-Date=20260709T133907Z&HW-CC-Expire=86400&HW-CC-Sign=0847FA2C0674B6ED57E02745FDEE0EE8E2A334AC3F4589FA378A61B14A80F6B5 "点击放大")

点击“全屏”按钮进入横屏播放效果：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/39/v3/56_qIb1xTFOETlPMxCWgCQ/zh-cn_image_0000002658911729.png?HW-CC-KV=V1&HW-CC-Date=20260709T133907Z&HW-CC-Expire=86400&HW-CC-Sign=D6625E774D10A634CCCA47C9A82427A549442191266074CFF1E058D4D08C481D "点击放大")

视频横屏后，控制器依旧存在。

#### 背景知识

*   [Video组件](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-media-components-video)只能实现较简单场景下的视频播放，一般较复杂的视频播放功能推荐使用[AVPlayer](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/video-playback)。
*   通过自定义组件的[点击事件](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-events-click#onclick12)实现视频的控制器时，控制器可通过Video组件自带的[VideoController](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-media-components-video#videocontroller)的[this.controller.exitFullscreen()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-media-components-video#exitfullscreen)以及[this.controller.requestFullscreen(true)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-media-components-video#requestfullscreen)方法实现全屏播放。但是该全屏方法是VideoController自带的方法，只会将视频进行全屏展示，从而导致视频全屏后控制器组件消失。

#### 解决方案

采用自定义组件封装Video组件的VideoController方法：

1.  采用[Stack组件](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-stack)将“自定义控制器”与视频播放器Video组件重叠，除了全屏方法外，其它方法依旧采用自定义组件封装Video组件的VideoController方法实现。
2.  通过[window.getLastWindow](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-window-f#windowgetlastwindow9)方法获取窗口信息。
3.  再通过[setPreferredOrientation()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-window-window#setpreferredorientation9)方法设置窗口的显示方向。
4.  窗口横屏后，Video组件通过自适应宽高实现横屏下全屏播放且自定义控制条仍然存在的效果。

import { window } from '@kit.ArkUI';

@Entry
@Component
struct Index {
  @State private isFullScreen: boolean = false;
  @State videoSrc: Resource = $rawfile('videoTest.mp4'); _// 视频文件资源需要替换为本地资源_
  @State previewUri: Resource = $r('app.media.img\_1'); _// 视频封面资源需要替换为本地资源_
  private controller = new VideoController();
  @State curRate: PlaybackSpeed = PlaybackSpeed.Speed\_Forward\_1\_00\_X;

  aboutToAppear(): void {
    window.getLastWindow(this.getUIContext().getHostContext(), (err, data) => {
      data?.setWindowLayoutFullScreen(true); _// 设置沉浸式布局_
    });
  }

  build() {
    Column() {
      Stack() {
        Video({
          src: this.videoSrc,
          previewUri: this.previewUri,
          controller: this.controller
        })
          .width('100%')
          .loop(false)
          .controls(false)
          .objectFit(ImageFit.Contain)
          .autoPlay(false)
          .id('video\_news\_detail');
      _  // 自定义的控制器_
        Row() {
          Text('start').onClick(() => {
            this.controller.start(); _// 开始播放_
          }).margin(5).fontColor(Color.White);
          Text('pause').onClick(() => {
            this.controller.pause(); _// 暂停播放_
          }).margin(5).fontColor(Color.White);
          Text('0.75').onClick(() => {
            this.curRate = PlaybackSpeed.Speed\_Forward\_0\_75\_X; _// 0.75倍速播放_
          }).margin(5).fontColor(Color.White);
          Text('1').onClick(() => {
            this.curRate = PlaybackSpeed.Speed\_Forward\_1\_00\_X; _// 原倍速播放_
          }).margin(5).fontColor(Color.White);
          Text('2').onClick(() => {
            this.curRate = PlaybackSpeed.Speed\_Forward\_2\_00\_X; _// 2倍速播放_
          }).margin(5).fontColor(Color.White);
        _  // 修改全屏控制方法，同时删除原问题代码中Video组件的onFullscreenChange判断条件_
          Text(this.isFullScreen ? '退出全屏' : '全屏')
            .onClick(() => {
              this.isFullScreen = !this.isFullScreen;
              this.changeOrientation(this.isFullScreen);
            })
            .fontColor(Color.White);
        }
        .margin({ bottom: 20 });
      }
      .height(this.isFullScreen ? '100%' : 260)
      .align(Alignment.Bottom)
      .width('100%');
    }
    .height('100%')
    .backgroundColor(Color.Black)
    .justifyContent(FlexAlign.Center);
  }

 _ // 更改屏幕方向landscape为true横屏，false竖屏_
  changeOrientation(landscape: boolean) {
    window.getLastWindow(this.getUIContext().getHostContext()).then((lastWindow) => {
      lastWindow.setPreferredOrientation(landscape ? window.Orientation.LANDSCAPE : window.Orientation.PORTRAIT);
    });
  }
}

#### 常见FAQ

Q：Video组件没有办法获取到具体的进度条内容，取不到值应该如何解决？

A：可使用功能更齐全的[AVPlayer](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/video-playback)。

Q：横屏播放后页面的导航条依旧存在，如何去除导航条？

A：采用沉浸模式去除导航条即可，具体参考链接如下：[开发应用沉浸式效果](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-develop-apply-immersive-effects)。

#### 总结

该自定义视频控制器的方案仅适用于页面仅包含Video组件的情况，若该页面下还有除Video组件和视频控制器组件外的其它组件，则不建议使用该方式，会导致布局错乱，建议使用AVPlayer。