@ohos.intelligentScene (情景模式)
本模块提供查询免打扰的相关功能,包括查询系统的免打扰功能是否开启、查询应用自身是否允许打扰等。情景模式(免打扰、睡眠模式、学习模式、工作模式和自定义模式)开启时,免打扰功能会开启。
说明:
- 本模块首批接口从API version 23开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import { intelligentScene } from '@kit.BasicServicesKit';
intelligentScene.isDoNotDisturbEnabled
isDoNotDisturbEnabled(): Promise<boolean>
系统免打扰功能是否已开启,使用Promise异步回调。
模型约束:此接口仅可在Stage模型下使用。
系统能力:SystemCapability.Applications.IntelligentScene
需要权限: ohos.permission.GET_DONOTDISTURB_STATE
返回值:
| 类型 | 说明 |
|---|---|
| Promise<boolean> | Promise对象。返回免打扰功能是否已开启。true表示免打扰功能已开启,false表示免打扰功能未开启。 |
错误码:
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. |
| 35200001 | Internal error. |
示例:
import { BusinessError, intelligentScene } from '@kit.BasicServicesKit';
let isDoNotDisturbEnabled: boolean = false;
try {
isDoNotDisturbEnabled = await intelligentScene.isDoNotDisturbEnabled();
} catch (err) {
console.error(`Failed to get doNotDisturb state, code: ${err.code}, message: ${err.message}`);
}
if (isDoNotDisturbEnabled) {
console.info('DoNotDisturb state is open');
} else {
console.info('DoNotDisturb state is closed');
}
intelligentScene.isNotifyAllowedInDoNotDisturb
isNotifyAllowedInDoNotDisturb(): Promise<boolean>
如果用户已经把当前应用添加到了情景模式允许打扰列表内,那么开启此情景模式后,当前应用推送的通知将正常提醒、并且响铃振动,使用Promise异步回调。
模型约束:此接口仅可在Stage模型下使用。
系统能力:SystemCapability.Applications.IntelligentScene
需要权限: ohos.permission.GET_DONOTDISTURB_STATE
返回值:
| 类型 | 说明 |
|---|---|
| Promise<boolean> | Promise对象。免打扰功能未开启时,返回false;免打扰功能开启时,返回是否允许当前应用打扰:true表示允许打扰,false表示不允许打扰。 |
错误码:
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. |
| 35200001 | Internal error. |
示例:
import { BusinessError, intelligentScene } from '@kit.BasicServicesKit';
let isNotifyAllowedInDoNotDisturb: boolean = false;
try {
isNotifyAllowedInDoNotDisturb = await intelligentScene.isNotifyAllowedInDoNotDisturb();
} catch (err) {
console.error(`Failed to get doNotDisturb state, code: ${err.code}, message: ${err.message}`);
}
if (isNotifyAllowedInDoNotDisturb) {
console.info('Allowed to notify in doNotDisturb state');
} else {
console.info('Not allowed to notify in doNotDisturb state or doNotDisturb is closed');
}
你可能感兴趣的鸿蒙文章
openharmony 鸿蒙 capi-oh-scan-scan-picturescanprogress
openharmony 鸿蒙 js-apis-screen-lock
openharmony 鸿蒙 capi-os-account-common-h
openharmony 鸿蒙 js-apis-screen-lock-sys
openharmony 鸿蒙 capi-oh-print-print-propertylist
openharmony 鸿蒙 js-apis-system-device