Merge branch 'master' of gitee.com:openharmony/docs into master

Signed-off-by: N李兀立 <liwuli@huawei.com>

en/application-dev/device/inputdevice-guidelines.md

@@ -29,7 +29,6 @@ When a user enters text, the input method determines whether to launch the virtu
 
 1. Call the **getDeviceList** API to obtain the list of connected input devices. Call the **getKeyboardType** API to traverse all connected devices to check whether a physical keyboard exists. If a physical keyboard exists, mark the physical keyboard as connected. This step ensures that your application detects all inserted input devices before listening for device hot swap events.
 2. Call the **on** API to listen for device hot swap events. If a physical keyboard is inserted, mark the physical keyboard as connected. If a physical keyboard is removed, mark the physical keyboard as disconnected.
-3. When a user enters text, check whether a physical keyboard is connected. If a physical keyboard is not connected, launch the virtual keyboard.
 
 
 ```js
@@ -65,6 +64,4 @@ try {
 } catch (error) {
   console.log(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
 }
-  // 3. Determine whether to launch the virtual keyboard based on the value of isPhysicalKeyboardExist.
-  // TODO
 ```

en/application-dev/dfx/apprecovery-guidelines.md

@@ -125,12 +125,12 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
 
 #### Actively Saving the Application State and Restoring Data
 
-- Define and register the [ErrorObserver](../reference/apis/js-apis-inner-application-errorObserver.md) callback. 
+- Define and register the [ErrorObserver](../reference/apis/js-apis-inner-application-errorObserver.md) callback. For details about its usage, see [errorManager](../reference/apis/js-apis-app-ability-errorManager.md).
 
 ```ts
   var registerId = -1;
   var callback = {
-      onUnhandledException: function (errMsg) {
+      onUnhandledException(errMsg) {
           console.log(errMsg);
           appRecovery.saveAppState();
           appRecovery.restartApp();
@@ -142,7 +142,7 @@ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
       console.log("[Demo] EntryAbility onWindowStageCreate")
 
       globalThis.registerObserver = (() => {
-          registerId = errorManager.registerErrorObserver(callback);
+          registerId = errorManager.on('error', callback);
       })
 
       windowStage.loadContent("pages/index", null);
@@ -158,7 +158,7 @@ After the callback triggers **appRecovery.saveAppState()**, **onSaveState(state,
       // Ability has called to save app data
       console.log("[Demo] EntryAbility onSaveState")
       wantParams["myData"] = "my1234567";
-      return AbilityConstant.onSaveResult.ALL_AGREE;
+      return AbilityConstant.OnSaveResult.ALL_AGREE;
   }
 ```
 
