Merge branch 'master' of https://gitee.com/zengyawen/docs

en/application-dev/reference/apis/js-apis-hidebug.md

@@ -30,9 +30,10 @@ This API is defined but not implemented in OpenHarmony 3.1 Release.
 
 
 **Example**
-  ```js
-  let nativeHeapSize = hidebug.getNativeHeapSize();
-  ```
+
+```js
+let nativeHeapSize = hidebug.getNativeHeapSize();
+```
 
 
 ## hidebug.getNativeHeapAllocatedSize
@@ -45,17 +46,18 @@ This API is defined but not implemented in OpenHarmony 3.1 Release.
 
 **System capability**: SystemCapability.HiviewDFX.HiProfiler.HiDebug
 
-
 **Return value**
+
 | Type  | Description                             |
 | ------ | --------------------------------- |
 | bigint | Size of the allocated native heap memory, in kB.|
 
 
 **Example**
-  ```js
-  let nativeHeapAllocatedSize = hidebug.getNativeHeapAllocatedSize();
-  ```
+
+```js
+let nativeHeapAllocatedSize = hidebug.getNativeHeapAllocatedSize();
+```
 
 
 ## hidebug.getNativeHeapFreeSize
@@ -68,17 +70,18 @@ This API is defined but not implemented in OpenHarmony 3.1 Release.
 
 **System capability**: SystemCapability.HiviewDFX.HiProfiler.HiDebug
 
-
 **Return value**
+
 | Type  | Description                           |
 | ------ | ------------------------------- |
 | bigint | Size of the free native heap memory, in kB.|
 
 
 **Example**
-  ```js
-  let nativeHeapFreeSize = hidebug.getNativeHeapFreeSize();
-  ```
+
+```js
+let nativeHeapFreeSize = hidebug.getNativeHeapFreeSize();
+```
 
 
 ## hidebug.getPss
@@ -89,17 +92,18 @@ Obtains the PSS of this process.
 
 **System capability**: SystemCapability.HiviewDFX.HiProfiler.HiDebug
 
-
 **Return value**
+
 | Type  | Description                     |
 | ------ | ------------------------- |
 | bigint | PSS of the process, in kB.|
 
 
 **Example**
-  ```js
-  let pss = hidebug.getPss();
-  ```
+
+```js
+let pss = hidebug.getPss();
+```
 
 
 ## hidebug.getSharedDirty
@@ -110,17 +114,18 @@ Obtains the size of the shared dirty memory of this process.
 
 **System capability**: SystemCapability.HiviewDFX.HiProfiler.HiDebug
 
-
 **Return value**
+
 | Type  | Description                      |
 | ------ | -------------------------- |
 | bigint | Size of the shared dirty memory of the process, in kB.|
 
 
 **Example**
-  ```js
-  let sharedDirty = hidebug.getSharedDirty();
-  ```
+  
+```js
+let sharedDirty = hidebug.getSharedDirty();
+```
 
 ## hidebug.getPrivateDirty<sup>9+<sup>
 
@@ -130,8 +135,8 @@ Obtains the size of the private dirty memory of this process.
 
 **System capability**: SystemCapability.HiviewDFX.HiProfiler.HiDebug
 
-
 **Return value**
+
 | Type  | Description                      |
 | ------ | -------------------------- |
 | bigint | Size of the private dirty memory of the process, in kB.|
@@ -152,17 +157,18 @@ For example, if the CPU usage is **50%**, **0.5** is returned.
 
 **System capability**: SystemCapability.HiviewDFX.HiProfiler.HiDebug
 
-
 **Return value**
+
 | Type  | Description                      |
 | ------ | -------------------------- |
 | number | CPU usage of the process.|
 
 
 **Example**
-  ```js
-  let cpuUsage = hidebug.getCpuUsage();
-  ```
+
+```js
+let cpuUsage = hidebug.getCpuUsage();
+```
 
 ## hidebug.startProfiling
 
