在HarmonyOS应用开发中,使用Video组件进行视频播放时,其自带的控制器(controls)样式固定,可能无法满足特定的UI设计需求。开发者常常需要实现自定义样式的播放/暂停按钮、进度条、音量控制、全屏切换等功能。
Video组件是HarmonyOS提供的基础视频播放组件,通过VideoController可以便捷地控制视频的播放、暂停、进度调整、全屏等行为。要实现个性化的播放器界面需要将Video组件的controls属性设置为false以隐藏默认控制器,然后组合使用基础组件(如Button、Slider、Text)与VideoController的API,自行构建控制栏的布局与交互逻辑。
Video组件控制栏功能的自定义主要是通过将VideoController与各种基础组件结合实现,以下将分解四个常见自定义场景,详细说明其实现原理并提供关键代码片段。
Slider({
value: this.currentTime,
min: 0,
max: this.durationTime
})
.onChange((value: number) => {
this.controller.setCurrentTime(value); // 设置视频播放的进度跳转到value处
})
.width('65%'); .onPrepared((event) => {
if (event) {
this.durationTime = event.duration;
this.restTime = event.duration; // 获取视频总长
}
})
.onUpdate((event) => {
if (event) {
this.currentTime = event.time;
this.restTime = this.durationTime - event.time; // 剩余时长等于总长减去当前位置
}
}); // 展示剩余时长
Text(`${this.restTime.toString()}s`)
.width('10%')
.fontColor(Color.White); Slider({
value: $$this.voiceValue,
min: 0,
max: 15
})
.rotate({
z: 1,
angle: -90
})
.height(150)
.width(150); AVVolumePanel({
volumeLevel: this.voiceValue,
volumeParameter: {
position: {
x: 100,
y: 200
}
}
}); // 修改全屏控制方法,同时删除原问题代码中Video组件的onFullscreenChange判断条件
Text(this.isFullScreen ? '退出全屏' : '全屏')
.onClick(() => {
this.isFullScreen = !this.isFullScreen;
this.changeOrientation(this.isFullScreen);
})
.width('15%')
.fontColor(Color.White); // 更改屏幕方向landscape为true横屏,false竖屏
changeOrientation(landscape: boolean) {
window.getLastWindow(this.getUIContext().getHostContext()).then((lastWindow) => {
lastWindow.setPreferredOrientation(landscape ? window.Orientation.LANDSCAPE : window.Orientation.PORTRAIT);
});
} 完整示例参考如下:
import { window } from '@kit.ArkUI';
import { AVVolumePanel } from '@kit.AudioKit';
@Entry
@Component
struct VideoControlPage {
@State private isFullScreen: boolean = false;
@State videoSrc: Resource = $rawfile('videoTest.mp4'); // 视频文件资源需要替换为本地资源
@State previewUri: Resource = $r('app.media.foreground'); // 视频封面资源需要替换为本地资源
private controller = new VideoController();
@State currentTime: number = 0;
@State voiceValue: number = 5;
@State durationTime: number = 100;
@State play: boolean = false;
@State restTime: number = 0;
aboutToAppear(): void {
this.durationTime = 29;
}
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);
})
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
.objectFit(ImageFit.Contain)
.autoPlay(false)
.id('video_news_detail')
.onPrepared((event) => {
if (event) {
this.durationTime = event.duration;
this.restTime = event.duration; // 获取视频总长
}
})
.onUpdate((event) => {
if (event) {
this.currentTime = event.time;
this.restTime = this.durationTime - event.time; // 剩余时长等于总长减去当前位置
}
});
// 音量控制器
Row() {
Slider({
value: $$this.voiceValue,
min: 0,
max: 15
})
.rotate({
z: 1,
angle: -90
})
.height(150)
.width(150);
}
.margin({ bottom: this.isFullScreen ? 50 : 200 })
.width('100%')
.height(200)
.justifyContent(FlexAlign.Start)
.zIndex(1);
// 自定义的控制器
Row() {
Text(this.play ? '暂停' : '播放').onClick(() => {
this.play = !this.play;
if (this.play) {
this.controller.start(); // 开始播放
} else {
this.controller.pause(); // 暂停播放
}
}).margin(5).fontColor(Color.White)
.width('10%');
Slider({
value: this.currentTime,
min: 0,
max: this.durationTime
})
.onChange((value: number) => {
this.controller.setCurrentTime(value); // 设置视频播放的进度跳转到value处
})
.width('65%');
// 展示剩余时长
Text(`${this.restTime.toString()}s`)
.width('10%')
.fontColor(Color.White);
// 修改全屏控制方法,同时删除原问题代码中Video组件的onFullscreenChange判断条件
Text(this.isFullScreen ? '退出全屏' : '全屏')
.onClick(() => {
this.isFullScreen = !this.isFullScreen;
this.changeOrientation(this.isFullScreen);
})
.width('15%')
.fontColor(Color.White);
}
.zIndex(2);
AVVolumePanel({
volumeLevel: this.voiceValue,
volumeParameter: {
position: {
x: 100,
y: 200
}
}
});
}
.align(Alignment.Bottom)
.width('100%');
}
// 更改屏幕方向landscape为true横屏,false竖屏
changeOrientation(landscape: boolean) {
window.getLastWindow(this.getUIContext().getHostContext()).then((lastWindow) => {
lastWindow.setPreferredOrientation(landscape ? window.Orientation.LANDSCAPE : window.Orientation.PORTRAIT);
});
}
} Q:横屏播放后页面的底部导航条依旧存在,如何去除底部导航条?
A:采用沉浸模式去除导航条即可,具体参考链接如下:开发应用沉浸式效果。
Q:Video组件默认控制器的进度条如何自定义?
A:Video组件默认控制器的进度条。若有其他需求,可隐藏默认控制器并自定义控制器的样式或功能。