diff --git a/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview-sys.md b/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview-sys.md
index 494f5465e351ad33b0eeb4f79457c3aa01c2f002..e9f7fb46811ed5795e5ecb4b9bd709bcf6939a4f 100644
--- a/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview-sys.md
+++ b/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview-sys.md
@@ -91,4 +91,141 @@ struct Index {
}
}
}
-```
\ No newline at end of file
+```
+
+## MovingPhotoViewController12+
+
+一个MovingPhotoViewController对象可以控制一个MovingPhotoView,可用视频播放实例请参考[媒体业务模块](../apis-media-kit/arkts-apis-media.md)。
+
+### pausePlayback20+
+
+pausePlayback()
+
+停止播放时显示当前帧,再次播放时从当前帧开始播放。
+
+**系统接口:** 该接口为系统接口。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**错误码:**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### reset20+
+
+reset()
+
+重置播放时显示封面帧,再次播放时从头开始播放。
+
+**系统接口:** 该接口为系统接口。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**错误码:**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### restart20+
+
+restart()
+
+重启播放视频,继承当前播放区间和播放模式参数。
+
+**系统接口:** 该接口为系统接口。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**错误码:**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### setPlaybackPeriod20+
+
+setPlaybackPeriod(startTime: double, endTime: double)
+
+设置播放区间,再次播放时生效。
+
+**系统接口:** 该接口为系统接口。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | ------- | ---- | ---------------------------- |
+| startTime| double| 是 | 区间播放开始时间,单位:ms。取值范围:大于等于0。|
+| endTime| double| 是 | 区间播放结束时间,单位:ms。取值范围:大于startTime。 |
+
+**错误码:**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### enableTransition20+
+
+enableTransition(enabled: boolean)
+
+关闭视频启动播放时的放大效果,再次播放时生效。
+
+**系统接口:** 该接口为系统接口。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | ------- | ---- | ---------------------------- |
+| enabled| boolean| 是 | 是否开启放大过渡效果。true表示开启,false表示不开启。
默认值:true。|
+
+**错误码:**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### enableAutoPlay20+
+
+enableAutoPlay(enabled: boolean)
+
+控制动态照片数据中视频是否能够自动播放并自动播放一次。
+
+**系统接口:** 该接口为系统接口。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | ------- | ---- | ---------------------------- |
+| enabled| boolean| 是 | 是否能够自动播放。true表示能自动播放,false表示不能自动播放。
默认值:false。|
+
+**错误码:**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
diff --git a/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview.md b/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview.md
index f99daf66c10ba2db8def04c29ed261f6718b089b..26d318b318f6538506eb0c115c4035df1e2b44c4 100644
--- a/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview.md
+++ b/zh-cn/application-dev/reference/apis-media-library-kit/ohos-multimedia-movingphotoview.md
@@ -255,6 +255,23 @@ onStop(callback: MovingPhotoViewEventCallback)
| -------- | ------------------------------------------------------------- | ---- | ------------------------------ |
| callback | [MovingPhotoViewEventCallback](#movingphotovieweventcallback) | 是 | 动态照片停止播放时触发的回调。 |
+### onPrepared20+
+
+onPrepared(callback: MovingPhotoViewEventCallback)
+
+动态照片准备完成图片时触发该事件。
+
+**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。
+
+**系统能力:** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**参数:**
+
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------------------------------- | ---- | ------------------------------ |
+| callback | [MovingPhotoViewEventCallback](#movingphotovieweventcallback) | 是 | 动态照片加载完成图片的回调。 |
+
## MovingPhotoViewEventCallback
declare type MovingPhotoViewEventCallback = () => void