@@ -188,8 +188,8 @@ onWindowStageDestroy() {
     console.log("[Demo] EntryAbility onWindowStageDestroy")
 
     globalThis.unRegisterObserver = (() => {
-        errorManager.unregisterErrorObserver(registerId, (result) => {
-            console.log("[Demo] result " + result.code + ";" + result.message)
+        errorManager.off('error', registerId, (err) => {
+            console.error("[Demo] err:", err);
         });
     })
 }
@@ -217,7 +217,7 @@ export default class EntryAbility extends Ability {
         // Ability has called to save app data
         console.log("[Demo] EntryAbility onSaveState")
         wantParams["myData"] = "my1234567";
-        return AbilityConstant.onSaveResult.ALL_AGREE;
+        return AbilityConstant.OnSaveResult.ALL_AGREE;
     }
 }
 ```

en/application-dev/quick-start/app-configuration-file.md

@@ -19,7 +19,9 @@ This document gives an overview of the **app.json5** configuration file. To star
     "debug": false,
     "car": {
       "minAPIVersion": 8,
-    }
+    },
+    "targetBundleName": "com.application.test",
+    "targetPriority": 50
   },
 }
 ```
@@ -28,11 +30,12 @@ This document gives an overview of the **app.json5** configuration file. To star
 As shown above, the **app.json5** file contains several tags.
 
 
-**Table 1** Tags in the app.json5 file
+  **Table 1** Tags in the app.json5 file
 
 | Name| Description| Data Type| Initial Value Allowed|
 | -------- | -------- | -------- | -------- |
 | bundleName | Bundle name, which uniquely identifies an application.  The value must comply with the following rules:<br>- Consists of letters, digits, underscores (_), and periods (.).<br>- Starts with a letter.<br>- Contains 7 to 127 bytes.<br>You are advised to use the reverse domain name notation, for example, *com.example.demo*, where the first part is the domain suffix **com**, the second part is the vendor/individual name, and the third part is the application name, which can be of multiple levels.<br>If an application is built with the system source code, you are advised to name it in *com.ohos.demo* notation, where **ohos** signifies that the application is an OpenHarmony system application.| String| No|
+| bundleType| Bundle type, which is used to distinguish applications and atomic services.<br>- **app**: The bundle is a common application.<br>- **atomicService**: The bundle is an atomic service.<br>- **shared**: The bundle is a shared object application. | String| Yes (initial value: **"app"**)|
 | debug | Whether the application can be debugged. This tag is generated during compilation and building in DevEco Studio.<br>- **true**: The application can be debugged.<br>- **false**: The application cannot be debugged.| Boolean| Yes (initial value: **false**)|
 | icon | [Icon of the application](../application-models/application-component-configuration-stage.md). The value is an icon resource index.| String| No|
 | label | [Name of the application](../application-models/application-component-configuration-stage.md). The value is a string resource index.| String| No|
@@ -51,3 +54,5 @@ As shown above, the **app.json5** file contains several tags.
 | wearable | Wearable-specific configuration, which includes **minAPIVersion** and **distributedNotificationEnabled** attributes.<br>When running on wearables, the application applies the attribute settings under this tag and ignores the general counterparts.| Object| Yes (initial value: general settings in the **app.json5** file)|
 | car | Head unit–specific configuration, which includes **minAPIVersion** and **distributedNotificationEnabled** attributes.<br>When running on head units, the application applies the attribute settings under this tag and ignores the general counterparts.| Object| Yes (initial value: general settings in the **app.json5** file)|
 | default | Default device–specific configuration, which includes **minAPIVersion** and **distributedNotificationEnabled** attributes.<br>When running on default devices, the application applies the attribute settings under this tag and ignores the general counterparts.| Object| Yes (initial value: general settings in the **app.json5** file)|
+|targetBundleName|Target application name of the bundle. The value rule and range are the same as those of **bundleName**.|String|Yes (if the initial value is used, the target application is not an application with the overlay feature)|
+|targetPriority|Priority of the application. When **targetBundleName** is set, the application is an application with the overlay feature. The value ranges from 1 to 100.|Number|Yes (initial value: **1**)|

en/application-dev/quick-start/application-package-structure-fa.md

@@ -11,7 +11,7 @@ The difference between the application package structures in the FA model and st
 
 - The **assets** folder is a collection of all the resource files, library files, and code files in a HAP file. It can be further organized into the **entry** folder and the **js** folder. The **entry** folder stores the **resources** folder and the **resources.index** file.
 
-- The **resources** folder stores resource files (such as strings and images) of the application.
+- The **resources** folder stores resource files (such as strings and images) of the application. For details, see [Resource Categories and Access](resource-categories-and-access.md).
 
 - The **resources.index** file provides a resource index table, which is generated by DevEco Studio invoking the specific SDK tool.
 

en/application-dev/quick-start/application-package-structure-stage.md

@@ -22,7 +22,7 @@ To develop an application based on the [stage model](application-configuration-f
 - The HAP file includes folders such as **ets**, **libs**, and **resources** and files such as **resources.index**, **module.json**, and **pack.info**.
   - The **ets** folder stores bytecode files generated after application code build.
   - The **libs** folder stores library files, which are .so binary files that contain third-party code on which the OpenHarmony application depends.
-  - The **resources** folder stores resource files (such as strings and images) of the application.
+  - The **resources** folder stores resource files (such as strings and images) of the application. For details, see [Resource Categories and Access](resource-categories-and-access.md).
   - The **resources.index** file provides a resource index table, which is generated when the application project is built in DevEco Studio.
   - The **module.json** file is the configuration file indispensable in a HAP file. It consists of **module.json5** and **app.json5** in the project configuration. While DevEco Studio provides default configuration, you must modify the configuration as needed. For details about the configuration fields, see [Application Configuration Files in Stage Model](application-configuration-file-overview-stage.md).
   - The **pack.info** file describes the HAP attributes in the bundle, for example, **bundleName** and **versionCode** in **app** and **name**, **type**, and **abilities** in **module**. The file is automatically generated when DevEco Studio generates the bundle.

en/application-dev/quick-start/atomicService.md

+# Atomic Service
+
+## Pre-loading by HAP Type
+
+### HAP File Implementation
+
+To speed up the initial startup of an atomic service, you can configure it to load on demand with the use of HAP files. HAP files of an atomic service are classified as entry-type or feature-type. The entry-type HAP file contains the page code and related resources required for starting up the atomic service. The feature-type HAP files contain the rest of the code and resources. To start the atomic service, the user only needs to download and install the entry-type HAP file, which minimizes the time for downloading the atomic service.
+
+#### How to Use
+
+You create HAP files of an atomic service by creating an atomic service project in DevEco Studio. The basic project directory structure is as follows:
+
+```
+├── AppScope
+|    ├── resources
+|    └── app.json5
+├── entry
+|    └── src/main
+|       ├── ets
+|       ├── resources
+|       └── module.json5
+├── feature
+|    └── src/main
+|       ├── ets
+|       ├── resources
+|       └── module.json5
+├── library
+|    └── src/main
+|       ├── ets
+|       ├── resources
+|       └── module.json5
+├── node_modules
+```
+
+Note that you must set the **bundleType** field to **atomicService** in the [app.json5](app-configuration-file.md) file, which is located in the **AppScope** folder. The following is an example of the file content:
+
+```json
+{
+  "app": {
+    "bundleName": "com.example.hmservice",
+    "bundleType":"atomicService",
+    "vendor": "example",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "icon": "$media:app_icon",
+    "label": "$string:app_name",
+    "distributedNotificationEnabled": true,
+    "targetAPIVersion": 9
+  }
+}
+```
+
+For details about HAP files, see [Multi-HAP Design Objectives](multi-hap-objective.md).
+
+#### Restrictions
+
+1. The **installationFree** field must be set to **true** in each module-specific configuration file [module.json5](module-configuration-file.md) file.
+
+2. When packaging an atomic service, comply with the following size rules:
+
+- The total size of HAP files cannot exceed 10 MB.
+
+- The size of a HAP file itself and all its dependent [HSP](in-app-hsp.md) cannot exceed 2 MB.
+
+
+### Pre-loading Implementation
+
+You can configure the system to automatically pre-download required modules when the atomic service enters a module, thereby speeding up module access.
+
+Currently, pre-loading can be implemented only through configuration, not by invoking APIs.
+
+#### How to Use
+
+Pre-loading is triggered after the first frame of the newly accessed module is rendered. You can configure what to pre-load for a module, by setting the **preloads** field under **atomicService** in the [module.json5](module-configuration-file.md) file of the module. The following is an example of the **module.json5** file of the **entry** module, saved in **entry/src/main**:
+
+```json
+{
+  "module": {
+    "name": "entry",
+    "type": "entry",
+    "srcEntrance": "./ets/Application/MyAbilityStage.ts",
+    "description": "$string:entry_desc",
+    "mainElement": "MainAbility",
+    "deviceTypes": [
+      "default",
+      "tablet"
+    ],
+    "deliveryWithInstall": true,
+    "installationFree": true,
+    "pages": "$profile:main_pages",
+    "atomicService": {
+      "preloads": [
+        {
+          "moduleName": "feature"
+        }
+      ]
+    },
+    "abilities": [
+      {
+        "name": "MainAbility",
+        "srcEntrance": "./ets/MainAbility/MainAbility.ts",
+        "description": "$string:MainAbility_desc",
+        "icon": "$media:icon",
+        "label": "$string:MainAbility_label",
+        "startWindowIcon": "$media:icon",
+        "startWindowBackground": "$color:white",
+        "visible": true,
+        "skills": [
+          {
+            "entities": [
+              "entity.system.home"
+            ],
+            "actions": [
+              "action.system.home"
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+In this example, the system automatically pre-loads the **feature** module after the first frame of the **entry** module is rendered.
+
+#### Restrictions
+
+[moduleType](../reference/apis/js-apis-bundleManager.md#moduletype) corresponding to moduleName in the **preloads** list cannot be entry.
+
+## Using Dynamic Shared Packages in Atomic Services
+
+A [Harmony Shared Package (HSP)](shared-guide.md) is a dynamic shared package for sharing code, C++ libraries, resources, and configuration files among modules.
+For details about how to use the HSP within an atomic service, see [In-Application HSP Development](in-app-hsp.md).
+
+#### How to Use
+
+Assume that the project directory structure is as follows:
+```
+├── AppScope
+|    ├── resources
+|    └── app.json5
+├── entry
+|    └── src/main
+|       ├── ets
+|           ├── entryAbility
+|           └── pages
+|               └── Index.ets
+|       ├── resources
+|       └── module.json5
+├── feature
+|    └── src/main
+|       ├── ets
+|       ├── resources
+|       └── module.json5
+├── library
+|    └── src/main
+|       ├── ets
+|           └── pages
+|               └── menu.ets
+|       ├── resources
+|       └── module.json5
+├── node_modules
+```
+
+If you want to add a button in the **entry** module to jump to the menu page (**library/src/main/ets/pages/menu.ets**) in the **library** module, you can write the following code in the **entry/src/main/ets/MainAbility/Index.ets** file of the **entry** module:
+
+```ts
+import router from '@ohos.router';
+
+@Entry
+@Component
+struct Index {
+    @State message: string = 'Hello World'
+
+    build() {
+    Row() {
+        Column() {
+        Text(this.message)
+            .fontSize(50)
+            .fontWeight(FontWeight.Bold)
+        // Add a button to respond to user clicks.
+        Button() {
+            Text('click to menu')
+            .fontSize(30)
+            .fontWeight(FontWeight.Bold)
+        }
+        .type(ButtonType.Capsule)
+        .margin({
+            top: 20
+        })
+        .backgroundColor('#0D9FFB')
+        .width('40%')
+        .height('5%')
+        // Bind click events.
+        .onClick(() => {
+            router.pushUrl({
+              url: '@bundle:com.example.hmservice/library/ets/pages/menu'
+            }).then(() => {
+              console.log("push page success");
+            }).catch(err => {
+              console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
+            })
+        }
+        .width('100%')
+    }
+    .height('100%')
+    }
+}
+```
+
+The input parameter **url** of the **router.pushUrl** API is as follows:
+```ets
+'@bundle:com.example.hmservice/library/ets/pages/menu'
+```
+The **url** content template is as follows:
+```ets
+'@bundle:bundle name/module name/path/page file name (without the extension .ets)'
+```

en/application-dev/quick-start/module-structure.md

@@ -192,12 +192,20 @@ Example of the metadata attribute:
 
 **By default, application icons cannot be hidden from the home screen in OpenHarmony.**
 
-The OpenHarmony system imposes a strict rule on the presence of application icons. If no icon is configured in the HAP file of an application, the system creates a default icon for the application and displays it on the home screen.<br>
-Touching this icon will direct the user to the application details screen in **Settings**.
+The OpenHarmony system imposes a strict rule on the presence of application icons. If no icon is configured in the HAP file of an application, the system creates a default icon for the application and displays it on the home screen.
+
+Touching this icon will direct the user to the application details screen in **Settings**, as shown in Figure 1.
+
 To hide an application icon from the home screen, you must configure the **AllowAppDesktopIconHide** privilege. For details, see [Application Privilege Configuration Guide](../../device-dev/subsystems/subsys-app-privilege-config-guide.md).
 
+**Objectives**:
+
+This requirement on application icons is intended to prevent malicious applications from deliberately configuring no icon to block uninstallation attempts.
+
+**Setting the application icon to be displayed on the home screen**:
+
+Set **icon**, **label**, and **skills** under **abilities** in the **config.json** file. In addition, make sure the **skills** configuration contains **ohos.want.action.home** and **entity.system.home**.
 
-**Setting the application icon to be displayed on the home screen**:<br>Set **icon**, **label**, and **skills** under **abilities** in the **config.json** file. In addition, make sure the **skills** configuration contains **ohos.want.action.home** and **entity.system.home**.
 ```
 {
   "module":{
@@ -220,36 +228,37 @@ To hide an application icon from the home screen, you must configure the **Allow
 }
 ```
 
-**Querying an application icon:**
+**Display rules of application icons and labels on the home screen:**
 * The HAP file contains Page ability configuration.
-  * The application icon is set under **abilities** in the **config.json** file.
+  * The application icon on the home screen is set under **abilities** in the **config.json** file.
     * The application does not have the privilege to hide its icon from the home screen.
-      * The returned home screen icon is the icon configured for the ability.
-      * The returned home screen label is the label configured for the ability. If no label is configured, the bundle name is returned.
-      * The returned component name is the component name of the ability.
-      * When the user touches the home screen icon, the home screen of the ability is displayed.
+      * The application icon displayed on the home screen is the icon configured for the Page ability.
+      * The application label displayed on the home screen is the label configured for the Page ability. If no label is configured, the bundle name is returned.
+      * The name of the Page ability is displayed.
+      * When the user touches the home screen icon, the home screen of the Page ability is displayed.
     * The application has the privilege to hide its icon from the home screen.
       * The information about the application is not returned during home screen information query, and the icon of the application is not displayed on the home screen.
-  * The application icon is not set under **abilities** in the **config.json** file.
+  * The application icon on the home screen is not set under **abilities** in the **config.json** file.
     * The application does not have the privilege to hide its icon from the home screen.
-      * The returned home screen icon is the default icon.
-      *The returned home screen label is the bundle name of the application.
-      * The returned component name is the component name displayed on the application details screen (this component is built in the system).
-      * Touching the home screen icon will direct the user to the application details screen.
+      * The application icon displayed on the home screen is the default icon.
+      * The application label displayed on the home screen is the bundle name of the application.
+      * Touching the application icon on the home screen will direct the user to the application details screen shown in Figure 1.
     * The application has the privilege to hide its icon from the home screen.
       * The information about the application is not returned during home screen information query, and the icon of the application is not displayed on the home screen.
 * The HAP file does not contain Page ability configuration.
   * The application does not have the privilege to hide its icon from the home screen.
-    * The returned home screen icon is the default icon.
-    *The returned home screen label is the bundle name of the application.
-    * The returned component name is the component name displayed on the application details screen (this component is built in the system).
-    * Touching the home screen icon will direct the user to the application details screen.
+    * The application icon displayed on the home screen is the default icon.
+    * The application label displayed on the home screen is the bundle name of the application.
+    * Touching the application icon on the home screen will direct the user to the application details screen shown in Figure 1.
   * The application has the privilege to hide its icon from the home screen.
     * The information about the application is not returned during home screen information query, and the icon of the application is not displayed on the home screen.
 
-> **NOTE**
-> 
-> The icon and label displayed on the application details page may be different from those displayed on the home screen. For non-Page abilities, they are the entry icon and label set under **abilities**, if any.
+Note: The label displayed on the application details screen may be different from that displayed on the home screen. For non-Page abilities, it is the entry label set (if any).<br><br>
+
+**Figure 1** Application details screen
+
+![Application details screen](figures/application_details.jpg)
+
 
 **Table 8** Internal structure of the abilities attribute
 
@@ -412,39 +421,6 @@ Example of the **skills** attribute structure:
 ]
 ```
 
-**Enhanced implicit query**
-
-URI-level prefix matching is supported.
-
-When only **scheme** or a combination of **scheme** and **host** or **scheme**, **host**, and **port** are configured in the configuration file, the configuration is successful if a URI prefixed with the configuration file is passed in.
-
-  * The query enhancement involves the following APIs:<br>
-    [@ohos.bundle.bundleManager](../reference/apis/js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)<br>
-    1. function queryAbilityInfo(want: Want, abilityFlags: number, callback: AsyncCallback<Array\<AbilityInfo>>): void;<br>
-    2. function queryAbilityInfo(want: Want, abilityFlags: number, userId: number, callback: AsyncCallback<Array\<AbilityInfo>>): void;<br>
-    3. function queryAbilityInfo(want: Want, abilityFlags: number, userId?: number): Promise<Array\<AbilityInfo>>;
-  * Configuration requirements<br>
-    abilities -> skills -> uris object<br>
-    Configuration 1: only **scheme = 'http'**
-    Configuration 2: only **(scheme = 'http') + (host = 'www.example.com')**
-    Configuration 3: only **(scheme = 'http') + (host = 'www.example.com') + (port = '8080')**
-  * Prefix match<br>
-    If the value of **uri** under [want](../application-models/want-overview.md) is obtained by calling the **queryAbilityInfo** API:<br>
-    1. uri = 'https://': No matches<br>
-    2. uri = 'http://': Matches configuration 1<br>
-    3. uri = 'https://www.example.com': No matches<br>
-    4. uri = 'https://www.exa.com': No matches<br>
-    5. uri = 'http://www.exa.com': Matches configuration 1<br>
-    6. uri = 'http://www.example.com': Matches configuration 1 and configuration 2<br>
-    7. uri = 'https://www.example.com:8080': No matches<br>
-    8. uri = 'http://www.exampleaa.com:8080': Matches configuration 1<br>
-    9. uri = 'http://www.example.com:9180': Matches configuration 1 and configuration 2<br>
-    10. uri = 'http://www.example.com:8080': Matches configuration 1, configuration 2, and configuration 3<br>
-    11. uri = 'https://www.example.com:9180/query/student/name' : No matches<br>
-    12. uri = 'http://www.exampleap.com:8080/query/student/name': Matches configuration 1<br>
-    13. uri = 'http://www.example.com:9180/query/student/name': Matches configuration 1 and configuration 2<br>
-    14. uri = 'http://www.example.com:8080/query/student/name': Matches configuration 1, configuration 2, and configuration 3<br>
-
 ## Internal Structure of the reqPermissions Attribute
 
 **Table 12** Internal structure of the reqPermissions attribute

en/application-dev/quick-start/multi-hap-objective.md

 # Multi-HAP Design Objectives
 
 
-- Modular management: A well-designed application is generally managed in a modular manner, where modules are loosely coupled. In light of this, the multi-HAP mechanism is designed, allowing you to divide services into multiple modules and store each module in an independent HAP file. For example, If you are developing a payment application and its home screen consists of multiple modules, such as the scan, pay, messaging, and finance modules, you can implement the logic of the home screen for managing other modules in the entry-type HAP file, and implement specific modules in feature-type HAP files. The feature-type HAP files are independent. You can develop and test each of them separately, and then integrate them with the entry-type HAP file.
+- Modular management: A well-designed application is generally managed in a modular manner, where modules are loosely coupled. In light of this, the multi-HAP mechanism is designed, allowing you to divide services into multiple modules and store each module in an independent HAP file. For example, if you are developing a payment application whose home screen consists of multiple modules, such as the scan, pay, messaging, and finance modules, you can implement the HAP files as follows: (1) In the entry-type HAP file, implement the home screen logic for managing modules; (2) in feature-type HAP files, implement specific modules. The feature-type HAP files are independent of each other. You can develop and test each of them separately, and then integrate them with the entry-type HAP file.
 
-- Flexible deployment: You can combine multiple HAP files and deploy them on different devices. Assume that an application contains one entry-type HAP file (**Entry.hap**) and two feature-type HAP files (**Feature1.hap** and **Feature2.hap**). The **Entry.hap** file can be deployed on device A and device B, the **Feature1.hap** file can be deployed only on device A, and the **Feature2.hap** can be deployed only on device B. In this way, you can easily combine the **Entry.hap** and **Feature1.hap** files and deploy them on device A, and combine the **Entry.hap** and **Feature2.hap** files and deploy them on device B.
+- Flexible deployment: You can flexibly combine HAP files for device-specific deployment. Assume that an application contains one entry-type HAP file (**entry.hap**) and two feature-type HAP files (**Feature1.hap** and **Feature2.hap**). The **Entry.hap** file can be deployed on device A and device B, the **Feature1.hap** file can be deployed only on device A, and the **Feature2.hap** can be deployed only on device B. This means that you can combine the **Entry.hap** and **Feature1.hap** files and deploy them on device A, and combine the **Entry.hap** and **Feature2.hap** files and deploy them on device B.
 
-- On-demand loading: You can load modules only when they are needed, reducing the package size. Specifically, you can configure some HAP files of an application to be loaded on demand. For example, if some features are not used during application startup, you can configure them to be loaded only when they are needed, rather than being loaded at startup. This can reduce the size of the application package to some extent.
+- On-demand loading: You can load modules only when they are needed, reducing the package size. Specifically, you can configure some HAP files of your application to be loaded on demand. For example, if some features are not used during application startup, you can configure them to be loaded only when they are needed, rather than being loaded at startup. This can reduce the size of the application package to some extent.
 
-- Easier resource sharing: The resources (including public resource files and public pages) and shared objects (.so library files) required by multiple HAP files can be stored in an independent HAP file. In this way, other HAP files can obtain the resources and files by accessing the HAP, which reduces the size of the application package to some extent.
+- Easier resource sharing: The resources (including public resource files and public pages) and shared objects (.so library files) required by multiple HAP files can be stored in an independent HAP file. In this way, other HAP files can obtain the resources and files by accessing the HAP, which also reduces the size of the application package to some extent.

en/application-dev/reference/apis/Readme-EN.md

@@ -412,7 +412,6 @@
   - [@ohos.systemParameter (System Parameter)](js-apis-system-parameter.md)
   - [@ohos.systemTime (System Time and Time Zone)](js-apis-system-time.md)
   - [@ohos.usb (USB Management)](js-apis-usb-deprecated.md)
-  - [@ohos.usbV9 (USB Management)](js-apis-usb.md)
   - [@system.app (Application Context)](js-apis-system-app.md)
   - [@system.battery (Battery Information)](js-apis-system-battery.md)
   - [@system.bluetooth (Bluetooth)](js-apis-system-bluetooth.md)

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

@@ -4,7 +4,7 @@ The **geolocation** module provides a wide array of location services, including
 
 > **NOTE**
 > The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.
-> The APIs provided by this module are no longer maintained since API version 9. You are advised to use [geoLocationManager](js-apis-geoLocationManager.md) instead.
+> The APIs provided by this module are no longer maintained since API version 9. You are advised to use [geoLocationManager](js-apis-geoLocationManager.md).
 
 ## Applying for Permissions
 
@@ -1486,7 +1486,7 @@ Sets the priority of the location request.
 Enumerates error codes of the location service.
 
 > **NOTE**<br>
-> This API is deprecated since API version 9.
+> This API is deprecated since API version 9. You are advised to use [geoLocationManager](../errorcodes/errorcode-geoLocationManager.md).
 
 **Required permissions**: ohos.permission.LOCATION
 

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

@@ -399,7 +399,7 @@ discoveryService.stopSearchingMDNS();
 
 ### on('discoveryStart')
 
-on(type: 'discoveryStart', callback: Callback<{serviceInfo: LocalServiceInfo, errorCode?: MDNS_ERR}>): void
+on(type: 'discoveryStart', callback: Callback<{serviceInfo: LocalServiceInfo, errorCode?: MdnsError}>): void
 
 Enables listening for **discoveryStart** events.
 
@@ -410,7 +410,7 @@ Enables listening for **discoveryStart** events.
 | Name       | Type                            | Mandatory| Description                                    |
 |-------------|--------------|-----------|-----------------------------------------------------|
 | type     | string                          | Yes      |Event type. This field has a fixed value of **discoveryStart**.<br>**discoveryStart**: event of starting discovery of mDNS services on the LAN.|
-| callback | Callback<{serviceInfo: [LocalServiceInfo](#localserviceinfo), errorCode?: [MDNS_ERR](#mdns_err)}>                  | Yes       |   Callback used to return the mDNS service and error information.     |
+| callback | Callback<{serviceInfo: [LocalServiceInfo](#localserviceinfo), errorCode?: [MdnsError](#mdnserror)}>                  | Yes       |   Callback used to return the mDNS service and error information.     |
 
 **Example**
 
@@ -428,7 +428,7 @@ discoveryService.stopSearchingMDNS();
 
 ### on('discoveryStop')
 
-on(type: 'discoveryStop', callback: Callback<{serviceInfo: LocalServiceInfo, errorCode?: MDNS_ERR}>): void
+on(type: 'discoveryStop', callback: Callback<{serviceInfo: LocalServiceInfo, errorCode?: MdnsError}>): void
 
 Enables listening for **discoveryStop** events.
 
@@ -439,7 +439,7 @@ Enables listening for **discoveryStop** events.
 | Name       | Type                            | Mandatory| Description                                    |
 |-------------|--------------|-----------|-----------------------------------------------------|
 | type     | string                          | Yes      |Event type. This field has a fixed value of **discoveryStop**.<br>**discoveryStop**: event of stopping discovery of mDNS services on the LAN.|
-| callback | Callback<{serviceInfo: [LocalServiceInfo](#localserviceinfo), errorCode?: [MDNS_ERR](#mdns_err)}>                 | Yes       |   Callback used to return the mDNS service and error information.     |
+| callback | Callback<{serviceInfo: [LocalServiceInfo](#localserviceinfo), errorCode?: [MdnsError](#mdnserror)}>                 | Yes       |   Callback used to return the mDNS service and error information.     |
 
 **Example**
 
@@ -538,7 +538,7 @@ Defines the mDNS service attribute information.
 | key   | string                             |  Yes|  mDNS service attribute key. The value contains a maximum of 9 characters. |
 | value | Array\<number>                             |  Yes|  mDNS service attribute value.  |
 
-## MDNS_ERR
+## MdnsError
 
 Defines the mDNS error information.
 

en/application-dev/reference/apis/js-apis-resource-manager.md

@@ -13,7 +13,7 @@ The Resource Manager module provides APIs to obtain information about applicatio
 import resourceManager from '@ohos.resourceManager';
 ```
 
-## Instruction
+## How to Use
 
 Since API version 9, the stage model allows an application to obtain a **ResourceManager** object based on **context** and call its resource management APIs without first importing the required bundle. This approach, however, is not applicable to the FA model. For the FA model, you need to import the required bundle and then call the [getResourceManager](#resourcemanagergetresourcemanager) API to obtain a **ResourceManager** object.
 For details about how to reference context in the stage model, see [Context in the Stage Model](../../application-models/application-context-stage.md).
@@ -78,7 +78,7 @@ Obtains the **ResourceManager** object of an application based on the specified
 
 | Name       | Type                                      | Mandatory  | Description                           |
 | ---------- | ---------------------------------------- | ---- | ----------------------------- |
-| bundleName | string                                   | Yes   | Bundle name of the application.                |
+| bundleName | string                                   | Yes   | Bundle name of the target application.                |
 | callback   | AsyncCallback<[ResourceManager](#resourcemanager)> | Yes   | Callback used to return the result.|
 
 **Example**
@@ -135,7 +135,7 @@ Obtains the **ResourceManager** object of an application based on the specified
 
 | Name       | Type    | Mandatory  | Description           |
 | ---------- | ------ | ---- | ------------- |
-| bundleName | string | Yes   | Bundle name of the application.|
+| bundleName | string | Yes   | Bundle name of the target application.|
 
 **Return value**
 
@@ -171,12 +171,12 @@ Enumerates the device types.
 
 | Name                  | Value | Description  |
 | -------------------- | ---- | ---- |
-| DEVICE_TYPE_PHONE    | 0x00 | Phone  |
-| DEVICE_TYPE_TABLET   | 0x01 | Tablet  |
-| DEVICE_TYPE_CAR      | 0x02 | Head unit  |
-| DEVICE_TYPE_PC       | 0x03 | PC  |
-| DEVICE_TYPE_TV       | 0x04 | TV  |
-| DEVICE_TYPE_WEARABLE | 0x06 | Wearable  |
+| DEVICE_TYPE_PHONE    | 0x00 | Phone.  |
+| DEVICE_TYPE_TABLET   | 0x01 | Tablet.  |
+| DEVICE_TYPE_CAR      | 0x02 | Head unit.  |
+| DEVICE_TYPE_PC       | 0x03 | PC.  |
+| DEVICE_TYPE_TV       | 0x04 | TV.  |
+| DEVICE_TYPE_WEARABLE | 0x06 | Wearable.  |
 
 
 ## ScreenDensity
@@ -278,7 +278,7 @@ Defines the capability of accessing application resources.
 
 > **NOTE**
 >
-> - The APIs involved in **ResourceManager** are applicable only to the TypeScript-based declarative development paradigm.
+> - The methods involved in **ResourceManager** are applicable only to the TypeScript-based declarative development paradigm.
 >
 > - Resource files are defined in the **resources** directory of the project. You can obtain the resource ID using **$r(resource address).id**, for example, **$r('app.string.test').id**.
 
@@ -645,7 +645,7 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
 
 getMediaContent(resId: number, callback: AsyncCallback<Uint8Array>): void
 
-Obtains the content of the media file corresponding to the specified resource ID. This API uses an asynchronous callback to return the result.
+Obtains the content of the media file corresponding to the specified resource name. This API uses an asynchronous callback to return the result.
 
 **System capability**: SystemCapability.Global.ResourceManager
 
@@ -1543,7 +1543,7 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
       
   ```
 
-### closeRawFd<sup>8+</sup>
+### closeRawFd<sup>9+</sup>
 
 closeRawFd(path: string): Promise&lt;void&gt;
 
@@ -1658,7 +1658,7 @@ Obtains the string corresponding to the specified resource name. This API uses a
 
 | Type                   | Description        |
 | --------------------- | ---------- |
-| Promise&lt;string&gt; | String corresponding to the resource name.|
+| Promise&lt;string&gt; | Promise used to return the result.|
 
 For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
 
@@ -1770,7 +1770,7 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
 
 getMediaByName(resName: string, callback: AsyncCallback&lt;Uint8Array&gt;): void
 
-Obtains the content of the media file corresponding to the specified resource ID. This API uses an asynchronous callback to return the result.
+Obtains the content of the media file corresponding to the specified resource name. This API uses an asynchronous callback to return the result.
 
 **System capability**: SystemCapability.Global.ResourceManager
 
@@ -2036,7 +2036,7 @@ Obtains the string corresponding to the specified resource ID. This API returns
 
 | Type    | Description         |
 | ------ | ----------- |
-| string | Promise used to return the result.|
+| string | String corresponding to the specified resource ID.|
 
 For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
 
@@ -2057,6 +2057,47 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
   }
   ```
 
+### getStringSync<sup>10+</sup>
+
+getStringSync(resId: number, ...args: Array<string | number>): string
+
+Obtains the string corresponding to the specified resource ID and formats the string based on **args**. This API returns the result synchronously.
+
+**System capability**: SystemCapability.Global.ResourceManager
+
+**Parameters**
+
+| Name  | Type    | Mandatory  | Description   |
+| ----- | ------ | ---- | ----- |
+| resId | number | Yes   | Resource ID.|
+| args | Array<string \| number> | No   | Arguments for formatting strings.<br> Supported arguments:<br> -%d, %f, %s, and %%<br> Note: %% is used to translate %.<br>Example: %%d is translated into the %d string.|
+
+**Return value**
+
+| Type    | Description         |
+| ------ | ---------------------------- |
+| string | Formatted string.|
+
+For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ----------------------------------------------- |
+| 9001001  | If the resId invalid.                               |
+| 9001002  | If the resource not found by resId.                 |
+| 9001006  | If the resource re-ref too much.                    |
+| 9001007  | If the resource obtained by resId formatting error. |
+
+**Example**
+  ```ts
+  try {
+    this.context.resourceManager.getStringSync($r('app.string.test').id, "format string", 10, 98.78);
+  } catch (error) {
+    console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
+  }
+  ```
+
 ### getStringSync<sup>9+</sup>
 
 getStringSync(resource: Resource): string
@@ -2075,7 +2116,7 @@ Obtains the string corresponding to the specified resource object. This API retu
 
 | Type    | Description              |
 | ------ | ---------------- |
-| string | Promise used to return the result.|
+| string | String corresponding to the resource object.|
 
 For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
 
@@ -2101,6 +2142,52 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
   }
   ```
 
+### getStringSync<sup>10+</sup>
+
+getStringSync(resource: Resource, ...args: Array<string | number>): string
+
+Obtains the string corresponding to the specified resource object and formats the string based on **args**. This API returns the result synchronously.
+
+**System capability**: SystemCapability.Global.ResourceManager
+
+**Parameters**
+
+| Name     | Type                    | Mandatory  | Description  |
+| -------- | ---------------------- | ---- | ---- |
+| resource | [Resource](#resource9) | Yes   | Resource object.|
+| args | Array<string \| number> | No   | Arguments for formatting strings.<br> Supported arguments:<br> -%d, %f, %s, and %%<br> Note: %% is used to translate %.<br>Example: %%d is translated into the %d string.|
+
+**Return value**
+
+| Type    | Description         |
+| ------ | ---------------------------- |
+| string | Formatted string.|
+
+For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ---------------------------------------- |
+| 9001001  | If the resId invalid.                       |
+| 9001002  | If the resource not found by resId.         |
+| 9001006  | If the resource re-ref too much.            |
+| 9001007  | If the resource obtained by resId formatting error. |
+
+**Example**
+  ```ts
+  let resource = {
+      bundleName: "com.example.myapplication",
+      moduleName: "entry",
+      id: $r('app.string.test').id
+  };
+  try {
+    this.context.resourceManager.getStringSync(resource, "format string", 10, 98.78);
+  } catch (error) {
+    console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
+  }
+ ```
+
 ### getStringByNameSync<sup>9+</sup>
 
 getStringByNameSync(resName: string): string
@@ -2119,7 +2206,7 @@ Obtains the string corresponding to the specified resource name. This API return
 
 | Type    | Description        |
 | ------ | ---------- |
-| string | String corresponding to the specified resource name.|
+| string | String corresponding to the resource name.|
 
 For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
 
@@ -2140,6 +2227,47 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
   }
   ```
 
+### getStringByNameSync<sup>10+</sup>
+
+getStringByNameSync(resName: string, ...args: Array<string | number>): string
+
+Obtains the string corresponding to the specified resource name and formats the string based on **args**. This API returns the result synchronously.
+
+**System capability**: SystemCapability.Global.ResourceManager
+
+**Parameters**
+
+| Name    | Type    | Mandatory  | Description  |
+| ------- | ------ | ---- | ---- |
+| resName | string | Yes   | Resource name.|
+| args | Array<string \| number> | No   | Arguments for formatting strings.<br> Supported arguments:<br> -%d, %f, %s, and %%<br> Note: %% is used to translate %.<br>Example: %%d is translated into the %d string.|
+
+**Return value**
+
+| Type    | Description         |
+| ------ | ---------------------------- |
+| string | Formatted string.|
+
+For details about the error codes, see [Resource Manager Error Codes](../errorcodes/errorcode-resource-manager.md).
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ---------------------------------------- |
+| 9001003  | If the resName invalid.                     |
+| 9001004  | If the resource not found by resName.       |
+| 9001006  | If the resource re-ref too much.            |
+| 9001008  | If the resource obtained by resName formatting error. |
+
+**Example**
+  ```ts
+  try {
+    this.context.resourceManager.getStringByNameSync("test", "format string", 10, 98.78);
+  } catch (error) {
+    console.error(`getStringByNameSync failed, error code: ${error.code}, message: ${error.message}.`)
+  }
+ ```
+
 ### getBoolean<sup>9+</sup>
 
 getBoolean(resId: number): boolean
@@ -2399,7 +2527,7 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
 
 getDrawableDescriptor(resId: number, density?: number): DrawableDescriptor;
 
-Obtains the **DrawableDescriptor** object based on the specified resource ID. This API returns the result synchronously.
+Obtains the **DrawableDescriptor** object corresponding to the specified resource ID. This API returns the result synchronously.
 
 **System capability**: SystemCapability.Global.ResourceManager
 
@@ -2443,7 +2571,7 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
 
 getDrawableDescriptor(resource: Resource, density?: number): DrawableDescriptor;
 
-Obtains the **DrawableDescriptor** object based on the specified resource. This API returns the result synchronously.
+Obtains the **DrawableDescriptor** object corresponding to the specified resource. This API returns the result synchronously.
 
 **System capability**: SystemCapability.Global.ResourceManager
 
@@ -2492,7 +2620,7 @@ For details about the error codes, see [Resource Manager Error Codes](../errorco
 
 getDrawableDescriptorByName(resName: string, density?: number): DrawableDescriptor;
 
-Obtains the **DrawableDescriptor** object based on the specified resource name. This API returns the result synchronously.
+Obtains the **DrawableDescriptor** object corresponding to the specified resource name. This API returns the result synchronously.
 
 **System capability**: SystemCapability.Global.ResourceManager
 
@@ -2666,7 +2794,7 @@ This API is deprecated since API version 9. You are advised to use [getStringArr
 
 getMedia(resId: number, callback: AsyncCallback&lt;Uint8Array&gt;): void
 
-Obtains the content of the media file corresponding to the specified resource ID. This API uses an asynchronous callback to return the result.
+Obtains the content of the media file corresponding to the specified resource name. This API uses an asynchronous callback to return the result.
 
 This API is deprecated since API version 9. You are advised to use [getMediaContent](#getmediacontent9) instead.
 

en/application-dev/reference/arkui-ts/ts-basic-components-checkbox.md

@@ -21,7 +21,7 @@ Since API version 9, this API is supported in ArkTS widgets.
 | Name | Type| Mandatory | Description|
 | --------| --------| ------ | -------- |
 | name    | string | No| Name of the check box.|
-| group   | string | No| Group name of the check box.|
+| group   | string | No| Group name of the check box.<br>**NOTE**<br>If not used with the **\<CheckboxGroup>** component, this parameter is invalid.|
 
 ## Attributes
 
@@ -32,6 +32,8 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | ------------- | ------- | -------- |
 | select        | boolean | Whether the check box is selected.<br>Default value: **false**<br>Since API version 9, this API is supported in ArkTS widgets.|
 | selectedColor | [ResourceColor](ts-types.md#resourcecolor) | Color of the check box when it is selected.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| unselectedColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor) | Border color of the check box when it is not selected.|
+| mark<sup>10+</sup> | [MarkStyle](#markstyle10) | Internal icon style of the check box.|
 
 ## Events
 
@@ -41,6 +43,14 @@ In addition to the [universal events](ts-universal-events-click.md), the followi
 | -------------------------------------------- | ------------------------------------------------------------ |
 | onChange(callback: (value: boolean) => void) | Triggered when the selected status of the check box changes due to a manual operation.<br>- The value **true** means that the check box is selected.<br>- The value **false** means that the check box is not selected.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
+## MarkStyle<sup>10+</sup>
+
+| Name       | Type                                      | Mandatory| Default Value     | Description                                                        |
+| ----------- | ------------------------------------------ | ---- | ----------- | ------------------------------------------------------------ |
+| strokeColor | [ResourceColor](ts-types.md#resourcecolor) | No  | Color.White | Color of the internal mark.                                              |
+| size        | number \| string                 | No  | -           | Size of the internal mark, in vp. The default size is the same as the width of the check box.<br>This parameter cannot be set in percentage. If it is set to an invalid value, the default value is used.|
+| strokeWidth | number \| string                 | No  | 2           | Stroke width of the internal mark, in vp. This parameter cannot be set in percentage. If it is set to an invalid value, the default value is used.|
+
 ## Example
 
 ```ts

en/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md

@@ -14,7 +14,7 @@ Not supported
 
 CheckboxGroup(options?: { group?: string })
 
-Creates a check box group so that you can select or deselect all check boxes in the group at the same time. Check boxes and the check box group that share the group name belong to the same group.
+Creates a check box group so that you can select or deselect all check boxes in the group at the same time. Check boxes and the check box group that share a group name belong to the same group.
 
 Since API version 9, this API is supported in ArkTS widgets.
 
@@ -30,8 +30,10 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 
 | Name| Type| Description|
 | -------- | -------- | -------- |
-| selectAll | boolean | Whether to select all.<br>Default value: **false**<br>If **select** is explicitly set for check boxes in the group, the check box settings are prioritized.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| selectAll | boolean | Whether to select all.<br>Default value: **false**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>If the **select** attribute is set for a [\<Checkbox>](ts-basic-components-checkbox.md) component in the same group, the setting of the **\<Checkbox>** has a higher priority.|
 | selectedColor | [ResourceColor](ts-types.md#resourcecolor) | Color of the selected check box.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| unselectedColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor) | Border color of the check box when it is not selected.|
+| mark<sup>10+</sup> | [MarkStyle](#markstyle10) | Internal icon style of the check box.|
 
 ## Events
 
@@ -60,6 +62,13 @@ Since API version 9, this API is supported in ArkTS widgets.
 | Part  | Some check boxes in the group are selected.|
 | None  | None of the check boxes in the group are selected.|
 
+## MarkStyle<sup>10+</sup>
+
+| Name       | Type                                      | Mandatory| Default Value     | Description                                                        |
+| ----------- | ------------------------------------------ | ---- | ----------- | ------------------------------------------------------------ |
+| strokeColor | [ResourceColor](ts-types.md#resourcecolor) | No  | Color.White | Color of the internal mark.                                              |
+| size        | number \| string                 | No  | -           | Size of the internal mark, in vp. The default size is the same as the width of the check box group component.<br>This parameter cannot be set in percentage. If it is set to an invalid value, the default value is used.|
+| strokeWidth | number \| string                 | No  | 2           | Stroke width of the internal mark, in vp. This parameter cannot be set in percentage. If it is set to an invalid value, the default value is used.|
 
 ## Example
 

en/application-dev/reference/arkui-ts/ts-container-tabcontent.md

@@ -11,6 +11,10 @@ The **\<TabContent>** component is used only in the **\<Tabs>** component. It co
 
 This component supports only one child component.
 
+>  **NOTE**
+>
+>  System components and custom components can be built in, and rendering control types ([if/else](../../quick-start/arkts-rendering-control-ifelse.md), [ForEach](../../quick-start/arkts-rendering-control-foreach.md), and [LazyForEach](../../quick-start/arkts-rendering-control-lazyforeach.md)) are supported.
+
 
 ## APIs
 
@@ -23,37 +27,95 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 
 | Name| Type| Description|
 | -------- | -------- | -------- |
-| tabBar | string \| Resource \| {<br>icon?: string \| Resource,<br>text?: string \| Resource<br>}<br>\| [CustomBuilder](ts-types.md)<sup>8+</sup> | Content displayed on the tab bar.<br>**CustomBuilder**: builder, to which components can be passed (applicable to API version 8 and later versions).<br>**NOTE**<br>If an icon uses an SVG image, the width and height attributes of the SVG image must be deleted. Otherwise, the icon size will be determined by the width and height attributes of the SVG image. |
-| tabBar<sup>9+</sup> | [SubTabBarStyle](#subtabbarstyle) \| [BottomTabBarStyle](#bottomtabbarstyle) | Content displayed on the tab bar.<br>**SubTabBarStyle**: subtab style. It takes text as its input parameter.<br>**BottomTabBarStyle**: bottom and side tab style. It takes text and images as its input parameters.|
+| tabBar | string \| Resource \| {<br>icon?: string \| Resource,<br>text?: string \| Resource<br>}<br>\| [CustomBuilder](ts-types.md)<sup>8+</sup> | Content displayed on the tab bar.<br>**CustomBuilder**: builder, to which components can be passed (applicable to API version 8 and later versions).<br>**NOTE**<br>If an icon uses an SVG image, the width and height attributes of the SVG image must be deleted. Otherwise, the icon size will be determined by the width and height attributes of the SVG image.<br>If the content set exceeds the space provided by the tab bar, it will be clipped.|
+| tabBar<sup>9+</sup> | [SubTabBarStyle](#subtabbarstyle9) \| [BottomTabBarStyle](#bottomtabbarstyle9) | Content displayed on the tab bar.<br>**SubTabBarStyle**: subtab style. It takes text as its input parameter.<br>**BottomTabBarStyle**: bottom and side tab style. It takes text and images as its input parameters.<br>**NOTE**<br>The bottom tab style does not include an underline.<br>When an icon display error occurs, a gray blank block is displayed.|
 
 >  **NOTE**
+>
 >  - The **\<TabContent>** component does not support setting of the common width attribute. By default, its width is the same as that of the parent **\<Tabs>** component.
 >  - The **\<TabContent>** component does not support setting of the common height attribute. Its height is determined by the height of the parent **\<Tabs>** component and the **\<TabBar>** component.
+>  - If the **vertical** attribute is **false**, the width and height descriptions are swapped in the preceding two restrictions.
 >  - **\<TabContent>** does not support page scrolling. If page scrolling is required, consider nesting a list.
 
 ## SubTabBarStyle<sup>9+</sup>
 
 Implements the subtab style.
 
-### constructor<sup>9+</sup>
+### constructor
 
 constructor(content: string | Resource)
 
-A constructor used to create a **SubTabBarStyle** instance.
+Constructor used to create a **SubTabBarStyle** instance.
 
 **Parameters**
 
 | Name| Type        | Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| content | string \| [Resource](ts-types.md#resource) | Yes| Text for the tab.|
+| content | string \| [Resource](ts-types.md#resource) | Yes| Text for the tab. Since API version 10, the type of **content** is **ResourceStr**.|
+
+### of<sup>10+</sup>
+
+static of(content: ResourceStr)
+
+Static constructor used to create a **SubTabBarStyle** instance.
+
+**Parameters**
+
+| Name | Type                                  | Mandatory| Description          |
+| ------- | ------------------------------------------ | ---- | ------------------ |
+| content | [ResourceStr](ts-types.md#resourcestr) | Yes  | Text for the tab.|
+
+### Attributes
+
+The following attributes are supported.
+
+| Name        | Type                                                    | Description                                                        |
+| ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| indicator<sup>10+</sup> | [IndicatorStyle](#indicatorstyle10)| Underline indicator style of the selected subtab. It is valid only in the horizontal layout.<br>               |
+| selectedMode<sup>10+</sup> | [SelectedMode](#selectedmode10)   | Display mode of the selected subtab.<br>Default value: **SelectedMode.INDICATOR**|
+| board<sup>10+</sup> | [BoardStyle](#boardstyle10)   | Board style of the selected subtab.|
+| labelStyle<sup>10+</sup> | [LabelStyle](#labelstyle10) | Label text and font style of the selected subtab.|
+
+## IndicatorStyle<sup>10+</sup>
+
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------------------------------- |
+| color | [ResourceColor](ts-types.md#resourcecolor) | No| Underline indicator color and board color.<br>Default value: **#FF007DFF**|
+| height | [Length](ts-types.md#length) | No| Height of the underline indicator.<br>Default value: **2.0**<br>Unit: vp|
+| width | [Length](ts-types.md#length) | No| Width of the underline indicator.<br>Default value: **0.0**<br>Unit: vp|
+| borderRadius | [Length](ts-types.md#length) | No| Radius of the rounded corner of the underline indicator.<br>Default value: **0.0**<br>Unit: vp|
+| marginTop | [Length](ts-types.md#length) | No| Spacing between the underline indicator and text.<br>Default value: **8.0**<br>Unit: vp|
+
+## SelectedMode<sup>10+</sup>
+| Name      | Description                    |
+| ---------- | ------------------------ |
+| INDICATOR | Underline indicator mode.    |
+| BOARD   | Board mode.    |
+
+## BoardStyle<sup>10+</sup>
+
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | ------------------------------------ |
+| borderRadius | [Length](ts-types.md#length) | No| Radius of the rounded corner of the underline indicator.<br>Default value: **8.0**<br>Unit: vp|
+
+## LabelStyle<sup>10+</sup>
+
+| Name                | Type                                                    | Mandatory| Description                                                        |
+| -------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| overflow             | [TextOverflow](ts-appendix-enums.md#textoverflow)            | No  | Display mode when the label text is too long. By default, an ellipsis (...) is used to represent text overflow.|
+| maxLines             | number                                                       | No  | Maximum number of lines in the label text. By default, text is automatically folded. If this attribute is specified, the text will not exceed the specified number of lines. If there is extra text, you can use **textOverflow** to specify how it is displayed.|
+| minFontSize          | number \| [ResourceStr](ts-types.md#resourcestr)             | No  | Minimum font size of the label text. For the setting to take effect, this attribute must be used together with **maxFontSize**, **maxLines**, or layout constraint settings.|
+| maxFontSize          | number \| [ResourceStr](ts-types.md#resourcestr)             | No  | Maximum font size of the label text. For the setting to take effect, this attribute must be used together with **minFontSize**, **maxLines**, or layout constraint settings.|
+| heightAdaptivePolicy | [TextHeightAdaptivePolicy](ts-appendix-enums.md#textheightadaptivepolicy10) | No  | How the adaptive height is determined for the label text.                             |
+| font                 | [Font](ts-types.md#font)                                     | No  | Font of the label text.                                     |
 
 ## BottomTabBarStyle<sup>9+</sup>
 
 Implements the bottom and side tab style.
 
-### constructor<sup>9+</sup>
+### constructor
 
-constructor(icon: string | Resource, text: string | Resource)
+constructor(icon: string | Resource, content: string | Resource)
 
 A constructor used to create a **BottomTabBarStyle** instance.
 
@@ -61,8 +123,20 @@ A constructor used to create a **BottomTabBarStyle** instance.
 
 | Name| Type        | Mandatory| Description|
 | -------- | -------- | -------- | -------- |
-| icon | string \| [Resource](ts-types.md#resource) | Yes| Image for the tab.|
-| text | string \| [Resource](ts-types.md#resource) | Yes| Text for the tab.|
+| icon | string \| [Resource](ts-types.md#resource) | Yes| Image for the tab. Since API version 10, the type of **icon** is **ResourceStr**.|
+| text | string \| [Resource](ts-types.md#resource) | Yes| Text for the tab. Since API version 10, the type of **text** is **ResourceStr**.|
+
+### of<sup>10+</sup>
+
+static of(icon: ResourceStr, text: ResourceStr)
+Static constructor used to create a **BottomTabBarStyle** instance.
+
+**Parameters**
+
+| Name| Type        | Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| icon | [ResourceStr](ts-types.md#resourcestr) | Yes| Image for the tab.|
+| text | [ResourceStr](ts-types.md#resourcestr) | Yes| Text for the tab.|
 
 ## Example
 
@@ -325,3 +399,4 @@ struct TabBarStyleExample {
 ```
 
 ![tabbarStyle](figures/TabBarStyle.jpeg)
+<!--no_check-->
\ No newline at end of file

en/application-dev/reference/arkui-ts/ts-container-tabs.md

@@ -2,7 +2,7 @@
 
 The **\<Tabs>** component is a container component that allows users to switch between content views through tabs. Each tab page corresponds to a content view.
 
->  **NOTE**<br>
+>  **NOTE**
 >
 >  This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
 
@@ -18,16 +18,16 @@ Tabs(value?: {barPosition?: BarPosition, index?: number, controller?: [TabsContr
 
 **Parameters**
 
-| Name| Type| Mandatory| Description|
-| -------- | -------- | -------- | -------- |
-| barPosition | BarPosition | No| Position of the **\<Tabs>** component.<br>Default value: **BarPosition.Start**|
-| index | number | No| Initial tab index.<br>Default value: **0**|
-| controller | [TabsController](#tabscontroller) | No| Tab controller.|
+| Name        | Type                             | Mandatory  | Description                                    |
+| ----------- | --------------------------------- | ---- | ---------------------------------------- |
+| barPosition | BarPosition                       | No   | Position of the **\<Tabs>** component.<br>Default value: **BarPosition.Start**  |
+| index       | number                            | No   | Initial tab index.<br>Default value: **0**<br>**NOTE**<br><br>A value less than 0 evaluates to the default value.<br>The value ranges from 0 to the number of **\<TabContent>** subnodes minus 1.<br>When this parameter is set to different values, the slide animation for tab switching is enabled by default. To disable the animation, set **animationDuration** to **0**.|
+| controller  | [TabsController](#tabscontroller) | No   | Tab controller.                              |
 
 ## BarPosition
 
-| Name| Description|
-| -------- | -------- |
+| Name   | Description                                      |
+| ----- | ---------------------------------------- |
 | Start | If the **vertical** attribute is set to **true**, the tab is on the left of the container. If the **vertical** attribute is set to **false**, the tab is on the top of the container.|
 | End   | If the **vertical** attribute is set to **true**, the tab is on the right of the container. If the **vertical** attribute is set to **false**, the tab is at the bottom of the container.|
 
@@ -36,29 +36,40 @@ Tabs(value?: {barPosition?: BarPosition, index?: number, controller?: [TabsContr
 
 In addition to the [universal attributes](ts-universal-attributes-size.md), the following attributes are supported.
 
-| Name| Type| Description|
-| -------- | -------- | -------- |
+| Name                      | Type                                    | Description                                      |
+| ------------------------ | ---------------------------------------- | ---------------------------------------- |
 | vertical                 | boolean                                  | Whether to use vertical tabs. The value **true** means to use vertical tabs, and **false** means to use horizontal tabs.<br>Default value: **false**|
 | scrollable               | boolean                                  | Whether the tabs are scrollable. The value **true** means that the tabs are scrollable, and **false** means the opposite.<br>Default value: **true**|
 | barMode                  | BarMode                                  | Tab bar layout mode. For details, see **BarMode**.<br>Default value: **BarMode.Fixed**|
-| barWidth          | number \| Length<sup>8+</sup>  | Width of the tab bar.    |
-| barHeight         | number \| Length<sup>8+</sup>  | Height of the tab bar.    |
-| animationDuration | number | Duration of the slide animation for tab switching. If this parameter is set, the tab switching animation is played when the user switches between tabs by sliding or clicking. If this parameter is not set, the tab switching animation is played only when the user switches between tabs by sliding.<br>Default value: **200**|
+| barWidth                 | number \| Length<sup>8+</sup>  | Width of the tab bar.<br>**NOTE**<br><br>A value less than 0 or greater than the width of the **\<Tabs>** component evaluates to the default value.|
+| barHeight                | number \| Length<sup>8+</sup>  | Height of the tab bar.<br>**NOTE**<br><br>A value less than 0 or greater than the width of the **\<Tabs>** component evaluates to the default value.|
+| animationDuration        | number                                   | Duration of the slide animation for tab switching. If this parameter is set, the tab switching animation is played when the user switches between tabs by sliding or clicking. If this parameter is not set, the tab switching animation is played only when the user switches between tabs by sliding.<br>Default value: **300**<br>**NOTE**<br>A value less than 0 or in percentage evaluates to the default value. |
+| divider<sup>10+</sup>    | [DividerStyle](#dividerstyle10) \| null | Whether the divider is displayed for the **\<TabBar>** and **\<TabContent>** components and the divider style. By default, the divider is not displayed.<br> **DividerStyle**: divider style.<br> **null**: The divider is not displayed.|
+| FadingEdge<sup>10+</sup> | boolean                                  | Whether the tab fades out when it exceeds the container width.<br>Default value: **true**         |
+
+## DividerStyle<sup>10+</sup>
+
+| Name         | Type                                    | Mandatory  | Description                                 |
+| ----------- | ---------------------------------------- | ---- | ----------------------------------- |
+| strokeWidth | [Length](ts-types.md#length)             | Yes   | Width of the divider.                            |
+| color       | [ResourceColor](ts-types.md#resourcecolor) | No   | Color of the divider.<br>Default value: **#33182431**          |
+| startMargin | [Length](ts-types.md#length)             | No   | Distance between the divider and the top of the sidebar.<br>Default value: **0.0**<br>Unit: vp|
+| endMargin   | [Length](ts-types.md#length)             | No   | Distance between the divider and the bottom of the sidebar.<br>Default value: **0.0**<br>Unit: vp|
 
 ## BarMode
 
-| Name| Description|
-| -------- | -------- |
+| Name        | Description                                      |
+| ---------- | ---------------------------------------- |
 | Scrollable | The width of each tab is determined by the actual layout. The tabs are scrollable in the following case: In horizontal layout, the total width exceeds the tab bar width; in horizontal layout, the total height exceeds the tab bar height.|
-| Fixed | The width of each tab is determined by equally dividing the number of tabs by the bar width (or the bar height in vertical layout).|
+| Fixed      | The width of each tab is determined by equally dividing the number of tabs by the bar width (or bar height in the vertical layout).|
 
 ## Events
 
 In addition to the [universal events](ts-universal-events-click.md), the following events are supported.
 
-| Name| Description|
-| -------- | -------- |
-| onChange(event: (index: number) =&gt; void) | Event triggered when a tab is switched.|
+| Name                                        | Description                                                  |
+| ------------------------------------------- | ------------------------------------------------------------ |
+| onChange(event: (index: number) =&gt; void) | Triggered when a tab is switched.<br>- **index**: index of the active tab. The index starts from 0.<br>This event is triggered when any of the following conditions is met:<br>1. The **\<TabContent>** component supports sliding, and the user slides on the tab bar.<br>2. The [Controller](#tabscontroller) API is called.<br>3. The attribute value is updated using a [state variable](../../quick-start/arkts-state.md).<br>4. A tab is clicked. |
 
 ## TabsController
 
@@ -66,9 +77,8 @@ Defines a tab controller, which is used to control switching of tabs. One **Tabs
 
 ### Objects to Import
 
-```
+```ts
 controller: TabsController = new TabsController()
-
 ```
 
 ### changeIndex
@@ -79,9 +89,9 @@ Switches to the specified tab.
 
 **Parameters**
 
-| Name| Type| Mandatory| Description|
-| -------- | -------- | -------- | -------- |
-| value | number | Yes| Index of the tab. The value starts from 0.|
+| Name  | Type  | Mandatory  | Description                                    |
+| ----- | ------ | ---- | ---------------------------------------- |
+| value | number | Yes   | Index of the tab. The value starts from 0.<br>**NOTE**<br><br>If this parameter is set to a value less than 0 or greater than the maximum number, the event will be invalid.|
 
 
 ## Example
@@ -148,3 +158,4 @@ struct TabsExample {
 ```
 
 ![tabs2](figures/tabs2.gif)
+<!--no_check-->
\ No newline at end of file

en/application-dev/reference/arkui-ts/ts-drawing-components-circle.md

@@ -37,10 +37,10 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeDashArray | Array&lt;Length&gt; | Stroke dashes.<br>Default value: **[]**<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeDashOffset | number \| string  | Offset of the start point for drawing the stroke.<br>Default value: **0**<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeLineCap | [LineCapStyle](ts-appendix-enums.md#linecapstyle) | Cap style of the stroke.<br>Default value: **LineCapStyle.Butt**<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | Join style of the stroke.<br>Default value: **LineJoinStyle.Miter**<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | Join style of the stroke.<br>Default value: **LineJoinStyle.Miter**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>This attribute does not work for the **\<circle>** component, which does not have corners.|
 | strokeMiterLimit | number \| string | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join.<br>Default value: **4**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>This attribute does not take effect for the **\<Circle>** component, because it does not have a miter join.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| Stroke opacity.<br>Default value: **1**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.|
-| strokeWidth | Length | Stroke width.<br>Default value: **1**<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | Stroke width.<br>Default value: **1**<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | Whether anti-aliasing is enabled.<br>Default value: **true**<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 

en/application-dev/reference/arkui-ts/ts-drawing-components-ellipse.md

@@ -37,10 +37,10 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeDashArray | Array&lt;Length&gt; | [] | Stroke dashes.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeDashOffset | number \| string | 0 | Offset of the start point for drawing the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeLineCap | [LineCapStyle](ts-appendix-enums.md#linecapstyle) | LineCapStyle.Butt | Cap style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>This attribute does not work for the **\<ellipse>** component, which does not have corners.|
 | strokeMiterLimit | number \| string | 4 | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>This attribute does not take effect for the **\<Ellipse>** component, because it does not have a miter join.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Stroke opacity.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.|
-| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 

en/application-dev/reference/arkui-ts/ts-drawing-components-line.md

@@ -39,10 +39,10 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeDashArray | Array&lt;Length&gt; | [] | Stroke dashes.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeDashOffset | number \| string | 0 | Offset of the start point for drawing the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeLineCap | [LineCapStyle](ts-appendix-enums.md#linecapstyle) | LineCapStyle.Butt | Cap style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>This attribute does not work for the **\<Line>** component, which does not have corners. |
 | strokeMiterLimit | number \| string | 4 | Limit value when the sharp angle is drawn as a miter.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>This attribute does not take effect because the **\<Line>** component cannot be used to draw a shape with a sharp angle.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Stroke opacity.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.|
-| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 ## Example
@@ -58,35 +58,41 @@ struct LineExample {
     Column({ space: 10 }) {
       // The coordinates of the start and end points of the line are determined relative to the coordinates of the drawing area of the <Line> component.
       Line()
+        .width(200)
+        .height(150)
         .startPoint([0, 0])
         .endPoint([50, 100])
         .stroke(Color.Black)
         .backgroundColor('#F5F5F5')
       Line()
         .width(200)
-        .height(200)
+        .height(150)
         .startPoint([50, 50])
         .endPoint([150, 150])
         .strokeWidth(5)
         .stroke(Color.Orange)
         .strokeOpacity(0.5)
         .backgroundColor('#F5F5F5')
-      // If the coordinates of a point are beyond the width and height range of the <Line> component, the line will exceed the drawing area.
-      Line({ width: 50, height: 50 })
+      // strokeDashOffset is used to define the offset when the associated strokeDashArray array is rendered.
+      Line()
+        .width(200)
+        .height(150)
         .startPoint([0, 0])
         .endPoint([100, 100])
         .stroke(Color.Black)
         .strokeWidth(3)
         .strokeDashArray([10, 3])
+        .strokeDashOffset(5)
         .backgroundColor('#F5F5F5')
-      // strokeDashOffset is used to define the offset when the associated strokeDashArray array is rendered.
-      Line({ width: 50, height: 50 })
+      // If the coordinates of a point are beyond the width and height range of the <Line> component, the line will exceed the drawing area.
+      Line()
+        .width(50)
+        .height(50)
         .startPoint([0, 0])
         .endPoint([100, 100])
         .stroke(Color.Black)
         .strokeWidth(3)
         .strokeDashArray([10, 3])
-        .strokeDashOffset(5)
         .backgroundColor('#F5F5F5')
     }
   }
@@ -151,12 +157,16 @@ struct LineExample {
   build() {
     Column() {
       Line()
+        .width(300)
+        .height(30)
         .startPoint([50, 30])
         .endPoint([300, 30])
         .stroke(Color.Black)
         .strokeWidth(10)
       // Set the interval for strokeDashArray to 50.
       Line()
+        .width(300)
+        .height(30)
         .startPoint([50, 20])
         .endPoint([300, 20])
         .stroke(Color.Black)
@@ -164,6 +174,8 @@ struct LineExample {
         .strokeDashArray([50])
       // Set the interval for strokeDashArray to 50, 10.
       Line()
+        .width(300)
+        .height(30)
         .startPoint([50, 20])
         .endPoint([300, 20])
         .stroke(Color.Black)
@@ -171,6 +183,8 @@ struct LineExample {
         .strokeDashArray([50, 10])
       // Set the interval for strokeDashArray to 50, 10, 20.
       Line()
+        .width(300)
+        .height(30)
         .startPoint([50, 20])
         .endPoint([300, 20])
         .stroke(Color.Black)
@@ -178,6 +192,8 @@ struct LineExample {
         .strokeDashArray([50, 10, 20])
       // Set the interval for strokeDashArray to 50, 10, 20, 30.
       Line()
+        .width(300)
+        .height(30)
         .startPoint([50, 20])
         .endPoint([300, 20])
         .stroke(Color.Black)

en/application-dev/reference/arkui-ts/ts-drawing-components-path.md

@@ -41,7 +41,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeMiterLimit | number \| string | 4 | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join. The miter length indicates the distance from the outer tip to the inner corner of the miter.<br>**NOTE**<br>This attribute must be set to a value greater than or equal to 1 and takes effect when **strokeLineJoin** is set to **LineJoinStyle.Miter**.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Opacity of the stroke.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeWidth | Length | 1 | Width of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | 1 | Width of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 The supported commands are as follows:
@@ -74,9 +74,10 @@ struct PathExample {
         .fontSize(11)
         .fontColor(0xCCCCCC)
         .width('90%')
-      // Draw a straight line whose length is 900 px and width is 3 vp.
+      // Draw a straight line whose length is 600 px and width is 3 vp.
       Path()
-        .height(10)
+        .width('600px')
+        .height('10px')
         .commands('M0 0 L600 0')
         .stroke(Color.Black)
         .strokeWidth(3)
@@ -88,16 +89,22 @@ struct PathExample {
       // Draw a straight line.
       Flex({ justifyContent: FlexAlign.SpaceBetween }) {
         Path()
+          .width('210px')
+          .height('310px')
           .commands('M100 0 L200 240 L0 240 Z')
           .fillOpacity(0)
           .stroke(Color.Black)
           .strokeWidth(3)
         Path()
+          .width('210px')
+          .height('310px')
           .commands('M0 0 H200 V200 H0 Z')
           .fillOpacity(0)
           .stroke(Color.Black)
           .strokeWidth(3)
         Path()
+          .width('210px')
+          .height('310px')
           .commands('M100 0 L0 100 L50 200 L150 200 L200 100 Z')
           .fillOpacity(0)
           .stroke(Color.Black)
@@ -108,16 +115,22 @@ struct PathExample {
       // Draw an arc.
       Flex({ justifyContent: FlexAlign.SpaceBetween }) {
         Path()
+          .width('250px')
+          .height('310px')
           .commands("M0 300 S100 0 240 300 Z")
           .fillOpacity(0)
           .stroke(Color.Black)
           .strokeWidth(3)
         Path()
+          .width('210px')
+          .height('310px')
           .commands('M0 150 C0 100 140 0 200 150 L100 300 Z')
           .fillOpacity(0)
           .stroke(Color.Black)
           .strokeWidth(3)
         Path()
+          .width('210px')
+          .height('310px')
           .commands('M0 100 A30 20 20 0 0 200 100 Z')
           .fillOpacity(0)
           .stroke(Color.Black)

en/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md

@@ -42,7 +42,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeMiterLimit | number \| string | 4 | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join. The miter length indicates the distance from the outer tip to the inner corner of the miter.<br>**NOTE**<br>This attribute must be set to a value greater than or equal to 1 and takes effect when **strokeLineJoin** is set to **LineJoinStyle.Miter**.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Stroke opacity.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 ## Point

en/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md

@@ -42,7 +42,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeMiterLimit | number \| string | 4 | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join. The miter length indicates the distance from the outer tip to the inner corner of the miter.<br>**NOTE**<br>This attribute must be set to a value greater than or equal to 1 and takes effect when **strokeLineJoin** is set to **LineJoinStyle.Miter**.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Stroke opacity.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 ## Point

en/application-dev/reference/arkui-ts/ts-drawing-components-rect.md

@@ -48,7 +48,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeMiterLimit | number \| string | 4 | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join. The miter length indicates the distance from the outer tip to the inner corner of the miter.<br>**NOTE**<br>This attribute must be set to a value greater than or equal to 1 and takes effect when **strokeLineJoin** is set to **LineJoinStyle.Miter**.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Stroke opacity.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | Length | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>The value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
 

en/application-dev/reference/arkui-ts/ts-drawing-components-shape.md

@@ -36,7 +36,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 
 | Name| Type| Default Value| Description|
 | -------- | -------- | -------- | -------- |
-| viewPort | {<br>x?: number \| string,<br>y?: number \| string,<br>width?: number \| string,<br>height?: number \| string<br>} | { x:0, y:0, width:0, height:0 } | View port of the shape.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| viewPort | {<br>x?: number \| string,<br>y?: number \| string,<br>width?: number \| string,<br>height?: number \| string<br>} | { x:0, y:0, width:0, height:0 } | View port of the shape.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>If of the string type, the value cannot be a percentage.|
 | fill | [ResourceColor](ts-types.md) | Color.Black | Color of the fill area.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | fillOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Opacity of the fill area.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | stroke | [ResourceColor](ts-types.md) | - | Stroke color. If this attribute is not set, the component does not have any stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
@@ -46,7 +46,7 @@ In addition to the [universal attributes](ts-universal-attributes-size.md), the
 | strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | Join style of the stroke.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeMiterLimit | number \| string | 4 | Limit on the ratio of the miter length to the value of **strokeWidth** used to draw a miter join. The miter length indicates the distance from the outer tip to the inner corner of the miter.<br>**NOTE**<br>This attribute must be set to a value greater than or equal to 1 and takes effect when **strokeLineJoin** is set to **LineJoinStyle.Miter**.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | strokeOpacity | number \| string \| [Resource](ts-types.md#resource)| 1 | Stroke opacity.<br>**NOTE**<br>The value range is [0.0, 1.0]. If the set value is less than 0.0, **0.0** will be used. If the set value is greater than 1.0, **1.0** will be used.<br>Since API version 9, this API is supported in ArkTS widgets.|
-| strokeWidth | number \| string | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.|
+| strokeWidth | number \| string | 1 | Stroke width.<br>Since API version 9, this API is supported in ArkTS widgets.<br>**NOTE**<br>If of the string type, the value cannot be a percentage.|
 | antiAlias | boolean | true | Whether anti-aliasing is enabled.<br>Since API version 9, this API is supported in ArkTS widgets.|
 | mesh<sup>8+</sup> | Array&lt;number&gt;,number,number | [],0,0 | Mesh effect. The first parameter is an array of lengths (column + 1) * (row + 1) * 2, which records the position of each vertex of the distorted bitmap. The second parameter is the number of columns in the mesh matrix. The third parameter is the number of rows in the mesh matrix.<br>Since API version 9, this API is supported in ArkTS widgets.|
 
@@ -70,6 +70,8 @@ struct ShapeExample {
         Ellipse().width(300).height(50).offset({ x: 0, y: 60 })
         Path().width(300).height(10).commands('M0 0 L900 0').offset({ x: 0, y: 120 })
       }
+      .width(350)
+      .height(140)
       .viewPort({ x: -2, y: -2, width: 304, height: 130 })
       .fill(0x317AF7)
       .stroke(Color.Black)
@@ -83,6 +85,8 @@ struct ShapeExample {
       Shape() {
         Rect().width(300).height(50)
       }
+      .width(350)
+      .height(80)
       .viewPort({ x: 0, y: 0, width: 320, height: 70 })
       .fill(0x317AF7)
       .stroke(Color.Black)
@@ -91,6 +95,8 @@ struct ShapeExample {
       Shape() {
         Rect().width(300).height(50)
       }
+      .width(350)
+      .height(80)
       .viewPort({ x: -5, y: -5, width: 320, height: 70 })
       .fill(0x317AF7)
       .stroke(Color.Black)
@@ -101,6 +107,8 @@ struct ShapeExample {
       Shape() {
         Path().width(300).height(10).commands('M0 0 L900 0')
       }
+      .width(350)
+      .height(20)
       .viewPort({ x: 0, y: -5, width: 300, height: 20 })
       .stroke(0xEE8443)
       .strokeWidth(10)
@@ -109,6 +117,8 @@ struct ShapeExample {
       Shape() {
         Path().width(300).height(10).commands('M0 0 L900 0')
       }
+      .width(350)
+      .height(20)
       .viewPort({ x: 0, y: -5, width: 300, height: 20 })
       .stroke(0xEE8443)
       .strokeWidth(10)
@@ -118,6 +128,8 @@ struct ShapeExample {
       Shape() {
         Path().width(300).height(10).commands('M0 0 L900 0')
       }
+      .width(350)
+      .height(20)
       .viewPort({ x: 0, y: -5, width: 300, height: 20 })
       .stroke(0xEE8443)
       .strokeWidth(10)
@@ -126,6 +138,8 @@ struct ShapeExample {
       Shape() {
         Path().width(300).height(10).commands('M0 0 L900 0')
       }
+      .width(350)
+      .height(20)
       .viewPort({ x: 0, y: -5, width: 300, height: 20 })
       .stroke(0xEE8443)
       .strokeWidth(10)
@@ -135,7 +149,9 @@ struct ShapeExample {
       Shape() {
         Path().width(200).height(60).commands('M0 0 L400 0 L400 150 Z')
       }
-      .viewPort({ x: -80, y: -5, width: 310, height: 90 })
+      .width(300)
+      .height(200)
+      .viewPort({ x: -20, y: -5, width: 310, height: 90 })
       .fill(0x317AF7)
       .stroke(0xEE8443)
       .strokeWidth(10)
@@ -147,3 +163,4 @@ struct ShapeExample {
 ```
 
 ![en-us_image_0000001184628104](figures/en-us_image_0000001184628104.png)
+ 

en/application-dev/reference/js-service-widget-ui/js-service-widget-basic-span.md

@@ -23,7 +23,7 @@ The [universal attributes](js-service-widget-common-attributes.md) are supported
 | Name| Type| Default Value| Mandatory| Description|
 | -------- | -------- | -------- | -------- | -------- |
 | color | <color> | - | No| Font color of the modified text.|
-| font-size | <length> | 30px | No| Font size of the modified text.|
+| font-size | <length> | 16px | No| Font size of the modified text.|
 | font-style | string | normal | No| Font style of the modified text. For details, see **font-style** of the [**\<text>**](js-service-widget-basic-text.md#styles) component.|
 | font-weight | number \| string | normal | No| Font weight of the modified text. For details, see **font-weight** of the [**\<text>**](js-service-widget-basic-text.md##styles) component.|
 | text-decoration | string | none | No| Text decoration of the modified text. For details, see **text-decoration** of the [**\<text>**](js-service-widget-basic-text.md#styles) component.|

en/application-dev/reference/js-service-widget-ui/js-service-widget-basic-text.md

@@ -25,7 +25,7 @@ In addition to the [universal styles](js-service-widget-common-styles.md), the f
 | Name| Type| Default Value| Mandatory| Description|
 | -------- | -------- | -------- | -------- | -------- |
 | color | <color> | - | No| Font color.|
-| font-size | <length> | 30px | No| Font size.|
+| font-size | <length> | 16px | No| Font size.|
 | letter-spacing | <length> | 0px | No| Character spacing (px).|
 | font-style | string | normal | No| Font style. Available values are as follows:<br>- **normal**: standard font style<br>- **italic**: italic font style|
 | font-weight | number \| string | normal | No| Font weight. For the number type, the value ranges from 100 to 900. The default value is 400. A larger value indicates a heavier font weight.<br>The value of the number type must be an integer multiple of 100.<br>The value of the string type can be **lighter**, **normal**, **bold**, or **bolder**.|

en/application-dev/reference/native-apis/Readme-EN.md

+# Native API
+
+- Modules
+  - [Native XComponent](_o_h___native_x_component.md)
+  - [HiLog](_hi_log.md)
+  - [NativeWindow](_native_window.md)
+  - [Drawing](_drawing.md)
+  - [Image](image.md)
+  - [Rawfile](rawfile.md)
+  - [MindSpore](_mind_spore.md)
+  - [NeuralNeworkRuntime](_neural_nework_runtime.md)
+  - [AudioDecoder](_audio_decoder.md)
+  - [AudioEncoder](_audio_encoder.md)
+  - [CodecBase](_codec_base.md)
+  - [VideoDecoder](_video_decoder.md)
+  - [VideoEncoder](_video_encoder.md)
+  - [Core](_core.md)
+  - [HuksKeyApi](_huks_key_api.md)
+  - [HuksParamSetApi](_huks_param_set_api.md)
+  - [HuksTypeApi](_huks_type_api.md)
+- Header Files
+  - [drawing_bitmap.h](drawing__bitmap_8h.md)
+  - [drawing_brush.h](drawing__brush_8h.md)
+  - [drawing_canvas.h](drawing__canvas_8h.md)
+  - [drawing_color.h](drawing__color_8h.md)
+  - [drawing_font_collection.h](drawing__font__collection_8h.md)
+  - [drawing_path.h](drawing__path_8h.md)
+  - [drawing_pen.h](drawing__pen_8h.md)
+  - [drawing_text_declaration.h](drawing__text__declaration_8h.md)
+  - [drawing_text_typography.h](drawing__text__typography_8h.md)
+  - [drawing_types.h](drawing__types_8h.md)
+  - [external_window.h](external__window_8h.md)
+  - [image_pixel_map_napi.h](image__pixel__map__napi_8h.md)
+  - [log.h](log_8h.md)
+  - [native_interface_xcomponent.h](native__interface__xcomponent_8h.md)
+  - [raw_dir.h](raw__dir_8h.md)
+  - [raw_file_manager.h](raw__file__manager_8h.md)
+  - [raw_file.h](raw__file_8h.md)
+  - [context.h](context_8h.md)
+  - [data_type.h](data__type_8h.md)
+  - [format.h](format_8h.md)
+  - [model.h](model_8h.md)
+  - [status.h](status_8h.md)
+  - [tensor.h](tensor_8h.md)
+  - [types.h](types_8h.md)
+  - [neural_network_runtime_type.h](neural__network__runtime__type_8h.md)
+  - [neural_network_runtime.h](neural__network__runtime_8h.md)
+  - [native_avcodec_audiodecoder.h](native__avcodec__audiodecoder_8h.md)
+  - [native_avcodec_audioencoder.h](native__avcodec__audioencoder_8h.md)
+  - [native_avcodec_base.h](native__avcodec__base_8h.md)
+  - [native_avcodec_videodecoder.h](native__avcodec__videodecoder_8h.md)
+  - [native_avcodec_videoencoder.h](native__avcodec__videoencoder_8h.md)
+  - [native_averrors.h](native__averrors_8h.md)
+  - [native_avformat.h](native__avformat_8h.md)
+  - [native_avmemory.h](native__avmemory_8h.md)
+  - [native_huks_api.h](native__huks__api_8h.md)
+  - [native_huks_param.h](native__huks__param_8h.md)
+  - [native_huks_type.h](native__huks__type_8h.md)
+- Structs
+  - [OH_Drawing_BitmapFormat](_o_h___drawing___bitmap_format.md)
+  - [OH_NativeXComponent_Callback](_o_h___native_x_component___callback.md)
+  - [OH_NativeXComponent_MouseEvent](_o_h___native_x_component___mouse_event.md)
+  - [OH_NativeXComponent_MouseEvent_Callback](_o_h___native_x_component___mouse_event___callback.md)
+  - [OH_NativeXComponent_TouchEvent](_o_h___native_x_component___touch_event.md)
+  - [OH_NativeXComponent_TouchPoint](_o_h___native_x_component___touch_point.md)
+  - [OHExtDataHandle](_o_h_ext_data_handle.md)
+  - [OHHDRMetaData](_o_h_h_d_r_meta_data.md)
+  - [OhosPixelMapCreateOps](_ohos_pixel_map_create_ops.md)
+  - [OhosPixelMapInfo](_ohos_pixel_map_info.md)
+  - [RawFileDescriptor](_raw_file_descriptor.md)
+  - [Region](_region.md)
+  - [Rect](_rect.md)
+  - [OH_AI_CallBackParam](_o_h___a_i___call_back_param.md)
+  - [OH_AI_ShapeInfo](_o_h___a_i___shape_info.md)
+  - [OH_AI_TensorHandleArray](_o_h___a_i___tensor_handle_array.md)
+  - [OH_NN_Memory](_o_h___n_n___memory.md)
+  - [OH_NN_QuantParam](_o_h___n_n___quant_param.md)
+  - [OH_NN_Tensor](_o_h___n_n___tensor.md)
+  - [OH_NN_UInt32Array](_o_h___n_n___u_int32_array.md)
+  - [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md)
+  - [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md)
+  - [OH_Huks_Blob](_o_h___huks___blob.md)
+  - [OH_Huks_CertChain](_o_h___huks___cert_chain.md)
+  - [OH_Huks_KeyInfo](_o_h___huks___key_info.md)
+  - [OH_Huks_KeyMaterial25519](_o_h___huks___key_material25519.md)
+  - [OH_Huks_KeyMaterialDh](_o_h___huks___key_material_dh.md)
+  - [OH_Huks_KeyMaterialDsa](_o_h___huks___key_material_dsa.md)
+  - [OH_Huks_KeyMaterialEcc](_o_h___huks___key_material_ecc.md)
+  - [OH_Huks_KeyMaterialRsa](_o_h___huks___key_material_rsa.md)
+  - [OH_Huks_Param](_o_h___huks___param.md)
+  - [OH_Huks_ParamSet](_o_h___huks___param_set.md)
+  - [OH_Huks_PubKeyInfo](_o_h___huks___pub_key_info.md)
+  - [OH_Huks_Result](_o_h___huks___result.md)

en/application-dev/reference/native-apis/_audio_decoder.md

+# AudioDecoder
+
+
+## Overview
+
+Provides the functions for audio decoding.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+**Since:**
+9
+
+
+## Summary
+
+
+### Files
+
+| Name | Description | 
+| -------- | -------- |
+| [native_avcodec_audiodecoder.h](native__avcodec__audiodecoder_8h.md) | Declares the native APIs used for audio decoding. <br>File to Include: <multimedia/player_framework/native_avcodec_audiodecoder.h>  | 
+
+
+### Functions
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AudioDecoder_CreateByMime](#oh_audiodecoder_createbymime) (const char \*mime) | Creates an audio decoder instance based on a Multipurpose Internet Mail Extension (MIME) type. This API is recommended in most cases.  | 
+| [OH_AudioDecoder_CreateByName](#oh_audiodecoder_createbyname) (const char \*name) | Creates an audio decoder instance based on an audio decoder name. To use this API, you must know the exact name of the audio decoder.  | 
+| [OH_AudioDecoder_Destroy](#oh_audiodecoder_destroy) (OH_AVCodec \*codec) | Clears the internal resources of an audio decoder and destroys the audio decoder instance.  | 
+| [OH_AudioDecoder_SetCallback](#oh_audiodecoder_setcallback) (OH_AVCodec \*codec, [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md) callback, void \*userData) | Sets an asynchronous callback so that your application can respond to events generated by an audio decoder. This API must be called prior to **Prepare**.  | 
+| [OH_AudioDecoder_Configure](#oh_audiodecoder_configure) (OH_AVCodec \*codec, OH_AVFormat \*format) | Configures an audio decoder. Typically, you need to configure the attributes, which can be extracted from the container, of the audio track that can be decoded. This API must be called prior to **Prepare**.  | 
+| [OH_AudioDecoder_Prepare](#oh_audiodecoder_prepare) (OH_AVCodec \*codec) | Prepares internal resources for an audio decoder. This API must be called after **Configure**.  | 
+| [OH_AudioDecoder_Start](#oh_audiodecoder_start) (OH_AVCodec \*codec) | Starts an audio decoder. This API can be called only after the decoder is prepared successfully. After being started, the decoder starts to report the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) event.  | 
+| [OH_AudioDecoder_Stop](#oh_audiodecoder_stop) (OH_AVCodec \*codec) | Stops an audio decoder. After the decoder is stopped, you can call **Start** to start it again. If you have passed codec-specific data in the previous **Start** for the decoder, you must pass it again.  | 
+| [OH_AudioDecoder_Flush](#oh_audiodecoder_flush) (OH_AVCodec \*codec) | Clears the input and output data in the internal buffer of an audio decoder. This API invalidates the indexes of all buffers previously reported through the asynchronous callback. Therefore, before calling this API, ensure that the buffers corresponding to the indexes are no longer required.  | 
+| [OH_AudioDecoder_Reset](#oh_audiodecoder_reset) (OH_AVCodec \*codec) | Resets an audio decoder. To continue decoding, you must call **Configure** and **Start** to configure and start the decoder again.  | 
+| [OH_AudioDecoder_GetOutputDescription](#oh_audiodecoder_getoutputdescription) (OH_AVCodec \*codec) | Obtains the attributes of the output data of an audio decoder. The caller must manually release the **OH_AVFormat** instance in the return value.  | 
+| [OH_AudioDecoder_SetParameter](#oh_audiodecoder_setparameter) (OH_AVCodec \*codec, OH_AVFormat \*format) | Sets dynamic parameters for an audio decoder. This API can be called only after the decoder is started. Incorrect parameter settings may cause decoding failure.  | 
+| [OH_AudioDecoder_PushInputData](#oh_audiodecoder_pushinputdata) (OH_AVCodec \*codec, uint32_t index, [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md) attr) | Pushes the input buffer filled with data to an audio decoder. The [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback reports available input buffers and their indexes. After being pushed to the decoder, a buffer is not accessible until the buffer with the same index is reported again through the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback. In addition, some decoders require the input of codec-specific data to initialize the decoding process.  | 
+| [OH_AudioDecoder_FreeOutputData](#oh_audiodecoder_freeoutputdata) (OH_AVCodec \*codec, uint32_t index) | Frees an output buffer of an audio decoder.  | 
+
+
+## Function Description
+
+
+### OH_AudioDecoder_Configure()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Configure (OH_AVCodec * codec, OH_AVFormat * format )
+```
+**Description**<br>
+Configures an audio decoder. Typically, you need to configure the attributes, which can be extracted from the container, of the audio track that can be decoded. This API must be called prior to **Prepare**.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| format | Indicates the handle to an **OH_AVFormat** instance, which provides the attributes of the audio track to be decoded.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_CreateByMime()
+
+  
+```
+OH_AVCodec* OH_AudioDecoder_CreateByMime (const char * mime)
+```
+**Description**<br>
+Creates an audio decoder instance based on a Multipurpose Internet Mail Extension (MIME) type. This API is recommended in most cases.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| mime | Indicates the pointer to a MIME type. For details, see [OH_AVCODEC_MIMETYPE_AUDIO_AAC](_codec_base.md#oh_avcodec_mimetype_audio_aac).  | 
+
+**Returns**
+
+Returns the pointer to an **OH_AVCodec** instance.
+
+
+### OH_AudioDecoder_CreateByName()
+
+  
+```
+OH_AVCodec* OH_AudioDecoder_CreateByName (const char * name)
+```
+**Description**<br>
+Creates an audio decoder instance based on an audio decoder name. To use this API, you must know the exact name of the audio decoder.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| name | Indicates the pointer to an audio decoder name.  | 
+
+**Returns**
+
+Returns the pointer to an **OH_AVCodec** instance.
+
+
+### OH_AudioDecoder_Destroy()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Destroy (OH_AVCodec * codec)
+```
+**Description**<br>
+Clears the internal resources of an audio decoder and destroys the audio decoder instance.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_Flush()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Flush (OH_AVCodec * codec)
+```
+**Description**<br>
+Clears the input and output data in the internal buffer of an audio decoder. This API invalidates the indexes of all buffers previously reported through the asynchronous callback. Therefore, before calling this API, ensure that the buffers corresponding to the indexes are no longer required.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_FreeOutputData()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_FreeOutputData (OH_AVCodec * codec, uint32_t index )
+```
+**Description**<br>
+Frees an output buffer of an audio decoder.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| index | Indicates the index of an output buffer.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_GetOutputDescription()
+
+  
+```
+OH_AVFormat* OH_AudioDecoder_GetOutputDescription (OH_AVCodec * codec)
+```
+**Description**<br>
+Obtains the attributes of the output data of an audio decoder. The caller must manually release the **OH_AVFormat** instance in the return value.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns the handle to an **OH_AVFormat** instance, which must be manually released.
+
+
+### OH_AudioDecoder_Prepare()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Prepare (OH_AVCodec * codec)
+```
+**Description**<br>
+Prepares internal resources for an audio decoder. This API must be called after **Configure**.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_PushInputData()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_PushInputData (OH_AVCodec * codec, uint32_t index, OH_AVCodecBufferAttr attr )
+```
+**Description**<br>
+Pushes the input buffer filled with data to an audio decoder. The [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback reports available input buffers and their indexes. After being pushed to the decoder, a buffer is not accessible until the buffer with the same index is reported again through the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback. In addition, some decoders require the input of codec-specific data to initialize the decoding process.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| index | Indicates the index of an input buffer.  | 
+| attr | Indicates the attributes of the data contained in the buffer.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_Reset()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Reset (OH_AVCodec * codec)
+```
+**Description**<br>
+Resets an audio decoder. To continue decoding, you must call **Configure** and **Start** to configure and start the decoder again.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_SetCallback()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_SetCallback (OH_AVCodec * codec, OH_AVCodecAsyncCallback callback, void * userData )
+```
+**Description**<br>
+Sets an asynchronous callback so that your application can respond to events generated by an audio decoder. This API must be called prior to **Prepare**.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| callback | Indicates a collection of all callback functions. For details, see [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md).  | 
+| userData | Indicates the pointer to user-specific data.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_SetParameter()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_SetParameter (OH_AVCodec * codec, OH_AVFormat * format )
+```
+**Description**<br>
+Sets dynamic parameters for an audio decoder. This API can be called only after the decoder is started. Incorrect parameter settings may cause decoding failure.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_Start()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Start (OH_AVCodec * codec)
+```
+**Description**<br>
+Starts an audio decoder. This API can be called only after the decoder is prepared successfully. After being started, the decoder starts to report the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) event.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioDecoder_Stop()
+
+  
+```
+OH_AVErrCode OH_AudioDecoder_Stop (OH_AVCodec * codec)
+```
+**Description**<br>
+Stops an audio decoder. After the decoder is stopped, you can call **Start** to start it again. If you have passed codec-specific data in the previous **Start** for the decoder, you must pass it again.
+
+\@syscap SystemCapability.Multimedia.Media.AudioDecoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.

en/application-dev/reference/native-apis/_audio_encoder.md

+# AudioEncoder
+
+
+## Overview
+
+Provides the functions for audio encoding.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+**Since:**
+9
+
+
+## Summary
+
+
+### Files
+
+| Name | Description | 
+| -------- | -------- |
+| [native_avcodec_audioencoder.h](native__avcodec__audioencoder_8h.md) | Declares the native APIs used for audio encoding. <br>File to Include: <multimedia/player_framework/native_avcodec_audioencoder.h> | 
+
+
+### Functions
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AudioEncoder_CreateByMime](#oh_audioencoder_createbymime) (const char \*mime) | Creates an audio encoder instance based on a Multipurpose Internet Mail Extension (MIME) type. This API is recommended in most cases.  | 
+| [OH_AudioEncoder_CreateByName](#oh_audioencoder_createbyname) (const char \*name) | Creates an audio encoder instance based on an audio encoder name. To use this API, you must know the exact name of the audio encoder.  | 
+| [OH_AudioEncoder_Destroy](#oh_audioencoder_destroy) (OH_AVCodec \*codec) | Clears the internal resources of an audio encoder and destroys the audio encoder instance.  | 
+| [OH_AudioEncoder_SetCallback](#oh_audioencoder_setcallback) (OH_AVCodec \*codec, [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md) callback, void \*userData) | Sets an asynchronous callback so that your application can respond to events generated by an audio encoder. This API must be called prior to **Prepare**.  | 
+| [OH_AudioEncoder_Configure](#oh_audioencoder_configure) (OH_AVCodec \*codec, OH_AVFormat \*format) | Configures an audio encoder. Typically, you need to configure the attributes of the audio track that can be encoded. This API must be called prior to **Prepare**.  | 
+| [OH_AudioEncoder_Prepare](#oh_audioencoder_prepare) (OH_AVCodec \*codec) | Prepares internal resources for an audio encoder. This API must be called after **Configure**.  | 
+| [OH_AudioEncoder_Start](#oh_audioencoder_start) (OH_AVCodec \*codec) | Starts an audio encoder. This API can be called only after the encoder is prepared successfully. After being started, the encoder starts to report the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) event.  | 
+| [OH_AudioEncoder_Stop](#oh_audioencoder_stop) (OH_AVCodec \*codec) | Stops an audio encoder. After the encoder is stopped, you can call **Start** to start it again.  | 
+| [OH_AudioEncoder_Flush](#oh_audioencoder_flush) (OH_AVCodec \*codec) | Clears the input and output data in the internal buffer of an audio encoder. This API invalidates the indexes of all buffers previously reported through the asynchronous callback. Therefore, before calling this API, ensure that the buffers corresponding to the indexes are no longer required.  | 
+| [OH_AudioEncoder_Reset](#oh_audioencoder_reset) (OH_AVCodec \*codec) | Resets an audio encoder. To continue encoding, you must call **Configure** and **Start** to configure and start the encoder again.  | 
+| [OH_AudioEncoder_GetOutputDescription](#oh_audioencoder_getoutputdescription) (OH_AVCodec \*codec) | Obtains the attributes of the output data of an audio encoder. The caller must manually release the **OH_AVFormat** instance in the return value.  | 
+| [OH_AudioEncoder_SetParameter](#oh_audioencoder_setparameter) (OH_AVCodec \*codec, OH_AVFormat \*format) | Sets dynamic parameters for an audio encoder. This API can be called only after the encoder is started. Incorrect parameter settings may cause encoding failure.  | 
+| [OH_AudioEncoder_PushInputData](#oh_audioencoder_pushinputdata) (OH_AVCodec \*codec, uint32_t index, [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md) attr) | Pushes the input buffer filled with data to an audio encoder. The [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback reports available input buffers and their indexes. After being pushed to the decoder, a buffer is not accessible until the buffer with the same index is reported again through the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback.  | 
+| [OH_AudioEncoder_FreeOutputData](#oh_audioencoder_freeoutputdata) (OH_AVCodec \*codec, uint32_t index) | Frees an output buffer of an audio encoder.  | 
+
+
+## Function Description
+
+
+### OH_AudioEncoder_Configure()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Configure (OH_AVCodec * codec, OH_AVFormat * format )
+```
+**Description**<br>
+Configures an audio encoder. Typically, you need to configure the attributes of the audio track that can be encoded. This API must be called prior to **Prepare**.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_CreateByMime()
+
+  
+```
+OH_AVCodec* OH_AudioEncoder_CreateByMime (const char * mime)
+```
+**Description**<br>
+Creates an audio encoder instance based on a Multipurpose Internet Mail Extension (MIME) type. This API is recommended in most cases.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| mime | Indicates the pointer to a MIME type. For details, see [OH_AVCODEC_MIMETYPE_AUDIO_AAC](_codec_base.md#oh_avcodec_mimetype_audio_aac).  | 
+
+**Returns**
+
+Returns the pointer to an **OH_AVCodec** instance.
+
+
+### OH_AudioEncoder_CreateByName()
+
+  
+```
+OH_AVCodec* OH_AudioEncoder_CreateByName (const char * name)
+```
+**Description**<br>
+Creates an audio encoder instance based on an audio encoder name. To use this API, you must know the exact name of the audio encoder.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| name | Indicates the pointer to an audio encoder name.  | 
+
+**Returns**
+
+Returns the pointer to an **OH_AVCodec** instance.
+
+
+### OH_AudioEncoder_Destroy()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Destroy (OH_AVCodec * codec)
+```
+**Description**<br>
+Clears the internal resources of an audio encoder and destroys the audio encoder instance.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_Flush()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Flush (OH_AVCodec * codec)
+```
+**Description**<br>
+Clears the input and output data in the internal buffer of an audio encoder. This API invalidates the indexes of all buffers previously reported through the asynchronous callback. Therefore, before calling this API, ensure that the buffers corresponding to the indexes are no longer required.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_FreeOutputData()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_FreeOutputData (OH_AVCodec * codec, uint32_t index )
+```
+**Description**<br>
+Frees an output buffer of an audio encoder.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| index | Indicates the index of an output buffer.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_GetOutputDescription()
+
+  
+```
+OH_AVFormat* OH_AudioEncoder_GetOutputDescription (OH_AVCodec * codec)
+```
+**Description**<br>
+Obtains the attributes of the output data of an audio encoder. The caller must manually release the **OH_AVFormat** instance in the return value.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns the handle to an **OH_AVFormat** instance, which must be manually released.
+
+
+### OH_AudioEncoder_Prepare()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Prepare (OH_AVCodec * codec)
+```
+**Description**<br>
+Prepares internal resources for an audio encoder. This API must be called after **Configure**.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_PushInputData()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_PushInputData (OH_AVCodec * codec, uint32_t index, OH_AVCodecBufferAttr attr )
+```
+**Description**<br>
+Pushes the input buffer filled with data to an audio encoder. The [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback reports available input buffers and their indexes. After being pushed to the decoder, a buffer is not accessible until the buffer with the same index is reported again through the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) callback.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| index | Indicates the index of an input buffer.  | 
+| attr | Indicates the attributes of the data contained in the buffer.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_Reset()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Reset (OH_AVCodec * codec)
+```
+**Description**<br>
+Resets an audio encoder. To continue encoding, you must call **Configure** and **Start** to configure and start the encoder again.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_SetCallback()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_SetCallback (OH_AVCodec * codec, OH_AVCodecAsyncCallback callback, void * userData )
+```
+**Description**<br>
+Sets an asynchronous callback so that your application can respond to events generated by an audio encoder. This API must be called prior to **Prepare**.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| callback | Indicates a collection of all callback functions. For details, see [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md).  | 
+| userData | Indicates the pointer to user-specific data.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_SetParameter()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_SetParameter (OH_AVCodec * codec, OH_AVFormat * format )
+```
+**Description**<br>
+Sets dynamic parameters for an audio encoder. This API can be called only after the encoder is started. Incorrect parameter settings may cause encoding failure.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_Start()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Start (OH_AVCodec * codec)
+```
+**Description**<br>
+Starts an audio encoder. This API can be called only after the encoder is prepared successfully. After being started, the encoder starts to report the [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) event.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.
+
+
+### OH_AudioEncoder_Stop()
+
+  
+```
+OH_AVErrCode OH_AudioEncoder_Stop (OH_AVCodec * codec)
+```
+**Description**<br>
+Stops an audio encoder. After the encoder is stopped, you can call **Start** to start it again.
+
+\@syscap SystemCapability.Multimedia.Media.AudioEncoder
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+
+**Returns**
+
+Returns **AV_ERR_OK** if the operation is successful.
+
+Returns an error code defined in [OH_AVErrCode](_core.md#oh_averrcode) if the operation fails.

en/application-dev/reference/native-apis/_codec_base.md

+# CodecBase
+
+
+## Overview
+
+Provides the common structs, character constants, and enums for running **OH_AVCodec** instances.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+**Since:**
+9
+
+
+## Summary
+
+
+### Files
+
+| Name | Description | 
+| -------- | -------- |
+| [native_avcodec_base.h](native__avcodec__base_8h.md) | Declares the common structs, character constants, and enums for running **OH_AVCodec** instances. <br>File to Include: <multimedia/player_framework/native_avcodec_base.h> | 
+
+
+### Structs
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md) | Defines the buffer attributes of an **OH_AVCodec** instance.  | 
+| [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md) | Defines a collection of asynchronous callback functions for an **OH_AVCodec** instance. You must register this struct instance for an **OH_AVCodec** instance and process the information reported through these callbacks to ensure the normal running of the instance.  | 
+
+
+### Types
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVCodecBufferFlags](#oh_avcodecbufferflags) | Enumerates the buffer flags of an **OH_AVCodec** instance.  | 
+| [OH_AVCodecBufferAttr](#oh_avcodecbufferattr) | Defines the buffer attributes of an **OH_AVCodec** instance.  | 
+| [OH_AVCodecOnError](#oh_avcodeconerror)) (OH_AVCodec \*codec, int32_t errorCode, void \*userData) | Defines the function pointer that is called to report error information when an error occurs during the running of an **OH_AVCodec** instance.  | 
+| [OH_AVCodecOnStreamChanged](#oh_avcodeconstreamchanged)) (OH_AVCodec \*codec, OH_AVFormat \*format, void \*userData) | Defines the function pointer that is called to report the attributes of the new stream when the output stream changes. Note that the lifecycle of the pointer to the **OH_AVFormat** instance is valid only when the function pointer is being called. Do not access the pointer to the instance after the function pointer is called.  | 
+| [OH_AVCodecOnNeedInputData](#oh_avcodeconneedinputdata)) (OH_AVCodec \*codec, uint32_t index, OH_AVMemory \*data, void \*userData) | Defines the function pointer that is called, with a new buffer to fill in new input data, when new input data is required during the running of an **OH_AVCodec** instance.  | 
+| [OH_AVCodecOnNewOutputData](#oh_avcodeconnewoutputdata)) (OH_AVCodec \*codec, uint32_t index, OH_AVMemory \*data, [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md) \*attr, void \*userData) | Defines the function pointer that is called, with a buffer containing new output data, when the new output data is generated during the running of an **OH_AVCodec** instance. Note that the lifecycle of the pointer to the **[OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md)** instance is valid only when the function pointer is being called. Do not access the pointer to the instance after the function pointer is called.  | 
+| [OH_AVCodecAsyncCallback](#oh_avcodecasynccallback) | Defines a collection of asynchronous callback functions for an **OH_AVCodec** instance. You must register this struct instance for an **OH_AVCodec** instance and process the information reported through these callbacks to ensure the normal running of the instance.  | 
+| [OH_MediaType](#oh_mediatype) | Enumerates the media types.  | 
+| [OH_AVCProfile](#oh_avcprofile) | Enumerates the AVC profiles.  | 
+| [OH_AACProfile](#oh_aacprofile) | Enumerates the AAC profiles.  | 
+
+
+### Enums
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVCodecBufferFlags](#oh_avcodecbufferflags) {<br/>**AVCODEC_BUFFER_FLAGS_NONE** = 0, AVCODEC_BUFFER_FLAGS_EOS = 1 &lt;&lt; 0, AVCODEC_BUFFER_FLAGS_SYNC_FRAME = 1 &lt;&lt; 1, AVCODEC_BUFFER_FLAGS_INCOMPLETE_FRAME = 1 &lt;&lt; 2,<br/>AVCODEC_BUFFER_FLAGS_CODEC_DATA = 1 &lt;&lt; 3<br/>} | Enumerates the buffer flags of an **OH_AVCodec** instance.  | 
+| [OH_MediaType](#oh_mediatype) { MEDIA_TYPE_AUD = 0, MEDIA_TYPE_VID = 1 } | Enumerates the media types.  | 
+| [OH_AVCProfile](#oh_avcprofile) { **AVC_PROFILE_BASELINE** = 0, **AVC_PROFILE_HIGH** = 4, **AVC_PROFILE_MAIN** = 8 } | Enumerates the AVC profiles.  | 
+| [OH_AACProfile](#oh_aacprofile) { **AAC_PROFILE_LC** = 0 } | Enumerates the AAC profiles.  | 
+
+
+### Variables
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVCodecBufferAttr::pts](#pts) | Presentation timestamp of the buffer, in microseconds.  | 
+| [OH_AVCodecBufferAttr::size](#size) | Size of the data contained in the buffer, in bytes.  | 
+| [OH_AVCodecBufferAttr::offset](#offset) | Start offset of valid data in the buffer.  | 
+| [OH_AVCodecBufferAttr::flags](#flags) | Buffer flag, which is a combination of multiple [OH_AVCodecBufferFlags](#oh_avcodecbufferflags).  | 
+| [OH_AVCODEC_MIMETYPE_VIDEO_AVC](#oh_avcodec_mimetype_video_avc) | Defines the Multipurpose Internet Mail Extension (MIME) type for Advanced Video Coding (AVC).  | 
+| [OH_AVCODEC_MIMETYPE_AUDIO_AAC](#oh_avcodec_mimetype_audio_aac) | Defines the MIME type for Advanced Audio Coding (AAC).  | 
+| [OH_ED_KEY_TIME_STAMP](#oh_ed_key_time_stamp) | Provides unified character descriptors for the auxiliary data of the surface buffer.  | 
+| [OH_ED_KEY_EOS](#oh_ed_key_eos) | Character descriptor of the end-of-stream in the surface auxiliary data. The value type is bool.  | 
+| [OH_MD_KEY_TRACK_TYPE](#oh_md_key_track_type) |  Provides unified character descriptors for the media playback framework.  | 
+| [OH_MD_KEY_CODEC_MIME](#oh_md_key_codec_mime) | Character descriptor of the MIME type. The value type is string.  | 
+| [OH_MD_KEY_DURATION](#oh_md_key_duration) | Character descriptor of duration. The value type is int64_t.  | 
+| [OH_MD_KEY_BITRATE](#oh_md_key_bitrate) | Character descriptor of the bit rate. The value type is uint32_t.  | 
+| [OH_MD_KEY_MAX_INPUT_SIZE](#oh_md_key_max_input_size) | Character descriptor of the maximum input size. The value type is uint32_t.  | 
+| [OH_MD_KEY_WIDTH](#oh_md_key_width) | Character descriptor of the video width. The value type is uint32_t.  | 
+| [OH_MD_KEY_HEIGHT](#oh_md_key_height) | Character descriptor of the video height. The value type is uint32_t.  | 
+| [OH_MD_KEY_PIXEL_FORMAT](#oh_md_key_pixel_format) | Character descriptor of the video pixel format. The value type is int32_t. For details, see [OH_AVPixelFormat](_core.md#oh_avpixelformat).  | 
+| [OH_MD_KEY_AUDIO_SAMPLE_FORMAT](#oh_md_key_audio_sample_format) | Character descriptor of the audio sample format. The value type is uint32_t.  | 
+| [OH_MD_KEY_FRAME_RATE](#oh_md_key_frame_rate) | Character descriptor of the video frame rate. The value type is double.  | 
+| [OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE](#oh_md_key_video_encode_bitrate_mode) | Character descriptor of the video encoding bit rate mode. The value type is int32_t. For details, see [OH_VideoEncodeBitrateMode](_video_encoder.md#oh_videoencodebitratemode).  | 
+| [OH_MD_KEY_PROFILE](#oh_md_key_profile) | Character descriptor of the audio/video encoding capability. The value type is int32_t. For details, see [OH_AVCProfile](#oh_avcprofile) or [OH_AACProfile](#oh_aacprofile).  | 
+| [OH_MD_KEY_AUD_CHANNEL_COUNT](#oh_md_key_aud_channel_count) | Character descriptor of the number of audio channels. The value type is uint32_t.  | 
+| [OH_MD_KEY_AUD_SAMPLE_RATE](#oh_md_key_aud_sample_rate) | Character descriptor of the audio sampling rate. The value type is uint32_t.  | 
+| [OH_MD_KEY_I_FRAME_INTERVAL](#oh_md_key_i_frame_interval) | Character descriptor of the I-frame interval. The value type is int32_t, and the unit is ms.  | 
+| [OH_MD_KEY_ROTATION](#oh_md_key_rotation) | Character descriptor of the surface rotation angle. The value type is int32_t. The value range is {0, 90, 180, 270}. The default value is 0.  | 
+
+
+## Type Description
+
+
+### OH_AACProfile
+
+  
+```
+typedef enum OH_AACProfileOH_AACProfile
+```
+**Description**<br>
+Enumerates the AAC profiles.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_AVCodecAsyncCallback
+
+  
+```
+typedef struct OH_AVCodecAsyncCallbackOH_AVCodecAsyncCallback
+```
+**Description**<br>
+Defines a collection of asynchronous callback functions for an **OH_AVCodec** instance. You must register this struct instance for an **OH_AVCodec** instance and process the information reported through these callbacks to ensure the normal running of the instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| onError | Indicates the callback used to report errors occurred during the running of the instance. For details, see [OH_AVCodecOnError](#oh_avcodeconerror).  | 
+| onStreamChanged | Indicates the callback used to report stream information. For details, see [OH_AVCodecOnStreamChanged](#oh_avcodeconstreamchanged).  | 
+| onNeedInputData | Indicates the callback used to report input data needed. For details, see [OH_AVCodecOnNeedInputData](#oh_avcodeconneedinputdata).  | 
+| onNeedInputData | Indicates the callback used to report output data needed. For details, see [OH_AVCodecOnNewOutputData](#oh_avcodeconnewoutputdata).  | 
+
+
+### OH_AVCodecBufferAttr
+
+  
+```
+typedef struct OH_AVCodecBufferAttrOH_AVCodecBufferAttr
+```
+**Description**<br>
+Defines the buffer attributes of an **OH_AVCodec** instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_AVCodecBufferFlags
+
+  
+```
+typedef enum OH_AVCodecBufferFlagsOH_AVCodecBufferFlags
+```
+**Description**<br>
+Enumerates the buffer flags of an **OH_AVCodec** instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_AVCodecOnError
+
+  
+```
+typedef void(* OH_AVCodecOnError) (OH_AVCodec *codec, int32_t errorCode, void *userData)
+```
+**Description**<br>
+Defines the function pointer that is called to report error information when an error occurs during the running of an **OH_AVCodec** instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| errorCode | Indicates an error code.  | 
+| userData | Indicates the pointer to user-specific data.  | 
+
+
+### OH_AVCodecOnNeedInputData
+
+  
+```
+typedef void(* OH_AVCodecOnNeedInputData) (OH_AVCodec *codec, uint32_t index, OH_AVMemory *data, void *userData)
+```
+**Description**<br>
+Defines the function pointer that is called, with a new buffer to fill in new input data, when new input data is required during the running of an **OH_AVCodec** instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| index | Indicates the index of an input buffer.  | 
+| data | Indicates the pointer to the new input data.  | 
+| userData | Indicates the pointer to user-specific data.  | 
+
+
+### OH_AVCodecOnNewOutputData
+
+  
+```
+typedef void(* OH_AVCodecOnNewOutputData) (OH_AVCodec *codec, uint32_t index, OH_AVMemory *data, OH_AVCodecBufferAttr *attr, void *userData)
+```
+**Description**<br>
+Defines the function pointer that is called, with a buffer containing new output data, when the new output data is generated during the running of an **OH_AVCodec** instance. Note that the lifecycle of the pointer to the **[OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md)** instance is valid only when the function pointer is being called. Do not access the pointer to the instance after the function pointer is called.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| index | Indicates the index of a new output buffer.  | 
+| data | Indicates the pointer to the new output data.  | 
+| attr | Indicates the pointer to the attributes of the new output buffer. For details, see [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md).  | 
+| userData | Indicates the pointer to user-specific data.  | 
+| userData | specified data  | 
+
+
+### OH_AVCodecOnStreamChanged
+
+  
+```
+typedef void(* OH_AVCodecOnStreamChanged) (OH_AVCodec *codec, OH_AVFormat *format, void *userData)
+```
+**Description**<br>
+Defines the function pointer that is called to report the attributes of the new stream when the output stream changes. Note that the lifecycle of the pointer to the **OH_AVFormat** instance is valid only when the function pointer is being called. Do not access the pointer to the instance after the function pointer is called.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| codec | Indicates the pointer to an **OH_AVCodec** instance.  | 
+| format | Indicates the handle to the attributes of the new output stream.  | 
+| userData | Indicates the pointer to user-specific data.  | 
+
+
+### OH_AVCProfile
+
+  
+```
+typedef enum OH_AVCProfileOH_AVCProfile
+```
+**Description**<br>
+Enumerates the AVC profiles.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_MediaType
+
+  
+```
+typedef enum OH_MediaTypeOH_MediaType
+```
+**Description**<br>
+Enumerates the media types.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+## Enum Description
+
+
+### OH_AACProfile
+
+  
+```
+enum OH_AACProfile
+```
+**Description**<br>
+Enumerates the AAC profiles.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_AVCodecBufferFlags
+
+  
+```
+enum OH_AVCodecBufferFlags
+```
+**Description**<br>
+Enumerates the buffer flags of an **OH_AVCodec** instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+| Name | Description | 
+| -------- | -------- |
+| AVCODEC_BUFFER_FLAGS_EOS  | The buffer contains an end-of-stream frame. | 
+| AVCODEC_BUFFER_FLAGS_SYNC_FRAME  | The buffer contains a sync frame. | 
+| AVCODEC_BUFFER_FLAGS_INCOMPLETE_FRAME  | The buffer contains part of a frame. | 
+| AVCODEC_BUFFER_FLAGS_CODEC_DATA  | The buffer contains codec-specific data. | 
+
+
+### OH_AVCProfile
+
+  
+```
+enum OH_AVCProfile
+```
+**Description**<br>
+Enumerates the AVC profiles.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_MediaType
+
+  
+```
+enum OH_MediaType
+```
+**Description**<br>
+Enumerates the media types.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+| Name | Description | 
+| -------- | -------- |
+| MEDIA_TYPE_AUD  | Audio track. | 
+| MEDIA_TYPE_VID  | Video track. | 
+
+
+## Variable Description
+
+
+### flags
+
+  
+```
+uint32_t OH_AVCodecBufferAttr::flags
+```
+**Description**<br>
+Buffer flag, which is a combination of multiple [OH_AVCodecBufferFlags](#oh_avcodecbufferflags).
+
+
+### offset
+
+  
+```
+int32_t OH_AVCodecBufferAttr::offset
+```
+**Description**<br>
+Start offset of valid data in the buffer.
+
+
+### OH_AVCODEC_MIMETYPE_AUDIO_AAC
+
+  
+```
+const char* OH_AVCODEC_MIMETYPE_AUDIO_AAC
+```
+**Description**<br>
+Defines the MIME type for Advanced Audio Coding (AAC).
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_AVCODEC_MIMETYPE_VIDEO_AVC
+
+  
+```
+const char* OH_AVCODEC_MIMETYPE_VIDEO_AVC
+```
+**Description**<br>
+Defines the Multipurpose Internet Mail Extension (MIME) type for Advanced Video Coding (AVC).
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_ED_KEY_EOS
+
+  
+```
+const char* OH_ED_KEY_EOS
+```
+**Description**<br>
+Character descriptor of the end-of-stream in the surface auxiliary data. The value type is bool.
+
+
+### OH_ED_KEY_TIME_STAMP
+
+  
+```
+const char* OH_ED_KEY_TIME_STAMP
+```
+**Description**<br>
+Provides unified character descriptors for the auxiliary data of the surface buffer.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_MD_KEY_AUD_CHANNEL_COUNT
+
+  
+```
+const char* OH_MD_KEY_AUD_CHANNEL_COUNT
+```
+**Description**<br>
+Character descriptor of the number of audio channels. The value type is uint32_t.
+
+
+### OH_MD_KEY_AUD_SAMPLE_RATE
+
+  
+```
+const char* OH_MD_KEY_AUD_SAMPLE_RATE
+```
+**Description**<br>
+Character descriptor of the audio sampling rate. The value type is uint32_t.
+
+
+### OH_MD_KEY_AUDIO_SAMPLE_FORMAT
+
+  
+```
+const char* OH_MD_KEY_AUDIO_SAMPLE_FORMAT
+```
+**Description**<br>
+Character descriptor of the audio sample format. The value type is uint32_t.
+
+
+### OH_MD_KEY_BITRATE
+
+  
+```
+const char* OH_MD_KEY_BITRATE
+```
+**Description**<br>
+Character descriptor of the bit rate. The value type is uint32_t.
+
+
+### OH_MD_KEY_CODEC_MIME
+
+  
+```
+const char* OH_MD_KEY_CODEC_MIME
+```
+**Description**<br>
+Character descriptor of the MIME type. The value type is string.
+
+
+### OH_MD_KEY_DURATION
+
+  
+```
+const char* OH_MD_KEY_DURATION
+```
+**Description**<br>
+Character descriptor of duration. The value type is int64_t.
+
+
+### OH_MD_KEY_FRAME_RATE
+
+  
+```
+const char* OH_MD_KEY_FRAME_RATE
+```
+**Description**<br>
+Character descriptor of the video frame rate. The value type is double.
+
+
+### OH_MD_KEY_HEIGHT
+
+  
+```
+const char* OH_MD_KEY_HEIGHT
+```
+**Description**<br>
+Character descriptor of the video height. The value type is uint32_t.
+
+
+### OH_MD_KEY_I_FRAME_INTERVAL
+
+  
+```
+const char* OH_MD_KEY_I_FRAME_INTERVAL
+```
+**Description**<br>
+Character descriptor of the I-frame interval. The value type is int32_t, and the unit is ms.
+
+
+### OH_MD_KEY_MAX_INPUT_SIZE
+
+  
+```
+const char* OH_MD_KEY_MAX_INPUT_SIZE
+```
+**Description**<br>
+Character descriptor of the maximum input size. The value type is uint32_t.
+
+
+### OH_MD_KEY_PIXEL_FORMAT
+
+  
+```
+const char* OH_MD_KEY_PIXEL_FORMAT
+```
+**Description**<br>
+Character descriptor of the video pixel format. The value type is int32_t. For details, see [OH_AVPixelFormat](_core.md#oh_avpixelformat).
+
+
+### OH_MD_KEY_PROFILE
+
+  
+```
+const char* OH_MD_KEY_PROFILE
+```
+**Description**<br>
+Character descriptor of the audio/video encoding capability. The value type is int32_t. For details, see [OH_AVCProfile](#oh_avcprofile) or [OH_AACProfile](#oh_aacprofile).
+
+
+### OH_MD_KEY_ROTATION
+
+  
+```
+const char* OH_MD_KEY_ROTATION
+```
+**Description**<br>
+Character descriptor of the surface rotation angle. The value type is int32_t. The value range is {0, 90, 180, 270}. The default value is 0.
+
+
+### OH_MD_KEY_TRACK_TYPE
+
+  
+```
+const char* OH_MD_KEY_TRACK_TYPE
+```
+**Description**<br>
+Provides unified character descriptors for the media playback framework.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+
+### OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE
+
+  
+```
+const char* OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE
+```
+**Description**<br>
+Character descriptor of the video encoding bit rate mode. The value type is int32_t. For details, see [OH_VideoEncodeBitrateMode](_video_encoder.md#oh_videoencodebitratemode).
+
+
+### OH_MD_KEY_WIDTH
+
+  
+```
+const char* OH_MD_KEY_WIDTH
+```
+**Description**<br>
+Character descriptor of the video width. The value type is uint32_t.
+
+
+### pts
+
+  
+```
+int64_t OH_AVCodecBufferAttr::pts
+```
+**Description**<br>
+Presentation timestamp of the buffer, in microseconds.
+
+
+### size
+
+  
+```
+int32_t OH_AVCodecBufferAttr::size
+```
+**Description**<br>
+Size of the data contained in the buffer, in bytes.

en/application-dev/reference/native-apis/_core.md

+# Core
+
+
+## Overview
+
+Provides the basic backbone capabilities for the media playback framework, including functions related to the memory, error code, and format carrier.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+**Since:**
+9
+
+
+## Summary
+
+
+### Files
+
+| Name | Description | 
+| -------- | -------- |
+| [native_averrors.h](native__averrors_8h.md) | Declares the error codes used by the media playback framework. <br>File to Include: <multimedia/player_framework/native_averrors.h>  | 
+| [native_avformat.h](native__avformat_8h.md) | Declares the format-related functions and enums. <br>File to Include: <multimedia/player_framework/native_avformat.h> | 
+| [native_avmemory.h](native__avmemory_8h.md) | Declares the memory-related functions. <br>File to Include: <multimedia/player_framework/native_avmemory.h> | 
+
+
+### Types
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVErrCode](#oh_averrcode) | Enumerates the audio and video error codes.  | 
+| [OH_AVPixelFormat](#oh_avpixelformat) | Enumerates the audio and video pixel formats.  | 
+
+
+### Enums
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVErrCode](#oh_averrcode) {<br/>AV_ERR_OK = 0, AV_ERR_NO_MEMORY = 1, AV_ERR_OPERATE_NOT_PERMIT = 2, AV_ERR_INVALID_VAL = 3,<br/>AV_ERR_IO = 4, AV_ERR_TIMEOUT = 5, AV_ERR_UNKNOWN = 6, AV_ERR_SERVICE_DIED = 7,<br/>AV_ERR_INVALID_STATE = 8, AV_ERR_UNSUPPORT = 9, AV_ERR_EXTEND_START = 100<br/>} | Enumerates the audio and video error codes.  | 
+| [OH_AVPixelFormat](#oh_avpixelformat) {<br/>AV_PIXEL_FORMAT_YUVI420 = 1, AV_PIXEL_FORMAT_NV12 = 2, AV_PIXEL_FORMAT_NV21 = 3, AV_PIXEL_FORMAT_SURFACE_FORMAT = 4,<br/>AV_PIXEL_FORMAT_RGBA = 5<br/>} | Enumerates the audio and video pixel formats.  | 
+
+
+### Functions
+
+| Name | Description | 
+| -------- | -------- |
+| [OH_AVFormat_Create](#oh_avformat_create) (void) | Creates an **OH_AVFormat** instance for reading and writing data.  | 
+| [OH_AVFormat_Destroy](#oh_avformat_destroy) (struct OH_AVFormat \*format) | Destroys an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_Copy](#oh_avformat_copy) (struct OH_AVFormat \*to, struct OH_AVFormat \*from) | Copies the resources from an **OH_AVFormat** instance to another.  | 
+| [OH_AVFormat_SetIntValue](#oh_avformat_setintvalue) (struct OH_AVFormat \*format, const char \*key, int32_t value) | Writes data of the int type to an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_SetLongValue](#oh_avformat_setlongvalue) (struct OH_AVFormat \*format, const char \*key, int64_t value) | Writes data of the long type to an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_SetFloatValue](#oh_avformat_setfloatvalue) (struct OH_AVFormat \*format, const char \*key, float value) | Writes data of the float type to an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_SetDoubleValue](#oh_avformat_setdoublevalue) (struct OH_AVFormat \*format, const char \*key, double value) | Writes data of the double type to an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_SetStringValue](#oh_avformat_setstringvalue) (struct OH_AVFormat \*format, const char \*key, const char \*value) | Writes data of the string type to an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_SetBuffer](#oh_avformat_setbuffer) (struct OH_AVFormat \*format, const char \*key, const uint8_t \*addr, size_t size) | Writes data with a specified size to an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_GetIntValue](#oh_avformat_getintvalue) (struct OH_AVFormat \*format, const char \*key, int32_t \*out) | Reads data of the int type from an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_GetLongValue](#oh_avformat_getlongvalue) (struct OH_AVFormat \*format, const char \*key, int64_t \*out) | Reads data of the long type from an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_GetFloatValue](#oh_avformat_getfloatvalue) (struct OH_AVFormat \*format, const char \*key, float \*out) | Reads data of the float type from an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_GetDoubleValue](#oh_avformat_getdoublevalue) (struct OH_AVFormat \*format, const char \*key, double \*out) | Reads data of the double type from an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_GetStringValue](#oh_avformat_getstringvalue) (struct OH_AVFormat \*format, const char \*key, const char \*\*out) | Reads data of the double type from an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_GetBuffer](#oh_avformat_getbuffer) (struct OH_AVFormat \*format, const char \*key, uint8_t \*\*addr, size_t \*size) | Reads data with a specified size from an **OH_AVFormat** instance.  | 
+| [OH_AVFormat_DumpInfo](#oh_avformat_dumpinfo) (struct OH_AVFormat \*format) | Dumps the information contained in an**OH_AVFormat** instance as a string.  | 
+| [OH_AVMemory_GetAddr](#oh_avmemory_getaddr) (struct OH_AVMemory \*mem) | Obtains the virtual memory address of an **OH_AVMemory** instance.  | 
+| [OH_AVMemory_GetSize](#oh_avmemory_getsize) (struct OH_AVMemory \*mem) | Obtains the memory size of an **OH_AVMemory** instance.  | 
+
+
+## Type Description
+
+
+### OH_AVErrCode
+
+  
+```
+typedef enum OH_AVErrCodeOH_AVErrCode
+```
+**Description**<br>
+Enumerates the audio and video error codes.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+
+### OH_AVPixelFormat
+
+  
+```
+typedef enum OH_AVPixelFormatOH_AVPixelFormat
+```
+**Description**<br>
+Enumerates the audio and video pixel formats.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+
+## Enum Description
+
+
+### OH_AVErrCode
+
+  
+```
+enum OH_AVErrCode
+```
+**Description**<br>
+Enumerates the audio and video error codes.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+| Name | Description | 
+| -------- | -------- |
+| AV_ERR_OK  | Operation successful. | 
+| AV_ERR_NO_MEMORY  | No memory. | 
+| AV_ERR_OPERATE_NOT_PERMIT  | Invalid parameter. | 
+| AV_ERR_INVALID_VAL  | Invalid value. | 
+| AV_ERR_IO  | I/O error. | 
+| AV_ERR_TIMEOUT  | Timeout. | 
+| AV_ERR_UNKNOWN  | Unknown error. | 
+| AV_ERR_SERVICE_DIED  | Unavailable media service. | 
+| AV_ERR_INVALID_STATE  | Unsupported operation in this state. | 
+| AV_ERR_UNSUPPORT  | Unsupported API. | 
+| AV_ERR_EXTEND_START  | Initial value for extended error codes. | 
+
+
+### OH_AVPixelFormat
+
+  
+```
+enum OH_AVPixelFormat
+```
+**Description**<br>
+Enumerates the audio and video pixel formats.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+| Name | Description | 
+| -------- | -------- |
+| AV_PIXEL_FORMAT_YUVI420  | YUV 420 Planar. | 
+| AV_PIXEL_FORMAT_NV12  | NV12. YUV 420 Semi-planar. | 
+| AV_PIXEL_FORMAT_NV21  | NV21. YVU 420 Semi-planar. | 
+| AV_PIXEL_FORMAT_SURFACE_FORMAT  | Surface. | 
+| AV_PIXEL_FORMAT_RGBA  | RGBA8888. | 
+
+
+## Function Description
+
+
+### OH_AVFormat_Copy()
+
+  
+```
+bool OH_AVFormat_Copy (struct OH_AVFormat * to, struct OH_AVFormat * from )
+```
+**Description**<br>
+Copies the resources from an **OH_AVFormat** instance to another.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| to | Indicates the handle to the **OH_AVFormat** instance to which the data will be copied.  | 
+| from | Indicates the handle to the **OH_AVFormat** instance from which the data will be copied.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_Create()
+
+  
+```
+struct OH_AVFormat* OH_AVFormat_Create (void )
+```
+**Description**<br>
+Creates an **OH_AVFormat** instance for reading and writing data.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+**Returns**
+
+Returns the handle to an **OH_AVFormat** instance.
+
+
+### OH_AVFormat_Destroy()
+
+  
+```
+void OH_AVFormat_Destroy (struct OH_AVFormat * format)
+```
+**Description**<br>
+Destroys an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+
+**Returns**
+
+void
+
+
+### OH_AVFormat_DumpInfo()
+
+  
+```
+const char* OH_AVFormat_DumpInfo (struct OH_AVFormat * format)
+```
+**Description**<br>
+Dumps the information contained in an**OH_AVFormat** instance as a string.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+
+**Returns**
+
+Returns the pointer to a collect of strings, each of which consists of a key and value.
+
+
+### OH_AVFormat_GetBuffer()
+
+  
+```
+bool OH_AVFormat_GetBuffer (struct OH_AVFormat * format, const char * key, uint8_t ** addr, size_t * size )
+```
+**Description**<br>
+Reads data with a specified size from an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to read.  | 
+| addr | Indicates the double pointer to the address where the data read is stored. The data read is destroyed when the **OH_AVFormat** instance is destroyed. To hold the data for an extended period of time, copy it to the memory.  | 
+| size | Indicates the pointer to the size of the data read.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_GetDoubleValue()
+
+  
+```
+bool OH_AVFormat_GetDoubleValue (struct OH_AVFormat * format, const char * key, double * out )
+```
+**Description**<br>
+Reads data of the double type from an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to read.  | 
+| out | Indicates the pointer to the data read.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_GetFloatValue()
+
+  
+```
+bool OH_AVFormat_GetFloatValue (struct OH_AVFormat * format, const char * key, float * out )
+```
+**Description**<br>
+Reads data of the float type from an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to read.  | 
+| out | Indicates the pointer to the data read.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_GetIntValue()
+
+  
+```
+bool OH_AVFormat_GetIntValue (struct OH_AVFormat * format, const char * key, int32_t * out )
+```
+**Description**<br>
+Reads data of the int type from an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to read.  | 
+| out | Indicates the pointer to the data read.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_GetLongValue()
+
+  
+```
+bool OH_AVFormat_GetLongValue (struct OH_AVFormat * format, const char * key, int64_t * out )
+```
+**Description**<br>
+Reads data of the long type from an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to read.  | 
+| out | Indicates the pointer to the data read.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_GetStringValue()
+
+  
+```
+bool OH_AVFormat_GetStringValue (struct OH_AVFormat * format, const char * key, const char ** out )
+```
+**Description**<br>
+Reads data of the double type from an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to read.  | 
+| out | Indicates the double pointer to the data read. The data read is updated when **GetString** is called and destroyed when the **OH_AVFormat** instance is destroyed. To hold the data for an extended period of time, copy it to the memory.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_SetBuffer()
+
+  
+```
+bool OH_AVFormat_SetBuffer (struct OH_AVFormat * format, const char * key, const uint8_t * addr, size_t size )
+```
+**Description**<br>
+Writes data with a specified size to an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to write.  | 
+| addr | Indicates the pointer to the address where the data is written.  | 
+| size | Indicates the size of the data written.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_SetDoubleValue()
+
+  
+```
+bool OH_AVFormat_SetDoubleValue (struct OH_AVFormat * format, const char * key, double value )
+```
+**Description**<br>
+Writes data of the double type to an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to write.  | 
+| value | Indicates the value of the data to write.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_SetFloatValue()
+
+  
+```
+bool OH_AVFormat_SetFloatValue (struct OH_AVFormat * format, const char * key, float value )
+```
+**Description**<br>
+Writes data of the float type to an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to write.  | 
+| value | Indicates the value of the data to write.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_SetIntValue()
+
+  
+```
+bool OH_AVFormat_SetIntValue (struct OH_AVFormat * format, const char * key, int32_t value )
+```
+**Description**<br>
+Writes data of the int type to an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to write.  | 
+| value | Indicates the value of the data to write.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_SetLongValue()
+
+  
+```
+bool OH_AVFormat_SetLongValue (struct OH_AVFormat * format, const char * key, int64_t value )
+```
+**Description**<br>
+Writes data of the long type to an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to write.  | 
+| value | Indicates the value of the data to write.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVFormat_SetStringValue()
+
+  
+```
+bool OH_AVFormat_SetStringValue (struct OH_AVFormat * format, const char * key, const char * value )
+```
+**Description**<br>
+Writes data of the string type to an **OH_AVFormat** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| format | Indicates the handle to an **OH_AVFormat** instance.  | 
+| key | Indicates the pointer to the key of the data to write.  | 
+| value | Indicates the pointer to the value of the data to write.  | 
+
+**Returns**
+
+Returns **TRUE** if the operation is successful.
+
+Returns **FALSE** if the operation fails.
+
+
+### OH_AVMemory_GetAddr()
+
+  
+```
+uint8_t* OH_AVMemory_GetAddr (struct OH_AVMemory * mem)
+```
+**Description**<br>
+Obtains the virtual memory address of an **OH_AVMemory** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| mem | Indicates the pointer to an **OH_AVMemory** instance.  | 
+
+**Returns**
+
+Returns the virtual address if the memory is valid.
+
+Returns a null pointer if the memory is invalid.
+
+
+### OH_AVMemory_GetSize()
+
+  
+```
+int32_t OH_AVMemory_GetSize (struct OH_AVMemory * mem)
+```
+**Description**<br>
+Obtains the memory size of an **OH_AVMemory** instance.
+
+\@syscap SystemCapability.Multimedia.Media.Core
+
+ **Parameters**
+
+| Name | Description | 
+| -------- | -------- |
+| mem | Indicates the pointer to an **OH_AVMemory** instance.  | 
+
+**Returns**
+
+Returns the size if the memory is valid.
+
+Returns **-1** if the memory is invalid.

en/application-dev/reference/native-apis/_o_h___a_i___call_back_param.md

+# OH_AI_CallBackParam
+
+
+## Overview
+
+Defines the operator information passed in a callback.
+
+**Since:**
+9
+
+**Related Modules:**
+
+[MindSpore](_mind_spore.md)
+
+
+## Summary
+
+
+### Member Variables
+
+| Name | Description | 
+| -------- | -------- |
+| [node_name](#node_name) |Operator name  | 
+| [node_type](#node_type) |Operator type  | 
+
+
+## Member Variable Description 
+
+
+### node_name
+
+  
+```
+char* OH_AI_CallBackParam::node_name
+```
+**Description**<br>
+Operator name
+
+
+### node_type
+
+  
+```
+char* OH_AI_CallBackParam::node_type
+```
+**Description**<br>
+Operator type

en/application-dev/reference/native-apis/_o_h___a_i___shape_info.md

+# OH_AI_ShapeInfo
+
+
+## Overview
+
+Defines dimension information. The maximum dimension is set by **MS_MAX_SHAPE_NUM**.
+
+**Related Modules:**
+
+[MindSpore](_mind_spore.md)
+
+
+## Summary
+
+
+### Member Variables
+
+| Name | Description | 
+| -------- | -------- |
+| [shape_num](#shape_num) | size_t<br/>Dimension array length  | 
+| [shape](#shape) [[OH_AI_MAX_SHAPE_NUM](_mind_spore.md#oh_ai_max_shape_num)] | Dimension array  | 
+
+
+## Member Variable Description 
+
+
+### shape
+
+  
+```
+int64_t OH_AI_ShapeInfo::shape[OH_AI_MAX_SHAPE_NUM]
+```
+**Description**<br>
+Dimension array
+
+
+### shape_num
+
+  
+```
+size_t OH_AI_ShapeInfo::shape_num
+```
+**Description**<br>
+Dimension array length

en/application-dev/reference/native-apis/_o_h___a_i___tensor_handle_array.md

+# OH_AI_TensorHandleArray
+
+
+## Overview
+
+Defines the tensor array structure, which is used to store the tensor array pointer and tensor array length.
+
+**Since:**
+9
+
+**Related Modules:**
+
+[MindSpore](_mind_spore.md)
+
+
+## Summary
+
+
+### Member Variables
+
+| Name | Description | 
+| -------- | -------- |
+| [handle_num](#handle_num) | Tensor array length  | 
+| [handle_list](#handle_list) | Tensor array pointer  | 
+
+
+## Member Variable Description 
+
+
+### handle_list
+
+  
+```
+OH_AI_TensorHandle* OH_AI_TensorHandleArray::handle_list
+```
+**Description**<br>
+Tensor array pointer
+
+
+### handle_num
+
+  
+```
+size_t OH_AI_TensorHandleArray::handle_num
+```
+**Description**<br>
+Tensor array length

en/application-dev/reference/native-apis/_o_h___a_v_codec_async_callback.md

+# OH_AVCodecAsyncCallback
+
+
+## Overview
+
+Defines a collection of asynchronous callback functions for an **OH_AVCodec** instance. You must register this struct instance for an **OH_AVCodec** instance and process the information reported through these callbacks to ensure the normal running of the instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+**Since:**
+9
+
+**Related Modules:**
+
+[CodecBase](_codec_base.md)
+
+
+## Summary
+
+
+### Member Variables
+
+| Name | Description | 
+| -------- | -------- |
+| **onError** | Indicates the callback used to report errors occurred during the running of the instance. For details, see [OH_AVCodecOnError](_codec_base.md#oh_avcodeconerror) | 
+| **onStreamChanged** | Indicates the callback used to report stream information. For details, see [OH_AVCodecOnStreamChanged](_codec_base.md#oh_avcodeconstreamchanged) | 
+| **onNeedInputData** | Indicates the callback used to report input data needed. For details, see [OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) | 
+| **onNeedOutputData** | Indicates the callback used to report output data needed. For details, see [OH_AVCodecOnNewOutputData](_codec_base.md#oh_avcodeconnewoutputdata) | 

en/application-dev/reference/native-apis/_o_h___a_v_codec_buffer_attr.md

+# OH_AVCodecBufferAttr
+
+
+## Overview
+
+Defines the buffer attributes of an **OH_AVCodec** instance.
+
+\@syscap SystemCapability.Multimedia.Media.CodecBase
+
+**Since:**
+9
+
+**Related Modules:**
+
+[CodecBase](_codec_base.md)
+
+
+## Summary
+
+
+### Member Variables
+
+| Name | Description | 
+| -------- | -------- |
+| [pts](_codec_base.md#pts) | Presentation timestamp of the buffer, in microseconds.| 
+| [size](_codec_base.md#size) | Size of the data contained in the buffer, in bytes. | 
+| [offset](_codec_base.md#offset) | Start offset of valid data in the buffer. | 
+| [flags](_codec_base.md#flags) | Buffer flag, which is a combination of multiple **OH_AVCodecBufferFlags**.  |