鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之Video媒体组件

最新推荐文章于 2025-06-06 23:34:56 发布

亚丁号

最新推荐文章于 2025-06-06 23:34:56 发布

阅读量1k

点赞数 15

CC 4.0 BY-SA版权

文章标签： harmonyos

本文链接：https://blog.youkuaiyun.com/zy0412326/article/details/135990796

本文详细介绍了鸿蒙HarmonyOS3.1的方舟框架ArkUI中的Video媒体组件，包括其构造参数、接口、子组件、属性、事件以及示例代码，展示了如何使用这个组件进行视频播放和控制。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之Video媒体组件

一、操作环境

操作系统: Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1

二、Video媒体组件

用于播放视频文件并控制其播放状态的组件。

子组件

无

接口

Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})

构造参数

参数名	参数类型	必填	参数描述
src	string \| Resource	否	视频播放源的路径，支持本地视频路径和网络路径。支持在resources下面的video或rawfile文件夹里放置媒体资源。支持dataability://的路径前缀，用于访问通过Data Ability提供的视频路径，具体路径信息详见DataAbility说明。支持file:///data/storage路径前缀的字符串，用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。说明：视频支持的格式是：mp4、mkv、webm、TS。
currentProgressRate	number \| string \| PlaybackSpeed8+	否	视频播放倍速。说明： number取值仅支持：0.75，1.0，1.25，1.75，2.0。默认值：1.0 \| PlaybackSpeed.Speed_Forward_1_00_X
previewUri	string \| PixelMap8+ \| Resource	否	视频未播放时的预览图片路径，默认不显示图片。
controller