@@ -123,13 +123,13 @@ In this example, you'll be instructed to query all system events.
- Implement the callback API.
- void HiSysEventQueryCallBackBase::OnQuery\(const ::std::vector& sysEvent, const ::std::vector& seq\)
+ void HiSysEventQueryCallBack::OnQuery\(const ::std::vector& sysEvent, const ::std::vector& seq\)
- void HiSysEventQueryCallBackBase::OnComplete\(int32\_t reason, int32\_t total\)
+ void HiSysEventQueryCallBack::OnComplete\(int32\_t reason, int32\_t total\)
- Invoke the query API in the corresponding service logic.
- HiSysEventManager::QueryHiSysEvent\(struct QueryArg& queryArg, std::vector& queryRules, std::shared\_ptr queryCallBack\)
+ HiSysEventManager::QueryHiSysEvent\(struct QueryArg& queryArg, std::vector& queryRules, std::shared\_ptr queryCallBack\)
```
diff --git a/en/device-dev/subsystems/subsys-dfx-hisysevent.md b/en/device-dev/subsystems/subsys-dfx-hisysevent.md
index e03fc3a05c9a4367c3b3bb46bd2e23771f21e7de..38fe0b8f890fd05ed7a00ec15a5b5c538af49646 100644
--- a/en/device-dev/subsystems/subsys-dfx-hisysevent.md
+++ b/en/device-dev/subsystems/subsys-dfx-hisysevent.md
@@ -4,7 +4,7 @@
- **[HiSysEvent Listening](subsys-dfx-hisysevent-listening.md)**
-- **[HiSysEvent Query](subsys-dfx-hisysevent-query.md)**
+- **[HiSysEvent Query](subsys-dfx-hisysevent-querying.md)**
- **[HiSysEvent Tool Usage](subsys-dfx-hisysevent-tool.md)**
diff --git a/zh-cn/application-dev/Readme-CN.md b/zh-cn/application-dev/Readme-CN.md
index 112dabfdd80ad86b9e50e1e6ee9b54eca5ffc991..e91b5d97f37a5254720235875d1a4d78b9bf29d6 100644
--- a/zh-cn/application-dev/Readme-CN.md
+++ b/zh-cn/application-dev/Readme-CN.md
@@ -16,5 +16,6 @@
- [数据管理](database/Readme-CN.md)
- [USB服务](usb/Readme-CN.md)
- [DFX](dfx/Readme-CN.md)
+- [WebGL](webgl/Readme-CN.md)
- [开发参考](reference/Readme-CN.md)
diff --git a/zh-cn/application-dev/ability/Readme-CN.md b/zh-cn/application-dev/ability/Readme-CN.md
index 202dc4ca4253a99c5cb7a91f724b85cd2656fcdf..ae4403f9cf0425e51eccd71df27651e875911c79 100644
--- a/zh-cn/application-dev/ability/Readme-CN.md
+++ b/zh-cn/application-dev/ability/Readme-CN.md
@@ -5,4 +5,6 @@
* [基于Native的Data Ability创建与访问](data-ability-creating-accessing.md)
* [CommonEvent开发指南](common-event.md)
* [Notification开发指南](notification.md)
+* [应用迁移开发指导](ability-continuation.md)
+* [Ability助手使用指导](ability-assistant-guidelines.md)
diff --git a/zh-cn/application-dev/ability/ability-assistant-guidelines.md b/zh-cn/application-dev/ability/ability-assistant-guidelines.md
new file mode 100644
index 0000000000000000000000000000000000000000..6db0306ab489467b9e7b39065c2117822fc2c8e2
--- /dev/null
+++ b/zh-cn/application-dev/ability/ability-assistant-guidelines.md
@@ -0,0 +1,103 @@
+# Ability助手使用指导
+
+Ability assistant（Ability助手，简称为aa）是实现应用、原子化服务及测试用例启动功能，为开发者提供基本的调试及测试应用的工具。通过该工具，开发者可以在hdc shell中，发出命令以执行各种系统操作，比如启动Ability、强制停止进程、打印Ability相关信息等。
+
+## 开发指导
+
+工具已在设备环境预置，开发者可直接通过命令行调用。
+
+### 查询相关
+
+- **help**
+
+ 用于显示aa相关的帮助信息。
+
+ **返回值：**
+
+ 返回对应的帮助信息。
+
+ **使用方法：**
+
+ ```
+ aa help
+ ```
+
+### Ability相关
+
+- **start**
+
+ 用于启动一个ability。
+
+ | 参数 | 参数说明 |
+ | --------- | ---------------------- |
+ | -h/--help | 帮助信息。 |
+ | -d | 可选参数，device id |
+ | -a | 必选参数，ability name |
+ | -b | 必选参数，bundle name |
+ | -D | 可选参数，调试模式 |
+
+ **返回值：**
+
+ 当成功启动Ability时，返回“start ability successfully.”；当启动失败时，返回“error: failed to start ability.”。
+
+ 使用方法：
+
+ ```
+aa start [-d ] -a -b [-D]
+ ```
+
+- **stop-service**
+
+ 用于停止Service Ability。
+
+ | 参数 | 参数说明 |
+ | --------- | ------------------------ |
+ | -h/--help | 帮助信息。 |
+ | -d | 可选参数，device id。 |
+ | -a | 必选参数，ability name。 |
+ | -b | 必选参数，bundle name。 |
+
+ **返回值：**
+
+ 当成功停止Service Ability时，返回“stop service ability successfully.”；当停止失败时，返回“error: failed to stop service ability.”。
+
+ 使用方法：
+
+ ```
+aa stop-service [-d ] -a -b
+ ```
+
+- **dump**
+
+ 用于打印Ability的相关信息。
+
+ | 参数 | 参数说明 |
+ | ---------------------- | -------------------------------------- |
+ | -h/--help | 帮助信息。 |
+ | -a/--all | 打印所有mission内的Ability。 |
+ | -s/--stack \ | 打印指定mission stack内的Ability。 |
+ | -m/--mission \ | 打印指定mission内的Ability。 |
+ | -l/--stack-list | 打印每个mission stack内的mission列表。 |
+ | -u/--ui | 打印system ui Ability。 |
+ | -e/--serv | 打印Service Ability。 |
+ | -d/--data | 打印Data Ability。 |
+
+ **使用方法：**
+
+ ```
+ aa dump -a
+ ```
+
+- **force-stop**
+
+ 通过bundle name强制停止一个进程。
+
+ **返回值：**
+
+ 当成功强制停止该进程时，返回“force stop process successfully.”；当强制停止失败时，返回“error: failed to force stop process.”。
+
+ **使用方法：**
+
+ ```
+ aa force-stop
+ ```
\ No newline at end of file
diff --git a/zh-cn/application-dev/connectivity/ipc-rpc.md b/zh-cn/application-dev/connectivity/ipc-rpc.md
deleted file mode 100644
index b28f4d1c71d5cfa7c7d09ca22ca904cb8fa85ca3..0000000000000000000000000000000000000000
--- a/zh-cn/application-dev/connectivity/ipc-rpc.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# IPC与RPC通信
-
-
-- **[IPC与RPC通信概述](ipc-rpc-overview.md)**
-
-- **[IPC与RPC通信开发指导](ipc-rpc-development-guideline.md)**
-
-- **[远端状态订阅开发实例](subscribe-remote-state.md)**
\ No newline at end of file
diff --git a/zh-cn/application-dev/dfx/Readme-CN.md b/zh-cn/application-dev/dfx/Readme-CN.md
index 4962e5b9907be3cf6a11db0b10aa6fccb5c4858a..3743ff1aa3c06330bd6a720f55fd0e0c8b9e8b78 100644
--- a/zh-cn/application-dev/dfx/Readme-CN.md
+++ b/zh-cn/application-dev/dfx/Readme-CN.md
@@ -3,4 +3,10 @@
- 应用事件打点
- [应用事件打点概述](hiappevent-overview.md)
- [应用事件打点开发指导](hiappevent-guidelines.md)
+- 性能打点跟踪
+ - [性能打点跟踪概述](hitracemeter-overview.md)
+ - [性能打点跟踪开发指导](hitracemeter-guidelines.md)
+- 分布式跟踪
+ - [分布式跟踪概述](hitracechain-overview.md)
+ - [分布式跟踪开发指导](hitracechain-guidelines.md)
diff --git a/zh-cn/application-dev/dfx/hitracechain-guidelines.md b/zh-cn/application-dev/dfx/hitracechain-guidelines.md
new file mode 100644
index 0000000000000000000000000000000000000000..4d0b1759fa649cbaf5f02b46f50034353ed00444
--- /dev/null
+++ b/zh-cn/application-dev/dfx/hitracechain-guidelines.md
@@ -0,0 +1,58 @@
+# 分布式跟踪开发指导
+
+## 场景介绍
+
+HiTraceChain为开发者提供业务流程调用链跟踪的维测接口，帮助开发者迅速获取指定业务流程调用链的运行日志，定位跨设备/跨进程/跨线程的故障问题。
+
+## 接口说明
+
+分布式跟踪接口由hiTraceChain模块提供，详细API请参考[分布式跟踪API参考](../reference/apis/js-apis-hitracechain.md)。
+
+**分布式跟踪接口功能介绍：**
+
+| 接口名 | 返回值 | 描述 |
+| ------------------------------------------------------------------------------------------------------------------- | -------------- | ------------ |
+| hiTraceChain.begin(name: string, flags: number = HiTraceFlag.DEFAULT) | HiTraceId | 开始跟踪。 |
+| hiTraceChain.tracepoint(mode: HiTraceCommunicationMode, type: HiTraceTracepointType, id: HiTraceId, msg?: string) | void | 信息埋点。 |
+| hiTraceChain.end(id: HiTraceId) | void | 结束跟踪。 |
+
+## 开发步骤
+
+在应用启动执行页面加载后，开始分布式跟踪，完成业务之后，停止分布式跟踪。
+
+1. 新建一个JS应用工程，在“Project”窗口点击“entry > src > main > js > default > pages > index”，打开工程中的“index.js”文件，在页面执行加载后，在实际业务逻辑中调用hiTraceChain的API，进行分布式跟踪，示例代码如下：
+
+ ```
+ import hiTraceChain from '@ohos.hiTraceChain'
+
+ export default {
+ data: {
+ title: ""
+ },
+ onInit() {
+ this.title = this.$t('strings.world');
+
+ // 1、开启分布式跟踪
+ let asyncTraceId = hiTraceChain.begin("business", hiTraceChain.HiTraceFlag.INCLUDE_ASYNC | hiTraceChain.HiTraceFlag.DONOT_CREATE_SPAN);
+
+ // 2、业务流程开始
+ console.log(`business start`);
+
+ // 3、埋点操作
+ hiTraceChain.tracepoint(hiTraceChain.HiTraceCommunicationMode.THREAD, hiTraceChain.HiTraceTracepointType.SS, asyncTraceId, "Just a example");
+
+ // 4、业务流程执行中
+ console.log(`business running`);
+
+ // 5、业务流程结束
+ console.log(`business end`);
+
+ // 6、停止跟踪
+ hiTraceChain.end(asyncTraceId);
+ }
+ }
+ ```
+
+2. 运行项目，点击应用界面上的运行按钮，即可通过日志信息分析实际业务。
+
+
diff --git a/zh-cn/application-dev/dfx/hitracechain-overview.md b/zh-cn/application-dev/dfx/hitracechain-overview.md
new file mode 100644
index 0000000000000000000000000000000000000000..a95750b019e8c20a7043a44f5cce6fde290727b4
--- /dev/null
+++ b/zh-cn/application-dev/dfx/hitracechain-overview.md
@@ -0,0 +1,17 @@
+# 分布式跟踪概述
+
+hiTraceChain是基于云计算分布式跟踪调用链思想，在端侧业务流程（涉及跨线程、跨进程、跨设备）中的一种轻量级实现。
+
+## 基本概念
+
+- **chainId**
+
+ 分布式跟踪标识，属于HiTraceId的一部分，用于标识当前跟踪的业务流程。
+
+## 运作机制
+
+hiTraceChain在业务控制面流程中，生成和传递唯一跟踪标识，在业务流程中输出的各类信息中（包括应用事件、系统时间、日志等）记录该跟踪标识。在调试、问题定位过程中，开发者可以通过该唯一跟踪标识将本次业务流程端到端的各类信息快速关联起来。
+
+## 约束与限制
+
+hiTraceChain API提供的相关接口全部为同步接口。
\ No newline at end of file
diff --git a/zh-cn/application-dev/dfx/hitracemeter-guidelines.md b/zh-cn/application-dev/dfx/hitracemeter-guidelines.md
new file mode 100644
index 0000000000000000000000000000000000000000..fa287bd515c28516dbb8715c4259fcfed83bd48d
--- /dev/null
+++ b/zh-cn/application-dev/dfx/hitracemeter-guidelines.md
@@ -0,0 +1,73 @@
+# 性能打点跟踪开发指导
+
+## 场景介绍
+
+HiTraceMeter为开发者提供系统性能打点接口。开发者通过在自己的业务逻辑中的关键代码位置调用HiTraceMeter接口提供的API接口，能够有效追踪进程轨迹、查看系统性能。
+
+## 接口说明
+
+性能打点跟踪接口由hiTraceMeter模块提供，详细API请参考[性能打点跟踪API参考](../reference/apis/js-apis-hitracemeter.md)。
+
+**性能打点跟踪接口功能介绍：**
+
+| 接口名 | 返回值 | 描述 |
+| ---------------------------------------------------------------------------- | --------- | ------------ |
+| hiTraceMeter.startTrace(name: string, taskId: number, expectedTime?: number) | void | 标记一个预追踪耗时任务的开始。如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次，并且任务同时被执行，则每次调用startTrace的taskId不相同。如果具有相同name的任务是串行执行的，则taskId可以相同。 |
+| hiTraceMeter.finishTrace(name: string, taskId: number) | void | name和taskId必须与流程开始的hiTraceMeter.startTrace对应参数值保持一致。 |
+| hiTraceMeter.traceByValue(name: string, value: number) | void | 用来标记一个预追踪的数值变量，该变量的数值会不断变化。|
+
+## 开发步骤
+
+在应用启动执行页面加载后，开始分布式跟踪，完成业务之后，停止分布式跟踪。
+
+1. 新建一个JS应用工程，在“Project”窗口点击“entry > src > main > js > default > pages > index”，打开工程中的“index.js”文件，在页面执行加载后，在自己的业务中调用hiTraceMeter的接口，进行性能打点追踪，示例代码如下：
+
+ ```js
+ import hiTraceMeter from '@ohos.hiTraceMeter'
+
+ export default {
+ data: {
+ title: ""
+ },
+ onInit() {
+ this.title = this.$t('strings.world');
+
+ //从startTrace到finishTrace流程的耗时期望为5ms
+ hiTraceMeter.startTrace("business", 1);
+ hiTraceMeter.startTrace("business", 1, 5);
+
+ //追踪并行执行的同名任务
+ hiTraceMeter.startTrace("business", 1);
+ //业务流程
+ console.log(`business running`);
+ hiTraceMeter.startTrace("business", 2); //第二个追踪的任务开始，同时第一个追踪的同名任务还没结束，出现了并行执行，对应接口的taskId需要不同。
+ //业务流程
+ console.log(`business running`);
+ hiTraceMeter.finishTrace("business", 1);
+ //业务流程
+ console.log(`business running`);
+ hiTraceMeter.finishTrace("business", 2);
+
+ //追踪串行执行的同名任务
+ hiTraceMeter.startTrace("business", 1);
+ //业务流程
+ console.log(`business running`);
+ hiTraceMeter.finishTrace("business", 1); //第一个追踪的任务结束
+ //业务流程
+ console.log(`business running`);
+ hiTraceMeter.startTrace("business", 1); //第二个追踪的同名任务开始，同名的待追踪任务串行执行。
+ //业务流程
+ console.log(`business running`);
+
+ let traceCount = 3;
+ hiTraceMeter.traceByValue("myTestCount", traceCount);
+ traceCount = 4;
+ hiTraceMeter.traceByValue("myTestCount", traceCount);
+ hiTraceMeter.finishTrace("business", 1);
+ }
+ }
+ ```
+
+2. 运行项目，点击应用界面上的运行按钮，即可通过日志信息分析实际业务。
+
+
diff --git a/zh-cn/application-dev/dfx/hitracemeter-overview.md b/zh-cn/application-dev/dfx/hitracemeter-overview.md
new file mode 100644
index 0000000000000000000000000000000000000000..a6144101ad710c69bf7a8833580c2a4142438df0
--- /dev/null
+++ b/zh-cn/application-dev/dfx/hitracemeter-overview.md
@@ -0,0 +1,18 @@
+# 性能打点跟踪概述
+
+hiTraceMeter是开发者用于追踪进程轨迹，度量程序执行性能的一种工具，基于内核的ftrace机制，提供给用户态应用代码执行时长度量打点的能力。开发者通过使用hiTraceMeter API在程序中打点，并使用hiTraceMeter提供的命令行工具采集跟踪数据。
+
+## 基本概念
+
+- **hiTraceMeter Tag**
+
+ 跟踪数据使用类别分类，称作hiTraceMeter Tag或hiTraceMeter Category，一般每个软件子系统对应一个Tag，该Tag在打点API中以类别TAg参数传入。hiTraceMeter命令行工具采集跟踪数据时，只采集给定的Tag类别选项指定的跟踪数据。
+
+## 运作机制
+
+- 应用程序通过hiTraceMeter函数接口进行打点，hiTraceMeter函数将跟踪数据通过内核sysfs文件接口输出到内核的ftrace数据缓冲区。
+- hiTraceMeter命令行工具读取内核ftrace缓冲区中的跟踪数据，将文本格式的跟踪数据保存到设备侧的文件中。
+
+## 约束与限制
+
+- 由于JS程序的异步IO特性，现在hiTraceMeter只提供了异步接口。
\ No newline at end of file
diff --git a/zh-cn/application-dev/quick-start/package-structure.md b/zh-cn/application-dev/quick-start/package-structure.md
index fa6b27f5a92b36d8bd2ce9f80f9905e975c1c4ea..ec612e6e390a83481a4f3332f368baa742183e25 100644
--- a/zh-cn/application-dev/quick-start/package-structure.md
+++ b/zh-cn/application-dev/quick-start/package-structure.md
@@ -231,7 +231,7 @@ module对象包含HAP包的配置信息，内部结构说明参见表11。
| shortcuts | 表示应用的快捷方式信息。采用对象数组格式，其中的每个元素表示一个快捷方式对象。参考表25。 | 对象数组 | 可缺省，缺省值为空 |
| reqPermissions | 表示应用运行时向系统申请的权限。参考表21。 | 对象数组 | 可缺省，缺省值为空 |
| colorMode | 表示应用自身的颜色模式。\): void
拨打电话，使用callback方式作为异步方法。
-需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
+**需要权限**：ohos.permission.PLACE\_CALL，该权限为系统权限
+
+**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
@@ -41,7 +43,9 @@ dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback
拨打电话，可设置通话参数，使用promise方式作为异步方法。
-需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
+**需要权限**：ohos.permission.PLACE\_CALL，该权限为系统权限
+
+**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
@@ -102,6 +108,8 @@ hasCall\(callback: AsyncCallback\): void
判断是否存在通话，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -123,6 +131,8 @@ hasCall\(\): Promise
判断是否存在通话，使用Promise方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**返回值：**
| 类型 | 说明 |
@@ -147,6 +157,8 @@ getCallState\(callback: AsyncCallback\): void
获取通话状态，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -168,6 +180,8 @@ getCallState\(\): Promise
获取通话状态，使用Promise方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**返回值：**
| 类型 | 说明 |
@@ -191,6 +205,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, callback: AsyncCallback\)
判断是否是紧急电话号码，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -213,6 +229,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, options: EmergencyNumberOptions, ca
判断是否是紧急电话号码，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -236,6 +254,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, options?: EmergencyNumberOptions\):
判断是否是紧急电话号码，使用promise方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -266,6 +286,8 @@ formatPhoneNumber\(phoneNumber: string, callback: AsyncCallback\): void
格式化电话号码，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -288,6 +310,8 @@ formatPhoneNumber\(phoneNumber: string, options: NumberFormatOptions, callback:
格式化电话号码，可设置格式化参数，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -313,6 +337,8 @@ formatPhoneNumber\(phoneNumber: string, options?: NumberFormatOptions\): Promise
格式化电话号码，可设置格式化参数，使用promise方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -349,6 +375,8 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string, callback: Asy
支持所有国家码。
+**系统能力**：SystemCapability.Telephony.CallManager
+
**参数：**
| 参数 | 类型 | 必填 | 说明 |
@@ -378,6 +406,8 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise {
## DialOptions7+ 7+ ) : void
+
+通过Callback方法生成密钥（密钥对）。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------------------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 别名。
+
+通过Promise方法生成密钥（密钥对）。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------------------------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 密钥别名。) : void
+
+针对Callback生成的密钥进行删除。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------------------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 密钥别名，应为生成key时传入的别名。
+
+针对Promise生成的密钥进行删除。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | ----------------------------------------------------- |
+| keyAlias | string | 是 | 密钥别名，应为生成key时传入的别名。) : void
+
+导入Callback方法生成的密钥对 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------ | ---- | ------------------------------------------------- |
+| keyAlias | string | 是 | 密钥别名，用于存放所需密钥。
+
+导入Promise方法生成的密钥对。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | ------------------------------------ |
+| keyAlias | string | 是 | 密钥别名，用于存放所需密钥。) : void
+
+导出Callback方法生成的密钥对。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------------------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 密钥别名，应与所用密钥生成时使用的别名相同。
+
+导出Promise方法生成的密钥对。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 密钥别名，应与所用密钥生成时使用的别名相同。) : void
+
+获取Callback方法生成的密钥属性。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------------------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 密钥别名，应与所用密钥生成时使用的别名相同。
+
+获取Promise方法生成的密钥属性。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | ------------------------------------------------------------ |
+| keyAlias | string | 是 | 密钥别名，应与所用密钥生成时使用的别名相同。) : void
+
+判断Callback方法生成的密钥是否存在 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| keyAlias | string | 是 | 所需查找的密钥的别名。 | 是 | FALSE代表密钥不存在，TRUE代表密钥存在。
+
+判断Promise方法生成的密钥是否存在 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------- | ---- | -------------------------------- |
+| keyAlias | string | 是 | 所需查找的密钥的别名。 | FALSE代表密钥不存在，TRUE代表密钥存在。) : void
+
+init操作接口，使用callback回调异步返回结果 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| keyAlias | string | 是 | Init操作密钥的别名。
+
+init操作接口，使用Promise方式异步返回结果。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| keyAlias | string | 是 | Init操作密钥的别名。) : void
+
+update操作接口，使用callback回调异步返回结果 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| handle | number | 是 | Update操作的handle。
+
+update操作接口，使用Promise方式异步返回结果。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| handle | number | 是 | Update操作的handle。) : void
+
+finish操作接口，使用callback回调异步返回结果 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| handle | number | 是 | Finish操作的handle。
+
+finish操作接口，使用Promise方式异步返回结果。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| handle | number | 是 | Finish操作的handle。) : void
+
+abort操作接口，使用callback回调异步返回结果 。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| handle | number | 是 | Abort操作的handle。;
+
+abort操作接口，使用Promise方式异步返回结果。
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------- |
+| handle | number | 是 | Abort操作的handle。 | 否 | 属性,存HuksParam的数组。 | 否 | 属性 | 否 | 证书链
+
+通过colors和opts创建pixelmap。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------------------------------------- | ---- | ------------------------------------------------------------ |
+| colors | ArrayBuffer | 是 | 颜色数组。 |
+| opts | [InitializetionOptions](#InitializationOptions) | 是 | 创建像素的属性，包括透明度，尺寸，缩略值，像素格式和是否可编辑。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------ | -------------- |
+| Promise\ | 返回pixelmap。 |
+
+**示例：**
+
+```js
+image.createPixelMap(Color, opts)
+ .then((pixelmap) => {
+ expect(pixelmap !== null).assertTrue()
+ done()
+ })
+```
+
+## image.createPixelMap
+
+createPixelMap(colors: ArrayBuffer, opts: InitializetionOptions) callback: AsyncCallback\): void
+
+通过属性创建pixelmap。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------------------------- | ---- | -------------------- |
+| colors | ArrayBuffer | 是 | 颜色数组。 |
+| opts | [InitializetionOptions](#InitializationOptions) | 是 | 属性。 |
+| callback | AsyncCallback\ | 是 | 回调表示成功或失败。 |
+
+**示例：**
+
+```js
+image.createPixelMap(Color, opts, (pixelmap) => {
+ expect(pixelmap !== null).assertTrue()
+ done()
+ })
+```
+
+## PixelMap
+```
+
+读取图像像素数据，结果写入ArrayBuffer里，使用Promise形式返回。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------- | ---- | ------------------------------------------------------------ |
+| dst | ArrayBuffer | 是 | 缓冲区，函数执行结束后获取的图像像素数据写入到该内存区域内。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| :------------- | :---------------------------------------------- |
+| Promise\ | Promise实例，用于获取结果，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelmap.readPixelsToBuffer(readBuffer).then(() => {
+ var bufferArr = new Uint8Array(readBuffer)
+ var res = true
+ for (var i = 0; i < bufferArr.length; i++) {
+ if (res) {
+ if (bufferArr[i] !== 0) {
+ res = false
+ console.info('TC_020 Success')
+ expect(true).assertTrue()
+ done()
+ break
+ }
+ }
+ }
+ if (res) {
+ console.info('TC_020 buffer is all empty')
+ expect(false).assertTrue()
+ done()
+ }
+ })
+```
+
+### readPixelsToBuffer
+
+readPixelsToBuffer(dst: ArrayBuffer, callback: AsyncCallback\): void
+
+读取图像像素数据，结果写入ArrayBuffer里,使用callback形式返回。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ------------------------------------------------------------ |
+| dst | ArrayBuffer | 是 | 缓冲区，函数执行结束后获取的图像像素数据写入到该内存区域内。 |
+| callback | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelmap.readPixelsToBuffer(readBuffer, () => {
+ var bufferArr = new Uint8Array(readBuffer)
+ var res = true
+ for (var i = 0; i < bufferArr.length; i++) {
+ if (res) {
+ if (bufferArr[i] !== 0) {
+ res = false
+ console.info('TC_020-1 Success')
+ expect(true).assertTrue()
+ done()
+ break
+ }
+ }
+ }
+ if (res) {
+ console.info('TC_020-1 buffer is all empty')
+ expect(false).assertTrue()
+ done()
+ }
+ })
+```
+
+### readPixels
+
+readPixels(area: PositionArea): Promise\
+
+读取区域内的图片数据，使用Promise形式返回读取结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------------------------- | ---- | ------------------------ |
+| area | [PositionArea](#PositionArea) | 是 | 区域大小，根据区域读取。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| :------------- | :-------------------------------------------------- |
+| Promise\ | Promise实例，用于获取读取结果，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelmap.readPixels(area).then((data) => {
+ if(data !== null){
+ var bufferArr = new Uint8Array(area.pixels);
+ var res = true;
+ for (var i = 0; i < bufferArr.length; i++) {
+ console.info('TC_021 buffer ' + bufferArr[i]);
+ if(res) {
+ if (bufferArr[i] == 0) {
+ res = false;
+ console.info('TC_021 Success');
+ expect(true).assertTrue();
+ done();
+ break;
+ }
+ }
+ }
+ if (res) {
+ console.info('TC_021 buffer is all empty');
+ expect(false).assertTrue()
+ done();
+ }
+ }
+ })
+```
+
+### readPixels
+
+readPixels(area: PositionArea, callback: AsyncCallback\): void
+
+读区域的像素。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------- | ---- | ------------------------------ |
+| area | [PositionArea](#PositionArea) | 是 | 区域大小，根据区域读取。 |
+| callback | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelmap.readPixels(area,(data) => {
+ if(data !== null) {
+ var bufferArr = new Uint8Array(area.pixels);
+ var res = true;
+ for (var i = 0; i < bufferArr.length; i++) {
+ console.info('TC_021-1 buffer ' + bufferArr[i]);
+ if(res) {
+ if(bufferArr[i] == 0) {
+ res = false;
+ console.info('TC_021-1 Success');
+ expect(true).assertTrue();
+ done();
+ break;
+ }
+ }
+ }
+```
+
+### writePixels
+
+writePixels(area: PositionArea): Promise\
+
+先创建pixelmap，将pixelmap写入指定区域内，使用Promise形式返回写入结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------------------------- | ---- | -------------------- |
+| area | [PositionArea](#PositionArea) | 是 | 区域，根据区域写入。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| :------------- | :-------------------------------------------------- |
+| Promise\ | Promise实例，用于获取写入结果，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelMap.writePixels(area).then(() => {
+ console.log("Succeeded in writing pixels.");
+}).catch((err) => {
+ console.error("Failed to write pixels.");
+});
+```
+
+### writePixels
+
+writePixels(area: PositionArea, callback: AsyncCallback\): void
+
+将指定的像素信息写入指定区域内。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --------- | ----------------------------- | ---- | ------------------------------ |
+| area | [PositionArea](#PositionArea) | 是 | 区域，根据区域写入。 |
+| callback: | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelmap.writePixels(area, () => {
+ const readArea = {
+ pixels: new ArrayBuffer(20),
+ offset: 0,
+ stride: 8,
+ region: { size: { height: 1, width: 2 }, x: 0, y: 0 },
+ }
+ })
+```
+
+### writeBufferToPixels
+
+writeBufferToPixels(src: ArrayBuffer): Promise\
+
+将缓冲区的内容写入像素。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------- | ---- | -------- |
+| src | ArrayBuffer | 是 | 缓冲区。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | ----------------------------------------------- |
+| Promise\ | Promise实例，用于获取结果，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelMap.writeBufferToPixels(colorBuffer).then(() => {
+ console.log("Succeeded in writing data from a buffer to a PixelMap.");
+}).catch((err) => {
+ console.error("Failed to write data from a buffer to a PixelMap.");
+});
+```
+
+### writeBufferToPixels
+
+writeBufferToPixels(src: ArrayBuffer, callback: AsyncCallback\): void
+
+将缓冲区的内容写入像素。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ------------------------------ |
+| src | ArrayBuffer | 是 | 图像像素数据。 |
+| callback | AsyncCallback\ | 是 | 获取回调，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelMap.writeBufferToPixels(colorBuffer, function(err) {
+ if (err) {
+ console.error("Failed to write data from a buffer to a PixelMap.");
+ return;
+ }
+ console.log("Succeeded in writing data from a buffer to a PixelMap.");
+});
+```
+
+### getImageInfo
+
+getImageInfo(): Promise\
+
+获取图像像素信息，使用Promise形式返回获取的图像像素信息。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------- | ----------------------------------------------------------- |
+| Promise\ | Promise实例，用于异步获取图像像素信息，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+pixelMap.getImageInfo().then(function(info) {
+ console.log("Succeeded in obtaining the image pixel map information.");
+}).catch((err) => {
+ console.error("Failed to obtain the image pixel map information.");
+});
+```
+
+### getImageInfo
+
+getImageInfo(callback: AsyncCallback\): void
+
+获取图像像素信息，使用callback形式返回获取的图像像素信息。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------- | ---- | ------------------------------------------------------------ |
+| callback | AsyncCallback\ | 是 | 获取图像像素信息回调，异步返回图像像素信息，失败时返回错误信息。 |
+
+**示例:**
+
+```js
+pixelmap.getImageInfo((imageInfo) => {
+ if (imageInfo !== null) {
+ console.info('TC_024-1 imageInfo is ready')
+ expect(imageInfo.size.height == 4).assertTrue()
+ expect(imageInfo.size.width == 6).assertTrue()
+ expect(imageInfo.pixelFormat == 1).assertTrue()
+ done()
+ } else {
+ console.info('TC_024-1 imageInfo is empty')
+ expect(false).assertTrue()
+ done()
+ }
+ })
+```
+
+### getBytesNumberPerRow
+
+getBytesNumberPerRow(): Promise\
+
+获取图像像素每行字节数。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------- | --------------------------------------------- |
+| Promise\ | Promise实例，用于异步获取图像像素的行字节数。 |
+
+**示例：**
+
+```js
+pixelmap.getBytesNumberPerRow().then((num) => {
+ console.info('TC_025 num is ' + num)
+ expect(num == expectNum).assertTrue()
+ done()
+ })
+```
+
+### getBytesNumberPerRow
+
+getBytesNumberPerRow(callback: AsyncCallback\): void
+
+获取图像像素每行字节数。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------ |
+| callback | AsyncCallback\ | 是 | 通过回调返回结果。 |
+
+**示例：**
+
+```js
+pixelmap.getBytesNumberPerRow( num => {
+ console.info('TC_025-1 num is ' + num);
+ expect(num == expectNum).assertTrue();
+ done();
+ })
+```
+
+### getPixelBytesNumber
+
+getPixelBytesNumber(): Promise\
+
+获取图像像素的总字节数。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------- | --------------------------------------------- |
+| Promise\ | Promise实例，用于异步获取图像像素的总字节数。 |
+
+**示例：**
+
+```js
+pixelmap.getPixelBytesNumber().then((num) => {
+ console.info('TC_026 num is ' + num)
+ expect(num == expectNum).assertTrue()
+ done()
+ })
+```
+
+### getPixelBytesNumber
+
+getPixelBytesNumber(callback: AsyncCallback\): void
+
+获取图像像素的总字节数。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------ |
+| callback | AsyncCallback\ | 是 | 通过回调返回结果。 |
+
+**示例：**
+
+```js
+pixelmap.getPixelBytesNumber((num) => {
+ console.info('TC_026-1 num is ' + num)
+ expect(num == expectNum).assertTrue()
+ done()
+ })
+```
+
+### release
+
+release(): void
+
+释放pixelmap对象，使用Promise形式返回释放结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**示例：**
+
+```js
+pixelmap.release()
+ expect(true).assertTrue()
+ done()
+```
+
+## image.createImageSource
+
+createImageSource(uri: string): ImageSource
+
+创建图片源。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------ | ---- | ---------- |
+| uri | string | 是 | 图片路径。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------- | ------------ |
+| ImageSource | 返回图片源。 |
+
+**示例：**
+
+```js
+const imageSourceApi = image.createImageSource('/data/local/tmp/test.jpg')
+```
+
+## image.createImageSource
+
+createImageSource(fd: number): ImageSource
+
+创建图片源。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------ | ---- | ------------------ |
+| fd | number | 是 | 基于fd创建图片源。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------- | ------------ |
+| ImageSource | 返回图片源。 |
+
+**示例：**
+
+```js
+const imageSourceApi = image.createImageSource(0)
+```
+
+## image.createImageSource
+
+createImageSource(data: ArrayBuffer): ImageSource
+
+创建图片源。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------- | ---- | ------ |
+| data | ArrayBuffer | 是 | 数组。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------- | ------------ |
+| ImageSource | 返回图片源。 |
+
+**示例：**
+
+```js
+const data = new ArrayBuffer(96);
+const imageSourceApi = image.createImageSource(data);
+```
+
+## image.createIncrementalSource
+
+createIncrementalSource(data: ArrayBuffer): ImageSource
+
+创建增量图片源。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ----------- | ---- | ---- |
+| data | ArrayBuffer | 是 | 数组 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------- | ------------ |
+| ImageSource | 返回图片源。 |
+
+**示例：**
+
+```js
+const data = new ArrayBuffer(96);
+const imageSourceApi = image.createIncrementalSource(data);
+```
+
+## ImageSource
+
+图片源类，用于获取图片相关信息。在调用ImageSource的方法前，需要先通过createImageSource构建一个ImageSource实例。
+
+### 属性
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ---------------- | -------------- | ---- | ---- | ------------------------------------------------------------ |
+| supportedFormats | Array\ | 是 | 否 | 支持的图片格式，包括：png，jpeg，wbmp，bmp，gif，webp，heif等。): void
+
+获取指定序号的图片信息，使用callback形式返回图片信息。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------------------------- | ---- | ----------------------------------------------- |
+| index | number | 是 | 图片序号，创建图片源时的序号，不选择时默认为0。 |
+| callback | AsyncCallback<[ImageInfo](#ImageInfo)> | 是 | 获取图片信息回调，异步返回图片信息对象。 |
+
+**示例：**
+
+```js
+it('TC_046', 0, async function (done) {
+ const imageSourceApi = image.createImageSource('/sdcard/test.jpg');
+ if (imageSourceApi == null) {
+ console.info('TC_046 create image source failed');
+ expect(false).assertTrue();
+ done();
+ } else {
+ imageSourceApi.getImageInfo(0,(error, imageInfo) => {
+ console.info('TC_046 imageInfo');
+ expect(imageInfo !== null).assertTrue();
+ done();
+ })
+ }
+ })
+```
+
+### getImageInfo
+
+getImageInfo(callback: AsyncCallback\): void
+
+获取指定序号的图片信息，使用callback形式返回图片信息。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------------------------------------- | ---- | ---------------------------------------- |
+| callback | AsyncCallback<[ImageInfo](#ImageInfo)> | 是 | 获取图片信息回调，异步返回图片信息对象。 |
+
+**示例：**
+
+```js
+imageSourceApi.getImageInfo(imageInfo => {
+ console.info('TC_045 imageInfo');
+ expect(imageInfo !== null).assertTrue();
+ done();
+ })
+```
+
+### getImageInfo
+
+getImageInfo(index?: number): Promise\
+
+获取图片信息，使用Promise形式返回图片信息。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| ----- | ------ | ---- | ----------------------------------------------- |
+| index | number | 否 | 图片序号，创建图片源时的序号，不选择时默认为0。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| --------------------------------- | ---------------------- |
+| Promise\<[ImageInfo](#ImageInfo)> | 返回获取到的图片信息。 |
+
+**示例：**
+
+```js
+imageSourceApi.getImageInfo(0)
+ .then(imageInfo => {
+ console.info('TC_047 imageInfo');
+ expect(imageInfo !== null).assertTrue();
+ done();
+ })
+```
+
+### getImageProperty
+
+getImageProperty(key:string, options?: GetImagePropertyOptions): Promise\
+
+获取图片中给定索引处图像的指定属性键的值。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+ **参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| ------- | --------------------------------------------------- | ---- | ------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 否 | 图片属性，包括图片序号与默认属性值。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------- | ------------------------------------------------------------ |
+| Promise\ | Promise实例，用于异步获取图片属性值，如获取失败则返回属性默认值。 |
+
+**示例：**
+
+```js
+const w = imageSourceApi.getImageProperty("ImageWidth")
+```
+
+### getImageProperty
+
+getImageProperty(key:string, callback: AsyncCallback\): void
+
+获取图片中给定索引处图像的指定属性键的值，使用callback形式返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+ **参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------- | ---- | ------------------------------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| callback | AsyncCallback\ | 是 | 获取图片属性回调，返回图片属性值，如获取失败则返回属性默认值。 |
+
+**示例：**
+
+```js
+const w = imageSourceApi.getImageProperty("ImageWidth",w=>{})
+```
+
+### getImageProperty
+
+getImageProperty(key:string, options: GetImagePropertyOptions, callback: AsyncCallback\): void
+
+获取图片指定属性键的值，callback形式返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------------------------------------------------- | ---- | ------------------------------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 是 | 图片属性，包括图片序号与默认属性值。 |
+| callback | AsyncCallback\ | 是 | 获取图片属性回调，返回图片属性值，如获取失败则返回属性默认值。 |
+
+**示例：**
+
+```js
+ imageSourceApi.getImageProperty("ImageWidth",PropertyOptions,(w)=>{})
+```
+
+### modifyImageProperty
+
+modifyImageProperty(key:string, value:string, options?: GetImagePropertyOptions): Promise\
+
+修改属性的值。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------- | --------------------------------------------------- | ---- | ------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| value | string | 是 | 属性值。 |
+| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 是 | 图片属性，包括图片序号与默认属性值。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | --------------------------- |
+| Promise\ | Promise实例，异步返回结果。 |
+
+**示例：**
+
+**示例：**
+
+```js
+imageSourceApi.modifyImageProperty("ImageWidth", "abc")
+ .then(() => {
+ const w = imageSourceApi.getImageProperty("ImageWidth")
+ console.info('w', w);
+ expect(w == 'abc').assertTrue();
+ done();
+ })
+```
+
+### modifyImageProperty
+
+modifyImageProperty(key:string, value:string, callback: AsyncCallback\): void
+
+修改属性的值，callback返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| value | string | 是 | 属性值。 |
+| callback | AsyncCallback\ | 是 | 修改属性值，callback返回结果。 |
+
+**示例：**
+
+```js
+imageSourceApi.modifyImageProperty("ImageWidth", "abc",() => {})
+```
+
+### modifyImageProperty
+
+modifyImageProperty(key:string, value:string, options: GetImagePropertyOptions,callback: AsyncCallback\): void
+
+修改属性的值，callback返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | --------------------------------------------------- | ---- | ------------------------------------ |
+| key | string | 是 | 图片属性名。 |
+| value | string | 是 | 属性值。 |
+| options | [GetImagePropertyOptions](#GetImagePropertyOptions) | 是 | 图片属性，包括图片序号与默认属性值。 |
+| callback | AsyncCallback\ | 是 | 修改属性值，callback返回结果。 |
+
+**示例：**
+
+```js
+let PropertyOptions = {
+ index:0,
+ defaultValue:'a'
+imageSourceApi.modifyImageProperty("ImageWidth", "abc",PropertyOptions,() => {
+
+ };
+```
+
+### createPixelMap
+
+createPixelMap(index: number, options: DecodingOptions, callback: AsyncCallback\): void
+
+通过图片解码参数创建pixelmap对象，使用callback形式返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| ------------- | ------------------------------------ | ---- | -------------------- |
+| options | [DecodingOptions](#DecodingOptions) | 是 | 解码参数。 |
+| index | number | 是 | 图片索引。 |
+| AsyncCallback | AsyncCallback<[PixelMap](#PixelMap)> | 是 | 回调表示成功或失败。 |
+
+**示例：**
+
+```js
+imageSourceApi.createPixelMap().then(pixelmap => {
+ console.info('TC_050-11 createPixelMap ');
+ expect(pixelmap !== null ).assertTrue();
+ done();
+ })
+```
+
+### createPixelMap
+
+createPixelMap(options: DecodingOptions, callback: AsyncCallback\): void
+
+通过图片解码参数创建pixelmap对象。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------ | ---- | -------------------- |
+| options | [DecodingOptions](#DecodingOptions) | 是 | 解码参数。 |
+| callback | AsyncCallback<[PixelMap](#PixelMap)> | 是 | 回调表示成功或失败。 |
+
+**示例：**
+
+```js
+let decodingOptions = {
+ sampleSize:1,
+ editable: true,
+ desiredSize:{ width:1, height:2},
+ rotateDegrees:10,
+ desiredPixelFormat:1,
+ desiredRegion: { size: { height: 1, width: 2 }, x: 0, y: 0 },
+ };
+ imageSourceApi.createPixelMap(0,decodingOptions, pixelmap => {
+ console.info('TC_050-1 createPixelMap ');
+ expect(pixelmap !== null ).assertTrue();
+ done();
+ })
+```
+
+### createPixelMap
+
+createPixelMap(opts: DecodingOptions, callback: AsyncCallback\): void
+
+通过图片解码参数创建pixelmap对象。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------ | ---- | -------------------- |
+| opts | [DecodingOptions](#DecodingOptions) | 是 | 解码参数。 |
+| callback | AsyncCallback<[PixelMap](#PixelMap)> | 是 | 回调表示成功或失败。 |
+
+**示例：**
+
+```js
+let decodingOptions = {
+ sampleSize:1,
+ editable: true,
+ desiredSize:{ width:1, height:2},
+ rotateDegrees:10,
+ desiredPixelFormat:1,
+ desiredRegion: { size: { height: 1, width: 2 }, x: 0, y: 0 },
+ index:1
+ };
+ imageSourceApi.createPixelMap(decodingOptions, pixelmap => {
+ console.info('TC_050-1 createPixelMap ');
+ expect(pixelmap !== null ).assertTrue();
+ done();
+ })
+```
+
+### updateData
+
+updateData(data: Array\, isFinal: boolean, offset: number, length: number, callback: AsyncCallback\): void
+
+更新增量数据。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ----------------------- | ---- | -------------------- |
+| data | Array\ | 是 | 增量数据。 |
+| isFinal | boolean | 是 | 是否更新完。 |
+| offset | number | 是 | 偏移量。 |
+| length | number | 是 | 数组长。 |
+| callback | AsyncCallback\ | 是 | 回调表示成功或失败。 |
+
+**示例：**
+
+```js
+imageSourceIncrementalSApi.updateData(array, false, 0, 10,(error,data )=> {
+ if(data !== undefined){
+ expect(data).assertTrue();
+ console.info('TC_053-1 success');
+ done();
+ }
+```
+
+### updateData
+
+updateData(data: Array\, isFinal: boolean, offset?: number, length?: number): Promise\
+
+更新增量数据。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| ------- | -------------- | ---- | ------------ |
+| data | Array\ | 是 | 增量数据。 |
+| isFinal | boolean | 是 | 是否更新完。 |
+| offset | boolean | 否 | 偏移量。 |
+| length | number | 否 | 数组长。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------- | --------------------------------- |
+| Promise\ | Promise实例，异步返回成功或失败。 |
+
+**示例：**
+
+```js
+ imageSourceIncrementalSApi.updateData(array, false, 0, 10).then(data => {
+ expect(data).assertTrue();
+ console.info('TC_053 success');
+ done();
+ })
+```
+
+### updateData
+
+updateData(data: Array\, isFinal: boolean, callback: AsyncCallback\): void
+
+更新增量数据。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ----------------------- | ---- | -------------------- |
+| data | Array\ | 是 | 增量数据。 |
+| isFinal | boolean | 是 | 是否更新完。 |
+| callback | AsyncCallback\ | 是 | 回调表示成功或失败。 |
+
+**示例：**
+
+```js
+imageSourceIncrementalSApi.updateData(array, false,(error,data) => {
+ if(data !== undefined){
+ expect(data).assertTrue();
+ console.info('TC_053-2 success');
+ done();
+ }
+```
+
+### release
+
+release(callback: AsyncCallback\): void
+
+释放图片源。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ---------------------------------- |
+| callback | AsyncCallback\ | 是 | 资源释放回调，失败时返回错误信息。 |
+
+**示例：**
+
+```js
+imageSourceApi.release(() => {
+ console.info('TC_044-1 Success');
+ expect(true).assertTrue();
+ done();
+ })
+ }
+```
+
+### release
+
+release(): Promise\
+
+释放图片源。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**返回值：**
+
+| 类型 | 说明 |
+| -------------- | --------------------------- |
+| Promise\ | Promise实例，异步返回结果。 |
+
+**示例：**
+
+```js
+ imageSourceApi.release(() => {
+ console.info('TC_044-1 Success');
+ expect(true).assertTrue();
+ done();
+ })
+```
+
+## image.createImagePacker
+
+createImagePacker(): ImagePacker
+
+创建imagepacker实例。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------- | ----------------- |
+| ImagePacker | 返回ImagePacker。 |
+
+**示例：**
+
+```js
+const imagePackerApi = image.createImagePacker();
+```
+
+## ImagePacker
+
+图片打包器类，用于图片压缩和打包。在调用ImagePacker的方法前，需要先通过createImagePacker构建一个ImagePacker实例。
+
+### 属性
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| ---------------- | -------------- | ---- | ---- | ------------------------------------------------------------ |
+| supportedFormats | Array\ | 是 | 否 | 图片打包支持的格式，jpg。>): void
+
+图片压缩或重新打包，使用callback形式返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------- | ---- | ---------------------------------- |
+| source | [ImageSource](#ImageSource) | 是 | 打包的图片源。 |
+| option | [PackingOption](#PackingOption) | 是 | 设置打包参数。 |
+| callback | AsyncCallback> | 是 | 获取图片打包回调，返回打包后数据。 |
+
+**示例：**
+
+```js
+let packOpts = { format:["image/jpeg"], quality:98 }
+ imagePackerApi.packing(imageSourceApi, packOpts, data => {
+ console.info('TC_062-1 finished');
+ expect(data !== null).assertTrue();
+ done();
+ })
+```
+
+### packing
+
+packing(source: ImageSource, option: PackingOption): Promise>
+
+图片压缩或重新打包，使用promise形式返回结果。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------------------------------- | ---- | -------------- |
+| source | [ImageSource](#ImageSource) | 是 | 打包的图片源。 |
+| option | [PackingOption](#PackingOption) | 是 | 设置打包参数。 |
+
+**返回值：**
+
+| 类型 | 说明 |
+| :---------------------- | :-------------------------------------------- |
+| Promise> | Promise实例，用于异步获取压缩或打包后的数据。 |
+
+**示例：**
+
+```js
+let packOpts = { format:["image/jpeg"], quality:98 }
+ imagePackerApi.packing(imageSourceApi, packOpts)
+ .then( data => {
+ console.info('TC_062 finished');
+ expect(data !== null).assertTrue();
+ done();
+ })
+```
+
+### release
+
+release(callback: AsyncCallback\): void
+
+释放packer对象。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------------------- | ---- | ---------------------- |
+| callback | AsyncCallback\ | 是 | 回调表示成功还是失败。 |
+
+**示例：**
+
+```js
+imagePackerApi.release(()=>{
+ console.info('TC_063-1 release');
+ expect(true).assertTrue();
+ done();
+```
+
+### release
+
+release(): Promise\
+
+释放packer对象。
+
+**系统能力：** SystemCapability.Multimedia.Image
+
+**返回值：**
+
+| 类型 | 说明 |
+| :------------- | :------------------------------ |
+| Promise\ | Promise实例，用于异步返回结果。 |
+
+**示例：**
+
+```js
+imagePackerApi.release();
+ console.info('TC_063 release');
+ expect(true).assertTrue();
+ done();
+```
+
+## PositionArea8+
diff --git a/zh-cn/application-dev/reference/apis/js-apis-observer.md b/zh-cn/application-dev/reference/apis/js-apis-observer.md
index 6babbe512afb4d6a4518b0ced6d0a08adb6302bf..e020047aa5e967808761fede6d7c06e4e407b2d8 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-observer.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-observer.md
@@ -177,3 +177,89 @@ observer.off('signalInfoChange', callback);
observer.off('signalInfoChange');
```
+
+## observer.on('callStateChange')\): void
获取网络状态，使用callback方式作为异步方法。
-需要ohos.permission.GET\_NETWORK\_INFO权限。
+**需要权限**：ohos.permission.GET_NETWORK_INFO。
**系统能力**：SystemCapability.Telephony.CoreService
@@ -104,7 +104,7 @@ getNetworkState\(slotId: number, callback: AsyncCallback\): void
获取网络状态，使用callback方式作为异步方法。
-需要ohos.permission.GET\_NETWORK\_INFO权限。
+**需要权限**：ohos.permission.GET_NETWORK_INFO。
**系统能力**：SystemCapability.Telephony.CoreService
@@ -131,7 +131,7 @@ getNetworkState\(slotId?: number\): Promise
获取网络状态，使用Promise方式作为异步方法。
-需要ohos.permission.GET\_NETWORK\_INFO权限。
+**需要权限**：ohos.permission.GET_NETWORK_INFO。
**系统能力**：SystemCapability.Telephony.CoreService
@@ -338,9 +338,9 @@ promise.then(data => {
isRadioOn\(callback: AsyncCallback\): void
-判断Radio是否打开，使用callback方式作为异步方法。
+判断主卡的Radio是否打开，使用callback方式作为异步方法。
-需要ohos.permission.GET\_NETWORK\_INFO权限。
+**需要权限**：ohos.permission.GET_NETWORK_INFO。
**系统能力**：SystemCapability.Telephony.CoreService
@@ -359,16 +359,49 @@ radio.isRadioOn((err, data) => {
```
-## radio.isRadioOn7+ 7+
+isRadioOn\(slotId: number, callback: AsyncCallback\): void
+
+判断指定卡槽位的Radio是否打开，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO。
+
+**系统能力**：SystemCapability.Telephony.CoreService
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------ | ---- | ------------------------------------------------------- |
+| slotId | number | 是 | 卡槽ID。 | 是 | 回调函数。7+
判断Radio是否打开，使用Promise方式作为异步方法。
-需要ohos.permission.GET\_NETWORK\_INFO权限。
+**需要权限**：ohos.permission.GET_NETWORK_INFO。
**系统能力**：SystemCapability.Telephony.CoreService
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------ | ---- | -------------------------------------- |
+| slotId | number | 否 | 卡槽ID。
**示例：**
```
-let promise = radio.isRadioOn();
+let slotId = 0;
+let promise = radio.isRadioOn(slotId);
promise.then(data => {
console.log(`isRadioOn success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
@@ -501,6 +535,7 @@ promise.then(data => {
| plmnNumeric | string | 注册网络的PLMN码。8+ | [RadioTechnology](#RadioTechnology) | 设备的无线接入技术。, specification: string, callback: AsyncCallba
根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.SmsMms
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -42,6 +44,8 @@ createMessage\(pdu: Array, specification: string\): Promise\): void
获取发送短信的默认SIM卡槽ID，使用callback方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.SmsMms
+
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
@@ -129,6 +137,8 @@ getDefaultSmsSlotId\(\): Promise
获取发送短信的默认SIM卡槽ID，使用Promise方式作为异步方法。
+**系统能力**：SystemCapability.Telephony.SmsMms
+
**返回值：**
| 类型 | 说明 |
@@ -153,7 +163,9 @@ setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback\):
设置短信服务中心（SMSC）地址，使用callback方式作为异步方法。
-需要ohos.permission.SET\_TELEPHONY\_STATE权限，该权限为系统权限。
+**需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限
+
+**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
@@ -180,7 +192,9 @@ setSmscAddr\(slotId: number, smscAddr: string\): Promise
设置短信服务中心（SMSC）地址，使用Promise方式作为异步方法。
-需要ohos.permission.SET\_TELEPHONY\_STATE权限，该权限为系统权限。
+**需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限
+
+**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
@@ -215,7 +229,9 @@ getSmscAddr\(slotId: number, callback: AsyncCallback\): void
获取短信服务中心（SMSC）地址，使用callback方式作为异步方法。
-需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
+**需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限
+
+**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
@@ -240,7 +256,9 @@ getSmscAddr\(slotId: number\): Promise
获取短信服务中心（SMSC）地址，使用Promise方式作为异步方法。
-需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
+**需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限
+
+**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
@@ -271,6 +289,8 @@ promise.then(data => {
短信实例。
+**系统能力**：SystemCapability.Telephony.SmsMms
+
| 变量 | 类型 | 说明 |
| ------------------------ | --------------------------------------- | ------------------------------------------------------------ |
| emailAddress | string | 电子邮件地址。 |
@@ -294,13 +314,13 @@ promise.then(data => {
短信类型。
-| 变量 | 值 | 说明 |
-| ---------------- | ---- | ---------------------------------------- |
-| UNKNOWN | 0 | 未知类型。 |
-| INSTANT_MESSAGE | 1 | 即时消息，收到后立即显示。 |
-| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。 |
-| SIM_MESSAGE | 3 | 包含SIM卡信息的短信，需要存储在SIM卡中。 |
-| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。 |
+| 变量 | 值 | 说明 |
+| ---------------- | ---- | ------------------------------------------------------------ |
+| UNKNOWN | 0 | 未知类型。): void
+
+获取默认移动数据的SIM卡，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ----------------------- | ---- | ------------------------------------------ |
+| callback | AsyncCallback\ | 是 | 回调函数。
+
+获取默认移动数据的SIM卡，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**返回值：**
+
+| 类型 | 说明 |
+| ----------------- | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回获取默认移动数据的SIM卡。): void
+
+获取蜂窝数据业务的上下行状态，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ---------------------------------------------- | ---- | ---------- |
+| callback | AsyncCallback\<[DataFlowType](#DataFlowType)\> | 是 | 回调函数。 |
+
+**示例：**
+
+```
+data.getCellularDataFlowType((err, data) => {
+ console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
+});
+```
+
+## data.getCellularDataFlowType
+
+获取蜂窝数据业务的上下行状态，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**返回值：**
+
+| 类型 | 说明 |
+| ---------------------------------------- | ----------------------------------------------- |
+| Promise\<[DataFlowType](#DataFlowType)\> | 以Promise形式返回获取蜂窝数据业务的上下行状态。 |
+
+**示例：**
+
+```
+let promise = data.getCellularDataFlowType();
+promise.then((data) => {
+ console.log(`test success, promise: data->${JSON.stringify(data)}`);
+}).catch((err) => {
+ console.error(`test fail, promise: err->${JSON.stringify(err)}`);
+});
+```
+
+## data.getCellularDataState): void
+
+获取分组交换域（PS域）的连接状态，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------------------------------------ | ---- | ---------- |
+| callback | AsyncCallback\<[DataConnectState](#DataConnectState)\> | 是 | 回调函数。 |
+
+**示例：**
+
+```
+data.getCellularDataState((err, data) => {
+ console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
+});
+```
+
+## data.getCellularDataState
+
+获取分组交换域(PS域)的连接状态，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------------------------------------ | ------------------------------------- |
+| Promise\<[DataConnectState](#DataConnectState)\> | 以Promise形式返回获取PS域的连接状态。 |
+
+**示例：**
+
+```
+let promise = data.getCellularDataState();
+promise.then((data) => {
+ console.log(`test success, promise: data->${JSON.stringify(data)}`);
+}).catch((err) => {
+ console.error(`test fail, promise: err->${JSON.stringify(err)}`);
+});
+```
+
+## data.isCellularDataEnabled): void
+
+检查蜂窝数据业务是否启用，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------ | ---- | ------------------------------------------------------------ |
+| callback | AsyncCallback\ | 是 | 回调函数。
+
+检查蜂窝数据业务是否启用，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**返回值：**
+
+| 类型 | 说明 |
+| ------------------ | ------------------------------------------------------------ |
+| Promise\ | 以Promise形式返回检查蜂窝数据业务是否启用。): void
+
+检查蜂窝数据业务是否启用漫游，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | ------------------------ | ---- | ------------------------------------------------------------ |
+| slotId | number | 是 | 卡槽ID。 | 是 | 回调函数。
+
+检查蜂窝数据业务是否启用漫游，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.GET_NETWORK_INFO
+
+**系统能力**：SystemCapability.Telephony.CellularData
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| ------ | ------ | ---- | ---------------------------------------- |
+| slotId | number | 是 | 卡槽ID。 | 以Promise形式返回检查蜂窝数据业务是否启用漫游。7+ 7+ 7+ 7+ | boolean | 是 | 是 | 状态栏图标是否为高亮状态。 |
-| navigationBarColor | string | 是 | 是 | 导航栏颜色，为16进制颜色，例如"\#00FF00"或"\#FF00FF00"。 |
-| isNavigationBarLightIcon7+ | boolean | 是 | 是 | 导航栏图标是否为高亮状态。 |
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| -------------------------------------- | -------- | ---- | ---- | ------------------------------------------------------------ |
+| statusBarColor | string | 是 | 是 | 状态栏背景颜色，为16进制RGB或ARGB颜色，例如"\#00FF00"或"\#FF00FF00"。7+ | boolean | 否 | 是 | 状态栏图标是否为高亮状态。8+ | string | 否 | 是 | 状态栏文字颜色。7+ | boolean | 否 | 否 | 导航栏图标是否为高亮状态。8+ | string | 否 | 是 | 导航栏文字颜色。8+ 8+ 7+ 7+ 7+ 7+ | [Rect](#rect) | 是 | 否 | 窗口尺寸。 |
-| type7+ | [WindowType](#windowtype) | 是 | 否 | 窗口类型。 |
-| brightness | number | 是 | 是 | 屏幕亮度，取值范围为0~1，1表示最大亮度值。 |
-| isTransparent7+ | boolean | 是 | 是 | 窗口是否透明，默认为false。 |
-| isFullScreen | boolean | 是 | 是 | 是否全屏，默认为false。 |
-| isKeepScreenOn | boolean | 是 | 是 | 屏幕是否常亮，默认为false。 |
-| dimBehindValue7+ | number | 是 | 是 | 靠后的窗口的暗度值，取值范围为0~1，1表示最暗。 |
-| isLayoutFullScreen7+ | boolean | 是 | 是 | 窗口是否为沉浸式，默认为false。 |
-| focusable7+ | boolean | 是 | 是 | 窗口是否可聚焦，默认为true。 |
-| touchable7+ | boolean | 是 | 是 | 窗口是否可触摸，默认为true。 |
-| isPrivacyMode7+ | boolean | 是 | 是 | 隐私模式，默认为false。 |
-| isRoundCorner7+ | boolean | 是 | 是 | 窗口是否为圆角。 |
-
+| 名称 | 参数类型 | 可读 | 可写 | 说明 |
+| ------------------------------- | ------------------------- | ---- | ---- | ------------------------------------------------------------ |
+| windowRect7+ | [Rect](#rect) | 是 | 是 | 窗口尺寸。7+ | [WindowType](#windowtype) | 是 | 是 | 窗口类型。7+ | boolean | 是 | 是 | 窗口是否为沉浸式，默认为false。7+ | boolean | 是 | 否 | 窗口是否可聚焦，默认为true。7+ | boolean | 是 | 否 | 窗口是否可触摸，默认为true。7+ 8+ 7 7
-## window.create7+
+create(id: string, type: WindowType): Promise<Window>
-create(id: string, type: WindowType, callback: AsyncCallback<Window>): void
+创建子窗口，使用Promise方式作为异步方法。
-创建子窗口。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | id | string | 是 | 窗口id。 |
- | type | [WindowType](#windowtype) | 是 | 窗口类型。 |
- | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前窗口对象。 |
-- 示例
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------------------------- | ---- | ---------- |
+ | id | string | 是 | 窗口id。 |
+ | type | [WindowType](#windowtype) | 是 | 窗口类型。 |
+- 返回值
-```
- window.create("first", 1, (err, data) => {
- windowClass = data;
- if (err) {
- console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('SubWindow created. Data: ' + JSON.stringify(data))
- windowClass.resetSize(500, 1000);
- windowClass.setOutsideTouchable(true);
- windowClass.loadContent("pages/index/index", (err, data) => {
+ | 类型 | 说明 |
+ | -------------------------------- | ------------------------------------------------- |
+ | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的子窗口对象。 |
+
+- 示例
+
+ ```
+ let promise = window.create("first", window.WindowType.TYPE_APP);
+ promise.then((data)=> {
+ console.info('SubWindow created. Data: ' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to create the subWindow. Cause: ' + JSON.stringify(err));
});
-})
-```
+ ```
+## window.create8+
-## window.find7+
+create(ctx: Context, id: string, type: WindowType, callback: AsyncCallback<Window>): void
+
+当Context为[ServiceExtensionContext](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md)时，创建系统窗口，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
+ | ctx | [Context](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-Context.md) | 是 | 当前应用上下文信息, 为ServiceExtensionContext的基类。 |
+ | id | string | 是 | 窗口id。 |
+ | type | [WindowType](#windowtype) | 是 | 窗口类型。 |
+ | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前窗口对象。 |
+
+- 示例
+
+ ```
+ window.create(this.context, "alertWindow", window.WindowType.TYPE_SYSTEM_ALERT, (err, data) => {
+ windowClass = data;
+ if (err) {
+ console.error('Failed to create the Window. Cause: ' + JSON.stringify(err));
+ return;
+ }
+ console.info('Window created. Data: ' + JSON.stringify(data))
+ windowClass.resetSize(500, 1000);
+ });
+ ```
+
+## window.create8+
+
+function create(ctx: Context, id: string, type: WindowType): Promise<Window>
+
+当Context为[ServiceExtensionContext](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-service-extension-context.md)时，创建系统窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
+ | ctx | [Context](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-Context.md) | 是 | 当前应用上下文信息, 为ServiceExtensionContext的基类。 |
+ | id | string | 是 | 窗口id。 |
+ | type | [WindowType](#windowtype) | 是 | 窗口类型。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | -------------------------------- | ----------------------------------------------- |
+ | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前创建的窗口对象。 |
+
+- 示例
+
+ ```
+ let promise = window.create(this.context, "alertWindow", window.WindowType.TYPE_SYSTEM_ALERT);
+ promise.then((data)=> {
+ console.info('Window created. Data: ' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to create the Window. Cause: ' + JSON.stringify(err));
+ });
+ ```
+
+## window.find7+ 7+
+
+find(id: string): Promise<Window>
+
+查找id所对应的窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------ | ---- | -------- |
+ | id | string | 是 | 窗口id。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | -------------------------------- | ----------------------------------------------- |
+ | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前查找的窗口对象。 |
+
+- 示例
+
+ ```
+ let promise = window.find("first");
+ promise.then((data)=> {
+ console.info('window found. Data: ' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to find the Window. Cause: ' + JSON.stringify(err));
+ });
```
+## window.getTopWindow7+
+getTopWindow(callback: AsyncCallback<Window>): void
-getAbilityWindowMode(callback: AsyncCallback<WindowMode>): void
+获取当前应用内最后显示的窗口，使用callback方式作为异步方法。
-获取当前窗口模式。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<[WindowMode](#windowmode)> | 是 | 回调返回当前窗口模式。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------------------------------------- | ---- | -------------------------------------- |
+ | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前应用内最后显示的窗口对象。 |
- 示例
+
```
- window.getAbilityWindowMode((err, data) => {
+ window.getTopWindow((err, data) => {
if (err) {
- console.error('Failed to obtain the window mode. Cause:' + JSON.stringify(err));
+ console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
return;
}
- console.info('Window mode obtained. Data:' + JSON.stringify(data))
-
+ console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
+ windowClass = data;
});
```
+## window.getTopWindow
+
+getTopWindow(): Promise<Window>
+
+获取当前应用内最后显示的窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 返回值
+
+ | 类型 | 说明 |
+ | -------------------------------- | --------------------------------------------------------- |
+ | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前应用内最后显示的窗口对象。 |
+
+- 示例
+
+ ```
+ let promise = window.getTopWindow();
+ promise.then((data)=> {
+ console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
+ })
+ ```
+
+## window.getTopWindow8+
-## window.getSplitScreenBounds7+
+getTopWindow(ctx: Context, callback: AsyncCallback<Window>): void
-getSplitScreenBounds(splitRatio: SplitRatio, callback: AsyncCallback<SplitScreenBoundsInfo>): void
+获取当前应用内最后显示的窗口，使用callback方式作为异步方法。
-获取分屏多窗口的位置和区域.。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | splitRatio | SplitRatio | 是 | 表示分屏比例，默认值为1:1，传值1表示1:2，传值2为2:1。 |
- | callback | AsyncCallback<[SplitScreenBoundsInfo](#splitscreenboundsinfo)> | 是 | 回调返回一个SplitScreenBoundsInfo对象，表示分屏边界相关信息。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------------------------------------------ | ---- | -------------------------------------- |
+ | ctx | [Context](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-Context.md) | 是 | 当前应用上下文信息。 |
+ | callback | AsyncCallback<[Window](#window)> | 是 | 回调返回当前应用内最后显示的窗口对象。 |
- 示例
+
```
- var splitRatio = '1:1';
- window.getSplitScreenBounds(splitRatio, (err, data) => {
+ window.getTopWindow(this.context, (err, data) => {
if (err) {
- console.error('Failed to obtain the split-screen boundary information. Cause: ' + JSON.stringify(err));
+ console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
return;
}
- console.info('Split-screen boundary information obtained. Data: ' + JSON.stringify(data))
-
+ console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data));
+ windowClass = data;
});
```
+## window.getTopWindow8+
+
+getTopWindow(ctx: Context): Promise<Window>
+
+获取当前应用内最后显示的窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------------------------------------------------------------ | ---- | -------------------- |
+ | ctx | [Context](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-Context.md) | 是 | 当前应用上下文信息。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | -------------------------------- | --------------------------------------------------------- |
+ | Promise<[Window](#window)> | 以Promise形式返回结果，返回当前应用内最后显示的窗口对象。 |
+
+- 示例
+
+ ```
+ let promise = window.getTopWindow(this.context);
+ promise.then((data)=> {
+ console.info('Succeeded in obtaining the top window. Data: ' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(err));
+ })
+ ```
+
+## on('systemBarTintChange')8+
+
+on(type: 'systemBarTintChange', callback: Callback<SystemBarTintState>): void
+
+注册状态栏、导航栏的监听函数。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ |
+ | type | string | 是 | 设置监听类型。8+
+
+off(type: 'systemBarTintChange', callback?: Callback<SystemBarTintState >): void
+
+关闭监听。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | --------------------------------------------------------- | ---- | ------------------------------------------------------------ |
+ | type | string | 是 | 设置监听类型。7+
+
+hide (callback: AsyncCallback<void>): void
+
+隐藏当前窗口，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | ---------- |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+- 示例
+
+ ```
+ windowClass.hide((err) => {
+ if (err) {
+ console.error('Failed to hide the window. Cause: ' + JSON.stringify(err));
+ return;
+ }
+ console.info('window hidden.')
+ })
+ ```
+
+### hide7+
+
+hide(): Promise<void>;
+
+隐藏当前窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
+
+- 示例
+
+ ```
+ let promise = windowClass.hide();
+ promise.then(()=> {
+ console.info('window hidden.')
+ }).catch((err)=>{
+ console.error('Failed to hide the window. Cause: ' + JSON.stringify(err));
+ })
+ ```
+
+### show7+
+
+show(callback: AsyncCallback<void>): void
+
+显示当前窗口，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | ---------- |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+- 示例
+
+ ```
+ windowClass.show((err) => {
+ if (err) {
+ console.error('Failed to show the window. Cause: ' + JSON.stringify(err));
+ return;
+ }
+ console.info('Succeeded in showing the window.')
+ })
+ ```
+
+### show7+
+
+show(): Promise<void>
+
+显示当前窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
+
+- 示例
+
+ ```
+ let promise = windowClass.show();
+ promise.then(()=> {
+ console.info('Succeeded in showing the window.')
+ }).catch((err)=>{
+ console.error('Failed to show the window. Cause: ' + JSON.stringify(err));
+ })
+ ```
+
+### destroy7+
+
+destroy(callback: AsyncCallback<void>): void
+
+销毁当前窗口，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | ---------- |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+- 示例
+
+ ```
+ windowClass.destroy((err) => {
+ if (err) {
+ console.error('Failed to destroy the window. Cause:' + JSON.stringify(err));
+ return;
+ }
+ console.info('Succeeded in destroying the window.')
+ })
+ ```
+
+### destroy7+
+
+destroy(): Promise<void>
+
+销毁当前窗口，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
+
+- 示例
+
+ ```
+ let promise = windowClass.destroy();
+ promise.then(()=> {
+ console.info('Succeeded in destroying the window.')
+ }).catch((err)=>{
+ console.error('Failed to destroy the window. Cause: ' + JSON.stringify(err));
+ })
+ ```
+
+### moveTo7+
-## window.isFloatingAbilityWindowVisible7+
+moveTo(x: number, y: number, callback: AsyncCallback<void>): void
-isFloatingAbilityWindowVisible(callback:AsyncCallback<boolean>): void
+移动窗口位置，使用callback方式作为异步方法。
-悬浮窗是否显示可见。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<boolean> | 是 | 回调返回一个boolean对象，表示悬浮窗是否可见。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | --------------------------------------- |
+ | x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 |
+ | y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
- window.isFloatingAbilityWindowVisible( (err, data) => {
+ windowClass.moveTo(300, 300, (err)=>{
if (err) {
- console.error('Failed to check whether the floating window is visible. Cause:' + JSON.stringify(err));
+ console.error('Failed to move the window. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in checking whether the floating window is visible. Data:' + JSON.stringify(data))
+ console.info('Window moved.');
});
```
+### moveTo7+
-## window.setSplitBarVisibility7+
+moveTo(x: number, y: number): Promise<void>
-setSplitBarVisibility(isVisibility: boolean, callback: AsyncCallback<void>): void
+移动窗口位置，使用Promise方式作为异步方法。
-设置分屏线是否可见。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 说明 |
- | -------- | -------- | -------- |
- | isVisibility | boolean | 表示分屏线是否是否显示，true为显示，false为显示。 |
- | callback | AsyncCallback<void> | callback形式返回结果。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------ | ---- | --------------------------------------- |
+ | x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 |
+ | y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
- var isVisibility = false;
- window.setSplitBarVisibility(isVisibility , (err, data) => {
+ let promise = windowClass.moveTo(300, 300);
+ promise.then(()=> {
+ console.info('Window moved.')
+ }).catch((err)=>{
+ console.error('Failed to move the window. Cause: ' + JSON.stringify(err));
+ })
+ ```
+
+### resetSize7+
+
+resetSize(width: number, height: number, callback: AsyncCallback<void>): void
+
+改变当前窗口大小，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | ---------------- |
+ | width | number | 是 | 目标窗口的宽度。 |
+ | height | number | 是 | 目标窗口的高度。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+- 示例
+
+ ```
+ windowClass.resetSize(500, 1000, (err) => {
if (err) {
- console.error('Failed to set the divider to be invisible. Cause:' + JSON.stringify(err));
+ console.error('Failed to change the window size. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the divider to be invisible. Data:' + JSON.stringify(data))
+ console.info('Window size changed.');
});
```
+### resetSize7+
-## WindowType7+ 7+ 7+ 7+
-| 名称 | 默认值 | 说明 |
-| -------- | -------- | -------- |
-| UNDEFINED | 1 | 表示APP未定义窗口模式。 |
-| FULLSCREEN | 2 | 表示APP全屏模式。 |
-| PRIMARY | 3 | 表示APP分屏多窗口主要模式。 |
-| SECONDARY | 4 | 表示APP分屏多窗口次要模式。 |
-| FLOATING | 5 | 表示APP自由悬浮形式窗口模式。 |
+setWindowType(type: WindowType, callback: AsyncCallback<void>): void
+设置窗口类型，使用callback方式作为异步方法。
-## splitMode7+ 7+
+
+setWindowType(type: WindowType): Promise<void>
+
+设置窗口类型，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 参数
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------------------------- | ---- | ---------- |
+ | type | [WindowType](#windowtype) | 是 | 窗口类型。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
+
+- 示例
-下列API示例中都需使用[getTopWindow()](#window-gettopwindow)先获取到Window实例，再通过此实例调用对应方法。
+ ```
+ var type = window.TYPE_APP;
+ let promise = windowClass.setWindowType(type);
+ promise.then(()=> {
+ console.info('Succeeded in setting the window type.')
+ }).catch((err)=>{
+ console.error('Failed to set the window type. Cause: ' + JSON.stringify(err));
+ });
+ ```
+### getProperties
-### setBrightness
+getProperties(callback: AsyncCallback<WindowProperties>): void
-setBrightness(brightness:number, callback: AsyncCallback<void>): void
+获取当前窗口的属性，使用callback方式作为异步方法返回WindowProperties。
-设置屏幕亮度值。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | brightness | number | 是 | 屏幕亮度值，值为0-1之间。1表示最亮。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ---------------------------------------------------------- | ---- | ------------------ |
+ | callback | AsyncCallback<[WindowProperties](#windowproperties)> | 是 | 回调返回窗口属性。 |
- 示例
+
```
- var brightness = 10;
- windowClass.setBrightness(brightness, (err, data) => {
+ windowClass.getProperties((err, data) => {
if (err) {
- console.error('Failed to set the brightness. Cause: ' + JSON.stringify(err));
+ console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the brightness. Data: ' + JSON.stringify(data));
+ console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data));
});
```
+### getProperties
+
+getProperties(): Promise<WindowProperties>
-### setBackgroundColor
+获取当前窗口的属性，使用promise方式作为异步方法返回WindowProperties。
-setBackgroundColor(color: string, callback: AsyncCallback<void>): void
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
-设置窗口的背景色。
+- 返回值
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | color | string | 是 | 需要设置的背景色，为16进制颜色，例如"\#00FF00"或"\#FF00FF00"。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+ | 类型 | 说明 |
+ | ---------------------------------------------------- | ------------------------------------- |
+ | Promise<[WindowProperties](#windowproperties)> | 以Promise形式返回结果，返回窗口属性。 |
- 示例
+
```
- var color = '#00ff33';
- windowClass.setBackgroundColor(color, (err, data) => {
- if (err) {
- console.error('Failed to set the background color. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in setting the background color. Data: ' + JSON.stringify(data));
- });
+ let promise = windowClass.getProperties();
+ promise.then((data)=> {
+ console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(err));
+ });
```
-### setTransparent7+
+### getAvoidArea7+
+
+getAvoidArea(type: AvoidAreaType, callback: AsyncCallback<AvoidArea>): void
-setTransparent(isTransparent: boolean, callback: AsyncCallback<void>): void
+获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用callback方式作为异步方法。
-设置窗口是否透明。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isTransparent | boolean | 是 | 窗口是否透明。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
+ | type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 |
+ | callback | AsyncCallback<[AvoidArea](#avoidarea)> | 是 | 回调返回窗口内容规避区域。 |
- 示例
+
```
- var isTransparent = true;
- windowClass.setTransparent(isTransparent, (err, data) => {
+ var type = window.AvoidAreaType.TYPE_SYSTEM;
+ windowClass.getAvoidArea(type, (err, data) => {
if (err) {
- console.error('Failed to set the window to be transparent. Cause: ' + JSON.stringify(err));
+ console.error('Failed to obtain the area. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the window to be transparent. Data: ' + JSON.stringify(data))
+ console.info('Succeeded in obtaining the area. Data:' + JSON.stringify(data));
});
```
-### setFullScreen
+### getAvoidArea7+
-setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void
+getAvoidArea(type: AvoidAreaType): Promise<AvoidArea>
-设置是否为全屏状态。
+获取窗口内容规避的区域，如系统的系统栏区域、凹凸区域。使用promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isFullScreen | boolean | 是 | 是否设为全屏状态。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ------------------------------- | ---- | ------------------------------------------------------------ |
+ | type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | -------------------------------------- | --------------------------------------------- |
+ | Promise<[AvoidArea](#avoidarea)> | 以Promise形式返回结果，返回窗口内容规避区域。 |
- 示例
+
```
- var isFullScreen = true;
- windowClass.setFullScreen(isFullScreen, (err, data) => {
- if (err) {
- console.error('Failed to enable the full-screen mode. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in enabling the full-screen mode. Data: ' + JSON.stringify(data));
- });
+ let promise = windowClass.getAvoidArea();
+ promise.then((data)=> {
+ console.info('Succeeded in obtaining the area. Data:' + JSON.stringify(data))
+ }).catch((err)=>{
+ console.error('Failed to obtain the area. Cause:' + JSON.stringify(err));
+ });
```
-### setKeepScreenOn
+### setFullScreen
+
+setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void
-setKeepScreenOn(isKeepScreenOn: boolean, callback: AsyncCallback<void>): void
+设置是否为全屏状态，使用callback方式作为异步方法。
-设置屏幕是否为常亮状态。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isKeepScreenOn | boolean | 是 | 是否设置为屏幕常亮状态。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------------ | ------------------------- | ---- | ---------------------------------------------- |
+ | isFullScreen | boolean | 是 | 是否设为全屏状态，且全屏状态隐藏状态栏导航栏。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
- var isKeepScreenOn = true;
- windowClass.setKeepScreenOn(isKeepScreenOn, (err, data) => {
+ var isFullScreen = true;
+ windowClass.setFullScreen(isFullScreen, (err) => {
if (err) {
- console.error('Failed to set the screen to be always on. Cause: ' + JSON.stringify(err));
+ console.error('Failed to enable the full-screen mode. Cause: ' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the screen to be always on. Data: ' + JSON.stringify(data));
+ console.info('Succeeded in enabling the full-screen mode.');
});
```
-### setWindowType7+
-
-setWindowType(type: WindowType, callback: AsyncCallback<void>): void
+### setFullScreen
-设置窗口类型。
+setFullScreen(isFullScreen: boolean): Promise<void>
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | type | [WindowType](#windowtype7) | 是 |窗口类型。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+设置是否为全屏状态，使用Promise方式作为异步方法。
-- 示例
- ```
- var type = window.TYPE_APP;
- windowClass.setWindowType(type, (err, data) => {
- if (err) {
- console.error('Failed to set the window type. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in setting the window type. Data: ' + JSON.stringify(data))
- });
- ```
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
-### setDimBehind7+
+- 参数
-setDimBehind(dimBehindValue: number, callback: AsyncCallback<void>): void
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------------ | ------- | ---- | ---------------------------------------------- |
+ | isFullScreen | boolean | 是 | 是否设为全屏状态，且全屏状态隐藏状态栏导航栏。 |
-窗口叠加时，设备有子窗口的情况下设置靠后的窗口的暗度值。
+- 返回值
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | dimBehindValue | number | 是 | 表示靠后的窗口的暗度值，取值范围为0-1，1表示最暗。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
- windowClass.setDimBehind(0.5, (err, data) => {
- if (err) {
- console.error('Failed to set the dimness. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in setting the dimness. Data:' + JSON.stringify(data));
+ var isFullScreen = true;
+ let promise = windowClass.setFullScreen(isFullScreen);
+ promise.then(()=> {
+ console.info('Succeeded in enabling the full-screen mode.'))
+ }).catch((err)=>{
+ console.error('Failed to enable the full-screen mode. Cause: ' + JSON.stringify(err));
});
```
@@ -498,121 +980,119 @@ setDimBehind(dimBehindValue: number, callback: AsyncCallback<void>): void
setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void>): void
-设置窗口的布局是否为全屏显示状态。
+设置窗口的布局是否为全屏显示状态，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ |
+ | isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
var isLayoutFullScreen= true;
- windowClass.setLayoutFullScreen(isLayoutFullScreen, (err, data) => {
+ windowClass.setLayoutFullScreen(isLayoutFullScreen, (err) => {
if (err) {
console.error('Failed to set the window layout to full-screen mode. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the window layout to full-screen mode. Data:' + JSON.stringify(data));
+ console.info('Succeeded in setting the window layout to full-screen mode.');
});
```
-### setFocusable7+
-
-setFocusable(isFocusable: boolean, callback: AsyncCallback<void>): void
+### setLayoutFullScreen7+
-设置点击时是否支持切换焦点窗口。
+setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void>
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isFocusable | boolean | 是 | 点击时是否支持切换焦点窗口。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+设置窗口的布局是否为全屏显示状态，使用Promise方式作为异步方法。
-- 示例
- ```
- var isFocusable= true;
- windowClass.setFocusable(isFocusable, (err, data) => {
- if (err) {
- console.error('Failed to set the window to be focusable. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in setting the window to be focusable. Data: ' + JSON.stringify(data));
- });
- ```
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
-### setTouchable7+
+- 参数
-setTouchable(isTouchable: boolean, callback: AsyncCallback<void>): void
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------------------ | ------- | ---- | ------------------------------------------------------------ |
+ | isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态，且全屏状态下状态栏、导航栏仍然显示。 |
-设置窗口是否为可触状态。
+- 返回值
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isTouchable | boolean | 是 | 窗口是否为可触状态。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
- var isTouchable = true;
- windowClass.setTouchable(isTouchable, (err, data) => {
- if (err) {
- console.error('Failed to set the window to be touchable. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in setting the window to be touchable. Data:' + JSON.stringify(data));
-
+ var isLayoutFullScreen = true;
+ let promise = windowClass.setLayoutFullScreen(isLayoutFullScreen);
+ promise.then(()=> {
+ console.info('Succeeded in setting the window layout to full-screen mode.'))
+ }).catch((err)=>{
+ console.error('Failed to set the window layout to full-screen mode. Cause:' + JSON.stringify(err));
});
```
-### setPrivacyMode7+
+### setSystemBarEnable7+
+
+setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback<void>): void
-setPrivacyMode(isPrivacyMode: boolean, callback: AsyncCallback<void>): void
+设置导航栏、状态栏的可见模式，使用callback方式作为异步方法。
-设置窗口是否为隐私模式。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | isPrivacyMode | boolean | 是 | 窗口是否为隐私模式。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | ------------------------------------------------------------ |
+ | names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"], 不设置，则默认不显示。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
- var isPrivacyMode = true;
- windowClass.setPrivacyMode(isPrivacyMode, (err, data) => {
+ var names = ["status", "navigation"];
+ windowClass.setSystemBarEnable(names, (err) => {
if (err) {
- console.error('Failed to set the window to privacy mode. Cause:' + JSON.stringify(err));
+ console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the window to privacy mode. Data:' + JSON.stringify(data));
-
+ console.info('Succeeded in setting the system bar to be visible.');
});
```
### setSystemBarEnable7+
-setSystemBarEnable(names: Array, callback: AsyncCallback<void>): void
+setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void>
+
+设置导航栏、状态栏的可见模式，使用Promise方式作为异步方法。
-设置导航栏、状态栏的可见模式。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"]。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------ | ----- | ---- | ------------------------------------------------------------ |
+ | names | Array | 是 | 设置状态栏和导航栏是否显示。例如，需全部显示，该参数设置为["status", "navigation"], 不设置，则默认不显示。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
var names = ["status", "navigation"];
- windowClass.setSystemBarEnable(names, (err, data) => {
- if (err) {
- console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in setting the system bar to be visible. Data: ' + JSON.stringify(data));
+ let promise = windowClass.setSystemBarEnable(names);
+ promise.then(()=> {
+ console.info('Succeeded in setting the system bar to be visible.'))
+ }).catch((err)=>{
+ console.error('Failed to set the system bar to be visible. Cause:' + JSON.stringify(err));
});
```
@@ -620,343 +1100,394 @@ setSystemBarEnable(names: Array, callback: AsyncCallback<void>): void
setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback<void>): void
-设置窗口内导航条状态栏的属性。
+设置窗口内导航栏、状态栏的属性，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航条状态栏的属性。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------------------- | ------------------------------------------- | ---- | -------------------- |
+ | SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航栏状态栏的属性。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
var SystemBarProperties={
statusBarColor: '#ff00ff',
navigationBarColor: '#00ff00',
//以下两个属性从API Version7开始支持
isStatusBarLightIcon: true,
- isNavigationBarLightIcon:false
+ isNavigationBarLightIcon:false,
+ //以下两个属性从API Version8开始支持
+ statusBarContentColor:'#ffffff'
+ navigationBarContentColor:'#00ffff'
};
- windowClass.setSystemBarProperties(SystemBarProperties, (err, data) => {
+ windowClass.setSystemBarProperties(SystemBarProperties, (err) => {
if (err) {
console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the system bar properties. Data: ' + JSON.stringify(data));
+ console.info('Succeeded in setting the system bar properties.');
});
```
-### getProperties
+### setSystemBarProperties
-getProperties(callback: AsyncCallback<WindowProperties>): void
+setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void>
-获取当前窗口的属性，异步返回WindowProperties。
+设置窗口内导航栏、状态栏的属性，使用Promise方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<[WindowProperties](#windowproperties)> | 是 | 回调返回窗口属性。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------------------- | ------------------------------------------- | ---- | -------------------- |
+ | SystemBarProperties | [SystemBarProperties](#systembarproperties) | 是 | 导航栏状态栏的属性。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
- windowClass.getProperties((err, data) => {
- if (err) {
- console.error('Failed to obtain the window properties. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in obtaining the window properties. Data: ' + JSON.stringify(data));
+ var SystemBarProperties={
+ statusBarColor: '#ff00ff',
+ navigationBarColor: '#00ff00',
+ //以下两个属性从API Version7开始支持
+ isStatusBarLightIcon: true,
+ isNavigationBarLightIcon:false,
+ //以下两个属性从API Version8开始支持
+ statusBarContentColor:'#ffffff'
+ navigationBarContentColor:'#00ffff'
+ };
+ let promise = windowClass.setSystemBarProperties(SystemBarProperties);
+ promise.then(()=> {
+ console.info('Succeeded in setting the system bar properties.'))
+ }).catch((err)=>{
+ console.error('Failed to set the system bar properties. Cause: ' + JSON.stringify(err));
});
```
-### getAvoidArea7+
+### loadContent8+
-getAvoidArea(type: AvoidAreaType, callback: AsyncCallback<AvoidArea>): void
+loadContent(path: string, storage: ContentStorage, callback: AsyncCallback<void>): void
+
+当前窗口加载具体页面内容，使用callback方式作为异步方法。
-获取窗口内容规避的区域。如系统的系统栏区域 、凹口区域。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | type | [AvoidAreaType](#avoidareatype) | 是 | 表示规避区类型。type为TYPE_SYSTEM，表示系统默认区域。type为TYPE_CUTOUT，表示刘海屏区域。 |
- | callback | AsyncCallback<[AvoidArea](#avoidarea)> | 是 | 回调返回窗口内容规避区域。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------- | ---- | -------------------- |
+ | path | string | 是 | 设置加载页面的路径。 |
+ | storage | ContentStorage | 否 | 当前应用内的数据。 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
- var type = window.AvoidAreaType.TYPE_SYSTEM;
- windowClass.getAvoidArea(type, (err, data) => {
- if (err) {
- console.error('Failed to obtain the area. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in obtaining the area. Data:' + JSON.stringify(data));
+ windowClass.loadContent("pages/page2/page2", (err) => {
+ if (err) {
+ console.error('Failed to load the content. Cause:' + JSON.stringify(err));
+ return;
+ }
+ console.info('Succeeded in loading the content.');
});
```
-### moveTo7+
+### loadContent8+
-moveTo(x: number, y: number, callback: AsyncCallback<void>): void
+loadContent(path: string, storage?: ContentStorage): Promise<void>
+
+当前窗口加载具体页面内容，使用Promise方式作为异步方法。
-窗口位置移动。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | x | number | 是 | 窗口在x轴方向移动的值，值为正表示右移。 |
- | y | number | 是 | 窗口在y轴方向移动的值，值为正表示下移。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ------- | -------------- | ---- | -------------------- |
+ | path | string | 是 | 设置加载页面的路径。 |
+ | storage | ContentStorage | 否 | 当前应用内的数据。 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
- windowClass.moveTo(300, 300, (err, data)=>{
- if (err) {
- console.error('Failed to move the window. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Window moved. Data:' + JSON.stringify(data));
-
+ let promise = windowClass.loadContent("pages/page2/page2");
+ promise.then(()=> {
+ console.info('Succeeded in loading the content.'))
+ }).catch((err)=>{
+ console.error('Failed to load the content. Cause: ' + JSON.stringify(err));
});
```
-### resetSize7+
+### isShowing7+
-resetSize(width: number, height: number, callback: AsyncCallback<void>): void
+isShowing(callback: AsyncCallback<boolean>): void
+
+判断当前窗口是否已显示，使用callback方式作为异步方法。
-改变当前窗口大小。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | width | number | 是 | 目标窗口的宽度。 |
- | height | number | 是 | 目标窗口的高度。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ---------------------------- | ---- | -------------------------------- |
+ | callback | AsyncCallback<boolean> | 是 | 回调函数返回是否显示子窗口结果。 |
- 示例
+
```
- windowClass.resetSize(500, 1000, (err, data) => {
+ windowClass.isShowing((err) => {
if (err) {
- console.error('Failed to change the window size. Cause:' + JSON.stringify(err));
+ console.error('Failed to check whether the window is showing. Cause:' + JSON.stringify(err));
return;
}
- console.info('Window size changed. Data:' + JSON.stringify(data));
+ console.info('Succeeded in checking whether the window is showing. Cause:')
});
```
-### loadContent7+
+### isShowing7+
+
+isShowing(): Promise<boolean>
-loadContent(path: string, callback: AsyncCallback<void>): void
+判断当前窗口是否已显示，使用Promise方式作为异步方法。
-子窗口加载具体页面内容。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | path | string | 是 | 设置加载页面的代码路径。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+- 返回值
+
+ | 类型 | 说明 |
+ | ---------------------- | ----------------------------------------------------- |
+ | Promise<boolean> | 以Promise形式返回结果，返回当前窗口是否已显示的结果。 |
- 示例
+
```
- windowClass.loadContent("pages/page2/page2", (err, data) => {
- if (err) {
- console.error('Failed to load the content. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in loading the content. Data:' + JSON.stringify(data));
+ let promise = windowClass.isShowing();
+ promise.then(()=> {
+ console.info('Succeeded in checking whether the window is showing.')
+ }).catch((err)=>{
+ console.error('Failed to check whether the window is showing. Cause: ' + JSON.stringify(err));
});
```
-### hide7+
+### on('windowSizeChange'|'systemAvoidAreaChange')
-hide (callback: AsyncCallback<void>): void
+on(type: 'windowSizeChange'|'systemAvoidAreaChange', callback: Callback<AvoidArea | Size>): void
+
+开启监听。
-隐藏子窗口。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+ | type | string | 是 | 设置监听类型。7+ 时表示监听类型为窗口尺寸变化监听；7+ 时表示监听类型为系统窗口规避区变化监听。 |
+ | callback | Callback<[AvoidArea](#avoidarea) \| [Size](#size)> | 是 | 回调返回监听到的信息。 |
- 示例
+
```
- windowClass.hide((err, data) => {
- if (err) {
- console.error('Failed to hide the subwindow. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Subwindow hidden. Data:' + JSON.stringify(data))
- })
+ var type = 'windowSizeChange';
+ windowClass.on(type, (data) => {
+ console.info('Succeeded in enabling the listener for window size changes. Data: ' + JSON.stringify(data));
+ });
```
-### show7+
+### off('windowSizeChange'|'systemAvoidAreaChange')7+
-show(callback: AsyncCallback<void>): void
+off(type: 'windowSizeChange'|'systemAvoidAreaChange', callback?: Callback<AvoidArea | Size >): void
-显示子窗口。
+关闭监听。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+ | type | string | 是 | 设置监听类型。7+ 时表示监听类型为窗口尺寸变化监听；7+ 时表示监听类型为系统窗口规避区变化监听。 |
+ | callback | Callback<[AvoidArea](#avoidarea) \| [Size](#size)> | 否 | 回调返回监听到的信息。 |
- 示例
+
```
- windowClass.show((err, data) => {
- if (err) {
- console.error('Failed to show the subwindow. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in showing the subwindow. Data: ' + JSON.stringify(data))
- })
+ var type = 'windowSizeChange';
+ windowClass.off(type);
```
-### isShowing7+
+### isSupportWideGamut8+
-isShowing(callback: AsyncCallback<boolean>): void
+isSupportWideGamut(callback: AsyncCallback<boolean>): void
-判断子窗口是否已显示。
+判断当前窗口是否支持广色域模式，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<boolean> | 是 | 回调函数返回是否显示子窗口结果。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ---------------------------- | ---- | -------------------------------- |
+ | callback | AsyncCallback<boolean> | 是 | 回调函数返回是否支持广色域模式。 |
- 示例
+
```
- windowClass.isShowing((err, data) => {
+ windowClass.isSupportWideGamut((err) => {
if (err) {
- console.error('Failed to check whether the subwindow is showing. Cause:' + JSON.stringify(err));
+ console.error('Failed to check whether the window support WideGamut. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in checking whether the subwindow is showing. Cause:' + JSON.stringify(data))
+ console.info('Succeeded in checking whether the window support WideGamut.')
})
```
-### destroy7+
+### isSupportWideGamut8+
-destroy(callback: AsyncCallback<void>): void
+isSupportWideGamut(): Promise<boolean>
-销毁子窗口。
+判断当前窗口是否支持广色域模式，使用Promise方式作为异步方法。
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ---------------------- | ------------------------------------------------------------ |
+ | Promise<boolean> | 以Promise形式返回结果，返回当前窗口是否支持广色域模式的结果。 |
- 示例
+
```
- windowClass.destroy((err, data) => {
- if (err) {
- console.error('Failed to destroy the subwindow. Cause:' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in destroying the subwindow. Data:' + JSON.stringify(data))
- })
+ let promise = windowClass.isSupportWideGamut();
+ promise.then(()=> {
+ console.info('Succeeded in checking whether the window support WideGamut.')
+ }).catch((err)=>{
+ console.error('Failed to check whether the window support WideGamut. Cause: ' + JSON.stringify(err));
+ });
```
-### setOutsideTouchable7+
+### setColorSpace8+
-setOutsideTouchable(touchable: boolean, callback: AsyncCallback<void>): void;
+setColorSpace(colorSpace:ColorSpace, callback: AsyncCallback<void>): void
-设置是否允许可点击子窗口以外的区域。
+设置当前窗口为广色域模式或默认色域模式，使用callback方式作为异步方法。
+
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | touchable | boolean | 是 | 设置是否可点击。 |
- | callback | AsyncCallback<void> | 是 | 回调函数。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ---------- | ------------------------- | ---- | ------------ |
+ | colorSpace | [ColorSpace](#colorspace) | 是 | 设置色域模式 |
+ | callback | AsyncCallback<void> | 是 | 回调函数。 |
- 示例
+
```
- windowClass.setOutsideTouchable(true, (err, data) => {
+ windowClass.setColorSpace(window.ColorSpace.WIDE_GAMUT, (err) => {
if (err) {
- console.error('Failed to set the area to be touchable. Cause: ' + JSON.stringify(err));
+ console.error('Failed to set window colorspace. Cause:' + JSON.stringify(err));
return;
}
- console.info('Succeeded in setting the area to be touchable. Data: ' + JSON.stringify(data))
+ console.info('Succeeded in setting window colorspace.')
})
```
-### on('keyboardHeightChange')
+### setColorSpace8+
-on(type: string, callback: AsyncCallback<number>): void
+setColorSpace(colorSpace:ColorSpace): Promise<void>
->  **说明：**
-> 从 API Version 7 开始废弃。
+设置当前窗口为广色域模式或默认色域模式，使用promise方式作为异步方法。
-开启监听键盘高度变化。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | type | string | 是 | 设置监听类型为监听键盘高度变化，应设置type为'keyboardHeightChange'。 |
- | callback | AsyncCallback<number> | 是 | 回调返回监听到的键盘高度。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | ---------- | ------------------------- | ---- | ------------ |
+ | colorSpace | [ColorSpace](#colorspace) | 是 | 设置色域模式 |
+
+- 返回值
+
+ | 类型 | 说明 |
+ | ------------------- | ----------------------------------------------- |
+ | Promise<void> | 以Promise形式返回结果，返回当前函数执行的结果。 |
- 示例
+
```
- var type= 'keyboardHeightChange';
- windowClass.on(type, (err, data) => {
- if (err) {
- console.error('Failed to enable the listener for keyboard height changes. Cause: ' + JSON.stringify(err));
- return;
- }
- console.info('Succeeded in enabling the listener for keyboard height changes. Data: ' + JSON.stringify(data));
+ let promise = windowClass.isSupportWideGamut(window.ColorSpace.WIDE_GAMUT);
+ promise.then(()=> {
+ console.info('Succeeded in setting window colorspace.')
+ }).catch((err)=>{
+ console.error('Failed to set window colorspacet. Cause: ' + JSON.stringify(err));
});
```
-### off('keyboardHeightChange')
+### getColorSpace8+
-off(type: string, callback?: AsyncCallback<number>): void
+getColorSpace(callback: AsyncCallback<ColorSpace>): void
->  **说明：**
-> 从 API Version 7 开始废弃。
+获取当前窗口色域模式，使用callback方式作为异步方法。
-关闭监听键盘高度变化。
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | type | string | 是 | 设置监听类型为监听键盘高度变化，应设置type为'keyboardHeightChange'。 |
- | callback | AsyncCallback<number> | 否 | 回调返回监听到的键盘高度。 |
+
+ | 参数名 | 类型 | 必填 | 说明 |
+ | -------- | ---------------------------------------------- | ---- | -------------------------- |
+ | callback | AsyncCallback<[ColorSpace](#colorspace)> | 是 | 回调函数返回当前色域模式。 |
- 示例
+
```
- var type= 'keyboardHeightChange';
- windowClass.off(type);
+ windowClass.getColorSpace((err, data) => {
+ if (err) {
+ console.error('Failed to get window color space. Cause:' + JSON.stringify(err));
+ return;
+ }
+ console.info('Succeeded in getting window color space. Cause:' + JSON.stringify(data))
+ })
```
-### on('keyboardHeightChange'|'windowSizeChange'7+ |'systemAvoidAreaChange'7+ )
-
-on(type: string, callback: Callback<AvoidArea | Size | number>): void
-
-开启监听。
-
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | type | string | 是 | 设置监听类型。8+
-- 示例
- ```
- var type = 'windowSizeChange';
- windowClass.on(type, (data) => {
- console.info('Succeeded in enabling the listener for window size changes. Data: ' + JSON.stringify(data));
- });
- ```
+getColorSpace(): Promise<ColorSpace>
-### off('keyboardHeightChange'|'windowSizeChange'7+ |'systemAvoidAreaChange'7+ )
+获取当前窗口色域模式，使用Promise方式作为异步方法。
-off(type: string, callback?: Callback<AvoidArea | Size | number>): void
+**系统能力**：SystemCapability.WindowManager.WindowManager.Core
-关闭监听。
+- 返回值
-- 参数
- | 参数名 | 类型 | 必填 | 说明 |
- | -------- | -------- | -------- | -------- |
- | type | string | 是 | 设置监听类型。) => void) | 密码输入结束时被调用的回调函数。) => {
+ if (input == null || input == undefined || input.length < 5) {
+ this.message = 'The password length needs to be greater than 5.'
+ return
+ }
+ if (this.passwords.length > 0) {
+ if (this.passwords.toString() == input.toString()) {
+ this.passwords = input
+ this.message = 'Set password successfully: ' + this.passwords.toString()
+ } else {
+ this.message = 'Inconsistent passwords, please enter again.'
+ }
+ } else {
+ this.passwords = input
+ this.message = "Please enter again."
+ }
+ })
+ Button('reset button').margin(30).onClick(() => {
+ this.patternLockController.reset()
+ this.passwords = []
+ this.message = 'Please input password'
+ })
+ }.width('100%').height('100%')
+ }
+}
+```
+
+
+
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
index 8aa097feebec90c33481cc229e004cc7b6b7a14b..83b31626aa2cd63a86b4dbc2c71a8d1322b19c1c 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-canvasrenderingcontext2d.md
@@ -1342,20 +1342,16 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number
.backgroundColor('#ffff00')
.onReady(() =>{
this.context.beginPath()
- this.context.ellipse(200, 200, 50, 100, Math.PI * 0.25, Math.PI * 0.5, Math.PI, true)
+ this.context.ellipse(200, 200, 50, 100, Math.PI * 0.25, Math.PI * 0.5, Math.PI)
this.context.stroke()
})
- Button('back')
- .onClick(() => {
- router.back()
- })
}
.width('100%')
.height('100%')
}
}
```
-
+
@@ -1462,17 +1458,13 @@ clip(): void
this.context.fillStyle = "rgb(255,0,0)"
this.context.fillRect(0, 0, 150, 150)
})
- Button('back')
- .onClick(() => {
- router.back()
- })
}
.width('100%')
.height('100%')
}
}
```
-
+
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-path2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-path2d.md
index 9659dda43e23befba5bafb5f4ad867ac6286167c..1b4ec1c571ecc81f73d76a0f4fcc8832ea6892f2 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-path2d.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-path2d.md
@@ -387,7 +387,7 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number
.height('100%')
.backgroundColor('#ffff00')
.onReady(() =>{
- this.path2Db.ellipse(200, 200, 50, 100, Math.PI * 0.25, Math.PI * 0.5, Math.PI, true)
+ this.path2Db.ellipse(200, 200, 50, 100, Math.PI * 0.25, Math.PI * 0.5, Math.PI)
this.context.stroke(this.path2Db)
})
}
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md
index 678b35609477b0de471e691af06dae5448919c7e..42bf03f17d543448f2172098b54817a1003d100e 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md
@@ -51,7 +51,8 @@ Column(value:{space?: Length})
@Component
struct ColumnExample {
build() {
- Text('space').fontSize(9).fontColor(0xCCCCCC).width('90%')
+ Column() {
+ Text('space').fontSize(9).fontColor(0xCCCCCC).width('90%')
Column({ space: 5 }) {
Column().width('100%').height(30).backgroundColor(0xAFEEEE)
Column().width('100%').height(30).backgroundColor(0x00FFFF)
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
index 111c5d38e148a819c89e86bf41553ae499c26d3f..9b757863d61cf2b961ce9540d213313662e67e64 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
@@ -3,8 +3,9 @@
>  **说明：**
> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+网格容器，由“行”和“列”分割的单元格所组成，通过指定“项目”所在的单元格做出各种各样的布局。
+
-网格容器，二维布局，将容器划分成"行"和"列"，产生单元格，然后指定"项目所在"的单元格，可以任意组合不同的网格，做出各种各样的布局。
## 权限列表
@@ -17,7 +18,7 @@
包含[GridItem](ts-container-griditem.md)子组件。
-## 接口说明
+## 接口
Grid()
@@ -30,20 +31,29 @@ Grid()
| rowsTemplate | string | '1fr' | 用于设置当前网格布局行的数量，不设置时默认1行 示例, '1fr 1fr 2fr'分三行，将父组件允许的高分为4等份，第一行占1份，第二行占一份，第三行占2份。 |
| columnsGap | Length | 0 | 用于设置列与列的间距。 |
| rowsGap | Length | 0 | 用于设置行与行的间距。 |
-| editMode | boolean | flase | 是否进入编辑模式，进入编辑模式可以拖拽Gird组件内部[GridItem](ts-container-griditem.md)。 |
-| maxCount | number | 1 | 表示可显示的最大行数。 |
-| minCount | number | 1 | 表示可显示的最小行数。 |
-| cellLength | number | 0 | 表示每行的固定高度。 |
-| $multiSelectable^{8+}$ | boolean | false | 是否开启鼠标框选。8+ 8+ 8+ 8+ 8+ 8+ 8+ 8+ 网页加载结束时触发该回调。
|
-| onPageBegin(callback: (event?: {url: string }) => void) | 网页加载时触发该回调。
|
+| 名称 | 功能描述 |
+| ---------------------------------------- | ---------------------------------------- |
+| onDownloadStart(callback: (event?: { url: string, userAgent: string, contentDisposition: string, mimetype: string, contentLength: number }) => void) | 下载开始时触发该回调。
|
+| onGeolocationHide(callback: () => void) | 调用onGeolocationShow时发出的地理位置权限请求被取消后触发该回调。
|
+| onGeolocationShow(callback: (event?: { origin: string, geolocation: JsGeolocation }) => void) | 应用尝试使用地理位置时触发该回调，并向用户请求权限。
|
+| onPageBegin(callback: (event?: { url: string }) => void) | 网页加载时触发该回调。
|
+| onPageEnd(callback: (event?: { url: string }) => void) | 网页加载结束时触发该回调。
|
| onProgressChange(callback: (event?: { newProgress: number }) => void) | 网页加载进度变化时触发该回调。
|
-| onTitleReceive(callback: (event?: { title: string }) => void) | 网页主页面标题更改时触发该回调。
|
-| onGeolocationHide(callback: () => void) | 调用onGeolocationShow()时发出的地理位置权限请求被取消后触发该回调。
|
-| onGeolocationShow(callback: (event?: { origin: string, geolocation: JsGeolocation }) => void) | 应用尝试使用地理位置时触发该回调，并向用户请求权限。
|
+| onTitleReceive(callback: (event?: { title: string }) => void) | 网页主页面标题更改时触发该回调。
|
### JsGeolocation 对象说明
@@ -75,9 +76,9 @@ ohos.permission.READ_USER_STORAGE
- 接口
- | 接口名称 | 功能描述 |
- | ------------------------------------------------------------ | ------------------------------------------------------------ |
- | invoke(origin: string, allow: boolean, retain: boolean): void | 通知系统用户是否批准该应用使用地理位置权限。
|
+ | 接口名称 | 功能描述 |
+ | ---------------------------------------- | ---------------------------------------- |
+ | invoke(origin: string, allow: boolean, retain: boolean): void | 通知系统用户是否批准该应用使用地理位置权限。
|
## WebController
@@ -89,30 +90,158 @@ Web 组件的控制器。
webController: WebController = new WebController()
```
-### runJavaScript
+### accessBackward
+
+accessBackward(): boolean
+
+当前页面是否可后退。
+
+### accessForward
+
+accessForward(): boolean
+
+当前页面是否可前进。
+
+### accessStep
-runJavaScript(script: string): void
+accessStep(step: number): boolean
-执行 JavaScript 脚本。
+当前页面是否可前进或者后退step步。
- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | ------ | ------ | ---- | ---- | -------------- |
- | script | string | 是 | - | JavaScript 脚本。 |
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | ---- | ------ | ---- | ---- | --------------------- |
+ | step | number | 是 | - | 要跳转的步数，正数代表前进，负数代表后退。 |
+
+### deleteJavaScriptRegister
+
+deleteJavaScriptRegister(options: { name: string }): void
+
+清空指定对象已注册的JavaScript方法。
+
+- options参数说明
+
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | ---- | ------ | ---- | ---- | ----------------------- |
+ | name | string | 是 | - | 注册对象的名称，与HTML中调用的对象名一致。 |
+
+### backward
+
+backward(): void
+
+页面后退。
+
+### forward
+
+forward(): void
+
+页面前进。
+
+### getHitTest
+
+getHitTest(): HitTestType
+
+获取当前已点击的对象类型。
+
+- HitTestType枚举说明
+
+ | 名称 | 描述 |
+ | ------- | -------------------------------- |
+ | Edit | 可编辑的区域。 |
+ | Email | 邮件地址。 |
+ | Http | HTTP网址的HTML \标签。 |
+ | HttpImg | HTTP网址与\标签组成的HTML \标签。 |
+ | Img | HTML \标签。 |
+ | Map | 地图地址。 |
+ | Phone | 电话号码。 |
+ | Unknown | 未知内容。 |
+
+### loadData
+
+loadData(options: { data: string, mimeType: string, encoding: string, baseUrl?: string, historyUrl?: string }): void
+
+加载数据。
+
+- options参数说明
+
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | ---------- | ------ | ---- | ---- | ------------------ |
+ | data | string | 是 | - | 需要加载的数据。 |
+ | mimeType | string | 是 | - | 媒体类型，格式为''\*/\*''。 |
+ | encoding | string | 是 | - | 编码类型。 |
+ | baseUrl | string | 否 | - | 基础URL。 |
+ | historyUrl | string | 否 | - | 历史URL。 |
### loadUrl
-loadUrl(url: string): void
+loadUrl(url: string, additionalHttpHeaders?: Array<{ key: string, value: string }>): void
-加载 URL。
+加载URL。
- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | ---- | ------ | ---- | ---- | ---------- |
- | url | string | 是 | - | 需要加载的 URL。 |
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | --------------------- | ------------------------------------- | ---- | ---- | ---------- |
+ | url | string | 是 | - | 需要加载的 URL。 |
+ | additionalHttpHeaders | Array<{ key: string, value: string }> | 否 | [] | HTTP附加信息。 |
+
+### onActive
+
+onActive(): void
+
+页面重新激活。当Web被重新激活为活跃状态时，执行此方法。
+
+### onInactive
+
+onInactive(): void
+
+页面暂停渲染。当Web被切换到后台不可见状态时，执行此方法。
+
+### refresh
+
+refresh(): void
+
+刷新页面。
+
+### registerJavaScriptProxy
+
+registerJavaScriptProxy(options: { obj: object, name: string, methodList: string[] }): void
+
+将JavaScript对象与方法注册到Web内核，可被已加载的HTML直接调用。注册后，须调用refresh接口生效。
+
+- options 参数说明
+
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | ---------- | -------- | ---- | ---- | ----------------------- |
+ | obj | object | 是 | - | 参与注册的对象。 |
+ | name | string | 是 | - | 注册对象的名称，与HTML中调用的对象名一致。 |
+ | methodList | string[] | 是 | - | 参与注册的方法。 |
+
+### runJavaScript
+
+runJavaScript(script: string, callback?: (result: string) => void): void
+
+执行JavaScript脚本。
+
+- 参数
+
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | -------- | ------------------------ | ---- | ---- | ------------------------------------ |
+ | script | string | 是 | - | JavaScript脚本。 |
+ | callback | (result: string) => void | 否 | - | 回调执行JavaScript脚本结果，默认result为null字符串。 |
+
+### requestFocus
+
+requestFocus(): void
+
+Web组件获焦。
+
+### stop
+
+stop(): void
+停止页面加载。
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
new file mode 100644
index 0000000000000000000000000000000000000000..2070b7c7820a33550e2f1e131df61b17a6176c3b
--- /dev/null
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
@@ -0,0 +1,196 @@
+# 日期时间滑动选择器弹窗
+
+>  **说明：**
+> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
+根据指定范围的Date创建可以选择时间或者日期的滑动选择器，展示在弹窗上。
+
+## 权限列表
+
+无
+
+## DatePickerDialog.show
+
+show(options?: DatePickerDialogOption)
+
+定义日期时间滑动选择器弹窗并弹出。
+
+- DatePickerDialogOption参数
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | -------- | -------- | -------- | -------- | -------- |
+ | start | Date | 否 | Date('1970-1-1') | 指定选择器的起始日期。 |
+ | end | Date | 否 | Date('2100-12-31') | 指定选择器的结束日期。 |
+ | selected | Date | 否 | 当前系统日期或时间 | 当type为DatePickerType.Date时，设置选中项的日期。当type为DatePickerType.Time时，设置选中项的时间。 |
+ | type | [DatePickerType](ts-basic-components-datepicker.md) | 否 | DatePickerType.Date | 指定选择器的类型，包括日期选择器和时间选择器，缺省使用日期选择器。 |
+ | lunar | boolean | 否 | false | 日期是否显示农历。 |
+ | useMilitaryTime | boolean | 否 | false | 展示时间是否为24小时制。 |
+ | onAccept | (value: [DatePickerResult](ts-basic-components-datepicker.md)) => void | 否 | - | 点击弹窗中确定按钮时触发。 |
+ | onCancel | () => void | 否 | - | 点击弹窗中取消按钮时触发。 |
+ | onChange | (value: [DatePickerResult](ts-basic-components-datepicker.md)) => void | 否 | - | 滑动选择器，当前选择项改变时触发。 |
+
+## 示例
+
+### 日期滑动选择器（显示农历）示例
+```
+@Entry
+@Component
+struct DatePickerDialogExample01 {
+ @State isLunar: boolean = true
+ @State isUseMilitaryTime: boolean = false
+ @State datePickerType: DatePickerType = DatePickerType.Date
+ selectedDate: Date = new Date("2000-1-1")
+
+ build() {
+ Flex({direction: FlexDirection.Column, alignItems: ItemAlign.Center,
+ justifyContent: FlexAlign.Center }) {
+ Button("DatePickerDialog").onClick(() => {
+ DatePickerDialog.show({
+ start: new Date("2000-1-1"),
+ end: new Date("2005-1-1"),
+ selected: this.selectedDate,
+ type: this.datePickerType,
+ lunar: this.isLunar,
+ useMilitaryTime: this.isUseMilitaryTime,
+ onAccept: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onAccept()" + JSON.stringify(value))
+ if (this.datePickerType == DatePickerType.Date) {
+ this.selectedDate.setFullYear(value.year, value.month, value.day)
+ } else if (this.datePickerType == DatePickerType.Time) {
+ this.selectedDate.setHours(value.hour, value.minute, value.second)
+ }
+ },
+ onCancel: () => {
+ console.info("DatePickerDialog:onCancel()")
+ },
+ onChange: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onChange()" + JSON.stringify(value))
+ }
+ })
+ })
+ }
+ }
+}
+```
+### 日期滑动选择器（不显示农历）示例
+```
+@Entry
+@Component
+struct DatePickerDialogExample02 {
+ @State isLunar: boolean = false
+ @State isUseMilitaryTime: boolean = false
+ @State datePickerType: DatePickerType = DatePickerType.Date
+ selectedDate: Date = new Date("2000-1-1")
+
+ build() {
+ Flex({direction: FlexDirection.Column, alignItems: ItemAlign.Center,
+ justifyContent: FlexAlign.Center }) {
+ Button("DatePickerDialog").onClick(() => {
+ DatePickerDialog.show({
+ start: new Date("2000-1-1"),
+ end: new Date("2005-1-1"),
+ selected: this.selectedDate,
+ type: this.datePickerType,
+ lunar: this.isLunar,
+ useMilitaryTime: this.isUseMilitaryTime,
+ onAccept: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onAccept()" + JSON.stringify(value))
+ if (this.datePickerType == DatePickerType.Date) {
+ this.selectedDate.setFullYear(value.year, value.month, value.day)
+ } else if (this.datePickerType == DatePickerType.Time) {
+ this.selectedDate.setHours(value.hour, value.minute, value.second)
+ }
+ },
+ onCancel: () => {
+ console.info("DatePickerDialog:onCancel()")
+ },
+ onChange: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onChange()" + JSON.stringify(value))
+ }
+ })
+ })
+ }
+ }
+}
+```
+### 时间滑动选择器（24小时制）示例
+```
+@Entry
+@Component
+struct DatePickerDialogExample03 {
+ @State isLunar: boolean = false
+ @State isUseMilitaryTime: boolean = true
+ @State datePickerType: DatePickerType = DatePickerType.Time
+ selectedDate: Date = new Date("2000-1-1")
+
+ build() {
+ Flex({direction: FlexDirection.Column, alignItems: ItemAlign.Center,
+ justifyContent: FlexAlign.Center }) {
+ Button("DatePickerDialog").onClick(() => {
+ DatePickerDialog.show({
+ start: new Date("2000-1-1"),
+ end: new Date("2005-1-1"),
+ selected: this.selectedDate,
+ type: this.datePickerType,
+ lunar: this.isLunar,
+ useMilitaryTime: this.isUseMilitaryTime,
+ onAccept: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onAccept()" + JSON.stringify(value))
+ if (this.datePickerType == DatePickerType.Date) {
+ this.selectedDate.setFullYear(value.year, value.month, value.day)
+ } else if (this.datePickerType == DatePickerType.Time) {
+ this.selectedDate.setHours(value.hour, value.minute, value.second)
+ }
+ },
+ onCancel: () => {
+ console.info("DatePickerDialog:onCancel()")
+ },
+ onChange: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onChange()" + JSON.stringify(value))
+ }
+ })
+ })
+ }
+ }
+}
+```
+### 时间滑动选择器（12小时制）示例
+```
+@Entry
+@Component
+struct DatePickerDialogExample04 {
+ @State isLunar: boolean = false
+ @State isUseMilitaryTime: boolean = false
+ @State datePickerType: DatePickerType = DatePickerType.Time
+ selectedDate: Date = new Date("2000-1-1")
+
+ build() {
+ Flex({direction: FlexDirection.Column, alignItems: ItemAlign.Center,
+ justifyContent: FlexAlign.Center }) {
+ Button("DatePickerDialog").onClick(() => {
+ DatePickerDialog.show({
+ start: new Date("2000-1-1"),
+ end: new Date("2005-1-1"),
+ selected: this.selectedDate,
+ type: this.datePickerType,
+ lunar: this.isLunar,
+ useMilitaryTime: this.isUseMilitaryTime,
+ onAccept: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onAccept()" + JSON.stringify(value))
+ if (this.datePickerType == DatePickerType.Date) {
+ this.selectedDate.setFullYear(value.year, value.month, value.day)
+ } else if (this.datePickerType == DatePickerType.Time) {
+ this.selectedDate.setHours(value.hour, value.minute, value.second)
+ }
+ },
+ onCancel: () => {
+ console.info("DatePickerDialog:onCancel()")
+ },
+ onChange: (value: DatePickerResult) => {
+ console.info("DatePickerDialog:onChange()" + JSON.stringify(value))
+ }
+ })
+ })
+ }
+ }
+}
+```
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
new file mode 100644
index 0000000000000000000000000000000000000000..5e16350f67e178461c1e7ce57ab38f3e156682bf
--- /dev/null
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
@@ -0,0 +1,65 @@
+# 文本滑动选择器弹窗
+
+>  **说明：**
+> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
+根据指定的选择范围创建文本选择器，展示在弹窗上。
+
+## 权限列表
+
+无
+
+## TextPickerDialog.show
+
+show(options: TextPickerDialogOption)
+
+定义文本滑动选择器弹窗并弹出。
+
+- TextPickerDialogOption参数
+ | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+ | -------- | -------- | -------- | -------- | -------- |
+ | range | string[] | 是 | - | 选择器的数据选择范围。 |
+ | selected | number | 否 | 第一个元素 | 选中项在数组中的index值。 |
+ | defaultPickerItemHeight | number | 否 | - | 默认Picker内容项元素高度。 |
+ | onAccept | (value: TextPickerResult) => void | 否 | - | 点击弹窗中确定按钮时触发。 |
+ | onCancel | () => void | 否 | - | 点击弹窗中取消按钮时触发。 |
+ | onChange | (value: TextPickerResult) => void | 否 | - | 滑动选择器，当前选择项改变时触发。 |
+
+- TextPickerResult对象说明
+ | 名称 | 参数类型 | 描述 |
+ | -------- | -------- | -------- |
+ | value | string | 选中项文本。 |
+ | index | number | 选中项在数组中的index值。 |
+
+## 示例
+
+```
+@Entry
+@Component
+struct TextPickerDialogExample {
+ @State select: number = 1
+ private fruits: string[] = ['apple1', 'orange2', 'peach3', 'grape4']
+
+ build() {
+ Flex({direction: FlexDirection.Column, alignItems: ItemAlign.Center,
+ justifyContent: FlexAlign.Center }) {
+ Button("TextPickerDialog").onClick(() => {
+ TextPickerDialog.show({
+ range: this.fruits,
+ selected: this.select,
+ onAccept: (value: TextPickerResult) => {
+ console.info("TextPickerDialog:onAccept()" + JSON.stringify(value))
+ this.select = value.index
+ },
+ onCancel: () => {
+ console.info("TextPickerDialog:onCancel()")
+ },
+ onChange: (value: TextPickerResult) => {
+ console.info("TextPickerDialog:onChange()" + JSON.stringify(value))
+ }
+ })
+ })
+ }
+ }
+}
+```
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
index 43dddb82795587b63bef2151ea2b607037066a45..95d3ab05e222f3675b0412969ccab5be988b5352 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
@@ -1424,7 +1424,7 @@ ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number
.backgroundColor('#ffff00')
.onReady(() =>{
this.offContext.beginPath()
- this.offContext.ellipse(200, 200, 50, 100, Math.PI * 0.25, Math.PI * 0.5, Math.PI, true)
+ this.offContext.ellipse(200, 200, 50, 100, Math.PI * 0.25, Math.PI * 0.5, Math.PI)
this.offContext.stroke()
var image = this.offContext.transferToImageBitmap()
this.context.transferFromImageBitmap(image)
diff --git a/zh-cn/application-dev/security/Readme-CN.md b/zh-cn/application-dev/security/Readme-CN.md
index 604a2c0dbfb42236a8525d1e1256940c2bc2311f..57303b1522c8b35de1e69bb73abcb5bfc482e56b 100644
--- a/zh-cn/application-dev/security/Readme-CN.md
+++ b/zh-cn/application-dev/security/Readme-CN.md
@@ -3,5 +3,10 @@
- 用户认证
- [用户认证开发概述](userauth-overview.md)
- [用户认证开发指导](userauth-guidelines.md)
+
+- 密钥管理
+ - [HUKS开发概述](huks-overview.md)
+ - [HUKS开发指导](huks-guidelines.md)
+
- Hap包签名工具
- - [Hap包签名工具开发指南](hapsigntool_guidelines.md)
\ No newline at end of file
+ - [Hap包签名工具开发指导](hapsigntool-guidelines.md)
diff --git a/zh-cn/application-dev/security/hapsigntool-guidelines.md b/zh-cn/application-dev/security/hapsigntool-guidelines.md
index 264b13dbc1746a7fd09ccb86086e72458da68c71..4fe2c34d3df809abfcd41ae4e47eae61d04bb102 100644
--- a/zh-cn/application-dev/security/hapsigntool-guidelines.md
+++ b/zh-cn/application-dev/security/hapsigntool-guidelines.md
@@ -1,4 +1,4 @@
-# Hap包签名工具开发指南
+# Hap包签名工具开发指导
@@ -13,10 +13,10 @@
Hap包签名工具支持本地签名需求的开发，为OpenHarmony应用提供完整性保护和来源管控机制，该签名工具基于PKI公钥证书的机制实现，在进行开发前，开发者应了解以下基本概念：
- 非对称密钥对
- 非对称密钥算法是数据签名/验签的基础，应用签名工具实现生成标准的非对称密钥对（ECC P384/256、RSA2048/3072/4096，用于证书的签发和验证、Profile文件的签名和验签、以及应用包的签名和验签，提供应用的完整性保护机制。
+ 非对称密钥算法是数据签名/验签的基础，应用签名工具实现生成标准的非对称密钥对（ECC P384/256、RSA2048/3072/4096，用于证书的签发和验证、Profile文件的签名和验签、以及应用包的签名和验签，提供应用的完整性保护机制。
- CSR
- CSR（Certificate Signing Request）证书签发请求是生成证书的前提，他包括证书的公钥、证书主题和私钥签名，在申请证书之前，需要先基于密钥对生成CSR，然后提交给CA签发证书。
+ CSR（Certificate Signing Request）证书签发请求是生成证书的前提，他包括证书的公钥、证书主题和私钥签名，在申请证书之前，需要先基于密钥对生成CSR，然后提交给CA签发证书。
- 证书
OpenHarmony采用RFC5280标准构建X509证书信任体系。用于应用签名的OpenHarmony证书按层级可分为：根CA证书、子CA证书、三级实体证书，其中三级实体证书分为应用签名证书和profile签名证书。应用签名证书表示应用开发者的身份，可保证系统上安装的应用来源可追溯，profile签名证书实现对profile文件的签名进行验签，保证profile文件的完整性。
- HAP包
@@ -33,13 +33,13 @@ hap包中的描述文件，该描述文件描述了已授权的证书权限和
## 编译构建
1. 该工具基于Gradle 7.1编译构建，请确认环境已安装配置Gradle环境，并且版本高于或等于7.1。
-
+
```shell
gradle -v
```
2. 下载代码，命令行打开文件目录至developtools_hapsigner/hapsigntool，执行命令进行编译打包。
-
+
```shell
gradle build
```
@@ -74,7 +74,7 @@ OpenHarmony系统内置密钥库文件，文件名称为OpenHarmony.p12，内含
1.输出命令帮助信息
-help # 输出命令帮助信息（不输入参数默认输出命令帮助信息）
-
+
2.输出版本信息
-version # 输出版本信息
@@ -209,7 +209,7 @@ OpenHarmony系统内置密钥库文件，文件名称为OpenHarmony.p12，内含
├── -outFil # 验证结果文件（包含验证结果和profile内容），json格式，可选项；如果不填，则直接输出到控制台
11.hap应用包签名
-
+
sign-app : hap应用包签名
├── -mode # 签名模式，必填项，包括localSign，remoteSign，remoteResign
├── -keyAlias # 密钥别名，必填项
@@ -247,9 +247,9 @@ OpenHarmony系统内置密钥库文件，文件名称为OpenHarmony.p12，内含
子CA证书所在路径：developtools_hapsigner/autosign/result/subCA.cer；
pfofile签名证书路径：developtools_hapsigner/autosign/result/OpenHarmonyProfileRelease.pem。
-
+
**1.生成应用签名证书密钥对
**
-
+
调用密钥对生成接口，生成签名密钥并保存到密钥库。
命令实例：
@@ -259,7 +259,7 @@ java -jar hap-sign-tool.jar generate-keypair -keyAlias "oh-app1-key-v1" -keyAlg
>  **说明：**请记录下**keyAlias、keyStorePwd**和**keyPwd**的值，在后续[生成应用签名证书](#生成应用签名证书)和[对Hap包进行签名](#对Hap包进行签名)操作会使用到。
该命令的参数说明：
-
+
generate-keypair : 生成应用签名证书密钥对
├── -keyAlias #用于生成应用签名证书的密钥别名，存于OpenHarmony.p12密钥库文件中，该参数必填
├── -keyAlg #密钥算法，推荐使用ECC，该参数必填
@@ -267,7 +267,7 @@ java -jar hap-sign-tool.jar generate-keypair -keyAlias "oh-app1-key-v1" -keyAlg
├── -keyStoreFile #密钥库文件，推荐使用提供的OpenHarmony.p12密钥库文件，该参数必填
├── -keyStorePwd #密钥库口令，OpenHarmony.p12口令默认为“123456”，必填项
├── -keyPwd #密钥口令，可选项，该参数不填默认生成的密钥对无口令
-
+
**2.生成应用签名证书
**
@@ -353,6 +353,7 @@ java -jar hap-sign-tool.jar sign-app -keyAlias "oh-app1-key-v1" -signAlg "SHA256
+
## 常见问题
**1.执行[生成应用签名证书](#生成应用签名证书)命令时，控制台打印结果，无文件输出**
diff --git a/zh-cn/application-dev/security/huks-guidelines.md b/zh-cn/application-dev/security/huks-guidelines.md
new file mode 100644
index 0000000000000000000000000000000000000000..3c9f934168a460e02247938e326b6ee4a927fd27
--- /dev/null
+++ b/zh-cn/application-dev/security/huks-guidelines.md
@@ -0,0 +1,140 @@
+# HUKS开发指导
+
+## 场景介绍
+
+ HUKS（OpenHarmony Universal KeyStore，OpenHarmony通用密钥库系统）向应用提供密钥库能力，包括密钥管理及密钥的密码学操作等功能。HUKS所管理的密钥可以由应用导入或者由应用调用HUKS接口生成。
+
+
+## 接口说明
+
+| 接口名 | 描述 |
+| ------------------------------------------------------------ | ---------------- |
+| function generateKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void; | 生成密钥/密钥对 |
+| function generateKey(keyAlias: string, options: HuksOptions) : Promise; | 生成密钥/密钥对 |
+| function exportKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void; | 导出公钥 |
+| function exportKey(keyAlias: string, options: HuksOptions) : Promise; | 导出公钥 |
+| function isKeyExist(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void; | 查询密钥是否存在 |
+| function isKeyExist(keyAlias: string, options: HuksOptions) : Promise; | 查询密钥是否存在 |
+| function deleteKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void; | 删除密钥 |
+| function deleteKey(keyAlias: string, options: HuksOptions) : Promise; | 删除密钥 |
+
+## 开发步骤
+
+1. 引入HUKS模块
+
+ ```js
+ import huks from '@ohos.security.huks'
+ ```
+
+2. 使用generateKey接口生成密钥对。
+
+ keyAlias为生成的密钥别名，options为生成密钥时使用到的参数，需根据具体需要到的算法设定options中的参数。
+
+ generateKey接口会返回密钥的生成是否成功。
+
+ ```js
+ var alias = 'testAlias';
+ var properties = new Array();
+ properties[0] = {
+ tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
+ value: huks.HuksKeyAlg.HUKS_ALG_ECC
+ };
+ properties[1] = {
+ tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
+ value: huks.HuksKeySize.HUKS_ECC_KEY_SIZE_224
+ };
+ properties[2] = {
+ tag: huks.HuksTag.HUKS_TAG_PURPOSE,
+ value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_AGREE
+ };
+ properties[3] = {
+ tag: huks.HuksTag.HUKS_TAG_DIGEST,
+ value: huks.HuksKeyDigest.HUKS_DIGEST_NONE
+ };
+ var options = {
+ properties: properties
+ }
+ var resultA = await huks.generateKey(alias, options);
+ ```
+
+3. 使用Init接口进行init操作。
+
+ Alias为初始化密钥的别名，options为初始化密钥用的参数集合，需根据具体需要到的算法设定options中的参数。
+
+ init接口会返回init操作是否成功。
+
+ ```js
+ var alias = 'test001'
+ var properties = new Array();
+ properties[0] = {
+ tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
+ value: huks.HksKeyAlg.HKS_ALG_DH
+ };
+ properties[1] = {
+ tag: huks.HksTag.HKS_TAG_PURPOSE,
+ value: huks.HksKeyPurpose.HKS_KEY_PURPOSE_AGREE
+ };
+ properties[2] = {
+ tag: huks.HksTag.HKS_TAG_KEY_SIZE
+ value: huks.HksKeySize.HKS_DH_KEY_SIZE_4096
+ };
+ var options = {
+ properties: properties
+ };
+ huks.init(alias, options, function (err, data){});
+ ```
+
+4. 使用Update接口进行update操作。
+
+ handle为更新密钥的session id，options为更新密钥用的参数集合，需根据具体需要到的算法设定options中的参数。
+
+ update接口会返回update操作是否成功。
+
+ ```js
+ var properties = new Array();
+ properties[0] = {
+ tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
+ value: huks.HksKeyAlg.HKS_ALG_DH
+ };
+ properties[1] = {
+ tag: huks.HksTag.HKS_TAG_PURPOSE,
+ value: huks.HksKeyPurpose.HKS_KEY_PURPOSE_AGREE
+ };
+ properties[2] = {
+ tag: huks.HksTag.HKS_TAG_KEY_SIZE
+ value: huks.HksKeySize.HKS_DH_KEY_SIZE_4096
+ };
+ var options = {
+ properties: properties
+ };
+ huks.update(handle, options, function (err, data){});
+ ```
+
+5. 使用Finish接口进行finish操作。
+
+ handle为 结束密钥的session id，options为结束密钥用的参数集合，需根据具体需要到的算法设定options中的参数。
+
+ finish接口会返回finish操作是否成功。
+
+ ```js
+ var properties = new Array();
+ properties[0] = {
+ tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
+ value: huks.HksKeyAlg.HKS_ALG_DH
+ };
+ properties[1] = {
+ tag: huks.HksTag.HKS_TAG_PURPOSE,
+ value: huks.HksKeyPurpose.HKS_KEY_PURPOSE_AGREE
+ };
+ properties[2] = {
+ tag: huks.HksTag.HKS_TAG_KEY_SIZE
+ value: huks.HksKeySize.HKS_DH_KEY_SIZE_4096
+ };
+ var options = {
+ properties: properties
+ };
+ huks.finish(handle, options, function (err, data){});
+ ```
+
+
+
diff --git a/zh-cn/application-dev/security/huks-overview.md b/zh-cn/application-dev/security/huks-overview.md
new file mode 100755
index 0000000000000000000000000000000000000000..4f0ee08a09481012c88f0dd009574e9412095714
--- /dev/null
+++ b/zh-cn/application-dev/security/huks-overview.md
@@ -0,0 +1,27 @@
+# HUKS概述
+
+### 功能简介
+
+HUKS（OpenHarmony Universal KeyStore）向应用提供密钥库能力，包括密钥管理及密钥的密码学操作等功能。HUKS所管理的密钥可以由应用导入或者由应用调用HUKS接口生成。
+
+### 基本概念
+
+- HUKS提供密钥管理功能，支持的主要操作包括：加密解密、签名验签、派生协商密钥、计算HMAC（Hash-based Message Authentication Code）。
+- HUKS涉及的算法主要有：AES加密解密、RSA加密解密、RSA签名验签、ECC签名验签、DSA签名验签、ED25519签名验签、PBKDF2派生、DH协商、ECDH协商、X25519协商等。
+- HUKS当前使用的算法库为OpenSSL和mbed TLS。
+
+### 运作机制
+
+HUKS对密钥的使用主要通过Init、Update、Finish操作来实现。
+
+- **Iit操作**：读取密钥，并为其创建Session Id返回给调用者。
+
+- **Udate操作**：根据Init操作获取的Session Id对数据进行分段update处理。
+
+- **Fnish操作**：当所有待处理的数据均传入HUKS后，调用Finish操作完成最终数据处理，释放资源。
+
+ > **须知：当Init、Update、Finish操作中的任一阶段发生错误时，都需要调用Abort操作来终止密钥的使用。**
+
+
+### 约束与限制
+不涉及。
\ No newline at end of file
diff --git a/zh-cn/application-dev/ui/ts-component-based-builder.md b/zh-cn/application-dev/ui/ts-component-based-builder.md
index 9bdf0dad957220ed5bab0790681edcef0a14fe30..536ed5d82c625932092a15f50e71d9688ba796d5 100644
--- a/zh-cn/application-dev/ui/ts-component-based-builder.md
+++ b/zh-cn/application-dev/ui/ts-component-based-builder.md
@@ -41,3 +41,93 @@ struct CompA {
}
}
```
+## @BuilderParam8+
+@BuilderParam装饰器用于修饰自定义组件内函数类型的属性（例如：`@BuilderParam content: () => any;`），并且在初始化自定义组件时被@BuilderParam修饰的属性必须赋值。
+
+### 引入动机
+
+当开发者创建自定义组件，想对该组件添加特定功能时（如：仅对自定义组件添加一个点击跳转操作）。若直接在组件内嵌入事件方法，将会导致所有初始化该组件的地方均增加了该功能。为解决此问题，引入了@BuilderParam装饰器，此装饰器修饰的属性值可为@Builder修饰的方法，开发者可在初始化自定义组件时对此属性进行赋值，为自定义组件增加特定的的功能。
+
+### 参数初始化组件
+通过参数初始化组件时，将@Builder装饰的方法赋值给@BuilderParam修饰的属性，并在自定义组件内调用content属性值。
+```
+@Component
+struct CustomContainer {
+ header: string = "";
+ @BuilderParam content: () => any;
+ footer: string = "";
+ build() {
+ Column() {
+ Text(this.header)
+ .fontSize(50)
+ this.content()
+ Text(this.footer)
+ .fontSize(50)
+ }
+ }
+}
+
+@Entry
+@Component
+struct CustomContainerUser {
+ @Builder specificParam(label: string) {
+ Column() {
+ Text(label).fontSize(50)
+ }
+ }
+
+ build() {
+ Column() {
+ CustomContainer({
+ header: "Header",
+ content: this.specificParam("111")
+ footer: "Footer",
+ })
+ }
+ }
+}
+```
+### 尾随闭包初始化组件
+在自定义组件中使用@BuilderParam修饰的属性接收尾随闭包（在初始化自定义组件时，组件名称紧跟一个大括号“{}”形成尾随闭包场景（`CustomComponent(){}`）。开发者可把尾随闭包看做一个容器，向其填充内容，如在闭包内增加组件（`{Column(){Text("content")}`），闭包内语法规范与[build](../ui/ts-function-build.md)一致。此场景下自定义组件内有且仅有一个使用@BuilderParam修饰的属性。
+
+示例：在闭包内增加Column组件并添加点击事件，在新增的Column组件内调用@Builder修饰的specificParam方法，点击Column组件后该改变自定义组件中header的属性值为“changeHeader”。并且在初始化自定义组件时会把尾随闭包的内容赋值给使用@BuilderParam修饰的closer属性。
+```
+@Component
+struct CustomContainer {
+ header: string = "";
+ @BuilderParam closer: () => any;
+ build() {
+ Column() {
+ Text(this.header)
+ .fontSize(50)
+ this.closer()
+ }
+ }
+}
+@Builder function specificParam(label1: string, label2: string) {
+ Column() {
+ Text(label1)
+ .fontSize(50)
+ Text(label2)
+ .fontSize(50)
+ }
+}
+@Entry
+@Component
+struct CustomContainerUser {
+ @State text: string = "header"
+ build() {
+ Column() {
+ CustomContainer({
+ header: this.text,
+ }){
+ Column(){
+ specificParam("111", "22")
+ }.onClick(()=>{
+ this.text = "changeHeader"
+ })
+ }
+ }
+ }
+}
+```
diff --git a/zh-cn/application-dev/webgl/Readme-CN.md b/zh-cn/application-dev/webgl/Readme-CN.md
new file mode 100644
index 0000000000000000000000000000000000000000..89d715d5a45a30e3a78c76937f835d89d2527549
--- /dev/null
+++ b/zh-cn/application-dev/webgl/Readme-CN.md
@@ -0,0 +1,4 @@
+# WebGL
+
+- [概述](webgl-overview.md)
+- [WebGL开发指导](webgl-guidelines.md)
diff --git a/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001192269746.gif b/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001192269746.gif
new file mode 100644
index 0000000000000000000000000000000000000000..e4c7ed66998e8c6b4b87c587edb5986cc547d9dc
Binary files /dev/null and b/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001192269746.gif differ
diff --git a/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001192429306.gif b/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001192429306.gif
new file mode 100644
index 0000000000000000000000000000000000000000..2297841f49ed784fbe4ecd131df8965202e1c14c
Binary files /dev/null and b/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001192429306.gif differ
diff --git a/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001238544451.png b/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001238544451.png
new file mode 100644
index 0000000000000000000000000000000000000000..007ac6263648c83671d4b085cfc9103f6391be6d
Binary files /dev/null and b/zh-cn/application-dev/webgl/figures/zh-cn_image_0000001238544451.png differ
diff --git a/zh-cn/application-dev/webgl/public_sys-resources/icon-caution.gif b/zh-cn/application-dev/webgl/public_sys-resources/icon-caution.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571
Binary files /dev/null and b/zh-cn/application-dev/webgl/public_sys-resources/icon-caution.gif differ
diff --git a/zh-cn/application-dev/webgl/public_sys-resources/icon-danger.gif b/zh-cn/application-dev/webgl/public_sys-resources/icon-danger.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571
Binary files /dev/null and b/zh-cn/application-dev/webgl/public_sys-resources/icon-danger.gif differ
diff --git a/zh-cn/application-dev/webgl/public_sys-resources/icon-note.gif b/zh-cn/application-dev/webgl/public_sys-resources/icon-note.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6314297e45c1de184204098efd4814d6dc8b1cda
Binary files /dev/null and b/zh-cn/application-dev/webgl/public_sys-resources/icon-note.gif differ
diff --git a/zh-cn/application-dev/webgl/public_sys-resources/icon-notice.gif b/zh-cn/application-dev/webgl/public_sys-resources/icon-notice.gif
new file mode 100644
index 0000000000000000000000000000000000000000..86024f61b691400bea99e5b1f506d9d9aef36e27
Binary files /dev/null and b/zh-cn/application-dev/webgl/public_sys-resources/icon-notice.gif differ
diff --git a/zh-cn/application-dev/webgl/public_sys-resources/icon-tip.gif b/zh-cn/application-dev/webgl/public_sys-resources/icon-tip.gif
new file mode 100644
index 0000000000000000000000000000000000000000..93aa72053b510e456b149f36a0972703ea9999b7
Binary files /dev/null and b/zh-cn/application-dev/webgl/public_sys-resources/icon-tip.gif differ
diff --git a/zh-cn/application-dev/webgl/public_sys-resources/icon-warning.gif b/zh-cn/application-dev/webgl/public_sys-resources/icon-warning.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6e90d7cfc2193e39e10bb58c38d01a23f045d571
Binary files /dev/null and b/zh-cn/application-dev/webgl/public_sys-resources/icon-warning.gif differ
diff --git a/zh-cn/application-dev/webgl/webgl-guidelines.md b/zh-cn/application-dev/webgl/webgl-guidelines.md
new file mode 100644
index 0000000000000000000000000000000000000000..6495b6aeb122781b25d4fdeb25e41327399c43bd
--- /dev/null
+++ b/zh-cn/application-dev/webgl/webgl-guidelines.md
@@ -0,0 +1,708 @@
+# WebGL开发指导
+
+## 场景介绍
+
+WebGL主要帮助开发者在前端开发中完成图形图像的相关处理，比如绘制彩色图形等。
+
+
+## 接口说明
+
+使用WebGL开放能力需导入模块：
+
+```
+import webgl from "@ohos.webglnapi";
+```
+
+**表1** WebGL主要接口列表
+
+| 接口名 | 描述 |
+| -------- | -------- |
+| canvas.getContext | 获取canvas对象上下文。 |
+| webgl.createBuffer(): WebGLBuffer \| null | 创建与初始化WebGL数据缓冲区。 |
+| webgl.bindBuffer(target: GLenum, buffer: WebGLBuffer \| null): void | 将WebGL数据缓冲区与目标进行绑定。 |
+| webgl.bufferData(target: GLenum, srcData: ArrayBufferView, usage: GLenum, srcOffset: GLuint, length?: GLuint): void | 创建并初始化WebGL的数据存储区。 |
+| webgl.getAttribLocation(program: WebGLProgram, name: string): GLint | 从给定WebGL着色程序中获取着色器中attribute变量的地址。 |
+| webgl.vertexAttribPointer(index: GLuint, size: GLint, type: GLenum, normalized: GLboolean, stride: GLsizei, offset: GLintptr): void | 将缓冲区对象分配给变量。 |
+| webgl.enableVertexAttribArray(index: GLuint): void | 连接变量与分配给它的缓冲区对象。 |
+| webgl.clearColor(red: GLclampf, green: GLclampf, blue: GLclampf, alpha: GLclampf): void | 清空<canvas>指定的颜色。 |
+| webgl.clear(mask: GLbitfield): void | 清空<canvas>。 |
+| webgl.drawArrays(mode: GLenum, first: GLint, count: GLsizei): void | 执行数据绘制。 |
+| webgl.flush(): void | 刷新数据至GPU，清空缓冲区。 |
+| webgl.createProgram(): WebGLProgram \| null | 创建着色器程序对象。 |
+
+
+## 开发步骤
+
+以下分别展示无着色器绘制2D图形和着色器绘制彩色三角形的两个场景示例及开发过程。
+
+>  **说明：**
+> 使用WebGL开发时，为保证界面图形显示效果，请使用真机运行。
+
+
+### 无着色器绘制2D图形
+
+此场景为未使用WebGL绘制的2D图形（CPU绘制非GPU绘制）。开发示例如下：
+
+1. 创建页面布局。index.hml示例如下：
+ ```
+
+ BtnDraw2D
+
+ ```
+
+2. 设置页面样式。index.css示例如下：
+ ```
+ .container {
+ flex-direction: column;
+ justify-content: center;
+ align-items: center;
+ }
+ .btn-button {
+ margin: 1px;
+ height: 40px;
+ width: 220px;
+ background-color: lightblue;
+ font-size: 20px;
+ text-color: blue;
+ }
+ ```
+
+3. 编辑JavaScript代码文件，增加2D绘制逻辑代码。index.js示例如下：
+ ```
+ //index.js
+ export default {//NAPI交互代码
+ data: {
+ title: "DEMO BY TEAMOL",
+ fit:"cover",
+ fits: ["cover", "contain", "fill", "none", "scale-down"]
+ },
+ onInit() {
+ this.title = this.$t('strings.world');
+ },
+ BtnDraw2D(){
+ // 获取canvas元素
+ const canvas = this.$refs.canvas1;
+ // 获取2D上下文
+ const ctx = canvas.getContext('2d');
+
+ //执行CPU绘制函数
+ // Set line width
+ ctx.lineWidth = 10;
+ // Wall
+ ctx.strokeRect(75, 140, 150, 110);
+ // Door
+ ctx.fillRect(130, 190, 40, 60);
+ // Roof
+ ctx.beginPath();
+ ctx.moveTo(50, 140);
+ ctx.lineTo(150, 60);
+ ctx.lineTo(250, 140);
+ ctx.closePath();
+ ctx.stroke();
+ }
+ }
+ ```
+
+**图1** 点击按钮绘制2D图形的效果图
+
+
+
+
+### 着色器绘制彩色三角形
+
+此场景为使用WebGL绘制的彩色三角形图形（GPU绘制）。开发示例如下：
+
+
+1. 创建页面布局。index.hml示例如下：
+ ```
+
+ BtnColorTriangle
+
+ ```
+
+2. 设置页面样式。index.css示例如下：
+ ```
+ .container {
+ flex-direction: column;
+ justify-content: center;
+ align-items: center;
+ }
+ .btn-button {
+ margin: 1px;
+ height: 40px;
+ width: 220px;
+ background-color: lightblue;
+ font-size: 20px;
+ text-color: blue;
+ }
+ ```
+
+3. 编辑JavaScript代码文件，增加彩色三角形绘制逻辑代码。index.js示例如下：
+ ```
+ //index.js
+ import webgl from "@ohos.webglnapi";//导入WebGL模块
+
+ //WebGL相关预定义
+ var gl = {
+ DEPTH_BUFFER_BIT: 0x00000100,
+ STENCIL_BUFFER_BIT: 0x00000400,
+ COLOR_BUFFER_BIT: 0x00004000,
+ POINTS: 0x0000,
+ LINES: 0x0001,
+ LINE_LOOP: 0x0002,
+ LINE_STRIP: 0x0003,
+ TRIANGLES: 0x0004,
+ TRIANGLE_STRIP: 0x0005,
+ TRIANGLE_FAN: 0x0006,
+ ZERO: 0,
+ ONE: 1,
+ SRC_COLOR: 0x0300,
+ ONE_MINUS_SRC_COLOR: 0x0301,
+ SRC_ALPHA: 0x0302,
+ ONE_MINUS_SRC_ALPHA: 0x0303,
+ DST_ALPHA: 0x0304,
+ ONE_MINUS_DST_ALPHA: 0x0305,
+ DST_COLOR: 0x0306,
+ ONE_MINUS_DST_COLOR: 0x0307,
+ SRC_ALPHA_SATURATE: 0x0308,
+ FUNC_ADD: 0x8006,
+ BLEND_EQUATION: 0x8009,
+ BLEND_EQUATION_RGB: 0x8009,
+ BLEND_EQUATION_ALPHA: 0x883D,
+ FUNC_SUBTRACT: 0x800A,
+ FUNC_REVERSE_SUBTRACT: 0x800B,
+ BLEND_DST_RGB: 0x80C8,
+ BLEND_SRC_RGB: 0x80C9,
+ BLEND_DST_ALPHA: 0x80CA,
+ BLEND_SRC_ALPHA: 0x80CB,
+ CONSTANT_COLOR: 0x8001,
+ ONE_MINUS_CONSTANT_COLOR: 0x8002,
+ CONSTANT_ALPHA: 0x8003,
+ ONE_MINUS_CONSTANT_ALPHA: 0x8004,
+ BLEND_COLOR: 0x8005,
+ ARRAY_BUFFER: 0x8892,
+ ELEMENT_ARRAY_BUFFER: 0x8893,
+ ARRAY_BUFFER_BINDING: 0x8894,
+ ELEMENT_ARRAY_BUFFER_BINDING: 0x8895,
+ STREAM_DRAW: 0x88E0,
+ STATIC_DRAW: 0x88E4,
+ DYNAMIC_DRAW: 0x88E8,
+ BUFFER_SIZE: 0x8764,
+ BUFFER_USAGE: 0x8765,
+ CURRENT_VERTEX_ATTRIB: 0x8626,
+ FRONT: 0x0404,
+ BACK: 0x0405,
+ FRONT_AND_BACK: 0x0408,
+ CULL_FACE: 0x0B44,
+ BLEND: 0x0BE2,
+ DITHER: 0x0BD0,
+ STENCIL_TEST: 0x0B90,
+ DEPTH_TEST: 0x0B71,
+ SCISSOR_TEST: 0x0C11,
+ POLYGON_OFFSET_FILL: 0x8037,
+ SAMPLE_ALPHA_TO_COVERAGE: 0x809E,
+ SAMPLE_COVERAGE: 0x80A0,
+ NO_ERROR: 0,
+ INVALID_ENUM: 0x0500,
+ INVALID_VALUE: 0x0501,
+ INVALID_OPERATION: 0x0502,
+ OUT_OF_MEMORY: 0x0505,
+ CW: 0x0900,
+ CCW: 0x0901,
+ LINE_WIDTH: 0x0B21,
+ ALIASED_POINT_SIZE_RANGE: 0x846D,
+ ALIASED_LINE_WIDTH_RANGE: 0x846E,
+ CULL_FACE_MODE: 0x0B45,
+ FRONT_FACE: 0x0B46,
+ DEPTH_RANGE: 0x0B70,
+ DEPTH_WRITEMASK: 0x0B72,
+ DEPTH_CLEAR_VALUE: 0x0B73,
+ DEPTH_FUNC: 0x0B74,
+ STENCIL_CLEAR_VALUE: 0x0B91,
+ STENCIL_FUNC: 0x0B92,
+ STENCIL_FAIL: 0x0B94,
+ STENCIL_PASS_DEPTH_FAIL: 0x0B95,
+ STENCIL_PASS_DEPTH_PASS: 0x0B96,
+ STENCIL_REF: 0x0B97,
+ STENCIL_VALUE_MASK: 0x0B93,
+ STENCIL_WRITEMASK: 0x0B98,
+ STENCIL_BACK_FUNC: 0x8800,
+ STENCIL_BACK_FAIL: 0x8801,
+ STENCIL_BACK_PASS_DEPTH_FAIL: 0x8802,
+ STENCIL_BACK_PASS_DEPTH_PASS: 0x8803,
+ STENCIL_BACK_REF: 0x8CA3,
+ STENCIL_BACK_VALUE_MASK: 0x8CA4,
+ STENCIL_BACK_WRITEMASK: 0x8CA5,
+ VIEWPORT: 0x0BA2,
+ SCISSOR_BOX: 0x0C10,
+ COLOR_CLEAR_VALUE: 0x0C22,
+ COLOR_WRITEMASK: 0x0C23,
+ UNPACK_ALIGNMENT: 0x0CF5,
+ PACK_ALIGNMENT: 0x0D05,
+ MAX_TEXTURE_SIZE: 0x0D33,
+ MAX_VIEWPORT_DIMS: 0x0D3A,
+ SUBPIXEL_BITS: 0x0D50,
+ RED_BITS: 0x0D52,
+ GREEN_BITS: 0x0D53,
+ BLUE_BITS: 0x0D54,
+ ALPHA_BITS: 0x0D55,
+ DEPTH_BITS: 0x0D56,
+ STENCIL_BITS: 0x0D57,
+ POLYGON_OFFSET_UNITS: 0x2A00,
+ POLYGON_OFFSET_FACTOR: 0x8038,
+ TEXTURE_BINDING_2D: 0x8069,
+ SAMPLE_BUFFERS: 0x80A8,
+ SAMPLES: 0x80A9,
+ RGBA8: 0x8058,
+ SAMPLE_COVERAGE_VALUE: 0x80AA,
+ SAMPLE_COVERAGE_INVERT: 0x80AB,
+ COMPRESSED_TEXTURE_FORMATS: 0x86A3,
+ DONT_CARE: 0x1100,
+ FASTEST: 0x1101,
+ NICEST: 0x1102,
+ GENERATE_MIPMAP_HINT: 0x8192,
+ BYTE: 0x1400,
+ UNSIGNED_BYTE: 0x1401,
+ SHORT: 0x1402,
+ UNSIGNED_SHORT: 0x1403,
+ INT: 0x1404,
+ UNSIGNED_INT: 0x1405,
+ FLOAT: 0x1406,
+ DEPTH_COMPONENT: 0x1902,
+ ALPHA: 0x1906,
+ RGB: 0x1907,
+ RGBA: 0x1908,
+ LUMINANCE: 0x1909,
+ LUMINANCE_ALPHA: 0x190A,
+ UNSIGNED_SHORT_4_4_4_4: 0x8033,
+ UNSIGNED_SHORT_5_5_5_1: 0x8034,
+ UNSIGNED_SHORT_5_6_5: 0x8363,
+ FRAGMENT_SHADER: 0x8B30,
+ VERTEX_SHADER: 0x8B31,
+ MAX_VERTEX_ATTRIBS: 0x8869,
+ MAX_VERTEX_UNIFORM_VECTORS: 0x8DFB,
+ MAX_VARYING_VECTORS: 0x8DFC,
+ MAX_COMBINED_TEXTURE_IMAGE_UNITS: 0x8B4D,
+ MAX_VERTEX_TEXTURE_IMAGE_UNITS: 0x8B4C,
+ MAX_TEXTURE_IMAGE_UNITS: 0x8872,
+ MAX_FRAGMENT_UNIFORM_VECTORS: 0x8DFD,
+ SHADER_TYPE: 0x8B4F,
+ DELETE_STATUS: 0x8B80,
+ LINK_STATUS: 0x8B82,
+ VALIDATE_STATUS: 0x8B83,
+ ATTACHED_SHADERS: 0x8B85,
+ ACTIVE_UNIFORMS: 0x8B86,
+ ACTIVE_ATTRIBUTES: 0x8B89,
+ SHADING_LANGUAGE_VERSION: 0x8B8C,
+ CURRENT_PROGRAM: 0x8B8D,
+ NEVER: 0x0200,
+ LESS: 0x0201,
+ EQUAL: 0x0202,
+ LEQUAL: 0x0203,
+ GREATER: 0x0204,
+ NOTEQUAL: 0x0205,
+ GEQUAL: 0x0206,
+ ALWAYS: 0x0207,
+ KEEP: 0x1E00,
+ REPLACE: 0x1E01,
+ INCR: 0x1E02,
+ DECR: 0x1E03,
+ INVERT: 0x150A,
+ INCR_WRAP: 0x8507,
+ DECR_WRAP: 0x8508,
+ VENDOR: 0x1F00,
+ RENDERER: 0x1F01,
+ VERSION: 0x1F02,
+ NEAREST: 0x2600,
+ LINEAR: 0x2601,
+ NEAREST_MIPMAP_NEAREST: 0x2700,
+ LINEAR_MIPMAP_NEAREST: 0x2701,
+ NEAREST_MIPMAP_LINEAR: 0x2702,
+ LINEAR_MIPMAP_LINEAR: 0x2703,
+ TEXTURE_MAG_FILTER: 0x2800,
+ TEXTURE_MIN_FILTER: 0x2801,
+ TEXTURE_WRAP_S: 0x2802,
+ TEXTURE_WRAP_T: 0x2803,
+ TEXTURE_2D: 0x0DE1,
+ TEXTURE: 0x1702,
+ TEXTURE_CUBE_MAP: 0x8513,
+ TEXTURE_BINDING_CUBE_MAP: 0x8514,
+ TEXTURE_CUBE_MAP_POSITIVE_X: 0x8515,
+ TEXTURE_CUBE_MAP_NEGATIVE_X: 0x8516,
+ TEXTURE_CUBE_MAP_POSITIVE_Y: 0x8517,
+ TEXTURE_CUBE_MAP_NEGATIVE_Y: 0x8518,
+ TEXTURE_CUBE_MAP_POSITIVE_Z: 0x8519,
+ TEXTURE_CUBE_MAP_NEGATIVE_Z: 0x851A,
+ MAX_CUBE_MAP_TEXTURE_SIZE: 0x851C,
+ TEXTURE0: 0x84C0,
+ TEXTURE1: 0x84C1,
+ TEXTURE2: 0x84C2,
+ TEXTURE3: 0x84C3,
+ TEXTURE4: 0x84C4,
+ TEXTURE5: 0x84C5,
+ TEXTURE6: 0x84C6,
+ TEXTURE7: 0x84C7,
+ TEXTURE8: 0x84C8,
+ TEXTURE9: 0x84C9,
+ TEXTURE10: 0x84CA,
+ TEXTURE11: 0x84CB,
+ TEXTURE12: 0x84CC,
+ TEXTURE13: 0x84CD,
+ TEXTURE14: 0x84CE,
+ TEXTURE15: 0x84CF,
+ TEXTURE16: 0x84D0,
+ TEXTURE17: 0x84D1,
+ TEXTURE18: 0x84D2,
+ TEXTURE19: 0x84D3,
+ TEXTURE20: 0x84D4,
+ TEXTURE21: 0x84D5,
+ TEXTURE22: 0x84D6,
+ TEXTURE23: 0x84D7,
+ TEXTURE24: 0x84D8,
+ TEXTURE25: 0x84D9,
+ TEXTURE26: 0x84DA,
+ TEXTURE27: 0x84DB,
+ TEXTURE28: 0x84DC,
+ TEXTURE29: 0x84DD,
+ TEXTURE30: 0x84DE,
+ TEXTURE31: 0x84DF,
+ ACTIVE_TEXTURE: 0x84E0,
+ REPEAT: 0x2901,
+ CLAMP_TO_EDGE: 0x812F,
+ MIRRORED_REPEAT: 0x8370,
+ FLOAT_VEC2: 0x8B50,
+ FLOAT_VEC3: 0x8B51,
+ FLOAT_VEC4: 0x8B52,
+ INT_VEC2: 0x8B53,
+ INT_VEC3: 0x8B54,
+ INT_VEC4: 0x8B55,
+ BOOL: 0x8B56,
+ BOOL_VEC2: 0x8B57,
+ BOOL_VEC3: 0x8B58,
+ BOOL_VEC4: 0x8B59,
+ FLOAT_MAT2: 0x8B5A,
+ FLOAT_MAT3: 0x8B5B,
+ FLOAT_MAT4: 0x8B5C,
+ SAMPLER_2D: 0x8B5E,
+ SAMPLER_CUBE: 0x8B60,
+ VERTEX_ATTRIB_ARRAY_ENABLED: 0x8622,
+ VERTEX_ATTRIB_ARRAY_SIZE: 0x8623,
+ VERTEX_ATTRIB_ARRAY_STRIDE: 0x8624,
+ VERTEX_ATTRIB_ARRAY_TYPE: 0x8625,
+ VERTEX_ATTRIB_ARRAY_NORMALIZED: 0x886A,
+ VERTEX_ATTRIB_ARRAY_POINTER: 0x8645,
+ VERTEX_ATTRIB_ARRAY_BUFFER_BINDING: 0x889F,
+ IMPLEMENTATION_COLOR_READ_TYPE: 0x8B9A,
+ IMPLEMENTATION_COLOR_READ_FORMAT: 0x8B9B,
+ COMPILE_STATUS: 0x8B81,
+ LOW_FLOAT: 0x8DF0,
+ MEDIUM_FLOAT: 0x8DF1,
+ HIGH_FLOAT: 0x8DF2,
+ LOW_INT: 0x8DF3,
+ MEDIUM_INT: 0x8DF4,
+ HIGH_INT: 0x8DF5,
+ FRAMEBUFFER: 0x8D40,
+ RENDERBUFFER: 0x8D41,
+ RGBA4: 0x8056,
+ RGB5_A1: 0x8057,
+ RGB565: 0x8D62,
+ DEPTH_COMPONENT16: 0x81A5,
+ STENCIL_INDEX8: 0x8D48,
+ DEPTH_STENCIL: 0x84F9,
+ RENDERBUFFER_WIDTH: 0x8D42,
+ RENDERBUFFER_HEIGHT: 0x8D43,
+ RENDERBUFFER_INTERNAL_FORMAT: 0x8D44,
+ RENDERBUFFER_RED_SIZE: 0x8D50,
+ RENDERBUFFER_GREEN_SIZE: 0x8D51,
+ RENDERBUFFER_BLUE_SIZE: 0x8D52,
+ RENDERBUFFER_ALPHA_SIZE: 0x8D53,
+ RENDERBUFFER_DEPTH_SIZE: 0x8D54,
+ RENDERBUFFER_STENCIL_SIZE: 0x8D55,
+ FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE: 0x8CD0,
+ FRAMEBUFFER_ATTACHMENT_OBJECT_NAME: 0x8CD1,
+ FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL: 0x8CD2,
+ FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE: 0x8CD3,
+ COLOR_ATTACHMENT0: 0x8CE0,
+ DEPTH_ATTACHMENT: 0x8D00,
+ STENCIL_ATTACHMENT: 0x8D20,
+ DEPTH_STENCIL_ATTACHMENT: 0x821A,
+ NONE: 0,
+ FRAMEBUFFER_COMPLETE: 0x8CD5,
+ FRAMEBUFFER_INCOMPLETE_ATTACHMENT: 0x8CD6,
+ FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT: 0x8CD7,
+ FRAMEBUFFER_INCOMPLETE_DIMENSIONS: 0x8CD9,
+ FRAMEBUFFER_UNSUPPORTED: 0x8CDD,
+ FRAMEBUFFER_BINDING: 0x8CA6,
+ RENDERBUFFER_BINDING: 0x8CA7,
+ MAX_RENDERBUFFER_SIZE: 0x84E8,
+ INVALID_FRAMEBUFFER_OPERATION: 0x0506,
+ UNPACK_FLIP_Y_WEBGL: 0x9240,
+ UNPACK_PREMULTIPLY_ALPHA_WEBGL: 0x9241,
+ CONTEXT_LOST_WEBGL: 0x9242,
+ UNPACK_COLORSPACE_CONVERSION_WEBGL: 0x9243,
+ BROWSER_DEFAULT_WEBGL: 0x9244,
+ TEXTURE_MAX_LOD: 0x813B,
+ TEXTURE_BASE_LEVEL: 0x813C,
+ TEXTURE_IMMUTABLE_FORMAT: 0x912F,
+ UNIFORM_BLOCK_BINDING: 0x8A3F,
+ UNIFORM_BLOCK_DATA_SIZE: 0x8A40,
+ UNIFORM_BLOCK_ACTIVE_UNIFORMS: 0x8A42,
+ UNIFORM_BLOCK_ACTIVE_UNIFORM_INDICES: 0x8A43,
+ UNIFORM_BLOCK_REFERENCED_BY_VERTEX_SHADER: 0x8A44,
+ UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER: 0x8A46,
+ RED: 0x1903,
+ PIXEL_UNPACK_BUFFER: 0x88EC,
+ RGB8: 0x8051,
+ R16F: 0x822D,
+ COPY_WRITE_BUFFER: 0x8F37,
+ TEXTURE_3D: 0x806F,
+ COMPRESSED_R11_EAC: 0x9270,
+ COPY_READ_BUFFER: 0x8F36,
+ TRANSFORM_FEEDBACK_BUFFER: 0x8C8E,
+ TRANSFORM_FEEDBACK_BUFFER_BINDING: 0x8C8F,
+ TRANSFORM_FEEDBACK_BUFFER_SIZE: 0x8C85,
+ TRANSFORM_FEEDBACK_BUFFER_START: 0x8C84,
+ UNIFORM_BUFFER_BINDING: 0x8A28,
+ UNIFORM_BUFFER_SIZE: 0x8A2A,
+ UNIFORM_BUFFER_START: 0x8A29,
+ DYNAMIC_READ: 0x88E9,
+ READ_FRAMEBUFFER: 0x8CA8,
+ COLOR_ATTACHMENT1: 0x8CE1,
+ INTERLEAVED_ATTRIBS: 0x8C8C,
+ UNIFORM_OFFSET: 0x8A3B,
+ UNIFORM_TYPE: 0x8A37,
+ UNIFORM_SIZE: 0x8A38,
+ UNIFORM_BLOCK_INDEX: 0x8A3A,
+ UNIFORM_ARRAY_STRIDE: 0x8A3C,
+ UNIFORM_MATRIX_STRIDE: 0x8A3D,
+ UNIFORM_IS_ROW_MAJOR: 0x8A3E,
+ TEXTURE_MAX_ANISOTROPY_EXT: 0x84FE
+ }
+
+ // 顶点着色器程序
+ var VSHADER_SOURCE =
+ 'attribute vec4 a_Position;\n' + // attribute variable
+ 'attribute vec4 a_Color;\n' +
+ 'varying vec4 v_Color;\n' +
+ 'void main() {\n' +
+ ' gl_Position = a_Position;\n' + // Set the vertex coordinates of the point
+ ' v_Color = a_Color;\n' +
+ '}\n';
+
+ // 片元着色器程序
+ var FSHADER_SOURCE =
+ 'precision mediump float;\n' +
+ 'varying vec4 v_Color;\n' +
+ 'void main() {\n' +
+ ' gl_FragColor = v_Color;\n' +
+ '}\n';
+
+ function initVertexBuffers(gl) {
+ // 顶点坐标和颜色
+ var verticesColors = new Float32Array([
+ 0.0, -0.5, 1.0, 0.0, 0.0,
+ -0.5, -0.8, 0.0, 1.0, 0.0,
+ 0.5, -0.8, 0.0, 0.0, 1.0,
+ ]);
+
+ var n = 3; // 点的个数
+ var FSIZE = verticesColors.BYTES_PER_ELEMENT; //数组中每个元素的字节数
+
+ // 创建缓冲区对象
+ var vertexBuffer = gl.createBuffer();
+ if (!vertexBuffer) {
+ console.log('Failed to create the buffer object');
+ return -1;
+ }
+
+ // 将缓冲区对象绑定到目标
+ gl.bindBuffer(gl.ARRAY_BUFFER, vertexBuffer);
+ // 向缓冲区对象写入数据
+ gl.bufferData(gl.ARRAY_BUFFER, verticesColors.buffer, gl.STATIC_DRAW);
+
+ //获取着色器中attribute变量a_Position的地址
+ var a_Position = gl.getAttribLocation(gl.program, 'a_Position');
+ if (a_Position < 0) {
+ console.log('Failed to get the storage location of a_Position');
+ return -1;
+ }
+ // 将缓冲区对象分配给a_Position变量
+ gl.vertexAttribPointer(a_Position, 2, gl.FLOAT, false, 5 * FSIZE, 0);
+
+ // 连接a_Position变量与分配给它的缓冲区对象
+ gl.enableVertexAttribArray(a_Position);
+
+ //获取着色器中attribute变量a_Color的地址
+ var a_Color = gl.getAttribLocation(gl.program, 'a_Color');
+ if (a_Color < 0) {
+ console.log('Failed to get the storage location of a_Color');
+ return -1;
+ }
+ // 将缓冲区对象分配给a_Color变量
+ gl.vertexAttribPointer(a_Color, 3, gl.FLOAT, false, FSIZE * 5, FSIZE * 2);
+
+ // 连接a_Color变量与分配给它的缓冲区对象
+ gl.enableVertexAttribArray(a_Color);
+
+ // 解除绑定
+ gl.bindBuffer(gl.ARRAY_BUFFER, null);
+
+ return n;
+ }
+
+ /**
+ * Creates a program object and makes it as the current object.
+ * @param gl Indicates the WebGL context.
+ * @param vshader Indicates a vertex shader program (string).
+ * @param fshader Indicates a fragment shader program (string).
+ * @return Returns true if the WebGLProgram object was created and successfully made as the current object; returns false otherwise.
+ */
+ function initShaders(gl, vshader, fshader) {
+ var program = createProgram(gl, vshader, fshader);
+ console.log("======createProgram program: " + program);
+
+ if (!program) {
+ console.log('Failed to create program');
+ return false;
+ }
+ gl.useProgram(program);
+ gl.program = program;
+
+ return true;
+ }
+
+ /**
+ * Creates a linked program object.
+ * @param gl Indicates the WebGL context.
+ * @param vshader Indicates a vertex shader program (string).
+ * @param fshader Indicates a fragment shader program (string).
+ * @return Returns the created program object if the operation is successful; returns null otherwise.
+ */
+ function createProgram(gl, vshader, fshader) {
+ console.log("======createProgram start======");
+ // Create shader object
+ var vertexShader = loadShader(gl, gl.VERTEX_SHADER, vshader);
+ console.log("======vertexShader: " + vertexShader);
+ var fragmentShader = loadShader(gl, gl.FRAGMENT_SHADER, fshader);
+ if (!vertexShader || !fragmentShader) {
+ return null;
+ }
+
+ // Create a program object.
+ var program = gl.createProgram();
+ console.log("======createProgram program: " + program);
+
+ if (!program) {
+ return null;
+ }
+
+ // Attach the shader objects.
+ gl.attachShader(program, vertexShader);
+ gl.attachShader(program, fragmentShader);
+
+ // Link the program object.
+ gl.linkProgram(program);
+
+ // Check the result of linking.
+ var linked = gl.getProgramParameter(program, 0x8B82);
+ console.log("======getProgramParameter linked: " + linked);
+
+ if (!linked) {
+ var error = gl.getProgramInfoLog(program);
+ console.log('Failed to link the program: ' + error);
+ gl.deleteProgram(program);
+ gl.deleteShader(fragmentShader);
+ gl.deleteShader(vertexShader);
+ return null;
+ }
+ return program;
+ }
+
+ /**
+ * Creates a shader object.
+ * @param gl Indicates the WebGL context.
+ * @param type Indicates the type of the shader object to be created.
+ * @param source Indicates the shader program (string).
+ * @return Returns the created shader object if the operation is successful; returns false otherwise.
+ */
+ function loadShader(gl, type, source) {
+ console.log("======into loadShader====");
+ // Create shader object
+ var shader = gl.createShader(type);
+ if (shader == null) {
+ console.log('Failed to create the shader.');
+ return null;
+ }
+
+ // Set the shader program.
+ gl.shaderSource(shader, source);
+
+ // Compile the shader.
+ gl.compileShader(shader);
+
+ // Check the result of compilation.
+ var compiled = gl.getShaderParameter(shader, gl.COMPILE_STATUS);
+ if (!compiled) {
+ var error = gl.getShaderInfoLog(shader);
+ console.log('Failed to compile the shader: ' + error);
+ gl.deleteShader(shader);
+ return null;
+ }
+
+ return shader;
+ }
+
+ export default {
+ data: {
+ title: "DEMO BY TEAMOL",
+ fit:"cover",
+ fits: ["cover", "contain", "fill", "none", "scale-down"]
+ }
+ ,onInit() {
+ this.title = this.$t('strings.world');
+ }
+ ,BtnColorTriangle() {
+ // 获取canvas元素
+ const el = this.$refs.canvas1;
+ // 获取webgl上下文
+ var gl = el.getContext('webgl');
+
+ if (!gl) {
+ console.log('Failed to get the rendering context for WebGL');
+ return;
+ }
+
+ // 初始化着色器
+ if (!initShaders(gl, VSHADER_SOURCE, FSHADER_SOURCE)) {
+ console.log('Failed to intialize shaders.');
+ return;
+ }
+
+ // 设置顶点位置
+ var n = initVertexBuffers(gl);
+ if (n < 0) {
+ console.log('Failed to set the positions of the vertices');
+ return;
+ }
+
+ // 指定清空的颜色
+ gl.clearColor(0.0, 0.0, 0.0, 1.0);
+
+ // 清空
+ gl.clear(gl.COLOR_BUFFER_BIT);
+
+ // 绘制三角形
+ gl.drawArrays(gl.TRIANGLES, 0, n);
+
+ //清buffer
+ gl.flush();
+ }
+ }
+ ```
+
+
+**图2** 点击按钮绘制彩色三角形的效果图
+
+
diff --git a/zh-cn/application-dev/webgl/webgl-overview.md b/zh-cn/application-dev/webgl/webgl-overview.md
new file mode 100644
index 0000000000000000000000000000000000000000..9f6add6c7eb67fd1418fdd6a72c83a2adb27c39c
--- /dev/null
+++ b/zh-cn/application-dev/webgl/webgl-overview.md
@@ -0,0 +1,47 @@
+# 概述
+
+WebGL的全称为Web Graphic Library(网页图形库)，主要用于交互式渲染2D图形和3D图形。目前OpenHarmony中使用的WebGL是基于OpenGL裁剪的OpenGL ES，可以在HTML5的canvas元素对象中使用，无需使用插件，支持跨平台。WebGL程序是由JavaScript代码组成的，其中使用的API可以利用用户设备提供的GPU硬件完成图形渲染和加速。
+
+
+## 基本概念
+
+
+### 着色器
+
+可以理解为运行在显卡中的指令和数据。在WebGL中，着色器是用OpenGL ES着色语言(GLSL)编写的。
+
+完整的着色器包括顶点着色器和片元着色器。顶点着色器和片元着色器的交互则涉及到图片光栅化。
+
+- 顶点着色器：最基本的任务是接收三维空间中点的坐标，将其处理为二维空间中的坐标并输出。
+
+- 片元着色器：最基本的任务是对需要处理的屏幕上的每个像素输出一个颜色值。
+
+- 图片光栅化：将顶点着色器输出的二维空间中的点坐标，转化为需要处理的像素并传递给片元着色器的过程。
+
+
+### 缓冲区
+
+驻存于内存中的JavaScript对象，存储着即将推送到着色器中的attribute对象。
+
+
+### 着色器程序
+
+将缓冲区中的数据推送到着色器中还需涉及“着色器程序”，一个负责关联着色器和缓冲区的JavaScript对象。一个WebGLProgram 对象由两个编译过后的 WebGLShader 组成，即顶点着色器和片段着色器（均由 GLSL 语言所写）。
+
+
+## 运作机制
+
+**图1** WebGL运作机制
+
+
+
+
+- 应用前端HTML5绘制界面组件。
+
+- Native API完成前端JavaScript与C++代码交互。
+
+- QuickJS与V8为图形框架，为WebGL模块提供绘制对象Surface。
+
+- WebGL模块对外暴露OpenGL ES的GPU绘制接口。
+
+- 中间接口层EGL（Embedded Graphics Library）完成不同平台的适配。
diff --git a/zh-cn/device-dev/driver/driver-hdf-manage.md b/zh-cn/device-dev/driver/driver-hdf-manage.md
index d5cef9325b4f6a86f858e41d65b22fe0068b4259..9b591965f4bb551eaac376cbc622aa92ef3c4dd1 100644
--- a/zh-cn/device-dev/driver/driver-hdf-manage.md
+++ b/zh-cn/device-dev/driver/driver-hdf-manage.md
@@ -347,8 +347,17 @@ root {
node1 {
attributes;
}
+node2 {
+ attr_1 = &root.node1;
+}
+```
+或
+```
node2 {
+ node1 {
+ attributes;
+ }
attr_1 = &node1;
}
```
diff --git a/zh-cn/device-dev/driver/driver-peripherals-sensor-des.md b/zh-cn/device-dev/driver/driver-peripherals-sensor-des.md
index 90ddbe4e79575b84bbf50802b4b5b5a6bd9de6fa..583fb5b8a28785b435f611c9f61dfa218b0e1e9a 100755
--- a/zh-cn/device-dev/driver/driver-peripherals-sensor-des.md
+++ b/zh-cn/device-dev/driver/driver-peripherals-sensor-des.md
@@ -15,7 +15,7 @@
### 功能简介
-Sensor设备作为外接设备重要组成模块，通过Sensor驱动模型屏蔽硬件器件差异，为上层Sensor服务系统提供稳定的Sensor基础能力接口，包括Sensor列表查询、Sensor启停、Sensor订阅及取消订阅，Sensor参数配置等功能；Sensor设备驱动的开发是基于HDF驱动框架基础上，结合操作系统适配层（OSAL）和平台驱动接口（比如I2C/SPI/UART总线等平台资源）能力，屏蔽不同操作系统和平台总线资源差异，实现Sensor驱动“一次开发，多系统部署”的目标。Sensor驱动模型如[图1](#fig10451455446)所示： 
