Video组件实现视频横竖屏切换与全屏播放,主要有两种实现思路:
无论采用哪种方案,都需要调用setPreferredOrientation调整窗口方向为横屏,否则全屏播放时仍会保持竖屏方向布局。
方案一:使用默认控制栏实现全屏播放。该方案利用Video组件的默认控制栏实现全屏播放功能。当用户点击默认控制栏中的全屏按钮时,视频会进入全屏模式,并切换窗口方向为横屏。退出全屏时,窗口方向恢复为竖屏。这种方式实现简单,适合不需要自定义播放控制界面的场景。示例代码如下:
import { window } from '@kit.ArkUI'; import { common } from '@kit.AbilityKit'; @Entry @Component struct VideoDemo1 { private controller: VideoController = new VideoController(); private context = this.getUIContext().getHostContext() as common.UIAbilityContext; private windowClass = (this.context as common.UIAbilityContext).windowStage.getMainWindowSync(); // 窗口方向切换(横竖屏切换) private setOrientation(orientation: Orientation) { this.windowClass.setPreferredOrientation(orientation).then(() => { console.info('setWindowOrientation: ' + orientation + ' Succeeded.'); }).catch((err: BusinessError<void>) => { console.info('setWindowOrientation: ' + orientation + ' Failed. Cause: ' + err.message); }); } build() { Column() { Video({ src: $rawfile('video1.mp4'), // 替换为您的本地视频文件路径 controller: this.controller }) .width('100%') .height(300) .controls(true) // 使用默认控制栏 .objectFit(ImageFit.Contain) // 全屏状态变化时自动切换横竖屏 // 当视频切换到全屏播放时,若没有将窗口切换到横屏,将会是一个竖屏全屏播放效果 .onFullscreenChange((event) => { if (event.fullscreen) { this.setOrientation(window.Orientation.LANDSCAPE); // 横屏 } else { this.setOrientation(window.Orientation.PORTRAIT); // 竖屏 } }); } .width('100%') .height('100%'); } }
方案二:通过窗口沉浸式布局实现全屏播放。该方案适用于需要自定义控制栏的场景。通过窗口沉浸式布局,同时调整窗口方向为横屏,隐藏状态栏和导航栏,以实现沉浸式的全屏播放效果。退出全屏时,窗口方向恢复为竖屏,状态栏和导航栏恢复显示。示例代码如下:
import { window } from '@kit.ArkUI'; import { common } from '@kit.AbilityKit'; @Entry @Component struct VideoDemo2 { private controller = new VideoController(); private context = this.getUIContext().getHostContext() as common.UIAbilityContext; private windowClass = (this.context as common.UIAbilityContext).windowStage.getMainWindowSync(); // 记录当前是否全屏状态 @State private isFullScreen: boolean = false; build() { Stack() { Video({ src: $rawfile('video1.mp4'), // 替换为您的本地视频文件路径 controller: this.controller }) .width('100%') .height(this.isFullScreen ? '100%' : 300) .objectFit(ImageFit.Contain) .autoPlay(true) .loop(true) .controls(false); // 自定义的控制器,全屏切换 Row() { Text(this.isFullScreen ? '退出全屏' : '进入全屏') .fontColor(Color.White); } .border({ color: Color.White, width: 1 }) .margin({ bottom: 15 }) .zIndex(1) .onClick(() => { this.isFullScreen = !this.isFullScreen; this.toggleWindowOrientationAndFullscreen(this.isFullScreen); }); } .alignContent(Alignment.Bottom) .width('100%'); } // 切换窗口方向、设置窗口全屏布局、控制避让区显隐 private toggleWindowOrientationAndFullscreen(isFullScreen: boolean) { // 1. 窗口方向切换(横竖屏切换) let orientation = isFullScreen ? window.Orientation.LANDSCAPE : window.Orientation.PORTRAIT; this.windowClass.setPreferredOrientation(orientation).then(() => { console.info('setWindowOrientation: ' + orientation + ' Succeeded.'); }).catch((err: BusinessError<void>) => { console.info('setWindowOrientation: ' + orientation + ' Failed. Cause: ' + err.message); }); // 2. 设置窗口全屏布局 this.windowClass.setWindowLayoutFullScreen(isFullScreen).then(() => { console.info('Succeeded in setting the window layout to full-screen mode.'); }).catch((err: BusinessError<void>) => { console.error(`Failed to set the window layout to full-screen mode. Code is ${err.code}, message is ${err.message}`); }); // 3. 设置状态栏显隐 this.windowClass.setSpecificSystemBarEnabled('status', !isFullScreen).then(() => { console.info('Succeeded in setting the status bar to be invisible.'); }).catch((err: BusinessError<void>) => { console.error(`Failed to set the status bar to be invisible. Code is ${err.code}, message is ${err.message}`); }); // 4. 设置导航区域显隐 this.windowClass.setSpecificSystemBarEnabled('navigationIndicator', !isFullScreen).then(() => { console.info('Succeeded in setting the navigation indicator to be invisible.'); }).catch((err: BusinessError<void>) => { console.error(`Failed to set the navigation indicator to be invisible. Code is ${err.code}, message is ${err.message}`); }); } }
以上两种方案均能实现Video组件的横竖屏切换与全屏播放功能。方案一利用系统默认控制栏的全屏播放能力,实现简单快捷,适合基础播放场景。方案二通过窗口沉浸式布局和避让区的显隐控制,更适合需要定制界面与交互的场景。开发者可根据实际场景选择适合的实现方式。
Q:当Tabs栏中的视频切换为横屏全屏播放时,如何隐藏Tabs栏?
A:在TabContent中进行视频播放时,若切换至横屏全屏,Tabs栏会随之旋转并仍保留在页面上。要解决此问题,可以在进入全屏时隐藏Tabs栏,退出全屏时再将其显示出来。
@Entry @Component struct TabsView { @State isFullScreen: boolean = false; build() { Tabs() { // todo } .visibility(this.isFullScreen ? Visibility.None : Visibility.Visible); // 需要使用None,隐藏但不参与布局,不进行占位。 } }
Q:应用采取组件安全区布局方案实现全屏时,Video组件配置expandSafeArea属性有什么限制?
A:Video组件在使用expandSafeArea扩展安全区域时,组件视频显示内容区域不支持扩展。