@@ -189,7 +195,6 @@ hidebug.stopProfiling();
 ```
 
 
-
 ## hidebug.stopProfiling
 
 stopProfiling() : void
@@ -245,6 +250,7 @@ This is a system API and cannot be called by third-party applications.
 | serviceid | number | Yes  | ID of the system service. |
 
 **Return value**
+
 | Type  | Description                      |
 | ------ | -------------------------- |
 | string | Absolute path of the file that contains the service information to dump. |

en/application-dev/reference/apis/js-apis-net-connection.md

@@ -47,7 +47,7 @@ Obtains the default active data network. This API uses a promise to return the r
 
 **System capability**: SystemCapability.Communication.NetManager.Core
 
-**Return Value**
+**Return value**
 
 | Type                             | Description                                 |
 | --------------------------------- | ------------------------------------- |
@@ -92,7 +92,7 @@ Checks whether the default data network is activated. This API uses a promise to
 
 **System capability**: SystemCapability.Communication.NetManager.Core
 
-**Return Value**
+**Return value**
 
 | Type             | Description                                           |
 | ----------------- | ----------------------------------------------- |
@@ -117,6 +117,7 @@ Obtains the list of all active data networks. This API uses an asynchronous call
 **System capability**: SystemCapability.Communication.NetManager.Core
 
 **Parameters**
+
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | callback | AsyncCallback<Array<[NetHandle](#nethandle)>> | Yes| Callback used to return the result.|
@@ -141,7 +142,8 @@ Obtains the list of all active data networks. This API uses a promise to return
 
 **System capability**: SystemCapability.Communication.NetManager.Core
 
-**Return Value**
+**Return value**
+
 | Type| Description|
 | -------- | -------- |
 | Promise<Array<[NetHandle](#nethandle)>> | Promise used to return the result.|
@@ -198,7 +200,7 @@ Obtains connection properties of the network corresponding to **netHandle**. Thi
 | --------- | ----------------------- | ---- | ---------------- |
 | netHandle | [NetHandle](#nethandle) | Yes  | Handle of the data network.|
 
-**Return Value**
+**Return value**
 
 | Type                                                   | Description                             |
 | ------------------------------------------------------- | --------------------------------- |
@@ -258,7 +260,7 @@ Obtains capability information of the network corresponding to **netHandle**. Th
 | --------- | ----------------------- | ---- | ---------------- |
 | netHandle | [NetHandle](#nethandle) | Yes  | Handle of the data network.|
 
-**Return Value**
+**Return value**
 
 | Type                                         | Description                             |
 | --------------------------------------------- | --------------------------------- |
@@ -285,6 +287,7 @@ Reports connection of the data network. This API uses an asynchronous callback t
 **System capability**: SystemCapability.Communication.NetManager.Core
 
 **Parameters**
+
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | netHandle | [NetHandle](#nethandle) | Yes| Handle of the data network. For details, see [NetHandle](#nethandle).|
@@ -312,11 +315,13 @@ Reports connection of the data network. This API uses a promise to return the re
 **System capability**: SystemCapability.Communication.NetManager.Core
 
 **Parameters**
+
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | netHandle | [NetHandle](#nethandle) | Yes| Handle of the data network. For details, see [NetHandle](#nethandle).|
 
-**Return Value**
+**Return value**
+
 | Type| Description|
 | -------- | -------- |
 | Promise<void> | Promise used to return the result.|
@@ -343,6 +348,7 @@ Reports disconnection of the data network. This API uses an asynchronous callbac
 **System capability**: SystemCapability.Communication.NetManager.Core
 
 **Parameters**
+
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | netHandle | [NetHandle](#nethandle) | Yes| Handle of the data network. For details, see [NetHandle](#nethandle).|
@@ -370,11 +376,13 @@ Reports disconnection of the data network. This API uses a promise to return the
 **System capability**: SystemCapability.Communication.NetManager.Core
 
 **Parameters**
+
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | netHandle | [NetHandle](#nethandle) | Yes| Handle of the data network. For details, see [NetHandle](#nethandle).|
 
-**Return Value**
+**Return value**
+
 | Type| Description|
 | -------- | -------- |
 | Promise<void> | Promise used to return the result.|
@@ -432,7 +440,7 @@ Resolves the host name by using the default network to obtain all IP addresses.
 | ------ | ------ | ---- | ------------------ |
 | host   | string | Yes  | Host name to be resolved.|
 
-**Return Value**
+**Return value**
 
 | Type                                       | Description                         |
 | ------------------------------------------- | ----------------------------- |
@@ -561,7 +569,7 @@ Obtains the handle of the network specified by **netSpecifier**.
 | netSpecifier | [NetSpecifier](#netspecifier) | No  | Network specifier. If this parameter is not set, the default network is used.                  |
 | timeout      | number                        | No  | Timeout interval for obtaining the network specified by **netSpecifier**. This parameter is valid only when **netSpecifier** is set.|
 
-**Return Value**
+**Return value**
 
 | Type                           | Description                |
 | ------------------------------- | -------------------- |
@@ -829,7 +837,7 @@ Resolves the host name by using the corresponding network to obtain all IP addre
 | ------ | ------ | ---- | ------------------ |
 | host   | string | Yes  | Host name to be resolved.|
 
-**Return Value**
+**Return value**
 
 | Type                                       | Description                         |
 | ------------------------------------------- | ----------------------------- |
@@ -891,7 +899,7 @@ Resolves the host name by using the corresponding network to obtain the first IP
 | ------ | ------ | ---- | ------------------ |
 | host   | string | Yes  | Host name to be resolved.|
 
-**Return Value**
+**Return value**
 
 | Type                               | Description                           |
 | ----------------------------------- | ------------------------------- |

zh-cn/application-dev/Readme-CN.md

@@ -8,8 +8,8 @@
 - 快速开始
     - 快速入门
         - [开发准备](quick-start/start-overview.md)
-        - [使用eTS语言开发（Stage模型）](quick-start/start-with-ets-stage.md)
-        - [使用eTS语言开发（FA模型）](quick-start/start-with-ets-fa.md)
+        - [使用ArkTS语言开发（Stage模型）](quick-start/start-with-ets-stage.md)
+        - [使用ArkTS语言开发（FA模型）](quick-start/start-with-ets-fa.md)
         - [使用JS语言开发（FA模型）](quick-start/start-with-js-fa.md)
     - 开发基础知识
         - [应用包结构说明(FA模型)](quick-start/package-structure.md)

zh-cn/application-dev/application-test/arkxtest-guidelines.md

+# 自动化测试框架使用指南 
+
+
+## 概述
+
+为支撑OpenHarmony操作系统的自动化测试活动开展，我们提供了支持JS/TS语言的单元及UI测试框架，支持开发者针对应用接口或系统接口进行单元测试，并且可基于UI操作进行UI自动化脚本的编写。
+
+本指南重点介绍自动化测试框架的主要功能，同时介绍编写单元/UI自动化测试脚本的方法以及执行过程。
+
+
+### 简介
+
+OpenHarmony自动化测试框架arkxtest，作为OpenHarmony工具集的重要组成部分，提供了OpenHarmony自动化脚本编写和运行的基础能力。编写方面提供了一系列支持测试脚本编写的API，包括了基础流程API、断言API以及UI操作相关的API，运行方面提供了识别测试脚本、调度执行测试脚本以及汇总测试脚本执行结果的能力。
+
+
+### 实现原理
+
+框架重要分为两大部分：单元测试框架和UI测试框架。
+
+- 单元测试框架
+
+  单元测试框架是测试框架的基础底座，提供了最基本的用例识别、调度、执行及结果汇总的能力。主要功能如下图所示：
+
+  ![](figures/UnitTest.PNG)
+
+  单元测试脚本的基础运行流程如下图所示，依赖aa test命令作为执行入口，该命令可具体参考[对应指南。](../ability/ability-delegator.md)
+
+  ![](figures/TestFlow.PNG)
+
+- UI测试框架
+
+  UI测试框架主要对外提供了[UiTest API](../reference/apis/js-apis-uitest.md)供开发人员在对应测试场景调用，而其脚本的运行基础还是上面提到的单元测试框架。
+
+  UI测试框架的主要功能如下图所示：
+
+  ![](figures/Uitest.PNG)
+
+
+### 约束与限制
+
+- UI测试框架的能力在OpenHarmony 3.1 release版本之后方可使用，历史版本不支持使用。
+- 单元测试框架的部分能力与其版本有关，具体能力与版本匹配信息可见代码仓中的[文档介绍](https://gitee.com/openharmony/testfwk_arkxtest/blob/master/README_zh.md)。
+
+
+## 环境准备
+
+### 环境要求
+
+OpenHarmony自动化脚本的编写主要基于DevEco Studio，并建议使用3.0之后的版本进行脚本编写。
+
+脚本执行需要PC连接OpenHarmony设备，如RK3568开发板等。
+
+### 搭建环境
+
+DevEco Studio可参考其官网介绍进行[下载](https://developer.harmonyos.com/cn/develop/deveco-studio#download)，并进行相关的配置动作。
+
+
+## 新建测试脚本
+
+1. 在DevEco Studio中新建应用开发工程，其中ohos目录即为测试脚本所在的目录。
+2. 在工程目录下打开待测试模块下的ets文件，将光标置于代码中任意位置，单击**右键 > Show Context Actions** **> Create Ohos Test**或快捷键**Alt+enter** **> Create Ohos Test**创建测试类，更多指导请参考DevEco Studio中[指导](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-openharmony-test-framework-0000001267284568)。
+
+## 编写单元测试脚本
+
+```TS
+import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium'
+import abilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
+
+const delegator = abilityDelegatorRegistry.getAbilityDelegator()
+export default function abilityTest() {
+  describe('ActsAbilityTest', function () {
+    it('testUiExample',0, async function (done) {
+      console.info("uitest: TestUiExample begin");
+      //start tested ability
+      await delegator.executeShellCommand('aa start -b com.ohos.uitest -a MainAbility').then(result =>{
+        console.info('Uitest, start ability finished:' + result)
+      }).catch(err => {
+        console.info('Uitest, start ability failed: ' + err)
+      })
+      await sleep(1000);
+      //check top display ability
+      await delegator.getCurrentTopAbility().then((Ability)=>{
+        console.info("get top ability");
+        expect(Ability.context.abilityInfo.name).assertEqual('MainAbility');
+      })
+      done();
+    })
+
+    function sleep(time) {
+      return new Promise((resolve) => setTimeout(resolve, time));
+    }
+  })
+}
+```
+
+单元测试脚本需要包含如下基本元素：
+
+1、依赖导包，以便使用依赖的测试接口。
+
+2、测试代码编写，主要编写测试代码的相关逻辑，如接口调用等。
+
+3、断言接口调用，设置测试代码中的检查点，如无检查点，则不可认为一个完整的测试脚本。
+
+## 编写UI测试脚本
+
+UI测试脚本是在单元测试框架的基础上编写，主要就是增加了UI测试框架提供的接口调用，实现对应的测试逻辑。
+
+下面的示例代码是在上面的测试脚本基础上增量编写，首先需要增加依赖导包，如下示例代码所示：
+
+```js
+import {UiDriver,BY,UiComponent,MatchPattern} from '@ohos.uitest'
+```
+
+然后是具体测试代码编写，场景较为简单，就是在启动的应用页面上进行点击操作，然后增加检查点检查用例。
+
+```js
+export default function abilityTest() {
+  describe('ActsAbilityTest', function () {
+    it('testUiExample',0, async function (done) {
+      console.info("uitest: TestUiExample begin");
+      //start tested ability
+      await delegator.executeShellCommand('aa start -b com.ohos.uitest -a MainAbility').then(result =>{
+        console.info('Uitest, start ability finished:' + result)
+      }).catch(err => {
+        console.info('Uitest, start ability failed: ' + err)
+      })
+      await sleep(1000);
+      //check top display ability
+      await delegator.getCurrentTopAbility().then((Ability)=>{
+        console.info("get top ability");
+        expect(Ability.context.abilityInfo.name).assertEqual('MainAbility');
+      })
+      //ui test code
+      //init uidriver
+      var driver = await UiDriver.create();
+      await driver.delayMs(1000);
+      //find button by text 'Next'
+      var button = await driver.findComponent(BY.text('Next'));
+      //click button
+      await button.click();
+      await driver.delayMs(1000);
+      //check text
+      await driver.assertComponentExist(BY.text('after click'));
+      await driver.pressBack();
+      done();
+    })
+
+    function sleep(time) {
+      return new Promise((resolve) => setTimeout(resolve, time));
+    }
+  })
+}
+```
+
+## 执行测试脚本
+
+执行测试脚本可以直接在DevEco Studio中通过点击按钮执行，当前支持以下执行方式：
+
+1、测试包级别执行即执行测试包内的全部用例。
+
+2、测试套级别执行即执行describe方法中定义的全部测试用例。
+
+3、测试方法级别执行即执行指定it方法也就是单条测试用例。
+
+![](figures/Execute.PNG)
+
+## 查看测试结果
+
+测试执行完毕后可直接在DevEco Studio中查看测试结果，如下图示例所示：
+
+![](figures/TestResult.PNG)

zh-cn/application-dev/media/audio-playback.md

 # 音频播放开发指导
 
-## 场景介绍
+## 简介
 
-音频播放的主要工作是将音频数据转码为可听见的音频模拟信号并通过输出设备进行播放，同时对播放任务进行管理。
+音频播放的主要工作是将音频数据转码为可听见的音频模拟信号，并通过输出设备进行播放，同时对播放任务进行管理，包括开始播放、暂停播放、停止播放、释放资源、设置音量、跳转播放位置、获取轨道信息等功能控制。
 
-**图1** 音频播放状态机
+## 运作机制
+
+该模块提供了音频播放状态变化示意图和音频播放外部模块交互图。
+
+**图1** 音频播放状态变化示意图
 
 ![zh-ch_image_audio_state_machine](figures/zh-ch_image_audio_state_machine.png)
 
-**说明**：当前为Idle状态，设置src不会改变状态；且src设置成功后，不能再次设置其它src，需调用reset()接口后，才能重新设置src。
+**注意**：当前为Idle状态，设置src不会改变状态；且src设置成功后，不能再次设置其它src，需调用reset()接口后，才能重新设置src。
 
 
 
-**图2** 音频播放零层图
+**图2** 音频播放外部模块交互图
 
 ![zh-ch_image_audio_player](figures/zh-ch_image_audio_player.png)
 
-## 开发步骤
+**说明**：三方应用通过调用JS接口层提供的js接口实现相应功能时，框架层会通过Native Framework的媒体服务，调用音频部件，将软件解码后的音频数据输出至硬件接口层的音频HDI，实现音频播放功能。
+
+## 开发指导
 
 详细API含义可参考：[媒体服务API文档AudioPlayer](../reference/apis/js-apis-media.md#audioplayer)
 
 ### 全流程场景
 
-包含流程：创建实例，设置uri，播放音频，跳转播放位置，设置音量，暂停播放，获取轨道信息，停止播放，重置，释放资源等流程。
+音频播放的全流程场景包含：创建实例，设置uri，播放音频，跳转播放位置，设置音量，暂停播放，获取轨道信息，停止播放，重置，释放资源等流程。
 
 AudioPlayer支持的src媒体源输入类型可参考：[src属性说明](../reference/apis/js-apis-media.md#audioplayer_属性)
 

zh-cn/application-dev/media/audio-recorder.md

 # 音频录制开发指导
 
-## 场景介绍
+## 简介
 
-音频录制的主要工作是捕获音频信号，完成音频编码并保存到文件中，帮助开发者轻松实现音频录制功能。它允许调用者指定音频录制的采样率、声道数、编码格式、封装格式、文件路径等参数。
+音频录制的主要工作是捕获音频信号，完成音频编码并保存到文件中，帮助开发者轻松实现音频录制功能。该模块允许调用者指定音频录制的采样率、声道数、编码格式、封装格式、输出文件的路径等参数。
 
-**图1** 音频录制状态机
+## 运作机制
+
+该模块提供了音频录制状态变化示意图和音频录制外部模块交互图。
+
+**图1** 音频录制状态变化变化示意图
 
 ![zh-ch_image_audio_recorder_state_machine](figures/zh-ch_image_audio_recorder_state_machine.png)
 
 
 
-**图2** 音频录制零层图
+**图2** 音频录制外部模块交互图
 
 ![zh-ch_image_audio_recorder_zero](figures/zh-ch_image_audio_recorder_zero.png)
 
-## 开发步骤
+**说明**：三方录音应用或录音机通过调用JS接口层提供的js接口实现相应功能时，框架层会通过Native Framework的媒体服务，调用音频部件获取通过音频HDI捕获的音频数据，再通过软件编码输出编码封装后的音频数据保存至文件中，实现音频录制功能。
+
+## 约束与限制
+
+开发者在进行录制功能开发前，需要先对所开发的应用配置麦克风权限（ohos.permission.MICROPHONE），权限配置相关内容可参考：[访问控制权限申请指导](../security/accesstoken-guidelines.md)
+
+## 开发指导
 
 详细API含义可参考：[媒体服务API文档AudioRecorder](../reference/apis/js-apis-media.md#audiorecorder)
 
 ### 全流程场景
 
-包含流程：创建实例，设置录制参数，录制音频，暂停录制，恢复录制，停止录制，释放资源等流程。
+音频录制的全流程场景包含：创建实例，设置录制参数，开始录制，暂停录制，恢复录制，停止录制，释放资源等流程。
 
 ```js
 import media from '@ohos.multimedia.media'

