From 3d16d0efd9477c919d427b612025d1f650e08a73 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E6=B0=B8=E5=87=AF?= Date: Tue, 24 Jun 2025 09:52:15 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=96=87=E5=AD=97?= =?UTF-8?q?=E6=8F=8F=E8=BF=B0=20Signed-off-by:=20=E5=88=98=E6=B0=B8?= =?UTF-8?q?=E5=87=AF=20?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ui/state-management/arkts-prop.md | 33 ++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/zh-cn/application-dev/ui/state-management/arkts-prop.md b/zh-cn/application-dev/ui/state-management/arkts-prop.md index 383f84a40d3..28210c888d6 100644 --- a/zh-cn/application-dev/ui/state-management/arkts-prop.md +++ b/zh-cn/application-dev/ui/state-management/arkts-prop.md @@ -186,7 +186,38 @@ struct ParentComponent { > **说明：** > -> \@Prop装饰的数据更新依赖其所属自定义组件的重新渲染，所以在应用进入后台后，\@Prop无法刷新，推荐使用\@Link代替。 +> \@Prop同步数据源依赖数据源所在组件的刷新，而应用在进入后台后无法触发刷新，因此在应用进入后台后，@Prop无法从数据源更新。在这种场景下，如果需要立刻进行数据同步，推荐使用@Link代替。 + +下列示例中，当@State装饰的变量message改变时，Father组件会刷新。由于Son组件使用@Prop接收了该变量，因此Father组件刷新的过程中会使用message的最新值去更新@Prop的值。@Prop更新后，会触发Son组件的刷新。 + +```ts +@Component +struct Son { + @Prop message: string = 'Hi'; + + build() { + Column() { + Text(this.message) + } + } +} + +@Entry +@Component +struct Father { + @State message: string = 'Hello'; + + build() { + Column() { + Text(this.message) + Button(`father click`).onClick(() => { + this.message += '*'; + }) + Son({ message: this.message }) + } + } +} +``` ## 使用场景 -- Gitee From a30e7ad35c8f754587b9a548d49821356529948b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=88=98=E6=B0=B8=E5=87=AF?= Date: Tue, 24 Jun 2025 17:00:18 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E4=BF=AE=E6=94=B9vod=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 刘永凯 --- .../reference/apis-arkui/arkui-ts/ts-media-components-video.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md index e7f7a41f75c..a12a79269b4 100755 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-media-components-video.md @@ -42,7 +42,7 @@ Video(value: VideoOptions) | 名称 | 类型 | 必填 | 说明 | | ------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| src | string \| [Resource](ts-types.md#resource) | 否 | 视频的数据源，支持本地视频和网络视频。
Resource格式可以跨包/跨模块访问资源文件，常用于访问本地视频。
- 支持rawfile文件下的资源，即通过\$rawfile引用视频文件。
string格式可用于加载网络视频和本地视频，常用于加载网络视频。
- 支持网络视频地址。
- 支持file://路径前缀的字符串，即[应用沙箱URI](../../apis-core-file-kit/js-apis-file-fileuri.md#constructor10)：file://\/\。用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。
**说明：**
视频支持的格式是：mp4、mkv、TS。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| src | string \| [Resource](ts-types.md#resource) | 否 | 视频的数据源，支持本地视频和网络视频。
Resource格式可以跨包/跨模块访问资源文件，常用于访问本地视频。
- 仅支持rawfile文件下的资源，即通过\$rawfile引用视频文件。
string格式可用于加载网络视频和本地视频，常用于加载网络视频。
- 支持网络视频地址。
- 支持file://路径前缀的字符串，即[应用沙箱URI](../../apis-core-file-kit/js-apis-file-fileuri.md#constructor10)：file://\/\。用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。
**说明：**
视频支持的格式是：mp4、mkv、TS。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | currentProgressRate | number \| string \| [PlaybackSpeed8+](#playbackspeed8枚举说明) | 否 | 视频播放倍速。
**说明：**
number格式取值仅支持：0.75，1.0，1.25，1.75，2.0。
string格式支持number格式取值的字符串形式："0.75"，"1.0"，"1.25"，"1.75"，"2.0"。
默认值：1.0 \| PlaybackSpeed.Speed_Forward_1_00_X
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | previewUri | string \| [PixelMap](../../apis-image-kit/js-apis-image.md#pixelmap7) \| [Resource](ts-types.md#resource) | 否 | 视频未播放时的预览图片路径，默认不显示图片。
string格式可用于加载本地图片和网络图片，
- 支持网络图片地址。
- 支持相对路径引用本地图片，例如：previewUri: “common/test.jpg”。当使用相对路径引用本地图片时，不支持跨包/跨模块调用。
- 支持file://路径前缀的字符串，即[应用沙箱URI](../../apis-core-file-kit/js-apis-file-fileuri.md#constructor10)：file://\/\。用于读取应用沙箱路径内的资源。需要保证目录包路径下的文件有可读权限。
Resource格式可以跨包/跨模块访问资源文件。
- 支持rawfile文件下的资源，即通过\\$rawfile引用图片。
- 支持通过\\$r引用系统资源或者应用资源中的图片。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | controller | [VideoController](#videocontroller) | 否 | 设置视频控制器，可以控制视频的播放状态。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -- Gitee