diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md index bd6ad396e3050b5bddf50f30ca2192c14ecbd45e..e09b18331636eae7ba6539ce0373e4bb8f46f1bc 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md @@ -3,9 +3,22 @@ > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 - 视频播放组件。 +## 权限列表 + +使用网络视频时，需要在config或者module.json对应的"abilities"中添加网络使用权限ohos.permission.INTERNET。 + +``` +"abilities":[ + { + ... + "permissions": ["ohos.permission.INTERNET], + ... + } +] +``` + ## 子组件 @@ -19,20 +32,20 @@ Video(value: VideoOptions) - VideoOptions类型接口说明 | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | - | src | string | 否 | - | 视频播放源的路径。 | + | src | string \| [Resource](../../ui/ts-types.md) | 否 | - | 视频播放源的路径，支持本地视频路径和网络路径。
支持在resources下面的video或rawfile文件夹里放置媒体资源。
支持dataability://的路径前缀，用于访问通过Data Ability提供的视频路径，具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。 | | currentProgressRate | number \| PlaybackSpeed8+ | 否 | 1.0 \| PlaybackSpeed.
Speed_Forward_1_00_X | 视频播放倍速。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> number取值仅支持：0.75，1.0，1.25，1.75，2.0。
| - | previewUri | string \| PixelMap8+ \| [Resource](../../ui/ts-types.md#Resource类型) | 否 | - | 预览图片的路径。 | + | previewUri | string \| PixelMap8+ \| [Resource](../../ui/ts-types.md) | 否 | - | 预览图片的路径。 | | controller | [VideoController](#videocontroller) | 否 | - | 控制器。 | - PlaybackSpeed8+类型接口说明 - | 名称 | 描述 | + | 名称 | 描述 | | -------- | -------- | - | Speed_Forward_0_75_X | 0.75倍速播放。 | - | Speed_Forward_1_00_X | 1倍速播放。 | - | Speed_Forward_1_25_X | 1.25倍速播放。 | - | Speed_Forward_1_75_X | 1.75倍速播放。 | - | Speed_Forward_2_00_X | 2倍速播放。 | + | Speed_Forward_0_75_X | 0.75倍速播放。 | + | Speed_Forward_1_00_X | 1倍速播放。 | + | Speed_Forward_1_25_X | 1.25倍速播放。 | + | Speed_Forward_1_75_X | 1.75倍速播放。 | + | Speed_Forward_2_00_X | 2倍速播放。 | ## 属性 @@ -48,16 +61,16 @@ Video(value: VideoOptions) ## 事件 -| 名称 | 功能描述 | +| 名称 | 功能描述 | | -------- | -------- | -| onStart() => void | 播放时触发该事件。 | -| onPause() => void | 暂停时触发该事件。 | -| onFinish() => void | 播放结束时触发该事件。 | +| onStart() => void | 播放时触发该事件。 | +| onPause() => void | 暂停时触发该事件。 | +| onFinish() => void | 播放结束时触发该事件。 | | onError() => void | 播放失败时触发该事件。 | -| onPrepared(event?: { duration: number }) => void | 视频准备完成时触发该事件，通过duration可以获取视频时长，单位为秒(s)。 | -| onSeeking(event?: { time: number }) => void | 操作进度条过程时上报时间信息，单位为s。 | -| onSeeked(event?: { time: number }) => void | 操作进度条完成后，上报播放时间信息，单位为s。 | -| onUpdate(event?: { time: number }) => void | 播放进度变化时触发该事件，单位为s，更新时间间隔为250ms。 | +| onPrepared(event?: { duration: number }) => void | 视频准备完成时触发该事件，通过duration可以获取视频时长，单位为秒(s)。 | +| onSeeking(event?: { time: number }) => void | 操作进度条过程时上报时间信息，单位为s。 | +| onSeeked(event?: { time: number }) => void | 操作进度条完成后，上报播放时间信息，单位为s。 | +| onUpdate(event?: { time: number }) => void | 播放进度变化时触发该事件，单位为s，更新时间间隔为250ms。 | ## VideoController @@ -97,7 +110,7 @@ setCurrentTime(value: number) 指定视频播放的进度位置。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | | value | number | 是 | - | 视频播放进度位置。 | @@ -108,7 +121,7 @@ requestFullscreen(value: boolean) 请求全屏播放。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | | value | number | 是 | false | 是否全屏播放。 | @@ -125,18 +138,18 @@ setCurrentTime(value: number, seekMode: SeekMode) 指定视频播放的进度位置，并指定跳转模式。 - 参数 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | | value | number | 是 | - | 视频播放进度位置。 | | seekMode | SeekMode | 是 | - | 跳转模式。 | - SeekMode8+类型接口说明 - | 名称 | 描述 | + | 名称 | 描述 | | -------- | -------- | - | PreviousKeyframe | 跳转到前一个最近的关键帧。 | - | NextKeyframe | 跳转到后一个最近的关键帧。 | - | ClosestKeyframe | 跳转到最近的关键帧。 | - | Accurate | 精准跳转，不论是否为关键帧。 | + | PreviousKeyframe | 跳转到前一个最近的关键帧。 | + | NextKeyframe | 跳转到后一个最近的关键帧。 | + | ClosestKeyframe | 跳转到最近的关键帧。 | + | Accurate | 精准跳转，不论是否为关键帧。 | @@ -146,8 +159,8 @@ setCurrentTime(value: number, seekMode: SeekMode) @Entry @Component struct VideoCreateComponent { - @State srcs: string = "/resources/video/video1.mp4"; - @State previewUris: string = "/resources/image/media.JPG"; + @State srcs: Resource = $rawfile('video1'); + @State previewUris: Resource = $r('app.media.img'); @State currentProgressRates: number = 1; @State autoPlays: boolean = false; @State controlsss: boolean = true; @@ -189,18 +202,10 @@ struct VideoCreateComponent { }) Row() { Button("src").onClick(() => { - if (this.srcs == "/resources/video/video1.mp4") { - this.srcs = "/resources/video/video2.mp4"; - } else { - this.srcs = "/resources/video/video1.mp4"; - } + this.srcs = $rawfile('video2'); }); Button("previewUri").onClick(() => { - if (this.previewUris == "/resources/image/media.JPG") { - this.previewUris = "/resources/image/sinlin.png"; - } else { - this.previewUris = "/resources/image/media.JPG"; - } + this.previewUris = $r('app.media.img1'); }); Button("controlsss").onClick(() => { this.controlsss = !this.controlsss;