《HarmonyOS应用开发基础》 课件知识点2-15 视频播放组件Video.pptx

视频播放组件Video

Video组件概述Video组件，用于播放视频文件并控制其播放状态。视频支持的格式是：mp4、mkv、webm、TS；Video支持本地视频路径和网络路径，使用网络视频时，需要申请权限ohos.permission.INTERNET。接口说明：Video(value:{src?:string|Resource,currentProgressRate?:number|string|PlaybackSpeed,previewUri?:string|PixelMap|Resource,controller?:VideoController})

Video的参数参数说明：参数名参数类型必填参数描述srcstring|?Resource否视频播放源的路径，支持本地视频路径和网络路径。支持在resources下面的video或rawfile文件夹里放置媒体资源。支持dataability://的路径前缀，用于访问通过DataAbility提供的视频路径，具体路径信息详见DataAbility说明。说明：视频支持的格式是：mp4、mkv、webm、TS。currentProgressRatenumber|string|PlaybackSpeed8+否视频播放倍速。说明：number取值仅支持：0.75，1.0，1.25，1.75，2.0。默认值：1.0|PlaybackSpeed.Speed_Forward_1_00_XpreviewUristring|PixelMap8+?|?Resource否视频未播放时的预览图片路径。controllerVideoController否设置视频控制器。

Video的控制器从Video的组件参数中可以看到，视频播放需要一个视频控制器，通过控制器来控制视频的播放、暂停和停止。控制器提供的方法：start()：开始播放。pause()：暂停播放，显示当前帧，再次播放时从当前位置继续播放。stop()：停止播放，显示当前帧，再次播放时从头开始播放。setCurrentTime(value:numbe)：指定视频播放的进度位置，单位为s。requestFullscreen(value:boolean)：请求全屏播放。exitFullscreen()：退出全屏播放。

Video的属性属性说明：名称参数类型描述mutedboolean是否静音。默认值：falseautoPlayboolean是否自动播放。默认值：falsecontrolsboolean控制视频播放的控制栏是否显示。默认值：trueobjectFitImageFit设置视频显示模式。默认值：Coverloopboolean是否单个视频循环播放。默认值：false

Video的事件Video除支持通用事件外，还支持以下事件：名称功能描述onStart(event:()=void)播放时触发该事件。onPause(event:()=void)暂停时触发该事件。onFinish(event:()=void)播放结束时触发该事件。onError(event:()=void)播放失败时触发该事件。onPrepared(callback:(event?:{duration:number})=void)视频准备完成时触发该事件，通过duration可以获取视频时长，单位为秒(s)。onSeeking(callback:(event?:{time:number})=void)操作进度条过程时上报时间信息，单位为s。onSeeked(callback:(event?:{time:number})=void)操作进度条完成后，上报播放时间信息，单位为s。onUpdate(callback:(event?:{time:number})=void)播放进度变化时触发该事件，单位为s，更新时间间隔为250ms。onFullscreenChange(callback:(event?:{fullscreen:boolean})=void)在全屏播放与非全屏播放状态之间切换时触发该事件，返回值为true表示进入全屏播放状态，为false则表示非全屏播放。