zh-cn/application-dev/media/video-playback.md

 # 视频播放开发指导
 
-## 场景介绍
+## 简介
 
-视频播放的主要工作是将视频数据转码并输出到设备进行播放，同时管理播放任务。本文将对视频播放全流程、视频切换、视频循环播放等场景开发进行介绍说明。
+视频播放的主要工作是将视频数据转码并输出到设备进行播放，同时管理播放任务，包括开始播放、暂停播放、停止播放、资源释放、音量设置、跳转播放位置、设置倍数、获取轨道信息等功能控制。本文将对视频播放全流程、视频切换、视频循环播放等场景开发进行介绍说明。
 
-**图1** 视频播放状态机
+## 运作机制
+
+该模块提供了视频播放状态变化示意图和视频播放外部模块交互图。
+
+**图1** 视频播放状态变化示意图
 
 ![zh-ch_image_video_state_machine](figures/zh-ch_image_video_state_machine.png)
 
-**图2** 视频播放零层图
+**图2** 视频播放外部模块交互图
 
 ![zh-ch_image_video_player](figures/zh-ch_image_video_player.png)
 
+**说明**：三方应用通过调用JS接口层提供的js接口实现相应功能时，框架层会通过Native Framework的媒体服务，调用音频部件将软件解码后的音频数据，输出至音频HDI，和图形子系统将硬件接口层的解码HDI部件的解码后的图像数据，输出至显示HDI，实现视频播放功能。
+
 *注意：视频播放需要显示、音频、编解码等硬件能力。*
 
 1. 三方应用从Xcomponent组件获取surfaceID。
