程序猿追头像

视频进入全屏,播放仍交给同一个控制器:HarmonyOS 6 放映室

1. 前言

播放器里有两个看起来相近的按钮:一个开始播放,一个把画面放大。前者改变播放状态,后者改变呈现方式。如果每次全屏都重新创建一个播放器,短片也许还能看,长视频就容易出现进度重来、重复声音或者返回后按钮与画面不同步。

这次放映室只使用一个 Video 和一个 VideoController。画面来自本地十二秒的几何测试短片,静音播放,方便专门观察进度与全屏过程。页面不需要账号、在线播放地址或外部播放器,就能把开始、暂停、全屏和返回接起来。

2. 测试短片与资源准备

先创建API 24的Empty Ability,保留入口加载pages/Index的默认关系。将可解码的本地短片放入resources/rawfile,名字使用motion.mp4,代码以rawfile资源引用读取。MP4是容器后缀,文件能否被播放还与里面的编码有关;把一个不支持的文件改成mp4后缀,并不能转换编码。

本例使用十二秒、640×360的H.264几何短片。内容只有移动图形,没有声音,所以播放设为静音。它适合观察画面是否持续变化、全屏是否进入和时间如何回报;这段无声GIF没有承担音频同步或音量验证的任务。

如果换自己的视频,先单独确认文件确实能被播放器打开,再检查全屏逻辑。否则资源尚未就绪,就会误把没有画面的问题归到requestFullscreen。新手复现时也可以先按播放等一秒,看到时间开始变化以后再做第二个动作,把资源层与交互层分开。

3. 播放事件与显示状态

事件页面记录的内容
onPrepared实际时长、资源就绪
onStart正在播放
onPause已暂停
onUpdate当前播放时间
onFullscreenChange当前是否全屏、进入次数

先区分命令与反馈。外部按钮调用 start、pause 或 requestFullscreen(true),表达用户想做什么;表中的回调再报告播放器实际处于什么状态。页面显示以事件为依据,避免按钮已经写着“暂停”,视频却还没真正开始。接下来的代码都围绕同一个播放器处理这条回路。

页面下方与播放器自带的控制条操作同一个组件。用户如果通过原生控制条暂停,onPause同样会更新页面,外面的按钮随后显示“播放”。这也是保留全局播放事件的意义:状态不能只在自定义按钮的点击回调里更新,否则换一条操作入口,外层文案就可能落后。

进入次数只在 fullscreen 为真时增加,退出全屏则更新当前形态。这个计数用于观察本次演示,不是播放历史。实际产品如果要统计观看行为,还应另行定义什么时候算一次观看,不能把进入全屏的次数直接拿来代替。

实现代码截图(一)

3.1 命令发出后的状态回写

播放器的外部按钮只能表达意图:start请求播放,pause请求暂停。playing用来决定按钮下次显示哪一个动作,但它的最终赋值来自组件事件。按下播放之后若资源出错,页面不会仅凭这次点击就永远停在“正在播放”的假状态。

      Video({ src: $rawfile('motion.mp4'), controller: this.controller })
        .id('player').width('100%').layoutWeight(1).controls(true).muted(true).loop(true)
        .objectFit(ImageFit.Contain)
        .onPrepared(event => { if (event) { this.duration = event.duration; this.status = '本地片段已就绪'; } })
        .onStart(() => { this.playing = true; this.status = '正在播放'; })
        .onPause(() => { this.playing = false; this.status = '已暂停'; })
        .onUpdate(event => { if (event) { this.seconds = event.time; } })
        .onFullscreenChange(event => {
          if (event) { this.fullscreen = event.fullscreen; if (event.fullscreen) { this.entered++; } }
        })
        .onError(() => { this.status = '视频加载失败'; })

onPrepared提供时长,onUpdate提供实际播放时间;两者分别写入duration和seconds。页面显示时向下取整,让十二秒素材的数字容易读,但没有修改播放器内部精度。不能把Text展示成整数,理解为播放器只能按整秒播放。

onFullscreenChange还承担另一份状态:当前是否处于全屏。进入次数只在收到fullscreen为true的事件时增加,退出时不会再加一。如果在按钮点击时加一次、进入事件又加一次,一次操作就会被重复记录;这类统计错误与视频是否能播无关,需要沿事件来源单独检查。

3.2 单一VideoController

