Basic service kit8分需求问题整改(一)-docs-AtomGit

已合并

Basic service kit8分需求问题整改(一) #156408

guxiang49创建于 7月19日从lx180327070811/docs： master 合入到 openharmony/docs： master

Basic service kit8分需求问题整改(一) #156408

已合并

guxiang49创建于 7月19日

从lx180327070811/docs master合入到openharmony/docs master

共 7 个文件变更+71-70

Mzh-cn/application-dev/reference/apis-basic-services-kit/Readme-CN.md+1-1

	@@ -173,7 +173,7 @@
173	- [热管理错误码](errorcode-thermal.md)	173	- [热管理错误码](errorcode-thermal.md)
174	- [上传下载错误码](errorcode-request.md)	174	- [上传下载错误码](errorcode-request.md)
175	- [时间时区服务错误码](errorcode-time.md)	175	- [时间时区服务错误码](errorcode-time.md)
176	- - [事件错误码](errorcode-CommonEventService.md)	176	+ - [公共事件错误码](errorcode-CommonEventService.md)
177	<!--Del-->	177	<!--Del-->
178	- [系统参数错误码](errorcode-system-parameterV9.md)	178	- [系统参数错误码](errorcode-system-parameterV9.md)
179	<!--DelEnd-->	179	<!--DelEnd-->

Mzh-cn/application-dev/reference/apis-basic-services-kit/capi-oh-commonevent-h.md+30-31

	@@ -152,15 +152,14 @@ enum CommonEvent_ErrCode
