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
+```
+
+## MovingPhotoViewController<sup>12+</sup>
+
+一个MovingPhotoViewController对象可以控制一个MovingPhotoView，可用视频播放实例请参考[媒体业务模块](../apis-media-kit/arkts-apis-media.md)。
+
+### pausePlayback<sup>20+</sup>
+
+pausePlayback()
+
+停止播放时显示当前帧，再次播放时从当前帧开始播放。
+
+**系统接口：** 该接口为系统接口。
+
+**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。
+
+**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**错误码：**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### reset<sup>20+</sup>
+
+reset()
+
+重置播放时显示封面帧，再次播放时从头开始播放。
+
+**系统接口：** 该接口为系统接口。
+
+**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。
+
+**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**错误码：**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### restart<sup>20+</sup>
+
+restart()
+
+重启播放视频，继承当前播放区间和播放模式参数。
+
+**系统接口：** 该接口为系统接口。
+
+**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。
+
+**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**错误码：**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### setPlaybackPeriod<sup>20+</sup>
+
+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. |
+
+### enableTransition<sup>20+</sup>
+
+enableTransition(enabled: boolean)
+
+关闭视频启动播放时的放大效果，再次播放时生效。
+
+**系统接口：** 该接口为系统接口。
+
+**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。
+
+**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+| 参数名  | 类型    | 必填 | 说明                         |
+| ------- | ------- | ---- | ---------------------------- |
+| enabled| boolean| 是   | 是否开启放大过渡效果。true表示开启，false表示不开启。<br></div>默认值：true。|
+
+**错误码：**
+
+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。
+
+| 错误码ID | 错误信息 |
+| -------- | ---------------------------------------- |
+| 202 | Non-system applications are not allowed to use system APIs. |
+
+### enableAutoPlay<sup>20+</sup>
+
+enableAutoPlay(enabled: boolean)
+
+控制动态照片数据中视频是否能够自动播放并自动播放一次。
+
+**系统接口：** 该接口为系统接口。
+
+**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。
+
+**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+| 参数名  | 类型    | 必填 | 说明                         |
+| ------- | ------- | ---- | ---------------------------- |
+| enabled| boolean| 是   | 是否能够自动播放。true表示能自动播放，false表示不能自动播放。<br></div>默认值：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) | 是   | 动态照片停止播放时触发的回调。 |
 
+### onPrepared<sup>20+</sup>
+
+onPrepared(callback: MovingPhotoViewEventCallback)
+
+动态照片准备完成图片时触发该事件。
+
+**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。
+
+**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core
+
+**参数：**
+
+
+| 参数名   | 类型                                                          | 必填 | 说明                           |
+| -------- | ------------------------------------------------------------- | ---- | ------------------------------ |
+| callback | [MovingPhotoViewEventCallback](#movingphotovieweventcallback) | 是   | 动态照片加载完成图片的回调。 |
+
 ## MovingPhotoViewEventCallback
 
 declare type MovingPhotoViewEventCallback = () => void