VideoController在组件成员中创建一次,再传给Video。下面两个按钮引用的正是这个成员。它们没有在点击回调里new另一个控制器,也没有临时改src来迫使视频“刷新”,因而播放、暂停与全屏属于同一个播放对象。

      Row({ space: 12 }) {
        Button(this.playing ? '暂停' : '播放').id('play').backgroundColor('#BD9757')
          .onClick(() => { if (this.playing) { this.controller.pause(); } else { this.controller.start(); } })
        Button('进入全屏').id('fullscreen').backgroundColor('#384A59')
          .onClick(() => { this.controller.requestFullscreen(true); })
        Text(Math.floor(this.seconds) + ' / ' + Math.floor(this.duration) + ' 秒')
          .id('time').fontColor('#DDD8CB')
      }.width('100%')
      Text(this.status + ' · 全屏进入 ' + this.entered + ' 次 · ' + (this.fullscreen ? '全屏中' : '窗口播放'))
        .id('status').fontColor('#C8BFAF').fontSize(14).width('100%')

控制器与状态变量的职责不同。控制器发送操作,playing和fullscreen记录事件结果;duration和seconds提供显示依据;status负责一段可读反馈。把它们放在一起看,比只给出两个按钮更能解释完整链路:用户操作进入控制器,组件回报进入状态,状态再决定界面文字。

外部播放按钮与原生控制条可以交替使用,正好能检查这条链路。如果仅在外部按钮里修改playing,那么通过原生控制条暂停以后,外部按钮可能仍显示“暂停”。让两条入口最终汇入相同事件,就不需要为每条入口另写一份互相通知。

全屏是显示方式的切换,不需要导航到另一个“全屏页面”。若先移除原Video,再创建第二个Video,即使给它同一个文件名,也可能重新准备资源。当前实现避开这条路径,页面中只有一个Video声明,进度变化可以持续沿它的事件追踪。

3.3 放映室页面代码

先准备可由系统解码的 H.264 MP4 文件,放到 resources/rawfile/motion.mp4。示例使用640×360的无声几何短片;也可以换成自己有权使用的本地视频,资源名与代码保持一致。不要只放封面图而漏掉视频文件,否则播放器会进入错误分支。

pages/Index.ets 的完整内容如下。原生播放控制条保留,同时在页面下方安排明确的播放、暂停和全屏入口,便于反复观察相同操作。

@Entry
@Component
struct Index {
  private controller: VideoController = new VideoController();
  @State playing: boolean = false;
  @State fullscreen: boolean = false;
  @State entered: number = 0;
  @State seconds: number = 0;
  @State duration: number = 0;
  @State status: string = '等待视频就绪';
  build() {
    Column({ space: 14 }) {
      Row() {
        Text('放映室 / 一段移动的色彩').fontSize(25).fontColor('#F5EEDC').layoutWeight(1)
        Text('LOCAL FILM').fontSize(12).fontColor('#C8A76A')
      }.width('100%')
      Video({ src: $rawfile('motion.mp4'), controller: this.controller })
        .id('player').width('100%').layoutWeight(1).controls(true).muted(true).loop(true)
        .objectFit(ImageFit.Contain)
        .onPrepared(event => { if (event) { this.duration = event.duration; this.status = '本地片段已就绪'; } })
        .onStart(() => { this.playing = true; this.status = '正在播放'; })
        .onPause(() => { this.playing = false; this.status = '已暂停'; })
        .onUpdate(event => { if (event) { this.seconds = event.time; } })
        .onFullscreenChange(event => {
          if (event) { this.fullscreen = event.fullscreen; if (event.fullscreen) { this.entered++; } }
        })
        .onError(() => { this.status = '视频加载失败'; })
      Row({ space: 12 }) {
        Button(this.playing ? '暂停' : '播放').id('play').backgroundColor('#BD9757')
          .onClick(() => { if (this.playing) { this.controller.pause(); } else { this.controller.start(); } })
        Button('进入全屏').id('fullscreen').backgroundColor('#384A59')
          .onClick(() => { this.controller.requestFullscreen(true); })
        Text(Math.floor(this.seconds) + ' / ' + Math.floor(this.duration) + ' 秒')
          .id('time').fontColor('#DDD8CB')
      }.width('100%')
      Text(this.status + ' · 全屏进入 ' + this.entered + ' 次 · ' + (this.fullscreen ? '全屏中' : '窗口播放'))
        .id('status').fontColor('#C8BFAF').fontSize(14).width('100%')
      Text('先播放,切全屏,再返回;进度由播放器回调报告。').fontSize(13).fontColor('#8998A3')
    }.width('100%').height('100%').padding(24).backgroundColor('#17232D')
  }
}

Video 在纵向容器里使用剩余高度。窗口变宽时,画面获得更多横向空间;可用高度变少时,播放器区域随布局调整。Contain 保留完整画面,因此不同纵横比之间可能出现背景留边,避免为了铺满而把测试画面边缘裁掉。