152	\| 枚举项 \| 描述 \|	152	\| 枚举项 \| 描述 \|
153	\| -- \| -- \|	153	\| -- \| -- \|
154	\| COMMONEVENT_ERR_OK = 0 \| 成功。 \|	154	\| COMMONEVENT_ERR_OK = 0 \| 成功。 \|
155	-\| COMMONEVENT_ERR_PERMISSION_ERROR = 201 \| 权限错误。 \|	155	+\| COMMONEVENT_ERR_INVALID_PARAMETER = 401 \| 参数错误。参数不合法，请检查参数类型、取值范围或参数是否为空。 \|
156	-\| COMMONEVENT_ERR_INVALID_PARAMETER = 401 \| 参数错误。 \|	156	+\| COMMONEVENT_ERR_SENDING_LIMIT_EXCEEDED = 1500003\| 事件发送频率过高。请检查应用是否过于频繁地发送公共事件，如发送频率超过每5毫秒20个，请降低公共事件发送频率或增加发送间隔后重新尝试。<br>起始版本： 20 \|
157	-\| COMMONEVENT_ERR_SENDING_LIMIT_EXCEEDED = 1500003\| 事件发送频率过高。<br>起始版本： 20 \|	157	+\| COMMONEVENT_ERR_NOT_SYSTEM_SERVICE = 1500004 \| 三方应用无法发送系统公共事件。请检查当前应用是否为系统应用，或当前服务是否为系统服务。 \|
158	-\| COMMONEVENT_ERR_NOT_SYSTEM_SERVICE = 1500004 \| 三方应用无法发送系统公共事件。 \|	158	+\| COMMONEVENT_ERR_SENDING_REQUEST_FAILED = 1500007 \| IPC发送失败。请勿频繁建立连接，稍后重新尝试。\|
159	-\| COMMONEVENT_ERR_SENDING_REQUEST_FAILED = 1500007 \| IPC发送失败。\|	159	+\| COMMONEVENT_ERR_INIT_UNDONE = 1500008 \| 服务未初始化。请稍后重新尝试。 \|
160	-\| COMMONEVENT_ERR_INIT_UNDONE = 1500008 \| 服务未初始化。 \|	160	+\| COMMONEVENT_ERR_OBTAIN_SYSTEM_PARAMS = 1500009 \| 系统错误。请稍后重新尝试。 \|
161	-\| COMMONEVENT_ERR_OBTAIN_SYSTEM_PARAMS = 1500009 \| 系统错误。 \|	161	+\| COMMONEVENT_ERR_SUBSCRIBER_NUM_EXCEEDED = 1500010 \| 进程内订阅者数量超过系统限制（200个）。请检查应用内是否存在订阅者未取消订阅，如存在则取消订阅后重新尝试；不存在请稍后重新尝试。 \|
162	-\| COMMONEVENT_ERR_SUBSCRIBER_NUM_EXCEEDED = 1500010 \| 进程内订阅者数量超过系统限制（200个）。 \|	162	+\| COMMONEVENT_ERR_ALLOC_MEMORY_FAILED = 1500011 \| 内存分配失败。请稍后重新尝试。 \|
163	-\| COMMONEVENT_ERR_ALLOC_MEMORY_FAILED = 1500011 \| 内存分配失败。 \|
164		163
165		164
166	## 函数说明	165	## 函数说明
	@@ -201,14 +200,14 @@ CommonEvent_SubscribeInfo* OH_CommonEvent_CreateSubscribeInfo(const char* events
201		200
202	\| 参数项 \| 描述 \|	201	\| 参数项 \| 描述 \|
203	\| -- \| -- \|	202	\| -- \| -- \|
204	-\| const char* events[] \| 订阅的公共事件，实际订阅的公共事件数量为`eventsNum`与`events`数组长度的最小值。 \|	203	+\| const char* events[] \| 订阅的公共事件，实际订阅的数量为`eventsNum`与`events`数组长度的最小值。 \|
205	-\| int32_t eventsNum \| 订阅的公共事件数量，取值为`events`数组长度。 \|	204	+\| int32_t eventsNum \| 订阅的公共事件数量，非负整数，取值为`events`数组长度。 \|
206		205
207	返回：	206	返回：
208		207
209	\| 类型 \| 说明 \|	208	\| 类型 \| 说明 \|
210	\|--------------------------------\| -- \|	209	\|--------------------------------\| -- \|
211	-\| [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* \| 成功则返回订阅者信息，失败则返回NULL。 \|	210	+\| [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* \| 成功则返回订阅者信息，失败则返回NULL。该指针由内部管理，在[OH_CommonEvent_DestroySubscribeInfo()](#oh_commonevent_destroysubscribeinfo)时释放。 \|
212		211
213	### OH_CommonEvent_SetPublisherPermission()	212	### OH_CommonEvent_SetPublisherPermission()
214		213
	@@ -227,8 +226,8 @@ CommonEvent_ErrCode OH_CommonEvent_SetPublisherPermission(CommonEvent_SubscribeI
227		226
228	\| 参数项 \| 描述 \|	227	\| 参数项 \| 描述 \|
229	\| -- \| -- \|	228	\| -- \| -- \|
230	-\| [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* info \| 订阅者信息。 \|	229	+\| [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* info \| 待设置发布方权限的订阅者信息对象。 \|
231	-\| const char* permission \| 权限名称。 \|	230	+\| const char* permission \| 权限名称。取值为系统已定义的权限名，订阅方将只能接收到具有该权限的发送方发布的事件。不设置时，可接收所有发送方发布的事件。 \|
232		231
233	返回：	232	返回：
234		233
	@@ -253,8 +252,8 @@ CommonEvent_ErrCode OH_CommonEvent_SetPublisherBundleName(CommonEvent_SubscribeI
253		252
254	\| 参数项 \| 描述 \|	253	\| 参数项 \| 描述 \|
255	\| -- \| -- \|	254	\| -- \| -- \|
256	-\| [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* info \| 订阅者信息。 \|	255	+\| [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* info \| 待设置发布方权限的订阅者信息对象。 \|
257	-\| const char* bundleName \| 包名称。 \|	256	+\| const char* bundleName \| 包名称。用于限制订阅方只接收该bundleName的发布者发布的公共事件。不设置时，可接收所有应用发布的公共事件。 \|
258		257
259	返回：	258	返回：
260		259
	@@ -299,13 +298,13 @@ CommonEvent_Subscriber* OH_CommonEvent_CreateSubscriber(const CommonEvent_Subscr
299	\| 参数项 \| 描述 \|	298	\| 参数项 \| 描述 \|
300	\|----------------------------------------------------------------------\| -- \|	299	\|----------------------------------------------------------------------\| -- \|
301	\| const [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* info \| 订阅者信息。 \|	300	\| const [CommonEvent_SubscribeInfo](capi-oh-commonevent-commonevent-subscribeinfo.md)* info \| 订阅者信息。 \|
302	-\| [CommonEvent_ReceiveCallback](#commonevent_receivecallback) callback \| 公共事件回调函数。 \|	301	+\| [CommonEvent_ReceiveCallback](#commonevent_receivecallback) callback \| 公共事件回调函数。当公共事件订阅成功后，事件触发时通过data返回公共事件数据。 \|
303		302
304	返回：	303	返回：
305		304
306	\| 类型 \| 说明 \|	305	\| 类型 \| 说明 \|
307	\| -- \| -- \|	306	\| -- \| -- \|
308	-\| [CommonEvent_Subscriber](#变量)* \| 成功则返回订阅者，失败则返回NULL。 \|	307	+\| [CommonEvent_Subscriber](#变量)* \| 成功则返回订阅者，失败则返回NULL。该指针由内部管理，在[OH_CommonEvent_DestroySubscriber()](#oh_commonevent_destroysubscriber)时释放。 \|
309		308
310	### OH_CommonEvent_DestroySubscriber()	309	### OH_CommonEvent_DestroySubscriber()
311		310
	@@ -349,7 +348,7 @@ CommonEvent_ErrCode OH_CommonEvent_Subscribe(const CommonEvent_Subscriber* subsc
349		348
350	\| 类型 \| 说明 \|	349	\| 类型 \| 说明 \|
351	\| -- \| -- \|	350	\| -- \| -- \|
352	-\| [CommonEvent_ErrCode](#commonevent_errcode) \| 返回错误码。<br> 返回[COMMONEVENT_ERR_OK](capi-oh-commonevent-h.md#commonevent_errcode)表示成功。<br> 返回[COMMONEVENT_ERR_INVALID_PARAMETER](capi-oh-commonevent-h.md#commonevent_errcode)表示参数subscriber无效。<br> 返回[COMMONEVENT_ERR_SENDING_REQUEST_FAILED](capi-oh-commonevent-h.md#commonevent_errcode)表示IPC请求发送失败。<br> 返回[COMMONEVENT_ERR_INIT_UNDONE](capi-oh-commonevent-h.md#commonevent_errcode)表示公共事件服务未初始化。<br> 返回[COMMONEVENT_ERR_SUBSCRIBER_NUM_EXCEEDED](capi-oh-commonevent-h.md#commonevent_errcode)进程内订阅者数量超过系统限制（200个）。<br> 返回[COMMONEVENT_ERR_ALLOC_MEMORY_FAILED](capi-oh-commonevent-h.md#commonevent_errcode)表示系统分配内存失败。 \|	351	+\| [CommonEvent_ErrCode](#commonevent_errcode) \| 返回错误码。<br> 返回[COMMONEVENT_ERR_OK](capi-oh-commonevent-h.md#commonevent_errcode)表示成功。<br> 返回[COMMONEVENT_ERR_INVALID_PARAMETER](capi-oh-commonevent-h.md#commonevent_errcode)表示参数subscriber无效。<br> 返回[COMMONEVENT_ERR_SENDING_REQUEST_FAILED](capi-oh-commonevent-h.md#commonevent_errcode)表示IPC请求发送失败。<br> 返回[COMMONEVENT_ERR_INIT_UNDONE](capi-oh-commonevent-h.md#commonevent_errcode)表示公共事件服务未初始化。<br> 返回[COMMONEVENT_ERR_SUBSCRIBER_NUM_EXCEEDED](capi-oh-commonevent-h.md#commonevent_errcode)表示进程内订阅者数量超过系统限制（200个）。<br> 返回[COMMONEVENT_ERR_ALLOC_MEMORY_FAILED](capi-oh-commonevent-h.md#commonevent_errcode)表示系统分配内存失败。 \|
353		352
354	### OH_CommonEvent_UnSubscribe()	353	### OH_CommonEvent_UnSubscribe()
355		354
	@@ -399,7 +398,7 @@ const char* OH_CommonEvent_GetEventFromRcvData(const CommonEvent_RcvData* rcvDat
399		398
400	\| 类型 \| 说明 \|	399	\| 类型 \| 说明 \|
401	\| -- \| -- \|	400	\| -- \| -- \|
402	-\| const char* \| 返回公共事件名称。 \|	401	+\| const char* \| 返回公共事件名称。该指针由系统产生，回调函数[CommonEvent_ReceiveCallback](#commonevent_receivecallback)结束后即刻释放，不可在回调函数外部使用。 \|
403		402
404	### OH_CommonEvent_GetCodeFromRcvData()	403	### OH_CommonEvent_GetCodeFromRcvData()
405		404
	@@ -449,7 +448,7 @@ const char* OH_CommonEvent_GetDataStrFromRcvData(const CommonEvent_RcvData* rcvD
449		448
450	\| 类型 \| 说明 \|	449	\| 类型 \| 说明 \|
451	\| -- \| -- \|	450	\| -- \| -- \|
452	-\| const char* \| 返回接收到的公共事件数据，字符串类型。 \|	451	+\| const char* \| 返回接收到的公共事件数据，字符串类型。该指针由系统产生，回调函数[CommonEvent_ReceiveCallback](#commonevent_receivecallback)结束后即刻释放，不可在回调函数外部使用。 \|
453		452
454	### OH_CommonEvent_GetBundleNameFromRcvData()	453	### OH_CommonEvent_GetBundleNameFromRcvData()
455		454
	@@ -474,7 +473,7 @@ const char* OH_CommonEvent_GetBundleNameFromRcvData(const CommonEvent_RcvData* r
474		473
475	\| 类型 \| 说明 \|	474	\| 类型 \| 说明 \|
476	\| -- \| -- \|	475	\| -- \| -- \|
477	-\| const char* \| 返回公共事件的包名称。 \|	476	+\| const char* \| 返回公共事件的包名称。该指针由系统产生，回调函数[CommonEvent_ReceiveCallback](#commonevent_receivecallback)结束后即刻释放，不可在回调函数外部使用。 \|
478		477
479	### OH_CommonEvent_GetParametersFromRcvData()	478	### OH_CommonEvent_GetParametersFromRcvData()
480		479
	@@ -524,7 +523,7 @@ CommonEvent_PublishInfo* OH_CommonEvent_CreatePublishInfo(bool ordered)
524		523
525	\| 类型 \| 说明 \|	524	\| 类型 \| 说明 \|
526	\|------------------------------\| -- \|	525	\|------------------------------\| -- \|
527	-\| [CommonEvent_PublishInfo](capi-oh-commonevent-commonevent-publishinfo.md)* \| 创建的公共事件属性对象，创建失败时，返回NULL。 \|	526	+\| [CommonEvent_PublishInfo](capi-oh-commonevent-commonevent-publishinfo.md)* \| 创建的公共事件属性对象，创建失败时，返回NULL。该指针由内部管理，在[OH_CommonEvent_DestroyPublishInfo()](#oh_commonevent_destroypublishinfo)时释放。 \|
528		527
529	### OH_CommonEvent_DestroyPublishInfo()	528	### OH_CommonEvent_DestroyPublishInfo()
530		529
	@@ -589,7 +588,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetPublishInfoPermissions(CommonEvent_Publish
589	\| 参数项 \| 描述 \|	588	\| 参数项 \| 描述 \|
590	\| -- \| -- \|	589	\| -- \| -- \|
591	\| [CommonEvent_PublishInfo](capi-oh-commonevent-commonevent-publishinfo.md)* info \| 公共事件属性对象。 \|	590	\| [CommonEvent_PublishInfo](capi-oh-commonevent-commonevent-publishinfo.md)* info \| 公共事件属性对象。 \|
592	-\| const char* permissions[] \| 订阅者权限名称数组，生效数量为`num`与`permissions`数组长度的最小值。 \|	591	+\| const char* permissions[] \| 订阅者权限名称数组，只有具备这些权限的订阅者才能收到该公共事件。生效数量为`num`与`permissions`数组长度的最小值。 \|
593	\| int32_t num \| 权限名称的数量，取值为`permissions`数组长度。 \|	592	\| int32_t num \| 权限名称的数量，取值为`permissions`数组长度。 \|
594		593
595	返回：	594	返回：
	@@ -693,7 +692,7 @@ CommonEvent_Parameters* OH_CommonEvent_CreateParameters()
693		692
694	\| 类型 \| 说明 \|	693	\| 类型 \| 说明 \|
695	\| -- \| -- \|	694	\| -- \| -- \|
696	-\| [CommonEvent_Parameters](#变量)* \| 返回公共事件附加信息，创建失败时，返回NULL。 \|	695	+\| [CommonEvent_Parameters](#变量)* \| 返回公共事件附加信息，创建失败时，返回NULL。该指针由内部管理，在[OH_CommonEvent_DestroyParameters()](#oh_commonevent_destroyparameters)时释放。 \|
697		696
698	### OH_CommonEvent_DestroyParameters()	697	### OH_CommonEvent_DestroyParameters()
699		698
	@@ -840,7 +839,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetIntArrayToParameters(CommonEvent_Parameter
840	\| -- \| -- \|	839	\| -- \| -- \|
841	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|	840	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|
842	\| const char* key \| 数据键。 \|	841	\| const char* key \| 数据键。 \|
843	-\| const int* value \| 设置的int数组内容。 \|	842	+\| const int* value \| 设置的int数组内容。实际设置的数量为`num`，value数组长度需大于`num`，否则会有越界访问风险。 \|
844	\| size_t num \| 设置的int数组内容中元素的个数。 \|	843	\| size_t num \| 设置的int数组内容中元素的个数。 \|
845		844
846	返回：	845	返回：
	@@ -949,7 +948,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetLongArrayToParameters(CommonEvent_Paramete
949	\| -- \| -- \|	948	\| -- \| -- \|
950	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|	949	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|
951	\| const char* key \| 数据键。 \|	950	\| const char* key \| 数据键。 \|
952	-\| const long* value \| 设置的long数组内容。 \|	951	+\| const long* value \| 设置的long数组内容。实际设置的数量为`num`，value数组长度需大于`num`，否则会有越界访问风险。 \|
953	\| size_t num \| 设置的long数组内容中元素的个数。 \|	952	\| size_t num \| 设置的long数组内容中元素的个数。 \|
954		953
955	返回：	954	返回：
	@@ -1058,7 +1057,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetBoolArrayToParameters(CommonEvent_Paramete
1058	\| -- \| -- \|	1057	\| -- \| -- \|
1059	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|	1058	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|
1060	\| const char* key \| 数据键。 \|	1059	\| const char* key \| 数据键。 \|
1061	-\| const bool* value \| 设置的布尔数组内容。 \|	1060	+\| const bool* value \| 设置的布尔数组内容。实际设置的数量为`num`，value数组长度需大于`num`，否则会有越界访问风险。 \|
1062	\| size_t num \| 设置的布尔数组内容中元素的个数。 \|	1061	\| size_t num \| 设置的布尔数组内容中元素的个数。 \|
1063		1062
1064	返回：	1063	返回：
	@@ -1167,7 +1166,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetCharArrayToParameters(CommonEvent_Paramete
1167	\| -- \| -- \|	1166	\| -- \| -- \|
1168	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|	1167	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|
1169	\| const char* key \| 数据键。 \|	1168	\| const char* key \| 数据键。 \|
1170	-\| const char* value \| 设置的字符数组内容。 \|	1169	+\| const char* value \| 设置的字符数组内容。实际设置的数量为`num`与`value`数组长度的最小值。 \|
1171	\| size_t num \| 设置的字符数组内容中元素的个数。 \|	1170	\| size_t num \| 设置的字符数组内容中元素的个数。 \|
1172		1171
1173	返回：	1172	返回：
	@@ -1276,7 +1275,7 @@ CommonEvent_ErrCode OH_CommonEvent_SetDoubleArrayToParameters(CommonEvent_Parame
1276	\| -- \| -- \|	1275	\| -- \| -- \|
1277	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|	1276	\| [CommonEvent_Parameters](#变量)* param \| 公共事件附加信息。 \|
1278	\| const char* key \| 数据键。 \|	1277	\| const char* key \| 数据键。 \|
1279	-\| const double* value \| 设置的double数组内容。 \|	1278	+\| const double* value \| 设置的double数组内容。实际设置的数量为`num`，value数组长度需大于`num`，否则会有越界访问风险。 \|
1280	\| size_t num \| 设置的double数组内容中元素的个数。 \|	1279	\| size_t num \| 设置的double数组内容中元素的个数。 \|
1281		1280
1282	返回：	1281	返回：
	@@ -1308,7 +1307,7 @@ CommonEvent_ErrCode OH_CommonEvent_Publish(const char* event)
1308		1307
1309	\| 类型 \| 说明 \|	1308	\| 类型 \| 说明 \|
1310	\| -- \| -- \|	1309	\| -- \| -- \|
1311	-\| [CommonEvent_ErrCode](#commonevent_errcode) \| 返回错误码。<br> 返回[COMMONEVENT_ERR_OK](capi-oh-commonevent-h.md#commonevent_errcode)表示成功。<br> 返回[COMMONEVENT_ERR_INVALID_PARAMETER](capi-oh-commonevent-h.md#commonevent_errcode)表示参数错误。<br> 返回[COMMONEVENT_ERR_SENDING_LIMIT_EXCEEDED](capi-oh-commonevent-h.md#commonevent_errcode)表示事件发送频率过高。<br> 返回[COMMONEVENT_ERR_SENDING_REQUEST_FAILED](capi-oh-commonevent-h.md#commonevent_errcode)表示IPC请求发送失败。<br> 返回[COMMONEVENT_ERR_INIT_UNDONE](capi-oh-commonevent-h.md#commonevent_errcode)表示公共事件服务未初始化。 \|	1310	+\| [CommonEvent_ErrCode](#commonevent_errcode) \| 返回错误码。<br> 返回[COMMONEVENT_ERR_OK](capi-oh-commonevent-h.md#commonevent_errcode)表示成功。<br> 返回[COMMONEVENT_ERR_INVALID_PARAMETER](capi-oh-commonevent-h.md#commonevent_errcode)表示参数错误。<br> 返回[COMMONEVENT_ERR_SENDING_LIMIT_EXCEEDED](capi-oh-commonevent-h.md#commonevent_errcode)表示事件发送频率过高。<br> 返回[COMMONEVENT_ERR_SENDING_REQUEST_FAILED](capi-oh-commonevent-h.md#commonevent_errcode)表示IPC请求发送失败。<br> 返回[COMMONEVENT_ERR_INIT_UNDONE](capi-oh-commonevent-h.md#commonevent_errcode)表示公共事件服务未初始化。返回[COMMONEVENT_ERR_NOT_SYSTEM_SERVICE](capi-oh-commonevent-h.md#commonevent_errcode)表示三方应用无法发送系统公共事件。 \|
1312		1311
1313	### OH_CommonEvent_PublishWithInfo()	1312	### OH_CommonEvent_PublishWithInfo()
1314		1313

Mzh-cn/application-dev/reference/apis-basic-services-kit/capi-oh-commonevent-support-h.md+1-1

	@@ -26,7 +26,7 @@
26		26
27	\| 名称 \| 描述 \|	27	\| 名称 \| 描述 \|
28	\| -- \| -- \|	28	\| -- \| -- \|
29	-\| static const char * const COMMON_EVENT_SHUTDOWN = "usual.event.SHUTDOWN" \| 表示设备正在关闭并将继续直至最终关闭的公共事件。<br>起始版本： 12<br>系统能力： SystemCapability.Notification.CommonEvent \|	29	+\| static const char * const COMMON_EVENT_SHUTDOWN = "usual.event.SHUTDOWN" \| 表示设备正在关闭并将继续直至最终关闭的公共事件。<br>起始版本： 12 \|
30	\| static const char * const COMMON_EVENT_BATTERY_CHANGED = "usual.event.BATTERY_CHANGED" \| 表示电池充电状态、电平和其他信息发生变化的公共事件。<br>起始版本： 12 \|	30	\| static const char * const COMMON_EVENT_BATTERY_CHANGED = "usual.event.BATTERY_CHANGED" \| 表示电池充电状态、电平和其他信息发生变化的公共事件。<br>起始版本： 12 \|
31	\| static const char * const COMMON_EVENT_BATTERY_LOW = "usual.event.BATTERY_LOW" \| 表示电池电量低的公共事件。<br>起始版本： 12 \|	31	\| static const char * const COMMON_EVENT_BATTERY_LOW = "usual.event.BATTERY_LOW" \| 表示电池电量低的公共事件。<br>起始版本： 12 \|
32	\| static const char * const COMMON_EVENT_BATTERY_OKAY = "usual.event.BATTERY_OKAY" \| 表示电池退出低电平状态的公共事件。<br>起始版本： 12 \|	32	\| static const char * const COMMON_EVENT_BATTERY_OKAY = "usual.event.BATTERY_OKAY" \| 表示电池退出低电平状态的公共事件。<br>起始版本： 12 \|

Mzh-cn/application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md+23-21

	@@ -126,7 +126,7 @@
126		126
127	### COMMON_EVENT_BUNDLE_REMOVED	127	### COMMON_EVENT_BUNDLE_REMOVED
128		128
129	-表示现有的应用程序包从设备中移除的事件。	129	+（预留事件，暂未支持）表示现有的应用程序包从设备中移除的事件。
130		130
131	系统能力： SystemCapability.Notification.CommonEvent	131	系统能力： SystemCapability.Notification.CommonEvent
132		132
	@@ -150,7 +150,7 @@
150		150
151	表示应用包已更改的公共事件的动作（例如，包中的组件已启用或禁用）。	151	表示应用包已更改的公共事件的动作（例如，包中的组件已启用或禁用）。
152		152
153	-在设备上安装的应用程序包更新或者包的组件被禁用使能，将会触发事件通知服务发布该系统公共事件。	153	+在设备上安装的应用程序包更新或者包的组件被启用/禁用，将会触发事件通知服务发布该系统公共事件。
154		154
155	> 说明：	155	> 说明：
156	>	156	>
	@@ -186,7 +186,7 @@
186		186
187	### COMMON_EVENT_PACKAGES_SUSPENDED	187	### COMMON_EVENT_PACKAGES_SUSPENDED
188		188
189	-表示包已经被挂起。	189	+（预留事件，暂未支持）表示包已经被挂起。
190		190
191	系统能力： SystemCapability.Notification.CommonEvent	191	系统能力： SystemCapability.Notification.CommonEvent
192		192
	@@ -197,7 +197,7 @@
197		197
198	### COMMON_EVENT_MY_PACKAGE_SUSPENDED	198	### COMMON_EVENT_MY_PACKAGE_SUSPENDED
199		199
200	-发送到已被系统挂起的包。	200	+（预留事件，暂未支持）发送到已被系统挂起的包。
201		201
202	系统能力： SystemCapability.Notification.CommonEvent	202	系统能力： SystemCapability.Notification.CommonEvent
203		203
	@@ -208,7 +208,7 @@
208		208
209	### COMMON_EVENT_MY_PACKAGE_UNSUSPENDED	209	### COMMON_EVENT_MY_PACKAGE_UNSUSPENDED
210		210
211	-发送到已被系统解除挂起的包。	211	+（预留事件，暂未支持）发送到已被系统解除挂起的包。
212		212
213	系统能力： SystemCapability.Notification.CommonEvent	213	系统能力： SystemCapability.Notification.CommonEvent
214		214
	@@ -524,7 +524,7 @@ datashare服务启动完成后，将会触发事件通知服务发布该系统
524		524
525	表示分布式账号注销的动作。	525	表示分布式账号注销的动作。
526		526
527	-分布式账号注销成功会时触发事件通知服务发布该系统公共事件，事件携带系统账号ID和子身份ID。	527	+分布式账号注销成功会触发事件通知服务发布该系统公共事件，事件携带系统账号ID和子身份ID。
528		528
529	与这个公共事件相关的接口：setOsAccountDistributedInfo、updateOsAccountDistributedInfo(已废弃)，这些为公共API，setOsAccountDistributedInfoByLocalId为系统API，具体参看[分布式账号接口文档](../js-apis-distributed-account.md)。	529	与这个公共事件相关的接口：setOsAccountDistributedInfo、updateOsAccountDistributedInfo(已废弃)，这些为公共API，setOsAccountDistributedInfoByLocalId为系统API，具体参看[分布式账号接口文档](../js-apis-distributed-account.md)。
530		530
	@@ -596,7 +596,7 @@ datashare服务启动完成后，将会触发事件通知服务发布该系统
596		596
597	### COMMON_EVENT_BATTERY_LOW	597	### COMMON_EVENT_BATTERY_LOW
598		598
599	-表示电池电量低的普通事件的动作。	599	+表示电池电量低的公共事件的动作。
600		600
601	当电池电量低于设备设置的低电量百分比值时，将会触发事件通知服务发布该系统公共事件。<!--Del-->设备设置低电量百分比值请参考[电量等级定制开发指导](../../../../device-dev/subsystems/subsys-power-battery-level-customization.md)。<!--DelEnd-->	601	当电池电量低于设备设置的低电量百分比值时，将会触发事件通知服务发布该系统公共事件。<!--Del-->设备设置低电量百分比值请参考[电量等级定制开发指导](../../../../device-dev/subsystems/subsys-power-battery-level-customization.md)。<!--DelEnd-->
602		602
	@@ -611,7 +611,7 @@ datashare服务启动完成后，将会触发事件通知服务发布该系统
611		611
612	表示电池退出低电量状态的公共事件的动作。	612	表示电池退出低电量状态的公共事件的动作。
613		613
614	-当电池电量从低电量等级变化到电池电量高于低电量等级时，将会触发事件通知服务发布该系统公共事件。	614	+当电池电量从低电量等级上升到高于低电量等级时，将会触发事件通知服务发布该系统公共事件。
615		615
616		616
617	系统能力： SystemCapability.Notification.CommonEvent	617	系统能力： SystemCapability.Notification.CommonEvent
	@@ -623,7 +623,7 @@ datashare服务启动完成后，将会触发事件通知服务发布该系统
623		623
624	### COMMON_EVENT_POWER_CONNECTED	624	### COMMON_EVENT_POWER_CONNECTED
625		625
626	-设备连接到外部电源的公共事件的动作。	626	+表示设备连接到外部电源的公共事件的动作。
627		627
628	当设备连接到外部可识别的充电器类型充电时，将会触发事件通知服务发布该系统公共事件。	628	当设备连接到外部可识别的充电器类型充电时，将会触发事件通知服务发布该系统公共事件。
629		629
	@@ -636,7 +636,7 @@ datashare服务启动完成后，将会触发事件通知服务发布该系统
636		636
637	### COMMON_EVENT_POWER_DISCONNECTED	637	### COMMON_EVENT_POWER_DISCONNECTED
638		638
639	-设备与外部电源断开的公共事件的动作。	639	+表示设备与外部电源断开的公共事件的动作。
640		640
641	当设备与外部电源断开时，将会触发事件通知服务发布该系统公共事件。	641	当设备与外部电源断开时，将会触发事件通知服务发布该系统公共事件。
642		642
	@@ -966,9 +966,9 @@ datashare服务启动完成后，将会触发事件通知服务发布该系统
966		966
967	### COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED	967	### COMMON_EVENT_NFC_ACTION_ADAPTER_STATE_CHANGED
968		968
969	-指示设备NFC状态已更改的公共事件的操作。	969	+表示设备NFC状态已更改的公共事件的操作。
970		970
971	-指示设备NFC状态更改时，将会触发事件通知服务发布该系统公共事件。	971	+表示设备NFC状态更改时，将会触发事件通知服务发布该系统公共事件。
972		972
973	系统能力： SystemCapability.Notification.CommonEvent	973	系统能力： SystemCapability.Notification.CommonEvent
974		974
	@@ -1110,7 +1110,7 @@ Wi-Fi状态变化。
1110		1110
1111	系统能力： SystemCapability.Notification.CommonEvent	1111	系统能力： SystemCapability.Notification.CommonEvent
1112		1112
1113	-订阅者需要的权限：无	1113	+订阅者所需权限：无
1114		1114
1115	取值： "usual.event.wifi.mplink.STATE_CHANGE"	1115	取值： "usual.event.wifi.mplink.STATE_CHANGE"
1116		1116
	@@ -1229,9 +1229,9 @@ Wi-Fi状态变化。
1229		1229
1230	### COMMON_EVENT_CONNECTIVITY_CHANGE<sup>10+</sup>	1230	### COMMON_EVENT_CONNECTIVITY_CHANGE<sup>10+</sup>
1231		1231
1232	-指示网络连接状态变化。	1232	+表示网络连接状态变化。
1233		1233
1234	-各类网络（以太网、Wi-Fi、蜂窝等）在发生连接状态状态变化时（断开、断开中、连接中、已连接等），将会触发事件通知服务发布该系统公共事件。	1234	+各类网络（以太网、Wi-Fi、蜂窝等）在连接状态变化时（断开、断开中、连接中、已连接等），将会触发事件通知服务发布该系统公共事件。
1235	具体枚举值及其对应的连接状态如下表所示：	1235	具体枚举值及其对应的连接状态如下表所示：
1236		1236
1237	\| 枚举值 \| 连接状态 \|	1237	\| 枚举值 \| 连接状态 \|
	@@ -1252,7 +1252,7 @@ Wi-Fi状态变化。
1252		1252
1253	### COMMON_EVENT_AIRPLANE_MODE_CHANGED<sup>10+</sup>	1253	### COMMON_EVENT_AIRPLANE_MODE_CHANGED<sup>10+</sup>
1254		1254
1255	-指示飞行模式状态变化。	1255	+表示飞行模式状态变化。
1256		1256
1257	在开启或者关闭系统飞行模式状态后，将会触发事件通知服务发布该系统公共事件。	1257	在开启或者关闭系统飞行模式状态后，将会触发事件通知服务发布该系统公共事件。
1258		1258
	@@ -1265,7 +1265,7 @@ Wi-Fi状态变化。
1265		1265
1266	### COMMON_EVENT_HTTP_PROXY_CHANGE<sup>10+</sup>	1266	### COMMON_EVENT_HTTP_PROXY_CHANGE<sup>10+</sup>
1267		1267
1268	-指示网络Http代理配置信息更新。	1268	+表示网络Http代理配置信息更新。
1269		1269
1270	在系统全局代理或者各类网络（以太网、Wi-Fi、蜂窝等）Http代理配置信息发生变化时，将会触发事件通知服务发布该系统公共事件。	1270	在系统全局代理或者各类网络（以太网、Wi-Fi、蜂窝等）Http代理配置信息发生变化时，将会触发事件通知服务发布该系统公共事件。
1271		1271
	@@ -1336,8 +1336,10 @@ Wi-Fi状态变化。
1336	AppGallery Kit面向应用发布如下系统公共事件。	1336	AppGallery Kit面向应用发布如下系统公共事件。
1337		1337
1338	### COMMON_EVENT_PRIVACY_STATE_CHANGED<sup>11+</sup>	1338	### COMMON_EVENT_PRIVACY_STATE_CHANGED<sup>11+</sup>
		1339	+
1339	表示隐私签署结果的公共事件。	1340	表示隐私签署结果的公共事件。
1340	-隐私弹框场景下，用户点击同意，会发送此事件。	1341	+
		1342	+隐私弹框场景下，用户点击同意，将会触发事件通知服务发布该系统公共事件。
1341		1343
1342	系统能力： SystemCapability.Notification.CommonEvent	1344	系统能力： SystemCapability.Notification.CommonEvent
1343		1345
	@@ -2181,7 +2183,7 @@ Multimodalinput Kit面向应用发布如下系统公共事件。
2181		2183
2182		2184
2183	### COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATE<sup>(deprecated)</sup>	2185	### COMMON_EVENT_BLUETOOTH_HOST_NAME_UPDATE<sup>(deprecated)</sup>
2184	-指示设备蓝牙适配器名称已更改的公共事件的操作。	2186	+表示设备蓝牙适配器名称已更改的公共事件的操作。
2185		2187
2186	> 说明：	2188	> 说明：
2187	>	2189	>
	@@ -2279,7 +2281,7 @@ Multimodalinput Kit面向应用发布如下系统公共事件。
2279		2281
2280		2282
2281	### COMMON_EVENT_IVI_SLEEP	2283	### COMMON_EVENT_IVI_SLEEP
2282	-（预留事件，暂未支持）表示表示车辆的车载信息娱乐（IVI）系统正在休眠的常见事件的动作。	2284	+（预留事件，暂未支持）表示车辆的车载信息娱乐（IVI）系统正在休眠的公共事件的动作。
2283		2285
2284	系统能力： SystemCapability.Notification.CommonEvent	2286	系统能力： SystemCapability.Notification.CommonEvent
2285		2287
	@@ -2353,7 +2355,7 @@ Multimodalinput Kit面向应用发布如下系统公共事件。
2353		2355
2354		2356
2355	### COMMON_EVENT_IVI_TEMPERATURE_ABNORMAL	2357	### COMMON_EVENT_IVI_TEMPERATURE_ABNORMAL
2356	-（预留事件，暂未支持）表示车载系统具有极端温度的常见事件的动作。	2358	+（预留事件，暂未支持）表示车载系统具有极端温度的公共事件的动作。
2357		2359
2358		2360
2359	系统能力： SystemCapability.Notification.CommonEvent	2361	系统能力： SystemCapability.Notification.CommonEvent

Mzh-cn/application-dev/reference/apis-basic-services-kit/errorcode-CommonEventService.md+4-4

	@@ -1,4 +1,4 @@
1	-# 事件错误码	1	+# 公共事件错误码
2	<!--Kit: Basic Services Kit-->	2	<!--Kit: Basic Services Kit-->
3	<!--Subsystem: Notification-->	3	<!--Subsystem: Notification-->
4	<!--Owner: @HuYueRong-->	4	<!--Owner: @HuYueRong-->
	@@ -40,7 +40,7 @@ A sandbox application cannot send common events.
40		40
41	可能原因	41	可能原因
42		42
43	-事件发送方应用为沙箱应用，发送公共事件会被拦截。	43	+公共事件发送方应用为沙箱应用，发送公共事件会被拦截。
44		44
45	处理步骤	45	处理步骤
46		46
	@@ -58,11 +58,11 @@ The common event sending frequency too high.
58		58
59	可能原因	59	可能原因
60		60
61	-短时间内应用发送事件数量超过系统频率限制，触发频率控制。	61	+发送公共事件频率超过每5毫秒20个，触发系统频率限制。
62		62
63	处理步骤	63	处理步骤
64		64
65	-检查应用是否过于频繁地发送公共事件，如过于频繁，请降低事件发送频率或增加发送间隔后重新尝试。	65	+检查应用是否过于频繁地发送公共事件，如发送频率超过每5毫秒20个，请降低公共事件发送频率或增加发送间隔后重新尝试。
66		66
67	## 1500004 无法发送系统公共事件	67	## 1500004 无法发送系统公共事件
68		68

Mzh-cn/application-dev/reference/apis-basic-services-kit/js-apis-commonEventManager-sys.md+7-7

	@@ -46,7 +46,7 @@ publishAsUser(event: string, userId: number, callback: AsyncCallback\<void>): vo
46		46
47	错误码：	47	错误码：
48		48
49	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	49	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
50		50
51	\| 错误码ID \| 错误信息 \|	51	\| 错误码ID \| 错误信息 \|
52	\| -------- \| ----------------------------------- \|	52	\| -------- \| ----------------------------------- \|
	@@ -101,7 +101,7 @@ publishAsUser(event: string, userId: number, options: CommonEventPublishData, ca
101		101
102	错误码：	102	错误码：
103		103
104	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	104	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
105		105
106	\| 错误码ID \| 错误信息 \|	106	\| 错误码ID \| 错误信息 \|
107	\| -------- \| ----------------------------------- \|	107	\| -------- \| ----------------------------------- \|
	@@ -161,7 +161,7 @@ removeStickyCommonEvent(event: string, callback: AsyncCallback\<void>): void
161		161
162	错误码：	162	错误码：
163		163
164	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	164	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
165		165
166	\| 错误码ID \| 错误信息 \|	166	\| 错误码ID \| 错误信息 \|
167	\| -------- \| ----------------------------------- \|	167	\| -------- \| ----------------------------------- \|
	@@ -212,7 +212,7 @@ removeStickyCommonEvent(event: string): Promise\<void>
212		212
213	错误码：	213	错误码：
214		214
215	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	215	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
216		216
217	\| 错误码ID \| 错误信息 \|	217	\| 错误码ID \| 错误信息 \|
218	\| -------- \| ----------------------------------- \|	218	\| -------- \| ----------------------------------- \|
	@@ -256,7 +256,7 @@ setStaticSubscriberState(enable: boolean, callback: AsyncCallback\<void>): void
256		256
257	错误码：	257	错误码：
258		258
259	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	259	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
260		260
261	\| 错误码ID \| 错误信息 \|	261	\| 错误码ID \| 错误信息 \|
262	\| -------- \| ----------------------------------- \|	262	\| -------- \| ----------------------------------- \|
	@@ -305,7 +305,7 @@ setStaticSubscriberState(enable: boolean): Promise\<void>
305		305
306	错误码：	306	错误码：
307		307
308	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	308	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
309		309
310	\| 错误码ID \| 错误信息 \|	310	\| 错误码ID \| 错误信息 \|
311	\| -------- \| ----------------------------------- \|	311	\| -------- \| ----------------------------------- \|
	@@ -354,7 +354,7 @@ setStaticSubscriberState(enable: boolean, events?: Array\<string>): Promise\<voi
354		354
355	错误码：	355	错误码：
356		356
357	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	357	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
358		358
359	\| 错误码ID \| 错误信息 \|	359	\| 错误码ID \| 错误信息 \|
360	\| -------- \| ------------------------------------------------------ \|	360	\| -------- \| ------------------------------------------------------ \|

Mzh-cn/application-dev/reference/apis-basic-services-kit/js-apis-commonEventManager.md+5-5

	@@ -67,7 +67,7 @@ publish(event: string, callback: AsyncCallback\<void>): void
67		67
68	错误码：	68	错误码：
69		69
70	-以下错误码的详细介绍请参见[事件错误码](./errorcode-CommonEventService.md)。	70	+以下错误码的详细介绍请参见[公共事件错误码](./errorcode-CommonEventService.md)。
71		71
72	\| 错误码ID \| 错误信息 \|	72	\| 错误码ID \| 错误信息 \|
73	\| -------- \| ----------------------------------- \|	73	\| -------- \| ----------------------------------- \|
	@@ -116,7 +116,7 @@ publish(event: string, options: CommonEventPublishData, callback: AsyncCallback\
116		116
117	错误码：	117	错误码：
118		118
119	-以下错误码的详细介绍请参见[事件错误码](./errorcode-CommonEventService.md)。	119	+以下错误码的详细介绍请参见[公共事件错误码](./errorcode-CommonEventService.md)。
120		120
121	\| 错误码ID \| 错误信息 \|	121	\| 错误码ID \| 错误信息 \|
122	\| -------- \| ----------------------------------- \|	122	\| -------- \| ----------------------------------- \|
	@@ -323,7 +323,7 @@ subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback\<CommonEven
323		323
324	错误码：	324	错误码：
325		325
326	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	326	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
327		327
328	\| 错误码ID \| 错误信息 \|	328	\| 错误码ID \| 错误信息 \|
329	\| -------- \| ----------------------------------- \|	329	\| -------- \| ----------------------------------- \|
	@@ -393,7 +393,7 @@ unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback\<void>):
393		393
394	错误码：	394	错误码：
395		395
396	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	396	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
397		397
398	\| 错误码ID \| 错误信息 \|	398	\| 错误码ID \| 错误信息 \|
399	\| -------- \| ----------------------------------- \|	399	\| -------- \| ----------------------------------- \|
	@@ -487,7 +487,7 @@ subscribeToEvent(subscriber: CommonEventSubscriber, callback: Callback\<CommonEv
487		487
488	错误码：	488	错误码：
489		489
490	-以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[事件错误码](./errorcode-CommonEventService.md)。	490	+以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[公共事件错误码](./errorcode-CommonEventService.md)。
491		491
492	\| 错误码ID \| 错误信息 \|	492	\| 错误码ID \| 错误信息 \|
493	\| -------- \| ----------------------------------- \|	493	\| -------- \| ----------------------------------- \|