@@ -31,13 +37,13 @@
 |      ts      |   视频格式：H264/MPEG2/MPEG4 音频格式：AAC/MP3    | 主流分辨率，如1080P/720P/480P/270P |
 |     webm     |          视频格式：VP8 音频格式：VORBIS           | 主流分辨率，如1080P/720P/480P/270P |
 
-## 开发步骤
+## 开发指导
 
 详细API含义可参考：[媒体服务API文档VideoPlayer](../reference/apis/js-apis-media.md#videoplayer8)
 
 ### 全流程场景
 
-包含流程：创建实例，设置url，设置SurfaceId，准备播放视频，播放视频，暂停播放，获取轨道信息，跳转播放位置，设置音量，设置倍速，结束播放，重置，释放资源等流程。
+视频播放的全流程场景包含：创建实例，设置url，设置SurfaceId，准备播放视频，播放视频，暂停播放，获取轨道信息，跳转播放位置，设置音量，设置倍速，结束播放，重置，释放资源等流程。
 
 VideoPlayer支持的url媒体源输入类型可参考：[url属性说明](../reference/apis/js-apis-media.md#videoplayer_属性)
 

zh-cn/application-dev/media/video-recorder.md

 # 视频录制开发指导
 
-## 场景介绍
+## 简介
 
-视频录制的主要工作是捕获音视频信号，完成音视频编码并保存到文件中，帮助开发者轻松实现音视频录制功能。它允许调用者指定录制的编码格式、封装格式、文件路径等参数。
+视频录制的主要工作是捕获音视频信号，完成音视频编码并保存到文件中，帮助开发者轻松实现音视频录制功能，包括开始录制、暂停录制、恢复录制、停止录制、释放资源等功能控制。它允许调用者指定录制的编码格式、封装格式、文件路径等参数。
 
-**图1** 视频录制状态机
+## 运作机制
+
+该模块提供了视频录制状态变化示意图和视频录制外部模块交互图。
+
+**图1** 视频录制状态变化示意图
 
 ![zh-ch_image_video_recorder_state_machine](figures/zh-ch_image_video_recorder_state_machine.png)
 
-**图2** 视频录制零层图
+**图2** 视频录制外部模块交互图
 
 ![zh-ch_image_video_recorder_zero](figures/zh-ch_image_video_recorder_zero.png)
 
-## 开发步骤
+**说明**：三方相机应用或系统相机通过调用JS接口层提供的js接口实现相应功能时，框架层会通过Native Framework的媒体服务，调用音频部件通过音频HDI捕获的音频数据，再通过软件编码输出编码封装后的音频数据保存至文件中，和图形子系统通过视频HDI捕获的图像数据，再通过视频编码HDI编码，将编码后的图像数据保存至文件中，实现视频录制功能。
+
+## 约束与限制
+
+开发者在进行录制功能开发前，需要先对所开发的应用配置麦克风权限（ohos.permission.MICROPHONE）和相机权限（ohos.permission.CAMERA），权限配置相关内容可参考：[访问控制权限申请指导](../security/accesstoken-guidelines.md)
+
+## 开发指导
 
 详细API含义可参考：[媒体服务API文档VideoRecorder](../reference/apis/js-apis-media.md#videorecorder9)
 
 ### 全流程场景
 
-包含流程：创建实例、设置录制参数、录制视频、暂停录制、恢复录制、停止录制、释放资源等流程。
+视频录制全流程场景包含：创建实例、设置录制参数、开始录制、暂停录制、恢复录制、停止录制、释放资源等流程。
 
 ```js
 import media from '@ohos.multimedia.media'

zh-cn/application-dev/notification/Readme-CN.md

@@ -3,7 +3,4 @@
 - [公共事件与通知概述](notification-brief.md)
 - [公共事件开发指导](common-event.md)
 - [通知开发指导](notification-guidelines.md)
-- 后台代理提醒
-  - [后台代理提醒开发概述](background-agent-scheduled-reminder-overview.md)
-  - [后台代理提醒开发指导](background-agent-scheduled-reminder-guide.md)
 - [调试助手使用指导](assistant-guidelines.md)
\ No newline at end of file

zh-cn/application-dev/quick-start/Readme-CN.md

@@ -2,8 +2,8 @@
 
 - 快速入门
   - [开发准备](start-overview.md)
-  - [使用eTS语言开发（Stage模型）](start-with-ets-stage.md)
-  - [使用eTS语言开发（FA模型）](start-with-ets-fa.md)
+  - [使用ArkTS语言开发（Stage模型）](start-with-ets-stage.md)
+  - [使用ArkTS语言开发（FA模型）](start-with-ets-fa.md)
   - [使用JS语言开发（FA模型）](start-with-js-fa.md)
   
 - 开发基础知识

zh-cn/application-dev/quick-start/start-overview.md

@@ -16,11 +16,11 @@
 
 OpenHarmony提供了一套UI开发框架，即方舟开发框架（ArkUI框架）。方舟开发框架可为开发者提供应用UI开发所必需的能力，比如多种组件、布局计算、动画能力、UI交互、绘制等。
 
-方舟开发框架针对不同目的和技术背景的开发者提供了两种开发范式，分别是基于eTS的声明式开发范式（简称“声明式开发范式”）和兼容JS的类Web开发范式（简称“类Web开发范式”）。以下是两种开发范式的简单对比。
+方舟开发框架针对不同目的和技术背景的开发者提供了两种开发范式，分别是基于ArkTS的声明式开发范式（简称“声明式开发范式”）和兼容JS的类Web开发范式（简称“类Web开发范式”）。以下是两种开发范式的简单对比。
 
 | **开发范式名称** | **语言生态** | **UI更新方式** | **适用场景** | **适用人群** |
 | -------- | -------- | -------- | -------- | -------- |
-| 声明式开发范式 | eTS语言 | 数据驱动更新 | 复杂度较大、团队合作度较高的程序 | 移动系统应用开发人员、系统应用开发人员 |
+| 声明式开发范式 | ArkTS语言 | 数据驱动更新 | 复杂度较大、团队合作度较高的程序 | 移动系统应用开发人员、系统应用开发人员 |
 | 类Web开发范式 | JS语言 | 数据驱动更新 | 界面较为简单的程序应用和卡片 | Web前端开发人员 |
 
 更多UI框架的开发内容及指导，详见[UI开发](../ui/arkui-overview.md)。
@@ -36,7 +36,7 @@ Ability框架模型结构具有两种形态：
 
 - **Stage模型**：从API 9开始，Ability框架引入并支持使用Stage模型进行开发。更多Stage模型的内容详见[Stage模型综述](../ability/stage-brief.md)。
 
-FA模型和Stage模型的工程目录结构存在差异，Stage模型只支持使用eTS语言进行开发。
+FA模型和Stage模型的工程目录结构存在差异，Stage模型只支持使用ArkTS语言进行开发。
 
 关于FA模型和Stage模型的整体架构和设计思想等更多区别，详见[Ability框架概述](../ability/ability-brief.md)。
 
@@ -49,4 +49,4 @@ FA模型和Stage模型的工程目录结构存在差异，Stage模型只支持
 
 2. 请参考[配置OpenHarmony SDK](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-setting-up-environment-0000001263160443)，完成**DevEco Studio**的安装和开发环境配置。
 
-完成上述操作及基本概念的理解后，可参照[使用eTS语言进行开发（Stage模型）](start-with-ets-stage.md)、[使用eTS语言开发（FA模型）](start-with-ets-fa.md)、[使用JS语言开发（FA模型）](../quick-start/start-with-js-fa.md)中的任一章节进行下一步体验和学习。
+完成上述操作及基本概念的理解后，可参照[使用ArkTS语言进行开发（Stage模型）](start-with-ets-stage.md)、[使用ArkTS语言开发（FA模型）](start-with-ets-fa.md)、[使用JS语言开发（FA模型）](../quick-start/start-with-js-fa.md)中的任一章节进行下一步体验和学习。

zh-cn/application-dev/quick-start/start-with-ets-fa.md

-# 使用eTS语言开发（FA模型）
+# 使用ArkTS语言开发（FA模型）
 
 
 >  **说明：**
@@ -18,7 +18,7 @@
    ![02](figures/02.png)
 
    > **说明：**
-   > DevEco Studio V3.0 Beta3及更高版本支持使用eTS[低代码开发](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-low-code-development-0000001218440652)方式。
+   > DevEco Studio V3.0 Beta3及更高版本支持使用ArkTS[低代码开发](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-low-code-development-0000001218440652)方式。
    > 
    > 低代码开发方式具有丰富的UI界面编辑功能，通过可视化界面开发方式快速构建布局，可有效降低开发者的上手成本并提升开发者构建UI界面的效率。
    > 
@@ -288,4 +288,4 @@
 
    ![zh-cn_image_0000001363934577](figures/zh-cn_image_0000001363934577.png)
 
-恭喜您已经使用eTS语言开发（FA模型）完成了第一个OpenHarmony应用，快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。
+恭喜您已经使用ArkTS语言开发（FA模型）完成了第一个OpenHarmony应用，快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。

zh-cn/application-dev/quick-start/start-with-ets-stage.md

-# 使用eTS语言开发（Stage模型）
+# 使用ArkTS语言开发（Stage模型）
 
 
 > **说明：**
@@ -19,7 +19,7 @@
 
    > **说明：**
    >
-   > 支持使用eTS[低代码开发](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-low-code-development-0000001218440652)方式。
+   > 支持使用ArkTS[低代码开发](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-low-code-development-0000001218440652)方式。
    >
    > 低代码开发方式具有丰富的UI界面编辑功能，通过可视化界面开发方式快速构建布局，可有效降低开发者的上手成本并提升开发者构建UI界面的效率。
    >
@@ -287,4 +287,4 @@
 
    ![zh-cn_image_0000001311334972](figures/zh-cn_image_0000001311334972.png)
 
-恭喜您已经使用eTS语言开发（Stage模型）完成了第一个OpenHarmony应用，快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。
+恭喜您已经使用ArkTS语言开发（Stage模型）完成了第一个OpenHarmony应用，快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。

zh-cn/application-dev/reference/apis/js-apis-media.md

@@ -52,7 +52,7 @@ createVideoPlayer(callback: AsyncCallback\<[VideoPlayer](#videoplayer8)>): void
 
 | 参数名   | 类型                                        | 必填 | 说明                           |
 | -------- | ------------------------------------------- | ---- | ------------------------------ |
-| callback | AsyncCallback<[VideoPlayer](#videoplayer8)> | 是   | 回调函数。异步返回VideoPlayer实例，可用于管理和播放视频媒体。 |
+| callback | AsyncCallback<[VideoPlayer](#videoplayer8)> | 是   | 回调函数。异步返回VideoPlayer实例，失败时返回null。可用于管理和播放视频媒体。 |
 
 **示例：**
 
@@ -80,8 +80,8 @@ createVideoPlayer(): Promise<[VideoPlayer](#videoplayer8)>
 **返回值：**
 
 | 类型                                  | 说明                                                         |
-| ------------------------------------- | ----------------------------------- |
-| Promise<[VideoPlayer](#videoplayer8)> | Promise对象。异步返回VideoPlayer实例，可用于管理和播放视频媒体。 |
+| ------------------------------------- | ------------------------------------------------------------ |
+| Promise<[VideoPlayer](#videoplayer8)> | Promise对象。异步返回VideoPlayer实例，失败时返回null。可用于管理和播放视频媒体。 |
 
 **示例：**
 
@@ -112,8 +112,8 @@ createAudioRecorder(): AudioRecorder
 **返回值:**
 
 | 类型                            | 说明                                                         |
-| ------------------------------- | ----------------------------------------- |
-| [AudioRecorder](#audiorecorder) | 返回AudioRecorder类实例，失败时返回null。 |
+| ------------------------------- | ------------------------------------------------------------ |
+| [AudioRecorder](#audiorecorder) | 返回AudioRecorder类实例，失败时返回null。可用于录制音频媒体。 |
 
 **示例：**
 
@@ -134,7 +134,7 @@ createVideoRecorder(callback: AsyncCallback\<[VideoRecorder](#videorecorder9)>):
 
 | 参数名   | 类型                                            | 必填 | 说明                           |
 | -------- | ----------------------------------------------- | ---- | ------------------------------ |
-| callback | AsyncCallback<[VideoRecorder](#videorecorder9)> | 是   | 回调函数。异步返回VideoRecorder实例，可用于录制视频媒体。 |
+| callback | AsyncCallback<[VideoRecorder](#videorecorder9)> | 是   | 回调函数。异步返回VideoRecorder实例，失败时返回null。可用于录制视频媒体。 |
 
 **示例：**
 
@@ -163,8 +163,8 @@ createVideoRecorder(): Promise<[VideoRecorder](#videorecorder9)>
 **返回值：**
 
 | 类型                                      | 说明                                                         |
-| ----------------------------------------- | ----------------------------------- |
-| Promise<[VideoRecorder](#videorecorder9)> | Promise对象。异步返回VideoRecorder实例，可用于录制视频媒体。 |
+| ----------------------------------------- | ------------------------------------------------------------ |
+| Promise<[VideoRecorder](#videorecorder9)> | Promise对象。异步返回VideoRecorder实例，失败时返回null。可用于录制视频媒体。 |
 
 **示例：**
 
@@ -362,8 +362,8 @@ seek(timeMs: number): void
 **参数：**
 
 | 参数名 | 类型   | 必填 | 说明                                                        |
-| ------ | ------ | ---- | ------------------------------------ |
-| timeMs | number | 是   | 指定的跳转时间节点，单位毫秒（ms）。 |
+| ------ | ------ | ---- | ----------------------------------------------------------- |
+| timeMs | number | 是   | 指定的跳转时间节点，单位毫秒（ms），取值范围[0, duration]。 |
 
 **示例：**
 
@@ -427,8 +427,8 @@ getTrackDescription(callback: AsyncCallback<Array\<MediaDescription>>): void
 **参数：**
 
 | 参数名   | 类型                                                         | 必填 | 说明                                       |
-| -------- | ------------------------------------------------------------ | ---- | -------------------------- |
-| callback | AsyncCallback<Array<[MediaDescription](#mediadescription8)>> | 是   | 获取音频轨道信息回调方法。 |
+| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------ |
+| callback | AsyncCallback<Array<[MediaDescription](#mediadescription8)>> | 是   | 音频轨道信息MediaDescription数组回调方法。 |
 
 **示例：**
 
@@ -463,8 +463,8 @@ getTrackDescription(): Promise<Array\<MediaDescription>>
 **返回值：**
 
 | 类型                                                   | 说明                                            |
-| ------------------------------------------------------ | ------------------------------- |
-| Promise<Array<[MediaDescription](#mediadescription8)>> | 获取音频轨道信息Promise返回值。 |
+| ------------------------------------------------------ | ----------------------------------------------- |
+| Promise<Array<[MediaDescription](#mediadescription8)>> | 音频轨道信息MediaDescription数组Promise返回值。 |
 
 **示例：**
 
@@ -496,7 +496,7 @@ for (let i = 0; i < arrayDescription.length; i++) {
 
 on(type: 'bufferingUpdate', callback: (infoType: [BufferingInfoType](#bufferinginfotype8), value: number) => void): void
 
-开始订阅音频缓存更新事件。
+开始订阅音频缓存更新事件。仅网络播放支持该订阅事件。
 
 **系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
 
@@ -593,7 +593,7 @@ audioPlayer.src = fdPath;  //设置src属性，并触发'dataLoad'事件回调
 
 on(type: 'timeUpdate', callback: Callback\<number>): void
 
-开始订阅音频播放时间更新事件。
+开始订阅音频播放时间更新事件。处于播放状态时，每隔1s上报一次该事件。
 
 **系统能力：** SystemCapability.Multimedia.Media.AudioPlayer
 
@@ -1014,8 +1014,8 @@ seek(timeMs: number, callback: AsyncCallback\<number>): void
 **参数：**
 
 | 参数名   | 类型     | 必填 | 说明                                                         |
-| -------- | -------- | ---- | ------------------------------------ |
-| timeMs   | number   | 是   | 指定的跳转时间节点，单位毫秒（ms）。 |
+| -------- | -------- | ---- | ------------------------------------------------------------ |
+| timeMs   | number   | 是   | 指定的跳转时间节点，单位毫秒（ms），取值范围为[0, duration]。 |
 | callback | function | 是   | 跳转到指定播放位置的回调方法。                               |
 
 **示例：**
@@ -1042,8 +1042,8 @@ seek(timeMs: number, mode:SeekMode, callback: AsyncCallback\<number>): void
 **参数：**
 
 | 参数名   | 类型                   | 必填 | 说明                                                         |
-| -------- | ---------------------- | ---- | ------------------------------------ |
-| timeMs   | number                 | 是   | 指定的跳转时间节点，单位毫秒（ms）。 |
+| -------- | ---------------------- | ---- | ------------------------------------------------------------ |
+| timeMs   | number                 | 是   | 指定的跳转时间节点，单位毫秒（ms），取值范围为[0, duration]。 |
 | mode     | [SeekMode](#seekmode8) | 是   | 跳转模式。                                                   |
 | callback | function               | 是   | 跳转到指定播放位置的回调方法。                               |
 
@@ -1072,15 +1072,15 @@ seek(timeMs: number, mode?:SeekMode): Promise\<number>
 **参数：**
 
 | 参数名 | 类型                   | 必填 | 说明                                                         |
-| ------ | ---------------------- | ---- | ------------------------------------ |
-| timeMs | number                 | 是   | 指定的跳转时间节点，单位毫秒（ms）。 |
+| ------ | ---------------------- | ---- | ------------------------------------------------------------ |
+| timeMs | number                 | 是   | 指定的跳转时间节点，单位毫秒（ms），取值范围为[0, duration]。 |
 | mode   | [SeekMode](#seekmode8) | 否   | 跳转模式。                                                   |
 
 **返回值：**
 
 | 类型           | 说明                                        |
-| -------------- | ----------------------------------- |
-| Promise\<void> | 跳转到指定播放位置的Promise返回值。 |
+| -------------- | ------------------------------------------- |
+| Promise\<void> | 跳转到指定播放位置的Promise返回值，单位ms。 |
 
 **示例：**
 
@@ -1220,8 +1220,8 @@ getTrackDescription(callback: AsyncCallback<Array\<MediaDescription>>): void
 **参数：**
 
 | 参数名   | 类型                                                         | 必填 | 说明                                       |
-| -------- | ------------------------------------------------------------ | ---- | -------------------------- |
-| callback | AsyncCallback<Array<[MediaDescription](#mediadescription8)>> | 是   | 获取视频轨道信息回调方法。 |
+| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------ |
+| callback | AsyncCallback<Array<[MediaDescription](#mediadescription8)>> | 是   | 视频轨道信息MediaDescription数组回调方法。 |
 
 **示例：**
 
@@ -1256,8 +1256,8 @@ getTrackDescription(): Promise<Array\<MediaDescription>>
 **返回值：**
 
 | 类型                                                   | 说明                                            |
-| ------------------------------------------------------ | ------------------------------- |
-| Promise<Array<[MediaDescription](#mediadescription8)>> | 获取视频轨道信息Promise返回值。 |
+| ------------------------------------------------------ | ----------------------------------------------- |
+| Promise<Array<[MediaDescription](#mediadescription8)>> | 视频轨道信息MediaDescription数组Promise返回值。 |
 
 **示例：**
 
@@ -1332,8 +1332,8 @@ setSpeed(speed:number): Promise\<number>
 **返回值：**
 
 | 类型             | 说明                                                         |
-| ---------------- | ------------------------- |
-| Promise\<number> | 通过Promise获取设置结果。 |
+| ---------------- | ------------------------------------------------------------ |
+| Promise\<number> | 播放速度Promise返回值，具体见[PlaybackSpeed](#playbackspeed8)。 |
 
 **示例：**
 
@@ -1388,13 +1388,13 @@ selectBitrate(bitrate:number): Promise\<number>
 
 | 参数名  | 类型   | 必填 | 说明                                         |
 | ------- | ------ | ---- | -------------------------------------------- |
-| bitrate | number | 是   | 指定码率播放，用于hls多码率场景，单位为bps。 |
+| bitrate | number | 是   | 指定播放码率，用于hls多码率场景，单位为bps。 |
 
 **返回值：**
 
 | 类型             | 说明                        |
-| ---------------- | ------------------------- |
-| Promise\<number> | 通过Promise获取设置结果。 |
+| ---------------- | --------------------------- |
+| Promise\<number> | 指定播放码率Promise返回值。 |
 
 **示例：**
 
@@ -1434,7 +1434,7 @@ videoPlayer.on('playbackCompleted', () => {
 
 on(type: 'bufferingUpdate', callback: (infoType: BufferingInfoType, value: number) => void): void
 
-开始监听视频缓存更新事件。
+开始监听视频缓存更新事件。仅网络播放支持该订阅事件。
 
 **系统能力：** SystemCapability.Multimedia.Media.VideoPlayer
 

zh-cn/application-dev/reference/apis/js-apis-system-device.md

 # 设备信息
 
+本模块提供当前设备的信息。
+
 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
 > - 从API Version 6开始，该接口不再维护，推荐使用新接口[`@ohos.deviceInfo`](js-apis-device-info.md)进行设备信息查询。
 > 
 > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
 
-
 ## 导入模块
 
-
 ```
 import device from '@system.device';
 ```
 
-
 ## device.getInfo
 
 getInfo(Object): void
@@ -23,7 +22,7 @@ getInfo(Object): void
 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
 > 在首页的onShow生命周期之前不建议调用device.getInfo接口。
 
-**系统能力：** SystemCapability.Startup.SysInfo
+**系统能力：** SystemCapability.Startup.SystemInfo
 
 **参数：**
 

zh-cn/application-dev/task-management/Readme-CN.md

@@ -7,3 +7,7 @@
 - 延迟任务调度
   - [延迟任务调度概述](work-scheduler-overview.md)
   - [延迟任务调度开发指导](work-scheduler-dev-guide.md)
+
+- 后台代理提醒
+  - [后台代理提醒开发概述](background-agent-scheduled-reminder-overview.md)
+  - [后台代理提醒开发指导](background-agent-scheduled-reminder-guide.md)
\ No newline at end of file

zh-cn/device-dev/kernel/Readme-CN.md

@@ -65,6 +65,7 @@
                 - [虚拟文件系统](kernel-small-bundles-fs-virtual.md)
                 - [支持的文件系统](kernel-small-bundles-fs-support.md)
                 - [适配新的文件系统](kernel-small-bundles-fs-new.md)
+                - [Plimitsfs文件系统](kernel-small-plimits.md)
         - 调测与工具
             - Shell
                 - [Shell介绍](kernel-small-debug-shell-overview.md)