时间单位也应在这一层先对清楚。此处Video回报的进度与时长按秒使用,页面只取整方便观察;它没有自行创建一个定时器来推算进度。若后来更换播放接口,要重新核对单位,不要把别处使用毫秒的写法直接搬过来,否则十二秒短片也可能显示成上万秒。

全屏请求使用同一个控制器,没有再跳转到第二个页面,也没有重新给 src 赋值。返回之后仍是这一个 Video 实例继续报告时间。本例不额外保存进度到磁盘,关闭进程再启动会重新准备资源,这与一次前台全屏切换属于不同生命周期。

实现代码截图(二)

4. 播放与全屏时间线

在 HarmonyOS 6.1.1、API 24 的二合一模拟器里,先点击播放,再进入全屏,返回窗口后暂停。记录中,开始阶段报告到第1秒,全屏返回时已到第10秒,随后短片进入下一轮循环,暂停时显示0秒。这里开启了 loop,末尾回到起点属于循环播放。

这个顺序值得说明白。只看暂停后的“0 / 12秒”,容易误以为全屏导致重播;把前后的实际回调连起来看,才能区分资源重新加载、主动跳转和正常循环。演示里视频画面持续变化,进度来自播放器事件,按钮没有自己累加一个时间数字。

模拟器操作演示

4.1 返回窗口后的控制

模拟器运行截图

返回后,页面显示“窗口播放”和进入次数,播放按钮仍对应当前状态。测试最后再实际暂停,而不是仅检查“全屏退出”这几个字。因为有些错误只会出现在返回之后:画面继续走,按钮却显示播放;或者按钮变成暂停,实际控制的是已经离开的另一个播放器。

如果要在正常窗口和全屏之间保留字幕、清晰度或播放列表,也应让这些选择有明确归属。单纯属于播放会话的状态可以跟着当前播放器,应用级偏好则另行保存。不要在每次布局变化时顺手重置全部字段,否则即使视频时间没有清零,用户也会不断重新设置字幕和音量。

短视频循环还有一个检查方法:暂时把循环关闭,观察播放结束事件,再决定结束后的按钮和推荐内容怎么安排。本例为了连续展示画面而保留循环,没有实现片单自动下一集。把测试素材的播放策略写清楚,比让读者从一次回到零秒的截图里猜原因更有用。

全屏也不等于替应用修改所有窗口和方向设置。不同设备如何呈现全屏,由系统和组件共同处理;页面负责发出请求、接收结果并维持一致控制逻辑。本次只在二合一模拟器验证这条路径,不据此声称所有手机、分屏与外接显示场景都已覆盖。

5. 零时长与循环点排查

若总时长一直是零,先确认onPrepared有没有发生,文件是否位于正确rawfile目录;若时长有了、画面不动,再检查是否真正触发onStart;若时间继续增长但看起来画面不动,也应确认素材本身是不是静止片段。仅凭一张静态截图,很难区分这些原因。

若返回后看到零秒,先看loop是否开启,再看前一时刻是不是已经接近末尾。当前素材很短,来回操作一次就可能跨过循环点。只有在排除正常循环以后,才需要继续检查src变化、组件重建或主动跳转,不能把所有回零都归结为全屏失败。

还可以在全屏返回后按一下外部暂停,再用原生控制条恢复。这个顺序让两个入口都得到实际使用,也能同时核对按钮文字和播放时间是否一致。本轮已有返回后暂停的演示;更多切换组合可以按这个思路补测,但没有录过的路径不提前写成已验证。

当以后加入进度条时,用户拖动位置和播放器实际回报也要分开安排。拖动中显示用户选择,提交跳转后再跟随播放事件,才能减少两边争夺滑块的抖动。这个原则与本文的命令、事件、显示分层相同,先把这一层关系读明白,播放器功能就不需要靠不断增加临时标志拼接。

6. 总结

播放器的状态最好能沿事件追得回去:资源准备好了才有时长,真正开始才显示正在播放,返回窗口后还能继续暂停。把这一条路径接稳,比同时摆出许多外观完整、彼此却不同步的控制条更实用。

继续扩展时,可以先加入播放错误的分类提示、进度恢复和资源切换,再考虑清晰度或片单。每增加一个入口,都仍然核对它是否操作同一段会话。组件支持范围、控制器方法与回调参数可参阅华为 Video 组件说明。

转载自 CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/aasd23/article/details/170244211

文章来源转载

评论

评论列表

微信小程序
QQ小程序

关于作者

点赞数:0
关注数:0
粉丝:0
文章:0
关注标签:0
加入于:--