js-apis-notificationManager.md 134.6 KB
Newer Older
Z
zengyawen 已提交
1
# @ohos.notificationManager (NotificationManager模块)
2 3 4 5 6 7 8 9 10

本模块提供通知管理的能力,包括发布、取消发布通知,创建、获取、移除通知通道,获取通知的使能状态、角标使能状态,获取通知的相关信息等。

> **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

## 导入模块

11 12
```ts
import notificationManager from '@ohos.notificationManager';
13 14
```

15
## notificationManager.publish
16 17 18 19 20 21 22 23 24

publish(request: NotificationRequest, callback: AsyncCallback\<void\>): void

发布通知(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
25
| 参数名     | 类型                                        | 必填 | 说明                                        |
26
| -------- | ------------------------------------------- | ---- | ------------------------------------------- |
27
| request  | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是   | 用于设置要发布通知的内容和相关配置信息。 |
F
fangJinliang1 已提交
28
| callback | AsyncCallback\<void\>                       | 是   | 发布通知的回调方法。                        |
29 30 31

**错误码:**

F
fangJinliang1 已提交
32 33
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

34 35 36 37 38 39 40 41 42 43 44
| 错误码ID | 错误信息                                  |
| -------- | ----------------------------------------- |
| 1600001  | Internal error.                           |
| 1600002  | Marshalling or unmarshalling error.       |
| 1600003  | Failed to connect service.                |
| 1600004  | Notification is not enabled.              |
| 1600005  | Notification slot is not enabled.         |
| 1600009  | Over max number notifications per second. |

**示例:**

45
```ts
46 47 48
//publish回调
function publishCallback(err) {
    if (err) {
49
        console.error(`publish failed, code is ${err.code}, message is ${err.message}`);
50 51 52 53 54
    } else {
        console.info("publish success");
    }
}
//通知Request对象
55
let notificationRequest: notificationManager.NotificationRequest = {
56 57
    id: 1,
    content: {
58
        contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
59 60 61 62 63 64
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
F
fangJinliang1 已提交
65
};
66
notificationManager.publish(notificationRequest, publishCallback);
67 68
```

69
## notificationManager.publish
70 71 72 73 74 75 76 77 78

publish(request: NotificationRequest): Promise\<void\>

发布通知(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
79
| 参数名     | 类型                                        | 必填 | 说明                                        |
80
| -------- | ------------------------------------------- | ---- | ------------------------------------------- |
81
| request  | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是   | 用于设置要发布通知的内容和相关配置信息。 |
82 83 84

**错误码:**

F
fangJinliang1 已提交
85 86
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

87 88 89 90 91 92 93 94 95 96 97
| 错误码ID | 错误信息                                  |
| -------- | ----------------------------------------- |
| 1600001  | Internal error.                           |
| 1600002  | Marshalling or unmarshalling error.       |
| 1600003  | Failed to connect service.                |
| 1600004  | Notification is not enabled.              |
| 1600005  | Notification slot is not enabled.         |
| 1600009  | Over max number notifications per second. |

**示例:**

98
```ts
F
fangJinliang1 已提交
99
// 通知Request对象
100
let notificationRequest: notificationManager.NotificationRequest = {
101 102
    notificationId: 1,
    content: {
103
        contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
104 105 106 107 108 109
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
F
fangJinliang1 已提交
110
};
111
notificationManager.publish(notificationRequest).then(() => {
F
fangJinliang1 已提交
112
	console.info("publish success");
113 114 115 116
});

```

117
## notificationManager.publish
118 119 120

publish(request: NotificationRequest, userId: number, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
121
发布通知给指定的用户(callback形式)。
122 123 124 125 126 127 128 129 130

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
131
| 参数名     | 类型                                        | 必填 | 说明                                        |
132
| -------- | ----------------------------------------- | ---- | ------------------------------------------- |
133
| request  | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是   | 用于设置要发布通知的内容和相关配置信息。 |
F
fangJinliang1 已提交
134
| userId   | number                                      | 是   | 用户ID。                           |
135 136 137 138
| callback | AsyncCallback\<void\>                       | 是   | 被指定的回调方法。                           |

**错误码:**

F
fangJinliang1 已提交
139 140
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

141 142 143 144 145 146 147 148 149 150 151 152
| 错误码ID | 错误信息                                  |
| -------- | ----------------------------------------- |
| 1600001  | Internal error.                           |
| 1600002  | Marshalling or unmarshalling error.       |
| 1600003  | Failed to connect service.                |
| 1600004  | Notification is not enabled.              |
| 1600005  | Notification slot is not enabled.         |
| 1600008  | The user is not exist.                    |
| 1600009  | Over max number notifications per second. |

**示例:**

153
```ts
F
fangJinliang1 已提交
154
// publish回调
155 156
function publishCallback(err) {
    if (err) {
157
        console.error(`publish failed, code is ${err.code}, message is ${err.message}`);
158 159 160 161
    } else {
        console.info("publish success");
    }
}
F
fangJinliang1 已提交
162
// 用户ID
F
fangJinliang1 已提交
163
let userId = 1;
F
fangJinliang1 已提交
164
// 通知Request对象
165
let notificationRequest: notificationManager.NotificationRequest = {
166 167
    id: 1,
    content: {
168
        contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
169 170 171 172 173 174
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
F
fangJinliang1 已提交
175
};
176
notificationManager.publish(notificationRequest, userId, publishCallback);
177 178
```

179
## notificationManager.publish
180 181 182

publish(request: NotificationRequest, userId: number): Promise\<void\>

F
fangJinliang1 已提交
183
发布通知给指定的用户(Promise形式)。
184 185 186 187 188 189 190 191 192

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
193
| 参数名     |  类型                                        | 必填 | 说明                                        |
194
| -------- | ----------------------------------------- | ---- | ------------------------------------------- |
195
| request  | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是   | 用于设置要发布通知的内容和相关配置信息。 |
F
fangJinliang1 已提交
196
| userId   | number                                      | 是   | 用户ID。                           |
197 198 199

**错误码:**

F
fangJinliang1 已提交
200 201
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

202 203 204 205 206 207 208 209 210 211 212 213
| 错误码ID | 错误信息                                  |
| -------- | ----------------------------------------- |
| 1600001  | Internal error.                           |
| 1600002  | Marshalling or unmarshalling error.       |
| 1600003  | Failed to connect service.                |
| 1600004  | Notification is not enabled.              |
| 1600005  | Notification slot is not enabled.         |
| 1600008  | The user is not exist.                    |
| 1600009  | Over max number notifications per second. |

**示例:**

214
```ts
215
let notificationRequest: notificationManager.NotificationRequest = {
216 217
    notificationId: 1,
    content: {
218
        contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
219 220 221 222 223 224
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
F
fangJinliang1 已提交
225
};
226

F
fangJinliang1 已提交
227
let userId = 1;
228

229
notificationManager.publish(notificationRequest, userId).then(() => {
F
fangJinliang1 已提交
230
	console.info("publish success");
231 232 233 234
});
```


235
## notificationManager.cancel
236 237 238

cancel(id: number, label: string, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
239
通过通知ID和通知标签取消已发布的通知(callback形式)。
240 241 242 243 244

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
245
| 参数名     | 类型                  | 必填 | 说明                 |
246 247 248 249 250 251 252
| -------- | --------------------- | ---- | -------------------- |
| id       | number                | 是   | 通知ID。               |
| label    | string                | 是   | 通知标签。             |
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。 |

**错误码:**

F
fangJinliang1 已提交
253 254
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

255 256 257 258 259 260 261 262 263
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600007  | The notification is not exist.      |

**示例:**

264
```ts
F
fangJinliang1 已提交
265
// cancel回调
266 267
function cancelCallback(err) {
    if (err) {
268
        console.error(`cancel failed, code is ${err.code}, message is ${err.message}`);
269 270 271 272
    } else {
        console.info("cancel success");
    }
}
273
notificationManager.cancel(0, "label", cancelCallback);
274 275
```

276
## notificationManager.cancel
277 278 279

cancel(id: number, label?: string): Promise\<void\>

F
fangJinliang1 已提交
280
取消与指定通知ID相匹配的已发布通知,label可以指定也可以不指定(Promise形式)。
281 282 283 284 285

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
286
| 参数名  | 类型   | 必填 | 说明     |
287 288 289 290 291 292
| ----- | ------ | ---- | -------- |
| id    | number | 是   | 通知ID。   |
| label | string | 否   | 通知标签。 |

**错误码:**

F
fangJinliang1 已提交
293 294
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

295 296 297 298 299 300 301 302 303
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600007  | The notification is not exist.      |

**示例:**

304 305
```ts
notificationManager.cancel(0).then(() => {
F
fangJinliang1 已提交
306
	console.info("cancel success");
307 308 309
});
```

310
## notificationManager.cancel
311 312 313

cancel(id: number, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
314
取消与指定通知ID相匹配的已发布通知(callback形式)。
315 316 317 318 319

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
320
| 参数名     | 类型                  | 必填 | 说明                 |
321 322 323 324 325 326
| -------- | --------------------- | ---- | -------------------- |
| id       | number                | 是   | 通知ID。               |
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。 |

**错误码:**

F
fangJinliang1 已提交
327 328
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

329 330 331 332 333 334 335 336 337
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600007  | The notification is not exist.      |

**示例:**

338
```ts
F
fangJinliang1 已提交
339
// cancel回调
340 341
function cancelCallback(err) {
    if (err) {
342
        console.error(`cancel failed, code is ${err.code}, message is ${err.message}`);
343 344 345 346
    } else {
        console.info("cancel success");
    }
}
347
notificationManager.cancel(0, cancelCallback);
348 349
```

350
## notificationManager.cancelAll
351 352 353 354 355 356 357 358 359

cancelAll(callback: AsyncCallback\<void\>): void

取消所有已发布的通知(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**错误码:**

F
fangJinliang1 已提交
360 361
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

362 363 364 365 366 367 368 369
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**参数:**

F
fangJinliang1 已提交
370
| 参数名     | 类型                  | 必填 | 说明                 |
371 372 373 374 375
| -------- | --------------------- | ---- | -------------------- |
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。 |

**示例:**

376
```ts
F
fangJinliang1 已提交
377
// cancel回调
378 379
function cancelAllCallback(err) {
    if (err) {
380
        console.error(`cancelAll failed, code is ${err.code}, message is ${err.message}`);
381 382 383 384
    } else {
        console.info("cancelAll success");
    }
}
385
notificationManager.cancelAll(cancelAllCallback);
386 387
```

388
## notificationManager.cancelAll
389 390 391 392 393 394 395 396 397

cancelAll(): Promise\<void\>

取消所有已发布的通知(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**错误码:**

F
fangJinliang1 已提交
398 399
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

400 401 402 403 404 405 406 407
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

408 409
```ts
notificationManager.cancelAll().then(() => {
F
fangJinliang1 已提交
410
	console.info("cancelAll success");
411 412 413
});
```

414
## notificationManager.addSlot
415 416 417 418 419 420 421 422 423 424 425 426 427

addSlot(slot: NotificationSlot, callback: AsyncCallback\<void\>): void

创建通知通道(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
428
| 参数名     | 类型                  | 必填 | 说明                 |
429
| -------- | --------------------- | ---- | -------------------- |
430
| slot     | [NotificationSlot](js-apis-inner-notification-notificationSlot.md)       | 是   | 要创建的通知通道对象。 |
431 432 433 434
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。 |

**错误码:**

F
fangJinliang1 已提交
435 436
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

437 438 439 440 441 442 443 444
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

445
```ts
F
fangJinliang1 已提交
446
// addslot回调
447 448
function addSlotCallBack(err) {
    if (err) {
449
        console.error(`addSlot failed, code is ${err.code}, message is ${err.message}`);
450 451 452 453
    } else {
        console.info("addSlot success");
    }
}
F
fangJinliang1 已提交
454
// 通知slot对象
F
fangJinliang1 已提交
455
let notificationSlot = {
456
    type: notificationManager.SlotType.SOCIAL_COMMUNICATION
F
fangJinliang1 已提交
457
};
458
notificationManager.addSlot(notificationSlot, addSlotCallBack);
459 460
```

461
## notificationManager.addSlot
462 463 464 465 466 467 468 469 470 471 472 473 474

addSlot(slot: NotificationSlot): Promise\<void\>

创建通知通道(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
475
| 参数名 | 类型             | 必填 | 说明                 |
476
| ---- | ---------------- | ---- | -------------------- |
477
| slot | [NotificationSlot](js-apis-inner-notification-notificationSlot.md) | 是   | 要创建的通知通道对象。 |
478 479 480

**错误码:**

F
fangJinliang1 已提交
481 482
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

483 484 485 486 487 488 489 490
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

491
```ts
F
fangJinliang1 已提交
492
// 通知slot对象
F
fangJinliang1 已提交
493
let notificationSlot = {
494
    type: notificationManager.SlotType.SOCIAL_COMMUNICATION
F
fangJinliang1 已提交
495
};
496
notificationManager.addSlot(notificationSlot).then(() => {
F
fangJinliang1 已提交
497
	console.info("addSlot success");
498 499 500
});
```

501
## notificationManager.addSlot
502 503 504

addSlot(type: SlotType, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
505
创建指定类型的通知通道(callback形式)。
506 507 508 509 510

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
511
| 参数名     | 类型                  | 必填 | 说明                   |
512 513 514 515 516 517
| -------- | --------------------- | ---- | ---------------------- |
| type     | [SlotType](#slottype)              | 是   | 要创建的通知通道的类型。 |
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。   |

**错误码:**

F
fangJinliang1 已提交
518 519
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

520 521 522 523 524 525 526 527
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

528
```ts
F
fangJinliang1 已提交
529
// addslot回调
530 531
function addSlotCallBack(err) {
    if (err) {
532
        console.error(`addSlot failed, code is ${err.code}, message is ${err.message}`);
533 534 535 536
    } else {
        console.info("addSlot success");
    }
}
537
notificationManager.addSlot(notificationManager.SlotType.SOCIAL_COMMUNICATION, addSlotCallBack);
538 539
```

540
## notificationManager.addSlot
541 542 543

addSlot(type: SlotType): Promise\<void\>

F
fangJinliang1 已提交
544
创建指定类型的通知通道(Promise形式)。
545 546 547 548 549

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
550
| 参数名 | 类型     | 必填 | 说明                   |
551 552 553 554 555
| ---- | -------- | ---- | ---------------------- |
| type | [SlotType](#slottype) | 是   | 要创建的通知通道的类型。 |

**错误码:**

F
fangJinliang1 已提交
556 557
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

558 559 560 561 562 563 564 565
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

566 567
```ts
notificationManager.addSlot(notificationManager.SlotType.SOCIAL_COMMUNICATION).then(() => {
F
fangJinliang1 已提交
568
	console.info("addSlot success");
569 570 571
});
```

572
## notificationManager.addSlots
573 574 575 576 577 578 579 580 581 582 583 584 585

addSlots(slots: Array\<NotificationSlot\>, callback: AsyncCallback\<void\>): void

创建多个通知通道(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
586
| 参数名     | 类型                      | 必填 | 说明                     |
587
| -------- | ------------------------- | ---- | ------------------------ |
588
| slots    | Array\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\> | 是   | 要创建的通知通道对象数组。 |
589 590 591 592
| callback | AsyncCallback\<void\>     | 是   | 表示被指定的回调方法。     |

**错误码:**

F
fangJinliang1 已提交
593 594
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

595 596 597 598 599 600 601 602
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

603
```ts
F
fangJinliang1 已提交
604
// addSlots回调
605 606
function addSlotsCallBack(err) {
    if (err) {
607
        console.error(`addSlots failed, code is ${err.code}, message is ${err.message}`);
608 609 610 611
    } else {
        console.info("addSlots success");
    }
}
F
fangJinliang1 已提交
612
// 通知slot对象
F
fangJinliang1 已提交
613
let notificationSlot = {
614
    type: notificationManager.SlotType.SOCIAL_COMMUNICATION
F
fangJinliang1 已提交
615
};
F
fangJinliang1 已提交
616
// 通知slot array 对象
F
fangJinliang1 已提交
617
let notificationSlotArray = new Array();
618 619
notificationSlotArray[0] = notificationSlot;

620
notificationManager.addSlots(notificationSlotArray, addSlotsCallBack);
621 622
```

623
## notificationManager.addSlots
624 625 626 627 628 629 630 631 632 633 634 635 636

addSlots(slots: Array\<NotificationSlot\>): Promise\<void\>

创建多个通知通道(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
637
| 参数名  | 类型                      | 必填 | 说明                     |
638
| ----- | ------------------------- | ---- | ------------------------ |
639
| slots | Array\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\> | 是   | 要创建的通知通道对象数组。 |
640 641 642

**错误码:**

F
fangJinliang1 已提交
643 644
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

645 646 647 648 649 650 651 652
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

653
```ts
F
fangJinliang1 已提交
654
// 通知slot对象
F
fangJinliang1 已提交
655
let notificationSlot = {
656
    type: notificationManager.SlotType.SOCIAL_COMMUNICATION
F
fangJinliang1 已提交
657
};
F
fangJinliang1 已提交
658
// 通知slot array 对象
F
fangJinliang1 已提交
659
let notificationSlotArray = new Array();
660 661
notificationSlotArray[0] = notificationSlot;

662
notificationManager.addSlots(notificationSlotArray).then(() => {
F
fangJinliang1 已提交
663
	console.info("addSlots success");
664 665 666
});
```

667
## notificationManager.getSlot
668 669 670

getSlot(slotType: SlotType, callback: AsyncCallback\<NotificationSlot\>): void

F
fangJinliang1 已提交
671
获取一个指定类型的通知通道(callback形式)。
672 673 674 675 676

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
677
| 参数名     | 类型                              | 必填 | 说明                                                        |
678
| -------- | --------------------------------- | ---- | ----------------------------------------------------------- |
F
fangJinliang1 已提交
679
| slotType | [SlotType](#slottype)                          | 是   | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
680
| callback | AsyncCallback\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\> | 是   | 表示被指定的回调方法。                                        |
681 682 683

**错误码:**

F
fangJinliang1 已提交
684 685
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

686 687 688 689 690 691 692 693
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

694
```ts
F
fangJinliang1 已提交
695
// getSlot回调
696 697
function getSlotCallback(err,data) {
    if (err) {
698
        console.error(`getSlot failed, code is ${err.code}, message is ${err.message}`);
699 700 701 702
    } else {
        console.info("getSlot success");
    }
}
703 704
let slotType = notificationManager.SlotType.SOCIAL_COMMUNICATION;
notificationManager.getSlot(slotType, getSlotCallback);
705 706
```

707
## notificationManager.getSlot
708 709 710

getSlot(slotType: SlotType): Promise\<NotificationSlot\>

F
fangJinliang1 已提交
711
获取一个指定类型的通知通道(Promise形式)。
712 713 714 715 716

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
717
| 参数名     | 类型     | 必填 | 说明                                                        |
718
| -------- | -------- | ---- | ----------------------------------------------------------- |
F
fangJinliang1 已提交
719
| slotType | [SlotType](#slottype) | 是   | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
720 721 722 723 724 725 726 727 728

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| Promise\<NotificationSlot\> | 以Promise形式返回获取一个通知通道。 |

**错误码:**

F
fangJinliang1 已提交
729 730
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

731 732 733 734 735 736 737 738
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

739 740 741
```ts
let slotType = notificationManager.SlotType.SOCIAL_COMMUNICATION;
notificationManager.getSlot(slotType).then((data) => {
F
fangJinliang1 已提交
742
	console.info("getSlot success, data: " + JSON.stringify(data));
743 744 745
});
```

746
## notificationManager.getSlots
747 748 749 750 751 752 753 754 755

getSlots(callback: AsyncCallback<Array\<NotificationSlot\>>): void

获取此应用程序的所有通知通道(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
756 757
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

F
fangJinliang1 已提交
758
| 参数名     | 类型                              | 必填 | 说明                 |
759
| -------- | --------------------------------- | ---- | -------------------- |
760
| callback | AsyncCallback\<Array\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\>\> | 是   | 以callback形式返回获取此应用程序的所有通知通道的结果。 |
761 762 763 764 765 766 767 768 769 770 771

**错误码:**

| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

772
```ts
F
fangJinliang1 已提交
773
// getSlots回调
774 775
function getSlotsCallback(err,data) {
    if (err) {
776
        console.error(`getSlots failed, code is ${err.code}, message is ${err.message}`);
777 778 779 780
    } else {
        console.info("getSlots success");
    }
}
781
notificationManager.getSlots(getSlotsCallback);
782 783
```

784
## notificationManager.getSlots
785 786 787 788 789 790 791 792 793 794 795

getSlots(): Promise\<Array\<NotificationSlot\>>

获取此应用程序的所有通知通道(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
796
| Promise\<Array\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\>\> | 以Promise形式返回获取此应用程序的所有通知通道的结果。 |
797 798 799

**错误码:**

F
fangJinliang1 已提交
800 801
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

802 803 804 805 806 807 808 809
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

810 811
```ts
notificationManager.getSlots().then((data) => {
F
fangJinliang1 已提交
812
	console.info("getSlots success, data: " + JSON.stringify(data));
813 814 815
});
```

816
## notificationManager.removeSlot
817 818 819

removeSlot(slotType: SlotType, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
820
删除指定类型的通知通道(callback形式)。
821 822 823 824 825

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
826
| 参数名     | 类型                  | 必填 | 说明                                                        |
827 828 829 830 831 832
| -------- | --------------------- | ---- | ----------------------------------------------------------- |
| slotType | [SlotType](#slottype)              | 是   | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。                                        |

**错误码:**

F
fangJinliang1 已提交
833 834
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

835 836 837 838 839 840 841 842
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

843
```ts
F
fangJinliang1 已提交
844
// removeSlot回调
845 846
function removeSlotCallback(err) {
    if (err) {
847
        console.error(`removeSlot failed, code is ${err.code}, message is ${err.message}`);
848 849 850 851
    } else {
        console.info("removeSlot success");
    }
}
852 853
let slotType = notificationManager.SlotType.SOCIAL_COMMUNICATION;
notificationManager.removeSlot(slotType,removeSlotCallback);
854 855
```

856
## notificationManager.removeSlot
857 858 859

removeSlot(slotType: SlotType): Promise\<void\>

F
fangJinliang1 已提交
860
删除指定类型的通知通道(Promise形式)。
861 862 863 864 865

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
866
| 参数名     | 类型     | 必填 | 说明                                                        |
867 868 869 870 871
| -------- | -------- | ---- | ----------------------------------------------------------- |
| slotType | [SlotType](#slottype) | 是   | 通知渠道类型,目前分为社交通信、服务提醒、内容咨询和其他类型。 |

**错误码:**

F
fangJinliang1 已提交
872 873
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

874 875 876 877 878 879 880 881
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

882 883 884
```ts
let slotType = notificationManager.SlotType.SOCIAL_COMMUNICATION;
notificationManager.removeSlot(slotType).then(() => {
F
fangJinliang1 已提交
885
	console.info("removeSlot success");
886 887 888
});
```

889
## notificationManager.removeAllSlots
890 891 892 893 894 895 896 897 898

removeAllSlots(callback: AsyncCallback\<void\>): void

删除所有通知通道(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
899
| 参数名     | 类型                  | 必填 | 说明                 |
900 901 902 903 904
| -------- | --------------------- | ---- | -------------------- |
| callback | AsyncCallback\<void\> | 是   | 表示被指定的回调方法。 |

**错误码:**

F
fangJinliang1 已提交
905 906
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

907 908 909 910 911 912 913 914
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

915
```ts
916 917
function removeAllCallBack(err) {
    if (err) {
918
        console.error(`removeAllSlots failed, code is ${err.code}, message is ${err.message}`);
919 920 921 922
    } else {
        console.info("removeAllSlots success");
    }
}
923
notificationManager.removeAllSlots(removeAllCallBack);
924 925
```

926
## notificationManager.removeAllSlots
927 928 929 930 931 932 933 934 935

removeAllSlots(): Promise\<void\>

删除所有通知通道(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**错误码:**

F
fangJinliang1 已提交
936 937
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

938 939 940 941 942 943 944 945
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

946 947
```ts
notificationManager.removeAllSlots().then(() => {
F
fangJinliang1 已提交
948
	console.info("removeAllSlots success");
949 950 951
});
```

952
## notificationManager.setNotificationEnable
953 954 955

setNotificationEnable(bundle: BundleOption, enable: boolean, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
956
设定指定应用的通知使能状态(Callback形式)。
957 958 959 960 961 962 963 964 965

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
966
| 参数名     | 类型                  | 必填 | 说明                 |
967
| -------- | --------------------- | ---- | -------------------- |
968
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)   | 是   | 指定应用的包信息。        |
969 970 971 972 973
| enable   | boolean               | 是   | 使能状态。             |
| callback | AsyncCallback\<void\> | 是   | 设定通知使能回调函数。 |

**错误码:**

F
fangJinliang1 已提交
974 975
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

976 977 978 979 980 981 982 983 984
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

985
```ts
986 987
function setNotificationEnablenCallback(err) {
    if (err) {
988
        console.error(`setNotificationEnablenCallback failed, code is ${err.code}, message is ${err.message}`);
989 990 991 992
    } else {
        console.info("setNotificationEnablenCallback success");
    }
}
F
fangJinliang1 已提交
993
let bundle = {
994
    bundle: "bundleName1",
F
fangJinliang1 已提交
995
};
996
notificationManager.setNotificationEnable(bundle, false, setNotificationEnablenCallback);
997 998
```

999
## notificationManager.setNotificationEnable
1000 1001 1002

setNotificationEnable(bundle: BundleOption, enable: boolean): Promise\<void\>

F
fangJinliang1 已提交
1003
设定指定应用的通知使能状态(Promise形式)。
1004 1005 1006 1007 1008 1009 1010 1011 1012

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1013
| 参数名   | 类型         | 必填 | 说明       |
1014
| ------ | ------------ | ---- | ---------- |
1015
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1016 1017 1018 1019
| enable | boolean      | 是   | 使能状态。   |

**错误码:**

F
fangJinliang1 已提交
1020 1021
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1022 1023 1024 1025 1026 1027 1028 1029 1030
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1031
```ts
F
fangJinliang1 已提交
1032
let bundle = {
1033
    bundle: "bundleName1",
F
fangJinliang1 已提交
1034
};
1035
notificationManager.setNotificationEnable(bundle, false).then(() => {
F
fangJinliang1 已提交
1036
	console.info("setNotificationEnable success");
1037 1038 1039
});
```

1040
## notificationManager.isNotificationEnabled
1041 1042 1043

isNotificationEnabled(bundle: BundleOption, callback: AsyncCallback\<boolean\>): void

F
fangJinliang1 已提交
1044
获取指定应用的通知使能状态(Callback形式)。
1045 1046 1047 1048 1049 1050 1051 1052 1053

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

F
fangJinliang1 已提交
1054
| 参数名     | 类型                  | 必填 | 说明                     |
1055
| -------- | --------------------- | ---- | ------------------------ |
1056
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)          | 是   | 指定应用的包信息。            |
1057 1058 1059 1060
| callback | AsyncCallback\<void\> | 是   | 获取通知使能状态回调函数。 |

**错误码:**

F
fangJinliang1 已提交
1061 1062
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1063 1064 1065 1066 1067 1068 1069 1070 1071
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1072
```ts
1073 1074
function isNotificationEnabledCallback(err, data) {
    if (err) {
1075
        console.error(`isNotificationEnabled failed, code is ${err.code}, message is ${err.message}`);
1076 1077 1078 1079
    } else {
        console.info("isNotificationEnabled success");
    }
}
F
fangJinliang1 已提交
1080
let bundle = {
1081
    bundle: "bundleName1",
F
fangJinliang1 已提交
1082
};
1083
notificationManager.isNotificationEnabled(bundle, isNotificationEnabledCallback);
1084 1085
```

1086
## notificationManager.isNotificationEnabled
1087 1088 1089

isNotificationEnabled(bundle: BundleOption): Promise\<boolean\>

F
fangJinliang1 已提交
1090
获取指定应用的通知使能状态(Promise形式)。
1091 1092 1093 1094 1095 1096 1097 1098 1099

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1100
| 参数名   | 类型         | 必填 | 说明       |
1101
| ------ | ------------ | ---- | ---------- |
1102
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1103 1104 1105

**返回值:**

F
fangJinliang1 已提交
1106 1107 1108
| 类型               | 说明                                                |
| ------------------ | --------------------------------------------------- |
| Promise\<boolean\> | 以Promise形式返回获取指定应用的通知使能状态的结果。 |
1109 1110 1111

**错误码:**

F
fangJinliang1 已提交
1112 1113
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1114 1115 1116 1117 1118 1119 1120 1121 1122
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1123
```ts
F
fangJinliang1 已提交
1124
let bundle = {
1125
    bundle: "bundleName1",
F
fangJinliang1 已提交
1126
};
1127
notificationManager.isNotificationEnabled(bundle).then((data) => {
F
fangJinliang1 已提交
1128
	console.info("isNotificationEnabled success, data: " + JSON.stringify(data));
1129 1130 1131
});
```

1132
## notificationManager.isNotificationEnabled
1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145

isNotificationEnabled(callback: AsyncCallback\<boolean\>): void

获取通知使能状态(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1146
| 参数名     | 类型                  | 必填 | 说明                     |
1147 1148 1149 1150 1151
| -------- | --------------------- | ---- | ------------------------ |
| callback | AsyncCallback\<void\> | 是   | 获取通知使能状态回调函数。 |

**错误码:**

F
fangJinliang1 已提交
1152 1153
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1154 1155 1156 1157 1158 1159 1160 1161
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1162
```ts
1163 1164
function isNotificationEnabledCallback(err, data) {
    if (err) {
1165
        console.error(`isNotificationEnabled failed, code is ${err.code}, message is ${err.message}`);
1166 1167 1168 1169 1170
    } else {
        console.info("isNotificationEnabled success");
    }
}

1171
notificationManager.isNotificationEnabled(isNotificationEnabledCallback);
1172 1173
```

1174
## notificationManager.isNotificationEnabled
1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187

isNotificationEnabled(): Promise\<boolean\>

获取通知使能状态(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1188
| 参数名   | 类型         | 必填 | 说明       |
1189
| ------ | ------------ | ---- | ---------- |
1190
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1191 1192 1193 1194 1195 1196 1197 1198 1199

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| Promise\<boolean\> | 以Promise形式返回获取通知使能状态的结果。 |

**错误码:**

F
fangJinliang1 已提交
1200 1201
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1202 1203 1204 1205 1206 1207 1208 1209 1210
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1211 1212
```ts
notificationManager.isNotificationEnabled().then((data) => {
F
fangJinliang1 已提交
1213
	console.info("isNotificationEnabled success, data: " + JSON.stringify(data));
1214 1215 1216
});
```

1217
## notificationManager.displayBadge
1218 1219 1220

displayBadge(bundle: BundleOption, enable: boolean, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
1221
设定指定应用的角标使能状态(Callback形式)。
1222 1223 1224 1225 1226 1227 1228 1229 1230

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1231
| 参数名     | 类型                  | 必填 | 说明                 |
1232
| -------- | --------------------- | ---- | -------------------- |
1233
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)          | 是   | 指定应用的包信息。           |
1234 1235 1236 1237 1238
| enable   | boolean               | 是   | 使能状态。             |
| callback | AsyncCallback\<void\> | 是   | 设定角标使能回调函数。 |

**错误码:**

F
fangJinliang1 已提交
1239 1240
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1241 1242 1243 1244 1245 1246 1247 1248 1249
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1250
```ts
1251 1252
function displayBadgeCallback(err) {
    if (err) {
1253
        console.error(`displayBadge failed, code is ${err.code}, message is ${err.message}`);
1254 1255 1256 1257
    } else {
        console.info("displayBadge success");
    }
}
F
fangJinliang1 已提交
1258
let bundle = {
1259
    bundle: "bundleName1",
F
fangJinliang1 已提交
1260
};
1261
notificationManager.displayBadge(bundle, false, displayBadgeCallback);
1262 1263
```

1264
## notificationManager.displayBadge
1265 1266 1267

displayBadge(bundle: BundleOption, enable: boolean): Promise\<void\>

F
fangJinliang1 已提交
1268
设定指定应用的角标使能状态(Promise形式)。
1269 1270 1271 1272 1273 1274 1275 1276 1277

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1278
| 参数名   | 类型         | 必填 | 说明       |
1279
| ------ | ------------ | ---- | ---------- |
1280
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1281 1282 1283 1284
| enable | boolean      | 是   | 使能状态。   |

**错误码:**

F
fangJinliang1 已提交
1285 1286
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1287 1288 1289 1290 1291 1292 1293 1294 1295
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1296
```ts
F
fangJinliang1 已提交
1297
let bundle = {
1298
    bundle: "bundleName1",
F
fangJinliang1 已提交
1299
};
1300
notificationManager.displayBadge(bundle, false).then(() => {
F
fangJinliang1 已提交
1301
	console.info("displayBadge success");
1302 1303 1304
});
```

1305
## notificationManager.isBadgeDisplayed
1306 1307 1308

isBadgeDisplayed(bundle: BundleOption, callback: AsyncCallback\<boolean\>): void

F
fangJinliang1 已提交
1309
获取指定应用的角标使能状态(Callback形式)。
1310 1311 1312 1313 1314 1315 1316 1317 1318

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1319
| 参数名     | 类型                  | 必填 | 说明                     |
1320
| -------- | --------------------- | ---- | ------------------------ |
1321
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)          | 是   | 指定应用的包信息。               |
1322 1323 1324 1325
| callback | AsyncCallback\<void\> | 是   | 获取角标使能状态回调函数。 |

**错误码:**

F
fangJinliang1 已提交
1326 1327
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1328 1329 1330 1331 1332 1333 1334 1335 1336
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1337
```ts
1338 1339
function isBadgeDisplayedCallback(err, data) {
    if (err) {
1340
        console.error(`isBadgeDisplayed failed, code is ${err.code}, message is ${err.message}`);
1341 1342 1343 1344
    } else {
        console.info("isBadgeDisplayed success");
    }
}
F
fangJinliang1 已提交
1345
let bundle = {
1346
    bundle: "bundleName1",
F
fangJinliang1 已提交
1347
};
1348
notificationManager.isBadgeDisplayed(bundle, isBadgeDisplayedCallback);
1349 1350
```

1351
## notificationManager.isBadgeDisplayed
1352 1353 1354

isBadgeDisplayed(bundle: BundleOption): Promise\<boolean\>

F
fangJinliang1 已提交
1355
获取指定应用的角标使能状态(Promise形式)。
1356 1357 1358 1359 1360 1361 1362 1363 1364

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1365
| 参数名   | 类型         | 必填 | 说明       |
1366
| ------ | ------------ | ---- | ---------- |
1367
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1368 1369 1370 1371 1372

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
F
fangJinliang1 已提交
1373
| Promise\<boolean\> | 以Promise形式返回获取指定应用的角标使能状态。 |
1374 1375 1376

**错误码:**

F
fangJinliang1 已提交
1377 1378
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1379 1380 1381 1382 1383 1384 1385 1386 1387
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1388
```ts
F
fangJinliang1 已提交
1389
let bundle = {
1390
    bundle: "bundleName1",
F
fangJinliang1 已提交
1391
};
1392
notificationManager.isBadgeDisplayed(bundle).then((data) => {
F
fangJinliang1 已提交
1393
	console.info("isBadgeDisplayed success, data: " + JSON.stringify(data));
1394 1395 1396
});
```

F
fangJinliang1 已提交
1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469
## notificationManager.setBadgeNumber<sup>10+</sup>

setBadgeNumber(badgeNumber: number): Promise\<void\>

设定角标个数,在应用的桌面图标上呈现(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

| 参数名      | 类型   | 必填 | 说明       |
| ----------- | ------ | ---- | ---------- |
| badgeNumber | number | 是   | 角标个数。 |

**错误码:**

| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600012  | No memory space.                    |

**示例:**

```ts
let badgeNumber = 10
notificationManager.setBadgeNumber(badgeNumber).then(() => {
	console.info("displayBadge success");
});
```

## notificationManager.setBadgeNumber<sup>10+</sup>

setBadgeNumber(badgeNumber: number, callback: AsyncCallback\<void\>): void

设定角标个数,在应用的桌面图标上呈现(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

| 参数名      | 类型                  | 必填 | 说明               |
| ----------- | --------------------- | ---- | ------------------ |
| badgeNumber | number                | 是   | 角标个数。         |
| callback    | AsyncCallback\<void\> | 是   | 设定角标回调函数。 |

**错误码:**

错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600012  | No memory space.                    |

**示例:**

```ts
function setBadgeNumberCallback(err) {
    if (err) {
        console.info(`displayBadge failed code is ${err.code}, message is ${err.message}`);
    } else {
        console.info("displayBadge success");
    }
}

let badgeNumber = 10
notificationManager.setBadgeNumber(badgeNumber, setBadgeNumberCallback);
```

1470
## notificationManager.setSlotByBundle
1471 1472 1473

setSlotByBundle(bundle: BundleOption, slot: NotificationSlot, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
1474
设定指定应用的通知通道(Callback形式)。
1475 1476 1477 1478 1479 1480 1481 1482 1483

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1484
| 参数名     | 类型                  | 必填 | 说明                 |
1485
| -------- | --------------------- | ---- | -------------------- |
1486 1487
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)          | 是   | 指定应用的包信息。           |
| slot     | [NotificationSlot](js-apis-inner-notification-notificationSlot.md)      | 是   | 通知通道。             |
1488 1489 1490 1491
| callback | AsyncCallback\<void\> | 是   | 设定通知通道回调函数。 |

**错误码:**

F
fangJinliang1 已提交
1492 1493
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1494 1495 1496 1497 1498 1499 1500 1501 1502
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1503
```ts
1504 1505
function setSlotByBundleCallback(err) {
    if (err) {
1506
        console.error(`setSlotByBundle failed, code is ${err.code}, message is ${err.message}`);
1507 1508 1509 1510
    } else {
        console.info("setSlotByBundle success");
    }
}
F
fangJinliang1 已提交
1511
let bundle = {
1512
    bundle: "bundleName1",
F
fangJinliang1 已提交
1513 1514
};
let notificationSlot = {
1515
    type: notificationManager.SlotType.SOCIAL_COMMUNICATION
F
fangJinliang1 已提交
1516
};
1517
notificationManager.setSlotByBundle(bundle, notificationSlot, setSlotByBundleCallback);
1518 1519
```

1520
## notificationManager.setSlotByBundle
1521 1522 1523

setSlotByBundle(bundle: BundleOption, slot: NotificationSlot): Promise\<void\>

F
fangJinliang1 已提交
1524
设定指定应用的通知通道(Promise形式)。
1525 1526 1527 1528 1529 1530 1531 1532 1533

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1534
| 参数名   | 类型         | 必填 | 说明       |
1535
| ------ | ------------ | ---- | ---------- |
1536 1537
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
| slot   | [NotificationSlot](js-apis-inner-notification-notificationSlot.md) | 是   | 通知通道。 |
1538 1539 1540

**错误码:**

F
fangJinliang1 已提交
1541 1542
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1543 1544 1545 1546 1547 1548 1549 1550 1551
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1552
```ts
F
fangJinliang1 已提交
1553
let bundle = {
1554
    bundle: "bundleName1",
F
fangJinliang1 已提交
1555 1556
};
let notificationSlot = {
1557
    type: notificationManager.SlotType.SOCIAL_COMMUNICATION
F
fangJinliang1 已提交
1558
};
1559
notificationManager.setSlotByBundle(bundle, notificationSlot).then(() => {
F
fangJinliang1 已提交
1560
	console.info("setSlotByBundle success");
1561 1562 1563
});
```

1564
## notificationManager.getSlotsByBundle
1565 1566 1567

getSlotsByBundle(bundle: BundleOption, callback: AsyncCallback<Array\<NotificationSlot\>>): void

F
fangJinliang1 已提交
1568
获取指定应用的所有通知通道(Callback形式)。
1569 1570 1571 1572 1573 1574 1575 1576 1577

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1578
| 参数名     | 类型                                     | 必填 | 说明                 |
1579
| -------- | ---------------------------------------- | ---- | -------------------- |
1580 1581
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)                             | 是   | 指定应用的包信息。           |
| callback | AsyncCallback<Array\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\>> | 是   | 获取通知通道回调函数。 |
1582 1583 1584

**错误码:**

F
fangJinliang1 已提交
1585 1586
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1587 1588 1589 1590 1591 1592 1593 1594 1595
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1596
```ts
1597 1598
function getSlotsByBundleCallback(err, data) {
    if (err) {
1599
        console.error(`getSlotByBundle failed, code is ${err.code}, message is ${err.message}`);
1600 1601 1602 1603
    } else {
        console.info("getSlotsByBundle success");
    }
}
F
fangJinliang1 已提交
1604
let bundle = {
1605
    bundle: "bundleName1",
F
fangJinliang1 已提交
1606
};
1607
notificationManager.getSlotsByBundle(bundle, getSlotsByBundleCallback);
1608 1609
```

1610
## notificationManager.getSlotsByBundle
1611 1612 1613

getSlotsByBundle(bundle: BundleOption): Promise<Array\<NotificationSlot\>>

F
fangJinliang1 已提交
1614
获取指定应用的所有通知通道(Promise形式)。
1615 1616 1617 1618 1619 1620 1621 1622 1623

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1624
| 参数名   | 类型         | 必填 | 说明       |
1625
| ------ | ------------ | ---- | ---------- |
1626
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1627 1628 1629 1630 1631

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
1632
| Promise<Array\<[NotificationSlot](js-apis-inner-notification-notificationSlot.md)\>> | 以Promise形式返回获取指定应用的通知通道。 |
1633 1634 1635

**错误码:**

F
fangJinliang1 已提交
1636 1637
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1638 1639 1640 1641 1642 1643 1644 1645 1646
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1647
```ts
F
fangJinliang1 已提交
1648
let bundle = {
1649
    bundle: "bundleName1",
F
fangJinliang1 已提交
1650
};
1651
notificationManager.getSlotsByBundle(bundle).then((data) => {
F
fangJinliang1 已提交
1652
	console.info("getSlotsByBundle success, data: " + JSON.stringify(data));
1653 1654 1655
});
```

1656
## notificationManager.getSlotNumByBundle
1657 1658 1659

getSlotNumByBundle(bundle: BundleOption, callback: AsyncCallback\<number\>): void

F
fangJinliang1 已提交
1660
获取指定应用的通知通道数量(Callback形式)。
1661 1662 1663 1664 1665 1666 1667 1668 1669

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1670
| 参数名     | 类型                      | 必填 | 说明                   |
1671
| -------- | ------------------------- | ---- | ---------------------- |
1672
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)              | 是   | 指定应用的包信息。             |
F
fangJinliang1 已提交
1673
| callback | AsyncCallback\<number\> | 是   | 获取通知通道数量回调函数。 |
1674 1675 1676

**错误码:**

F
fangJinliang1 已提交
1677 1678
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1679 1680 1681 1682 1683 1684 1685 1686 1687
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1688
```ts
1689 1690
function getSlotNumByBundleCallback(err, data) {
    if (err) {
1691
        console.error(`getSlotByBundle failed, code is ${err.code}, message is ${err.message}`);
1692 1693 1694 1695
    } else {
        console.info("getSlotNumByBundle success");
    }
}
F
fangJinliang1 已提交
1696
let bundle = {
1697
    bundle: "bundleName1",
F
fangJinliang1 已提交
1698
};
1699
notificationManager.getSlotNumByBundle(bundle, getSlotNumByBundleCallback);
1700 1701
```

1702
## notificationManager.getSlotNumByBundle
1703 1704 1705

getSlotNumByBundle(bundle: BundleOption): Promise\<number\>

F
fangJinliang1 已提交
1706
获取指定应用的通知通道数量(Promise形式)。
1707 1708 1709 1710 1711 1712 1713 1714 1715

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1716
| 参数名   | 类型         | 必填 | 说明       |
1717
| ------ | ------------ | ---- | ---------- |
1718
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 指定应用的包信息。 |
1719 1720 1721 1722 1723

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
F
fangJinliang1 已提交
1724
| Promise\<number\> | 以Promise形式返回获取指定应用的通知通道数量。 |
1725 1726 1727

**错误码:**

F
fangJinliang1 已提交
1728 1729
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1730 1731 1732 1733 1734 1735 1736 1737 1738
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

1739
```ts
F
fangJinliang1 已提交
1740
let bundle = {
1741
    bundle: "bundleName1",
F
fangJinliang1 已提交
1742
};
1743
notificationManager.getSlotNumByBundle(bundle).then((data) => {
F
fangJinliang1 已提交
1744
	console.info("getSlotNumByBundle success, data: " + JSON.stringify(data));
1745 1746 1747 1748
});
```


1749
## notificationManager.getAllActiveNotifications
1750 1751 1752

getAllActiveNotifications(callback: AsyncCallback<Array\<NotificationRequest\>>): void

F
fangJinliang1 已提交
1753
获取当前未删除的所有通知(Callback形式)。
1754 1755 1756 1757 1758 1759 1760 1761 1762

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
1763
| 参数名     | 类型                                                         | 必填 | 说明                 |
1764
| -------- | ------------------------------------------------------------ | ---- | -------------------- |
1765
| callback | AsyncCallback<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)\>> | 是   | 获取活动通知回调函数。 |
1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776

**错误码:**

| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1777
```ts
1778 1779
function getAllActiveNotificationsCallback(err, data) {
    if (err) {
1780
        console.error(`getAllActiveNotifications failed, code is ${err.code}, message is ${err.message}`);
1781 1782 1783 1784 1785
    } else {
        console.info("getAllActiveNotifications success");
    }
}

1786
notificationManager.getAllActiveNotifications(getAllActiveNotificationsCallback);
1787 1788
```

1789
## notificationManager.getAllActiveNotifications
1790

1791
getAllActiveNotifications(): Promise\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)\>\>
1792

F
fangJinliang1 已提交
1793
获取当前未删除的所有通知(Promise形式)。
1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
1805
| Promise\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)\>\> | 以Promise形式返回获取活动通知。 |
1806 1807 1808

**错误码:**

F
fangJinliang1 已提交
1809 1810
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1811 1812 1813 1814 1815 1816 1817 1818
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1819 1820
```ts
notificationManager.getAllActiveNotifications().then((data) => {
F
fangJinliang1 已提交
1821
	console.info("getAllActiveNotifications success, data: " + JSON.stringify(data));
1822 1823 1824
});
```

1825
## notificationManager.getActiveNotificationCount
1826 1827 1828

getActiveNotificationCount(callback: AsyncCallback\<number\>): void

F
fangJinliang1 已提交
1829
获取当前应用未删除的通知数(Callback形式)。
1830 1831 1832 1833 1834

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
1835
| 参数名     | 类型                   | 必填 | 说明                   |
1836
| -------- | ---------------------- | ---- | ---------------------- |
F
fangJinliang1 已提交
1837
| callback | AsyncCallback\<number\> | 是   | 获取未删除通知数回调函数。 |
1838 1839 1840

**错误码:**

F
fangJinliang1 已提交
1841 1842
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1843 1844 1845 1846 1847 1848 1849 1850
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1851
```ts
1852 1853
function getActiveNotificationCountCallback(err, data) {
    if (err) {
1854
        console.error(`getActiveNotificationCount failed, code is ${err.code}, message is ${err.message}`);
1855 1856 1857 1858 1859
    } else {
        console.info("getActiveNotificationCount success");
    }
}

1860
notificationManager.getActiveNotificationCount(getActiveNotificationCountCallback);
1861 1862
```

1863
## notificationManager.getActiveNotificationCount
1864 1865 1866

getActiveNotificationCount(): Promise\<number\>

F
fangJinliang1 已提交
1867
获取当前应用未删除的通知数(Promise形式)。
1868 1869 1870 1871 1872

**系统能力**:SystemCapability.Notification.Notification

**返回值:**

F
fangJinliang1 已提交
1873 1874 1875
| 类型              | 说明                                        |
| ----------------- | ------------------------------------------- |
| Promise\<number\> | 以Promise形式返回获取当前应用未删除通知数。 |
1876 1877 1878

**错误码:**

F
fangJinliang1 已提交
1879 1880
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1881 1882 1883 1884 1885 1886 1887 1888
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1889 1890
```ts
notificationManager.getActiveNotificationCount().then((data) => {
F
fangJinliang1 已提交
1891
	console.info("getActiveNotificationCount success, data: " + JSON.stringify(data));
1892 1893 1894
});
```

1895
## notificationManager.getActiveNotifications
1896 1897 1898

getActiveNotifications(callback: AsyncCallback<Array\<NotificationRequest\>>): void

F
fangJinliang1 已提交
1899
获取当前应用未删除的通知列表(Callback形式)。
1900 1901 1902 1903 1904

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
1905
| 参数名     | 类型                                                         | 必填 | 说明                           |
1906
| -------- | ------------------------------------------------------------ | ---- | ------------------------------ |
1907
| callback | AsyncCallback<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)\>> | 是   | 获取当前应用通知列表回调函数。 |
1908 1909 1910

**错误码:**

F
fangJinliang1 已提交
1911 1912
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1913 1914 1915 1916 1917 1918 1919 1920
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1921
```ts
1922 1923
function getActiveNotificationsCallback(err, data) {
    if (err) {
1924
        console.error(`getActiveNotifications failed, code is ${err.code}, message is ${err.message}`);
1925 1926 1927 1928 1929
    } else {
        console.info("getActiveNotifications success");
    }
}

1930
notificationManager.getActiveNotifications(getActiveNotificationsCallback);
1931 1932
```

1933
## notificationManager.getActiveNotifications
1934

1935
getActiveNotifications(): Promise\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)\>\>
1936

F
fangJinliang1 已提交
1937
获取当前应用未删除的通知列表(Promise形式)。
1938 1939 1940 1941 1942

**系统能力**:SystemCapability.Notification.Notification

**返回值:**

F
fangJinliang1 已提交
1943 1944
| 类型                                                         | 说明                                    |
| ------------------------------------------------------------ | --------------------------------------- |
1945
| Promise\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)\>\> | 以Promise形式返回获取当前应用通知列表。 |
1946 1947 1948

**错误码:**

F
fangJinliang1 已提交
1949 1950
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1951 1952 1953 1954 1955 1956 1957 1958
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1959 1960
```ts
notificationManager.getActiveNotifications().then((data) => {
F
fangJinliang1 已提交
1961
	console.info("removeGroupByBundle success, data: " + JSON.stringify(data));
1962 1963 1964
});
```

1965
## notificationManager.cancelGroup
1966 1967 1968

cancelGroup(groupName: string, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
1969
取消本应用指定组下的通知(Callback形式)。
1970 1971 1972 1973 1974

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
1975
| 参数名      | 类型                  | 必填 | 说明                         |
1976
| --------- | --------------------- | ---- | ---------------------------- |
1977
| groupName | string                | 是   | 通知组名称,此名称需要在发布通知时通过[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)对象指定。 |
F
fangJinliang1 已提交
1978
| callback  | AsyncCallback\<void\> | 是   | 取消本应用指定组下通知的回调函数。 |
1979 1980 1981

**错误码:**

F
fangJinliang1 已提交
1982 1983
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

1984 1985 1986 1987 1988 1989 1990 1991
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

1992
```ts
1993 1994
function cancelGroupCallback(err) {
    if (err) {
1995
        console.error(`cancelGroup failed, code is ${err.code}, message is ${err.message}`);
1996 1997 1998 1999 2000
    } else {
        console.info("cancelGroup success");
    }
}

F
fangJinliang1 已提交
2001
let groupName = "GroupName";
2002

2003
notificationManager.cancelGroup(groupName, cancelGroupCallback);
2004 2005
```

2006
## notificationManager.cancelGroup
2007 2008 2009

cancelGroup(groupName: string): Promise\<void\>

F
fangJinliang1 已提交
2010
取消本应用指定组下的通知(Promise形式)。
2011 2012 2013 2014 2015

**系统能力**:SystemCapability.Notification.Notification

**参数:**

F
fangJinliang1 已提交
2016
| 参数名      | 类型   | 必填 | 说明           |
2017
| --------- | ------ | ---- | -------------- |
F
fangJinliang1 已提交
2018
| groupName | string | 是   | 通知组名称。 |
2019 2020 2021

**错误码:**

F
fangJinliang1 已提交
2022 2023
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2024 2025 2026 2027 2028 2029 2030 2031
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2032
```ts
F
fangJinliang1 已提交
2033
let groupName = "GroupName";
2034
notificationManager.cancelGroup(groupName).then(() => {
F
fangJinliang1 已提交
2035
	console.info("cancelGroup success");
2036 2037 2038
});
```

2039
## notificationManager.removeGroupByBundle
2040 2041 2042

removeGroupByBundle(bundle: BundleOption, groupName: string, callback: AsyncCallback\<void\>): void

F
fangJinliang1 已提交
2043
删除指定应用的指定组下的通知(Callback形式)。
2044 2045 2046 2047 2048 2049 2050 2051 2052

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2053
| 参数名      | 类型                  | 必填 | 说明                         |
2054
| --------- | --------------------- | ---- | ---------------------------- |
2055
| bundle    | [BundleOption](./js-apis-inner-notification-bundleOption.md)          | 是   | 应用的包信息。                   |
F
fangJinliang1 已提交
2056 2057
| groupName | string                | 是   | 通知组名称。               |
| callback  | AsyncCallback\<void\> | 是   | 删除指定应用指定组下通知的回调函数。 |
2058 2059 2060

**错误码:**

F
fangJinliang1 已提交
2061 2062
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2063 2064 2065 2066 2067 2068 2069 2070 2071
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

2072
```ts
2073 2074
function removeGroupByBundleCallback(err) {
    if (err) {
2075
        console.error(`removeGroupByBundle failed, code is ${err.code}, message is ${err.message}`);
2076 2077 2078 2079 2080
    } else {
        console.info("removeGroupByBundle success");
    }
}

F
fangJinliang1 已提交
2081 2082
let bundleOption = {bundle: "Bundle"};
let groupName = "GroupName";
2083

2084
notificationManager.removeGroupByBundle(bundleOption, groupName, removeGroupByBundleCallback);
2085 2086
```

2087
## notificationManager.removeGroupByBundle
2088 2089 2090

removeGroupByBundle(bundle: BundleOption, groupName: string): Promise\<void\>

F
fangJinliang1 已提交
2091
删除指定应用的指定组下的通知(Promise形式)。
2092 2093 2094 2095 2096 2097 2098 2099 2100

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2101
| 参数名      | 类型         | 必填 | 说明           |
2102
| --------- | ------------ | ---- | -------------- |
2103
| bundle    | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 应用的包信息。     |
F
fangJinliang1 已提交
2104
| groupName | string       | 是   | 通知组名称。 |
2105 2106 2107

**错误码:**

F
fangJinliang1 已提交
2108 2109
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2110 2111 2112 2113 2114 2115 2116 2117 2118
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

2119
```ts
F
fangJinliang1 已提交
2120 2121
let bundleOption = {bundle: "Bundle"};
let groupName = "GroupName";
2122
notificationManager.removeGroupByBundle(bundleOption, groupName).then(() => {
F
fangJinliang1 已提交
2123
	console.info("removeGroupByBundle success");
2124 2125 2126
});
```

2127
## notificationManager.setDoNotDisturbDate
2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140

setDoNotDisturbDate(date: DoNotDisturbDate, callback: AsyncCallback\<void\>): void

设置免打扰时间(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2141
| 参数名     | 类型                  | 必填 | 说明                   |
2142 2143 2144 2145 2146 2147
| -------- | --------------------- | ---- | ---------------------- |
| date     | [DoNotDisturbDate](#donotdisturbdate)      | 是   | 免打扰时间选项。         |
| callback | AsyncCallback\<void\> | 是   | 设置免打扰时间回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2148 2149
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2150 2151 2152 2153 2154 2155 2156 2157
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2158
```ts
2159 2160
function setDoNotDisturbDateCallback(err) {
    if (err) {
2161
        console.error(`setDoNotDisturbDate failed, code is ${err.code}, message is ${err.message}`);
2162 2163 2164 2165 2166
    } else {
        console.info("setDoNotDisturbDate success");
    }
}

F
fangJinliang1 已提交
2167
let doNotDisturbDate = {
2168
    type: notificationManager.DoNotDisturbType.TYPE_ONCE,
2169 2170
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
F
fangJinliang1 已提交
2171
};
2172

2173
notificationManager.setDoNotDisturbDate(doNotDisturbDate, setDoNotDisturbDateCallback);
2174 2175
```

2176
## notificationManager.setDoNotDisturbDate
2177 2178 2179

setDoNotDisturbDate(date: DoNotDisturbDate): Promise\<void\>

F
fangJinliang1 已提交
2180
设置免打扰时间(Promise形式)。
2181 2182 2183 2184 2185 2186 2187 2188 2189

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2190
| 参数名 | 类型             | 必填 | 说明           |
2191 2192 2193 2194 2195
| ---- | ---------------- | ---- | -------------- |
| date | [DoNotDisturbDate](#donotdisturbdate) | 是   | 免打扰时间选项。 |

**错误码:**

F
fangJinliang1 已提交
2196 2197
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2198 2199 2200 2201 2202 2203 2204 2205
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2206
```ts
F
fangJinliang1 已提交
2207
let doNotDisturbDate = {
2208
    type: notificationManager.DoNotDisturbType.TYPE_ONCE,
2209 2210
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
F
fangJinliang1 已提交
2211
};
2212
notificationManager.setDoNotDisturbDate(doNotDisturbDate).then(() => {
F
fangJinliang1 已提交
2213
	console.info("setDoNotDisturbDate success");
2214 2215 2216 2217
});
```


2218
## notificationManager.setDoNotDisturbDate
2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231

setDoNotDisturbDate(date: DoNotDisturbDate, userId: number, callback: AsyncCallback\<void\>): void

指定用户设置免打扰时间(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2232
| 参数名     | 类型                  | 必填 | 说明                   |
2233 2234
| -------- | --------------------- | ---- | ---------------------- |
| date     | [DoNotDisturbDate](#donotdisturbdate)      | 是   | 免打扰时间选项。         |
F
fangJinliang1 已提交
2235
| userId   | number                | 是   | 设置免打扰时间的用户ID。 |
2236 2237 2238 2239
| callback | AsyncCallback\<void\> | 是   | 设置免打扰时间回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2240 2241
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2242 2243 2244 2245 2246 2247 2248 2249 2250
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

2251
```ts
2252 2253
function setDoNotDisturbDateCallback(err) {
    if (err) {
2254
        console.error(`setDoNotDisturbDate failed, code is ${err.code}, message is ${err.message}`);
2255 2256 2257 2258 2259
    } else {
        console.info("setDoNotDisturbDate success");
    }
}

F
fangJinliang1 已提交
2260
let doNotDisturbDate = {
2261
    type: notificationManager.DoNotDisturbType.TYPE_ONCE,
2262 2263
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
F
fangJinliang1 已提交
2264
};
2265

F
fangJinliang1 已提交
2266
let userId = 1;
2267

2268
notificationManager.setDoNotDisturbDate(doNotDisturbDate, userId, setDoNotDisturbDateCallback);
2269 2270
```

2271
## notificationManager.setDoNotDisturbDate
2272 2273 2274

setDoNotDisturbDate(date: DoNotDisturbDate, userId: number): Promise\<void\>

F
fangJinliang1 已提交
2275
指定用户设置免打扰时间(Promise形式)。
2276 2277 2278 2279 2280 2281 2282 2283 2284

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2285
| 参数名   | 类型             | 必填 | 说明           |
2286 2287
| ------ | ---------------- | ---- | -------------- |
| date   | [DoNotDisturbDate](#donotdisturbdate) | 是   | 免打扰时间选项。 |
F
fangJinliang1 已提交
2288
| userId | number           | 是   | 设置免打扰时间的用户ID。 |
2289 2290 2291

**错误码:**

F
fangJinliang1 已提交
2292 2293
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2294 2295 2296 2297 2298 2299 2300 2301 2302
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

2303
```ts
F
fangJinliang1 已提交
2304
let doNotDisturbDate = {
2305
    type: notificationManager.DoNotDisturbType.TYPE_ONCE,
2306 2307
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
F
fangJinliang1 已提交
2308
};
2309

F
fangJinliang1 已提交
2310
let userId = 1;
2311

2312
notificationManager.setDoNotDisturbDate(doNotDisturbDate, userId).then(() => {
F
fangJinliang1 已提交
2313
	console.info("setDoNotDisturbDate success");
2314 2315 2316 2317
});
```


2318
## notificationManager.getDoNotDisturbDate
2319 2320 2321

getDoNotDisturbDate(callback: AsyncCallback\<DoNotDisturbDate\>): void

F
fangJinliang1 已提交
2322
查询免打扰时间(Callback形式)。
2323 2324 2325 2326 2327 2328 2329 2330 2331

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2332
| 参数名     | 类型                              | 必填 | 说明                   |
2333 2334 2335 2336 2337
| -------- | --------------------------------- | ---- | ---------------------- |
| callback | AsyncCallback\<[DoNotDisturbDate](#donotdisturbdate)\> | 是   | 查询免打扰时间回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2338 2339
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2340 2341 2342 2343 2344 2345 2346 2347
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2348
```ts
2349 2350
function getDoNotDisturbDateCallback(err,data) {
    if (err) {
2351
        console.error(`getDoNotDisturbDate failed, code is ${err.code}, message is ${err.message}`);
2352 2353 2354 2355 2356
    } else {
        console.info("getDoNotDisturbDate success");
    }
}

2357
notificationManager.getDoNotDisturbDate(getDoNotDisturbDateCallback);
2358 2359
```

2360
## notificationManager.getDoNotDisturbDate
2361 2362 2363

getDoNotDisturbDate(): Promise\<DoNotDisturbDate\>

F
fangJinliang1 已提交
2364
查询免打扰时间(Promise形式)。
2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**返回值:**

| 类型                                             | 说明                                      |
| ------------------------------------------------ | ----------------------------------------- |
F
fangJinliang1 已提交
2376
| Promise\<[DoNotDisturbDate](#donotdisturbdate)\> | 以Promise形式返回获取查询到的免打扰时间。 |
2377 2378 2379

**错误码:**

F
fangJinliang1 已提交
2380 2381
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2382 2383 2384 2385 2386 2387 2388 2389
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2390 2391
```ts
notificationManager.getDoNotDisturbDate().then((data) => {
F
fangJinliang1 已提交
2392
	console.info("getDoNotDisturbDate success, data: " + JSON.stringify(data));
2393 2394 2395 2396
});
```


2397
## notificationManager.getDoNotDisturbDate
2398 2399 2400

getDoNotDisturbDate(userId: number, callback: AsyncCallback\<DoNotDisturbDate\>): void

F
fangJinliang1 已提交
2401
查询指定用户的免打扰时间(Callback形式)。
2402 2403 2404 2405 2406 2407 2408 2409 2410

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2411
| 参数名     | 类型                              | 必填 | 说明                   |
2412 2413
| -------- | --------------------------------- | ---- | ---------------------- |
| callback | AsyncCallback\<[DoNotDisturbDate](#donotdisturbdate)\> | 是   | 查询免打扰时间回调函数。 |
F
fangJinliang1 已提交
2414
| userId   | number                            | 是   | 用户ID。 |
2415 2416 2417

**错误码:**

F
fangJinliang1 已提交
2418 2419
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2420 2421 2422 2423 2424 2425 2426 2427 2428
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

2429
```ts
2430 2431
function getDoNotDisturbDateCallback(err,data) {
    if (err) {
2432
        console.error(`getDoNotDisturbDate failed, code is ${err.code}, message is ${err.message}`);
2433 2434 2435 2436 2437
    } else {
        console.info("getDoNotDisturbDate success");
    }
}

F
fangJinliang1 已提交
2438
let userId = 1;
2439

2440
notificationManager.getDoNotDisturbDate(userId, getDoNotDisturbDateCallback);
2441 2442
```

2443
## notificationManager.getDoNotDisturbDate
2444 2445 2446

getDoNotDisturbDate(userId: number): Promise\<DoNotDisturbDate\>

F
fangJinliang1 已提交
2447
查询指定用户的免打扰时间(Promise形式)。
2448 2449 2450 2451 2452 2453 2454 2455 2456

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2457
| 参数名     | 类型                              | 必填 | 说明                   |
2458
| -------- | --------------------------------- | ---- | ---------------------- |
F
fangJinliang1 已提交
2459
| userId   | number                            | 是   | 用户ID。 |
2460 2461 2462 2463 2464

**返回值:**

| 类型                                             | 说明                                      |
| ------------------------------------------------ | ----------------------------------------- |
F
fangJinliang1 已提交
2465
| Promise\<[DoNotDisturbDate](#donotdisturbdate)\> | 以Promise形式返回获取查询到的免打扰时间。 |
2466 2467 2468

**错误码:**

F
fangJinliang1 已提交
2469 2470
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2471 2472 2473 2474 2475 2476 2477 2478 2479
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

2480
```ts
F
fangJinliang1 已提交
2481
let userId = 1;
2482

2483
notificationManager.getDoNotDisturbDate(userId).then((data) => {
F
fangJinliang1 已提交
2484
	console.info("getDoNotDisturbDate success, data: " + JSON.stringify(data));
2485 2486 2487 2488
});
```


F
fangJinliang1 已提交
2489
## notificationManager.isSupportDoNotDisturbMode
2490

F
fangJinliang1 已提交
2491
 isSupportDoNotDisturbMode(callback: AsyncCallback\<boolean\>): void
2492

F
fangJinliang1 已提交
2493
查询是否支持免打扰功能(Callback形式)。
2494 2495 2496 2497 2498 2499 2500 2501 2502

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
2503
| 参数名     | 类型                     | 必填 | 说明                             |
2504
| -------- | ------------------------ | ---- | -------------------------------- |
F
fangJinliang1 已提交
2505
| callback | AsyncCallback\<boolean\> | 是   | 查询是否支持免打扰功能回调函数。 |
2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516

**错误码:**

| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2517
```ts
F
fangJinliang1 已提交
2518
function isSupportDoNotDisturbModeCallback(err,data) {
2519
    if (err) {
2520
        console.error(`isSupportDoNotDisturbMode failed, code is ${err.code}, message is ${err.message}`);
2521
    } else {
F
fangJinliang1 已提交
2522
        console.info("isSupportDoNotDisturbMode success");
2523 2524 2525
    }
}

F
fangJinliang1 已提交
2526
notificationManager.isSupportDoNotDisturbMode(isSupportDoNotDisturbModeCallback);
2527 2528
```

F
fangJinliang1 已提交
2529
## notificationManager.isSupportDoNotDisturbMode
2530

F
fangJinliang1 已提交
2531
isSupportDoNotDisturbMode(): Promise\<boolean\>
2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544

查询是否支持勿扰模式功能(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
F
fangJinliang1 已提交
2545
| Promise\<boolean\> | 以Promise形式返回获取是否支持免打扰功能的结果。 |
2546 2547 2548

**错误码:**

F
fangJinliang1 已提交
2549 2550
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2551 2552 2553 2554 2555 2556 2557 2558
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

2559
```ts
F
fangJinliang1 已提交
2560
notificationManager.isSupportDoNotDisturbMode().then((data) => {
F
fangJinliang1 已提交
2561
	console.info("supportDoNotDisturbMode success, data: " + JSON.stringify(data));
2562 2563 2564
});
```

2565
## notificationManager.isSupportTemplate
2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581

isSupportTemplate(templateName: string, callback: AsyncCallback\<boolean\>): void

查询模板是否存在(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

| 参数名       | 类型                     | 必填 | 说明                       |
| ------------ | ------------------------ | ---- | -------------------------- |
| templateName | string                   | 是   | 模板名称。                   |
| callback     | AsyncCallback\<boolean\> | 是   | 查询模板是否存在的回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2582 2583
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2584 2585 2586 2587 2588 2589 2590 2591 2592 2593
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600011  | Read template config failed.        |

**示例:**

```javascript
F
fangJinliang1 已提交
2594
let templateName = 'process';
2595 2596
function isSupportTemplateCallback(err, data) {
    if (err) {
2597
        console.error(`isSupportTemplate failed, code is ${err.code}, message is ${err.message}`);
2598 2599 2600 2601 2602
    } else {
        console.info("isSupportTemplate success");
    }
}

2603
notificationManager.isSupportTemplate(templateName, isSupportTemplateCallback);
2604 2605
```

2606
## notificationManager.isSupportTemplate
2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627

isSupportTemplate(templateName: string): Promise\<boolean\>

查询模板是否存在(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

| 参数名       | 类型   | 必填 | 说明     |
| ------------ | ------ | ---- | -------- |
| templateName | string | 是   | 模板名称。 |

**返回值:**

| 类型               | 说明            |
| ------------------ | --------------- |
| Promise\<boolean\> | Promise方式返回模板是否存在的结果。 |

**错误码:**

F
fangJinliang1 已提交
2628 2629
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2630 2631 2632 2633 2634 2635 2636 2637 2638 2639
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600011  | Read template config failed.        |

**示例:**

```javascript
F
fangJinliang1 已提交
2640
let templateName = 'process';
2641

2642
notificationManager.isSupportTemplate(templateName).then((data) => {
2643 2644 2645 2646
    console.info("isSupportTemplate success, data: " + JSON.stringify(data));
});
```

2647
## notificationManager.requestEnableNotification
2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659 2660 2661 2662

requestEnableNotification(callback: AsyncCallback\<void\>): void

应用请求通知使能(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
| callback | AsyncCallback\<void\> | 是   | 应用请求通知使能的回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2663 2664
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

```javascript
function requestEnableNotificationCallback(err) {
    if (err) {
2676
        console.error(`requestEnableNotification failed, code is ${err.code}, message is ${err.message}`);
2677 2678 2679 2680 2681
    } else {
        console.info("requestEnableNotification success");
    }
};

2682
notificationManager.requestEnableNotification(requestEnableNotificationCallback);
2683 2684
```

2685
## notificationManager.requestEnableNotification
2686 2687 2688 2689 2690 2691 2692 2693 2694

requestEnableNotification(): Promise\<void\>

应用请求通知使能(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**错误码:**

F
fangJinliang1 已提交
2695 2696
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2697 2698 2699 2700 2701 2702 2703 2704 2705
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

```javascript
2706
notificationManager.requestEnableNotification().then(() => {
F
fangJinliang1 已提交
2707 2708
    console.info("requestEnableNotification success");
});
2709 2710 2711 2712
```



2713
## notificationManager.setDistributedEnable
2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728

setDistributedEnable(enable: boolean, callback: AsyncCallback\<void\>): void

设置设备是否支持分布式通知(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
F
fangJinliang1 已提交
2729
| enable   | boolean                  | 是   | 是否支持。 |
2730 2731 2732 2733
| callback | AsyncCallback\<void\> | 是   | 设置设备是否支持分布式通知的回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2734 2735
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2736 2737 2738 2739 2740 2741 2742 2743 2744 2745
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600010  | Distributed operation failed.       |

**示例:**

```javascript
2746
function setDistributedEnableCallback(err) {
2747
    if (err) {
2748
        console.error(`setDistributedEnable failed, code is ${err.code}, message is ${err.message}`);
2749 2750 2751 2752 2753
    } else {
        console.info("setDistributedEnable success");
    }
};

F
fangJinliang1 已提交
2754
let enable = true;
2755

2756
notificationManager.setDistributedEnable(enable, setDistributedEnableCallback);
2757 2758
```

2759
## notificationManager.setDistributedEnable
2760 2761 2762 2763 2764 2765 2766 2767 2768 2769 2770 2771 2772 2773 2774

setDistributedEnable(enable: boolean): Promise\<void>

设置设备是否支持分布式通知(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
F
fangJinliang1 已提交
2775
| enable   | boolean                  | 是   | 是否支持。 |
2776 2777 2778

**错误码:**

F
fangJinliang1 已提交
2779 2780
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2781 2782 2783 2784 2785 2786 2787 2788 2789 2790
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600010  | Distributed operation failed.       |

**示例:**

```javascript
F
fangJinliang1 已提交
2791
let enable = true;
2792

2793
notificationManager.setDistributedEnable(enable).then(() => {
F
fangJinliang1 已提交
2794
        console.info("setDistributedEnable success");
2795 2796 2797 2798
    });
```


2799
## notificationManager.isDistributedEnabled
2800 2801 2802

isDistributedEnabled(callback: AsyncCallback\<boolean>): void

F
fangJinliang1 已提交
2803
查询设备是否支持分布式通知(Callback形式)。
2804 2805 2806 2807 2808 2809 2810 2811 2812 2813 2814

**系统能力**:SystemCapability.Notification.Notification

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
| callback | AsyncCallback\<boolean\> | 是   | 设备是否支持分布式通知的回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2815 2816
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2817 2818 2819 2820 2821 2822 2823 2824 2825 2826
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600010  | Distributed operation failed.       |

**示例:**

```javascript
F
fangJinliang1 已提交
2827
function isDistributedEnabledCallback(err, data) {
2828
    if (err) {
2829
        console.error(`isDistributedEnabled failed, code is ${err.code}, message is ${err.message}`);
2830
    } else {
F
fangJinliang1 已提交
2831
        console.info("isDistributedEnabled success " + JSON.stringify(data));
2832 2833 2834
    }
};

2835
notificationManager.isDistributedEnabled(isDistributedEnabledCallback);
2836 2837 2838 2839
```



2840
## notificationManager.isDistributedEnabled
2841 2842 2843

isDistributedEnabled(): Promise\<boolean>

F
fangJinliang1 已提交
2844
查询设备是否支持分布式通知(Promise形式)。
2845 2846 2847 2848 2849

**系统能力**:SystemCapability.Notification.Notification

**返回值:**

F
fangJinliang1 已提交
2850 2851 2852
| 类型               | 说明                                          |
| ------------------ | --------------------------------------------- |
| Promise\<boolean\> | Promise方式返回设备是否支持分布式通知的结果。 |
2853 2854 2855

**错误码:**

F
fangJinliang1 已提交
2856 2857
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2858 2859 2860 2861 2862 2863 2864 2865 2866 2867
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600010  | Distributed operation failed.       |

**示例:**

```javascript
2868
notificationManager.isDistributedEnabled()
2869
    .then((data) => {
F
fangJinliang1 已提交
2870
        console.info("isDistributedEnabled success, data: " + JSON.stringify(data));
2871 2872 2873 2874
    });
```


2875
## notificationManager.setDistributedEnableByBundle
2876 2877 2878

setDistributedEnableByBundle(bundle: BundleOption, enable: boolean, callback: AsyncCallback\<void>): void

F
fangJinliang1 已提交
2879
设置指定应用是否支持分布式通知(Callback形式)。
2880 2881 2882 2883 2884 2885 2886 2887 2888 2889 2890

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
2891
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)             | 是   | 应用的包信息。                   |
2892 2893 2894 2895 2896
| enable   | boolean                  | 是   | 是否支持。                       |
| callback | AsyncCallback\<void\> | 是   | 应用程序是否支持分布式通知的回调函数。 |

**错误码:**

F
fangJinliang1 已提交
2897 2898
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910 2911
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 1600010  | Distributed operation failed.            |
| 17700001 | The specified bundle name was not found. |

**示例:**

```javascript
function setDistributedEnableByBundleCallback(err) {
    if (err) {
2912
        console.error(`setDistributedEnableByBundle failed, code is ${err.code}, message is ${err.message}`);
2913 2914 2915 2916 2917
    } else {
        console.info("enableDistributedByBundle success");
    }
};

F
fangJinliang1 已提交
2918
let bundle = {
2919
    bundle: "bundleName1",
F
fangJinliang1 已提交
2920
};
2921

F
fangJinliang1 已提交
2922
let enable = true
2923

2924
notificationManager.setDistributedEnableByBundle(bundle, enable, setDistributedEnableByBundleCallback);
2925 2926 2927 2928
```



2929
## notificationManager.setDistributedEnableByBundle
2930 2931 2932

setDistributedEnableByBundle(bundle: BundleOption, enable: boolean): Promise\<void>

F
fangJinliang1 已提交
2933
设置指定应用是否支持分布式通知(Promise形式)。
2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
2945
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)             | 是   | 应用的包。                |
2946 2947 2948 2949
| enable   | boolean                  | 是   | 是否支持。                  |

**错误码:**

F
fangJinliang1 已提交
2950 2951
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 1600010  | Distributed operation failed.            |
| 17700001 | The specified bundle name was not found. |

**示例:**

```javascript
F
fangJinliang1 已提交
2963
let bundle = {
2964
    bundle: "bundleName1",
F
fangJinliang1 已提交
2965
};
2966

F
fangJinliang1 已提交
2967
let enable = true
2968

2969 2970 2971
notificationManager.setDistributedEnableByBundle(bundle, enable).then(() => {
    console.info("setDistributedEnableByBundle success");
});
2972 2973
```

2974
## notificationManager.isDistributedEnabledByBundle
2975 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989

isDistributedEnabledByBundle(bundle: BundleOption, callback: AsyncCallback\<boolean>): void

根据应用的包获取应用程序是否支持分布式通知(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
2990
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)             | 是   | 应用的包。                     |
F
fangJinliang1 已提交
2991
| callback | AsyncCallback\<boolean\> | 是   | 查询指定应用是否支持分布式通知的回调函数。 |
2992 2993 2994

**错误码:**

F
fangJinliang1 已提交
2995 2996
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 1600010  | Distributed operation failed.            |
| 17700001 | The specified bundle name was not found. |

**示例:**

```javascript
3008
function isDistributedEnabledByBundleCallback(err, data) {
3009
    if (err) {
3010
        console.error(`isDistributedEnabledByBundle failed, code is ${err.code}, message is ${err.message}`);
3011
    } else {
F
fangJinliang1 已提交
3012
        console.info("isDistributedEnabledByBundle success" + JSON.stringify(data));
3013 3014 3015
    }
};

F
fangJinliang1 已提交
3016
let bundle = {
3017
    bundle: "bundleName1",
F
fangJinliang1 已提交
3018
};
3019

3020
notificationManager.isDistributedEnabledByBundle(bundle, isDistributedEnabledByBundleCallback);
3021 3022
```

3023
## notificationManager.isDistributedEnabledByBundle
3024 3025 3026

isDistributedEnabledByBundle(bundle: BundleOption): Promise\<boolean>

F
fangJinliang1 已提交
3027
查询指定应用是否支持分布式通知(Promise形式)。
3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                     | 必填 | 说明                       |
| -------- | ------------------------ | ---- | -------------------------- |
3039
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md)             | 是   | 应用的包。                |
3040 3041 3042

**返回值:**

F
fangJinliang1 已提交
3043 3044 3045
| 类型               | 说明                                              |
| ------------------ | ------------------------------------------------- |
| Promise\<boolean\> | Promise方式返回指定应用是否支持分布式通知的结果。 |
3046 3047 3048

**错误码:**

F
fangJinliang1 已提交
3049 3050
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 1600010  | Distributed operation failed.            |
| 17700001 | The specified bundle name was not found. |

**示例:**

```javascript
F
fangJinliang1 已提交
3062
let bundle = {
3063
    bundle: "bundleName1",
F
fangJinliang1 已提交
3064
};
3065

3066
notificationManager.isDistributedEnabledByBundle(bundle).then((data) => {
F
fangJinliang1 已提交
3067 3068
    console.info("isDistributedEnabledByBundle success, data: " + JSON.stringify(data));
});
3069 3070 3071
```


3072
## notificationManager.getDeviceRemindType
3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087

getDeviceRemindType(callback: AsyncCallback\<DeviceRemindType\>): void

获取通知的提醒方式(Callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名   | 类型                               | 必填 | 说明                       |
| -------- | --------------------------------- | ---- | -------------------------- |
F
fangJinliang1 已提交
3088
| callback | AsyncCallback\<[DeviceRemindType](#deviceremindtype)\> | 是   | 获取通知提醒方式的回调函数。 |
3089 3090 3091

**错误码:**

F
fangJinliang1 已提交
3092 3093
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

```javascript
function getDeviceRemindTypeCallback(err, data) {
    if (err) {
3105
        console.error(`getDeviceRemindType failed, code is ${err.code}, message is ${err.message}`);
3106 3107 3108 3109 3110
    } else {
        console.info("getDeviceRemindType success");
    }
};

3111
notificationManager.getDeviceRemindType(getDeviceRemindTypeCallback);
3112 3113
```

3114
## notificationManager.getDeviceRemindType
3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129

getDeviceRemindType(): Promise\<DeviceRemindType\>

获取通知的提醒方式(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**返回值:**

| 类型               | 说明            |
| ------------------ | --------------- |
F
fangJinliang1 已提交
3130
| Promise\<[DeviceRemindType](#deviceremindtype)\> | Promise方式返回获取通知提醒方式的结果。 |
3131 3132 3133

**错误码:**

F
fangJinliang1 已提交
3134 3135
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3136 3137 3138 3139 3140 3141 3142 3143 3144
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |

**示例:**

```javascript
3145
notificationManager.getDeviceRemindType().then((data) => {
F
fangJinliang1 已提交
3146 3147
    console.info("getDeviceRemindType success, data: " + JSON.stringify(data));
});
3148 3149 3150
```


3151
## notificationManager.publishAsBundle
3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164

publishAsBundle(request: NotificationRequest, representativeBundle: string, userId: number, callback: AsyncCallback\<void\>): void

发布代理通知(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER,ohos.permission.NOTIFICATION_AGENT_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

F
fangJinliang1 已提交
3165 3166
| 参数名               | 类型                                        | 必填 | 说明                                     |
| -------------------- | ------------------------------------------- | ---- | ---------------------------------------- |
3167
| request              | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是   | 用于设置要发布通知的内容和相关配置信息。 |
F
fangJinliang1 已提交
3168 3169 3170
| representativeBundle | string                                      | 是   | 被代理应用的包名。                       |
| userId               | number                                      | 是   | 用户ID。                                 |
| callback             | AsyncCallback                               | 是   | 发布代理通知的回调方法。                 |
3171 3172 3173

**错误码:**

F
fangJinliang1 已提交
3174 3175
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187
| 错误码ID | 错误信息                                  |
| -------- | ----------------------------------------- |
| 1600001  | Internal error.                           |
| 1600002  | Marshalling or unmarshalling error.       |
| 1600003  | Failed to connect service.                |
| 1600004  | Notification is not enabled.              |
| 1600005  | Notification slot is not enabled.         |
| 1600008  | The user is not exist.                    |
| 1600009  | Over max number notifications per second. |

**示例:**

3188
```ts
3189
//publishAsBundle回调
F
fangJinliang1 已提交
3190
function callback(err) {
3191
    if (err) {
3192
        console.error(`publishAsBundle failed, code is ${err.code}, message is ${err.message}`);
3193 3194 3195 3196 3197
    } else {
        console.info("publishAsBundle success");
    }
}
// 被代理应用的包名
F
fangJinliang1 已提交
3198
let representativeBundle = "com.example.demo";
F
fangJinliang1 已提交
3199
// 用户ID
F
fangJinliang1 已提交
3200
let userId = 100;
F
fangJinliang1 已提交
3201 3202
// NotificationRequest对象
let request = {
3203 3204
    id: 1,
    content: {
3205
        contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
3206 3207 3208 3209 3210 3211
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
F
fangJinliang1 已提交
3212
};
3213

3214
notificationManager.publishAsBundle(request, representativeBundle, userId, callback);
3215 3216
```

3217
## notificationManager.publishAsBundle
3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233

publishAsBundle(request: NotificationRequest, representativeBundle: string, userId: number): Promise\<void\>

发布代理通知(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER,ohos.permission.NOTIFICATION_AGENT_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**


| 参数名               | 类型                                        | 必填 | 说明                                          |
| -------------------- | ------------------------------------------- | ---- | --------------------------------------------- |
3234
| request              | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是   | 用于设置要发布通知的内容和相关配置信息。 |
3235
| representativeBundle | string                                      | 是   | 被代理应用的包名。                            |
F
fangJinliang1 已提交
3236
| userId               | number                                      | 是   | 用户ID。                            |
3237 3238 3239

**错误码:**

F
fangJinliang1 已提交
3240 3241
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253
| 错误码ID | 错误信息                                  |
| -------- | ----------------------------------------- |
| 1600001  | Internal error.                           |
| 1600002  | Marshalling or unmarshalling error.       |
| 1600003  | Failed to connect service.                |
| 1600004  | Notification is not enabled.              |
| 1600005  | Notification slot is not enabled.         |
| 1600008  | The user is not exist.                    |
| 1600009  | Over max number notifications per second. |

**示例:**

3254
```ts
3255
// 被代理应用的包名
F
fangJinliang1 已提交
3256
let representativeBundle = "com.example.demo";
F
fangJinliang1 已提交
3257
// 用户ID
F
fangJinliang1 已提交
3258
let userId = 100;
F
fangJinliang1 已提交
3259
// NotificationRequest对象
F
fangJinliang1 已提交
3260
let request = {
3261 3262
    id: 1,
    content: {
3263
        contentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
3264 3265 3266 3267 3268 3269
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
F
fangJinliang1 已提交
3270
};
3271

3272
notificationManager.publishAsBundle(request, representativeBundle, userId).then(() => {
F
fangJinliang1 已提交
3273
	console.info("publishAsBundle success");
3274 3275 3276
});
```

3277
## notificationManager.cancelAsBundle
3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296

cancelAsBundle(id: number, representativeBundle: string, userId: number, callback: AsyncCallback\<void\>): void

取消代理通知(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER,ohos.permission.NOTIFICATION_AGENT_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名               | 类型          | 必填 | 说明                     |
| -------------------- | ------------- | ---- | ------------------------ |
| id                   | number        | 是   | 通知ID。                 |
| representativeBundle | string        | 是   | 被代理应用的包名。       |
F
fangJinliang1 已提交
3297
| userId               | number        | 是   | 用户ID。       |
3298 3299 3300 3301
| callback             | AsyncCallback | 是   | 取消代理通知的回调方法。 |

**错误码:**

F
fangJinliang1 已提交
3302 3303
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3304 3305 3306 3307 3308 3309 3310 3311 3312 3313
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600007  | The notification is not exist.      |
| 1600008  | The user is not exist.              |

**示例:**

3314
```ts
F
fangJinliang1 已提交
3315
// cancelAsBundle
3316 3317
function cancelAsBundleCallback(err) {
    if (err) {
3318
        console.error(`cancelAsBundle failed, code is ${err.code}, message is ${err.message}`);
3319 3320 3321 3322 3323
    } else {
        console.info("cancelAsBundle success");
    }
}
// 被代理应用的包名
F
fangJinliang1 已提交
3324
let representativeBundle = "com.example.demo";
F
fangJinliang1 已提交
3325
// 用户ID
F
fangJinliang1 已提交
3326
let userId = 100;
3327

3328
notificationManager.cancelAsBundle(0, representativeBundle, userId, cancelAsBundleCallback);
3329 3330
```

3331
## notificationManager.cancelAsBundle
3332 3333 3334

cancelAsBundle(id: number, representativeBundle: string, userId: number): Promise\<void\>

F
fangJinliang1 已提交
3335
取消代理通知(Promise形式)。
3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**: ohos.permission.NOTIFICATION_CONTROLLER,ohos.permission.NOTIFICATION_AGENT_CONTROLLER

**系统API**: 此接口为系统接口,三方应用不支持调用。

**参数:**

| 参数名               | 类型   | 必填 | 说明               |
| -------------------- | ------ | ---- | ------------------ |
| id                   | number | 是   | 通知ID。           |
| representativeBundle | string | 是   | 被代理应用的包名。 |
F
fangJinliang1 已提交
3351
| userId               | number | 是   | 用户ID。 |
3352 3353 3354

**错误码:**

F
fangJinliang1 已提交
3355 3356
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3357 3358 3359 3360 3361 3362 3363 3364 3365 3366
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600007  | The notification is not exist.      |
| 1600008  | The user is not exist.              |

**示例:**

3367
```ts
3368
// 被代理应用的包名
F
fangJinliang1 已提交
3369
let representativeBundle = "com.example.demo";
F
fangJinliang1 已提交
3370
// 用户ID
F
fangJinliang1 已提交
3371
let userId = 100;
3372

3373
notificationManager.cancelAsBundle(0, representativeBundle, userId).then(() => {
3374 3375 3376 3377
	console.info("cancelAsBundle success");
});
```

3378
## notificationManager.setNotificationEnableSlot 
3379 3380 3381

setNotificationEnableSlot(bundle: BundleOption, type: SlotType, enable: boolean, callback: AsyncCallback\<void>): void

F
fangJinliang1 已提交
3382
设置指定应用的指定渠道类型的使能状态(Callback形式)。
3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名   | 类型                          | 必填 | 说明                   |
| -------- | ----------------------------- | ---- | ---------------------- |
3394
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 应用的包信息。           |
3395 3396
| type     | [SlotType](#slottype)         | 是   | 指定渠道类型。         |
| enable   | boolean                       | 是   | 使能状态。             |
F
fangJinliang1 已提交
3397
| callback | AsyncCallback\<void\>         | 是   | 设置渠道使能回调函数。 |
3398 3399 3400

**错误码:**

F
fangJinliang1 已提交
3401 3402
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3403 3404 3405 3406 3407 3408 3409 3410 3411
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

3412
```ts
F
fangJinliang1 已提交
3413
// setNotificationEnableSlot
3414 3415
function setNotificationEnableSlotCallback(err) {
    if (err) {
3416
        console.error(`setNotificationEnableSlot failed, code is ${err.code}, message is ${err.message}`);
3417 3418 3419 3420 3421
    } else {
        console.info("setNotificationEnableSlot success");
    }
};

3422
notificationManager.setNotificationEnableSlot(
3423
    { bundle: "ohos.samples.notification", },
3424
    notificationManager.SlotType.SOCIAL_COMMUNICATION,
3425 3426 3427 3428
    true,
    setNotificationEnableSlotCallback);
```

3429
## notificationManager.setNotificationEnableSlot
3430 3431 3432

setNotificationEnableSlot(bundle: BundleOption, type: SlotType, enable: boolean): Promise\<void> 

F
fangJinliang1 已提交
3433
设置指定应用的指定渠道类型的使能状态(Promise形式)。
3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名 | 类型                          | 必填 | 说明           |
| ------ | ----------------------------- | ---- | -------------- |
3445
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 应用的包信息。   |
F
fangJinliang1 已提交
3446
| type   | [SlotType](#slottype)         | 是   | 渠道类型。 |
3447 3448 3449 3450
| enable | boolean                       | 是   | 使能状态。     |

**错误码:**

F
fangJinliang1 已提交
3451 3452
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3453 3454 3455 3456 3457 3458 3459 3460 3461
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

3462
```ts
F
fangJinliang1 已提交
3463
// setNotificationEnableSlot
3464
notificationManager.setNotificationEnableSlot(
3465
    { bundle: "ohos.samples.notification", },
3466
    notificationManager.SlotType.SOCIAL_COMMUNICATION,
3467
    true).then(() => {
F
fangJinliang1 已提交
3468
        console.info("setNotificationEnableSlot success");
3469 3470 3471
    });
```

3472
## notificationManager.isNotificationSlotEnabled
3473 3474 3475

isNotificationSlotEnabled(bundle: BundleOption, type: SlotType, callback: AsyncCallback\<boolean\>): void

F
fangJinliang1 已提交
3476
获取指定应用的指定渠道类型的使能状态(Callback形式)。
3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名   | 类型                          | 必填 | 说明                   |
| -------- | ----------------------------- | ---- | ---------------------- |
3488
| bundle   | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 应用的包信息。           |
F
fangJinliang1 已提交
3489 3490
| type     | [SlotType](#slottype)         | 是   | 渠道类型。         |
| callback | AsyncCallback\<boolean\>         | 是   | 获取渠道使能状态回调函数。 |
3491 3492 3493

**错误码:**

F
fangJinliang1 已提交
3494 3495
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3496 3497 3498 3499 3500 3501 3502 3503 3504
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

3505
```ts
F
fangJinliang1 已提交
3506
// isNotificationSlotEnabled
3507 3508
function getEnableSlotCallback(err, data) {
    if (err) {
3509
        console.error(`isNotificationSlotEnabled failed, code is ${err.code}, message is ${err.message}`);
3510 3511 3512 3513 3514
    } else {
        console.info("isNotificationSlotEnabled success");
    }
};

3515
notificationManager.isNotificationSlotEnabled(
3516
    { bundle: "ohos.samples.notification", },
3517
    notificationManager.SlotType.SOCIAL_COMMUNICATION,
3518 3519 3520
    getEnableSlotCallback);
```

3521
## notificationManager.isNotificationSlotEnabled
3522 3523 3524

isNotificationSlotEnabled(bundle: BundleOption, type: SlotType): Promise\<boolean\>  

F
fangJinliang1 已提交
3525
获取指定应用的指定渠道类型的使能状态(Promise形式)。
3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名 | 类型                          | 必填 | 说明           |
| ------ | ----------------------------- | ---- | -------------- |
3537
| bundle | [BundleOption](./js-apis-inner-notification-bundleOption.md) | 是   | 应用的包信息。   |
F
fangJinliang1 已提交
3538
| type   | [SlotType](#slottype)         | 是   | 渠道类型。 |
3539 3540 3541 3542 3543 3544 3545 3546 3547

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| Promise\<boolean\> | 以Promise形式返回指定类型的渠道使能状态。 |

**错误码:**

F
fangJinliang1 已提交
3548 3549
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3550 3551 3552 3553 3554 3555 3556 3557 3558
| 错误码ID | 错误信息                                 |
| -------- | ---------------------------------------- |
| 1600001  | Internal error.                          |
| 1600002  | Marshalling or unmarshalling error.      |
| 1600003  | Failed to connect service.               |
| 17700001 | The specified bundle name was not found. |

**示例:**

3559
```ts
F
fangJinliang1 已提交
3560
// isNotificationSlotEnabled
3561 3562
notificationManager.isNotificationSlotEnabled({ bundle: "ohos.samples.notification", },
    notificationManager.SlotType.SOCIAL_COMMUNICATION).then((data) => {
F
fangJinliang1 已提交
3563 3564
    console.info("isNotificationSlotEnabled success, data: " + JSON.stringify(data));
});
3565 3566 3567
```


3568
## notificationManager.setSyncNotificationEnabledWithoutApp
3569 3570 3571 3572 3573 3574 3575 3576 3577 3578 3579 3580 3581 3582 3583

setSyncNotificationEnabledWithoutApp(userId: number, enable: boolean, callback: AsyncCallback\<void\>): void

设置是否将通知同步到未安装应用程序的设备(callback形式)。

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:** 

| 参数名 | 类型                          | 必填 | 说明           |
| ------ | ----------------------------- | ---- | -------------- |
F
fangJinliang1 已提交
3584 3585
| userId | number | 是   | 用户ID。   |
| enable | boolean | 是   | 是否启用。   |
3586 3587 3588 3589
| callback | AsyncCallback\<void\>    | 是   | 设置是否将通知同步到未安装应用程序的设备的回调函数。 |

**错误码:**

F
fangJinliang1 已提交
3590 3591
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3592 3593 3594 3595 3596 3597 3598 3599 3600
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

3601
```ts
3602 3603 3604
let userId = 100;
let enable = true;

F
fangJinliang1 已提交
3605
function callback(err) {
3606
    if (err) {
3607
        console.error(`setSyncNotificationEnabledWithoutApp failed, code is ${err.code}, message is ${err.message}`);
3608 3609 3610 3611 3612
    } else {
        console.info("setSyncNotificationEnabledWithoutApp success");
    }
}

3613
notificationManager.setSyncNotificationEnabledWithoutApp(userId, enable, callback);
3614 3615 3616
```


3617
## notificationManager.setSyncNotificationEnabledWithoutApp
3618 3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629 3630 3631 3632

setSyncNotificationEnabledWithoutApp(userId: number, enable: boolean): Promise\<void>

设置是否将通知同步到未安装应用程序的设备(Promise形式)。

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名 | 类型                          | 必填 | 说明           |
| ------ | ----------------------------- | ---- | -------------- |
F
fangJinliang1 已提交
3633 3634
| userId | number | 是   | 用户ID。   |
| enable | boolean | 是   | 是否启用。   |
3635 3636 3637 3638 3639 3640 3641 3642 3643

**返回值:**

| 类型                                                        | 说明                                                         |
| ----------------------------------------------------------- | ------------------------------------------------------------ |
| Promise\<void\> | 以Promise形式返回设置是否将通知同步到未安装应用程序的设备的结果。 |

**错误码:**

F
fangJinliang1 已提交
3644 3645
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3646 3647 3648 3649 3650 3651 3652 3653 3654
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

3655
```ts
3656 3657 3658
let userId = 100;
let enable = true;

3659
notificationManager.setSyncNotificationEnabledWithoutApp(userId, enable).then(() => {
F
fangJinliang1 已提交
3660 3661
    console.info('setSyncNotificationEnabledWithoutApp success');
}).catch((err) => {
3662
    console.error(`setSyncNotificationEnabledWithoutApp failed, code is ${err.code}, message is ${err.message}`);
F
fangJinliang1 已提交
3663
});
3664 3665 3666
```


3667
## notificationManager.getSyncNotificationEnabledWithoutApp
3668 3669 3670

getSyncNotificationEnabledWithoutApp(userId: number, callback: AsyncCallback\<boolean>): void

F
fangJinliang1 已提交
3671
获取同步通知到未安装应用程序设备的开关是否开启(callback形式)。
3672 3673 3674 3675 3676 3677 3678 3679 3680 3681 3682

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名 | 类型                          | 必填 | 说明           |
| ------ | ----------------------------- | ---- | -------------- |
F
fangJinliang1 已提交
3683 3684
| userId | number | 是   | 用户ID。   |
| callback | AsyncCallback\<boolean\>         | 是   | 获取同步通知到未安装应用程序设备的开关是否开启的回调函数。 |
3685 3686 3687

**错误码:**

F
fangJinliang1 已提交
3688 3689
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3690 3691 3692 3693 3694 3695 3696 3697 3698
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

3699
```ts
3700 3701
let userId = 100;

Z
zhongjianfei 已提交
3702
function getSyncNotificationEnabledWithoutAppCallback(err, data) {
3703
    if (err) {
F
fangJinliang1 已提交
3704
        console.info('getSyncNotificationEnabledWithoutAppCallback, err:' + err);
3705
    } else {
F
fangJinliang1 已提交
3706
        console.info('getSyncNotificationEnabledWithoutAppCallback, data:' + data);
3707 3708 3709
    }
}

3710
notificationManager.getSyncNotificationEnabledWithoutApp(userId, getSyncNotificationEnabledWithoutAppCallback);
3711 3712 3713
```


3714
## notificationManager.getSyncNotificationEnabledWithoutApp
3715 3716 3717

getSyncNotificationEnabledWithoutApp(userId: number): Promise\<boolean>

F
fangJinliang1 已提交
3718
获取同步通知到未安装应用程序设备的开关是否开启(Promise形式)。
3719 3720 3721 3722 3723 3724 3725 3726 3727 3728 3729

**系统能力**:SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER

**参数:**

| 参数名 | 类型                          | 必填 | 说明           |
| ------ | ----------------------------- | ---- | -------------- |
F
fangJinliang1 已提交
3730
| userId | number | 是   | 用户ID。   |
3731 3732 3733

**返回值:**

F
fangJinliang1 已提交
3734 3735 3736
| 类型               | 说明                                                         |
| ------------------ | ------------------------------------------------------------ |
| Promise\<boolean\> | 以Promise形式返回获取同步通知到未安装应用程序设备的开关是否开启的结果。 |
3737 3738 3739

**错误码:**

F
fangJinliang1 已提交
3740 3741
错误码详细介绍请参考[errcode-notification](../errorcodes/errorcode-notification.md)

3742 3743 3744 3745 3746 3747 3748 3749 3750
| 错误码ID | 错误信息                            |
| -------- | ----------------------------------- |
| 1600001  | Internal error.                     |
| 1600002  | Marshalling or unmarshalling error. |
| 1600003  | Failed to connect service.          |
| 1600008  | The user is not exist.              |

**示例:**

3751
```ts
3752
let userId = 100;
3753
notificationManager.getSyncNotificationEnabledWithoutApp(userId).then((data) => {
F
fangJinliang1 已提交
3754 3755 3756 3757
    console.info('getSyncNotificationEnabledWithoutApp, data:' + data);
}).catch((err) => {
    console.info('getSyncNotificationEnabledWithoutApp, err:' + err);
});
3758 3759 3760 3761 3762 3763 3764 3765 3766
```


## DoNotDisturbDate

**系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification

**系统API**:此接口为系统接口,三方应用不支持调用。

F
fangJinliang1 已提交
3767 3768 3769 3770 3771
| 名称  | 类型                                  | 可读 | 可写 | 说明                   |
| ----- | ------------------------------------- | ---- | ---- | ---------------------- |
| type  | [DoNotDisturbType](#donotdisturbtype) | 是   | 是   | 免打扰设置的时间类型。 |
| begin | Date                                  | 是   | 是   | 免打扰设置的起点时间。 |
| end   | Date                                  | 是   | 是   | 免打扰设置的终点时间。 |
3772 3773 3774 3775 3776 3777 3778 3779 3780 3781 3782 3783 3784 3785 3786 3787 3788 3789 3790 3791 3792 3793 3794 3795 3796 3797 3798 3799 3800 3801 3802 3803 3804 3805 3806 3807 3808 3809 3810 3811 3812 3813 3814 3815 3816 3817 3818 3819 3820 3821 3822 3823 3824 3825 3826 3827 3828 3829 3830 3831 3832

## DoNotDisturbType

**系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification

**系统API**: 此接口为系统接口,三方应用不支持调用。

| 名称         | 值               | 说明                                       |
| ------------ | ---------------- | ------------------------------------------ |
| TYPE_NONE    | 0 | 非通知勿扰类型。                           |
| TYPE_ONCE    | 1 | 以设置时间段(只看小时和分钟)一次执行勿扰。 |
| TYPE_DAILY   | 2 | 以设置时间段(只看小时和分钟)每天执行勿扰。 |
| TYPE_CLEARLY | 3 | 以设置时间段(明确年月日时分)执行勿扰。     |


## ContentType

**系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification

| 名称                              | 值          | 说明               |
| --------------------------------- | ----------- | ------------------ |
| NOTIFICATION_CONTENT_BASIC_TEXT   | NOTIFICATION_CONTENT_BASIC_TEXT | 普通类型通知。     |
| NOTIFICATION_CONTENT_LONG_TEXT    | NOTIFICATION_CONTENT_LONG_TEXT | 长文本类型通知。   |
| NOTIFICATION_CONTENT_PICTURE      | NOTIFICATION_CONTENT_PICTURE | 图片类型通知。     |
| NOTIFICATION_CONTENT_CONVERSATION | NOTIFICATION_CONTENT_CONVERSATION | 社交类型通知。     |
| NOTIFICATION_CONTENT_MULTILINE    | NOTIFICATION_CONTENT_MULTILINE | 多行文本类型通知。 |

## SlotLevel

**系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification

| 名称                              | 值          | 说明               |
| --------------------------------- | ----------- | ------------------ |
| LEVEL_NONE                        | 0           | 表示关闭通知功能。     |
| LEVEL_MIN                         | 1           | 表示通知功能已启用,但状态栏中不显示通知图标,且没有横幅或提示音。 |
| LEVEL_LOW                         | 2           | 表示通知功能已启用,且状态栏中显示通知图标,但没有横幅或提示音。 |
| LEVEL_DEFAULT                     | 3           | 表示通知功能已启用,状态栏中显示通知图标,没有横幅但有提示音。 |
| LEVEL_HIGH                        | 4           | 表示通知功能已启用,状态栏中显示通知图标,有横幅和提示音。 |


## SlotType

**系统能力**:以下各项对应的系统能力均为SystemCapability.Notification.Notification

| 名称                 | 值       | 说明       |
| -------------------- | -------- | ---------- |
| UNKNOWN_TYPE         | 0 | 未知类型。 |
| SOCIAL_COMMUNICATION | 1 | 社交类型。 |
| SERVICE_INFORMATION  | 2 | 服务类型。 |
| CONTENT_INFORMATION  | 3 | 内容类型。 |
| OTHER_TYPES          | 0xFFFF | 其他类型。 |




## DeviceRemindType

**系统能力**:SystemCapability.Notification.Notification

**系统API**: 此接口为系统接口,三方应用不支持调用。

F
fangJinliang1 已提交
3833
| 名称                 | 值  | 说明                               |
3834 3835 3836 3837 3838 3839 3840 3841 3842 3843 3844 3845 3846
| -------------------- | --- | --------------------------------- |
| IDLE_DONOT_REMIND    | 0   | 设备未被使用,无需提醒。            |
| IDLE_REMIND          | 1   | 提醒设备未被使用。                 |
| ACTIVE_DONOT_REMIND  | 2   | 设备正在使用,无需提醒。            |
| ACTIVE_REMIND        | 3   | 提醒设备正在使用。                 |


## SourceType

**系统能力**:SystemCapability.Notification.Notification

**系统API**: 此接口为系统接口,三方应用不支持调用。

F
fangJinliang1 已提交
3847
| 名称                 | 值  | 说明                  |
3848 3849 3850 3851
| -------------------- | --- | -------------------- |
| TYPE_NORMAL          | 0   | 一般通知。            |
| TYPE_CONTINUOUS      | 1   | 连续通知。            |
| TYPE_TIMER           | 2   | 计划通知。            |