Skip to content

UNNotificationSettings ​

UNNotificationSettings 表示这个 App 的通知设置在某一刻的样子:用户同不同意发通知,声音、角标、锁屏、通知中心等各项开没开。

它只能从 getNotificationSettings() 来,是一份快照:用户之后在系统的「设置」里改了,这个对象不会变,要再取一次。用户改设置时没有事件:改设置要离开 App,回来时在 application 的 active 事件里重新取一次。

字段全部只读,写了抛 TypeError。它是普通的 JS 值,不继承 NSObject。

要先装 @nacrejs/user-notifications,装法见 UNUserNotificationCenter,也可以看核心和能力包。

继承关系:UNNotificationSettings

构造函数 ​

不能用 new 创建。new UNNotificationSettings() 抛 TypeError:

Illegal constructor: UNNotificationSettings comes from UNUserNotificationCenter.getNotificationSettings()

实例属性 ​

全部只读。

属性说明
authorizationStatus 只读用户同不同意这个 App 发通知
alertSetting 只读展示通知的总开关
soundSetting 只读声音
badgeSetting 只读图标上的数字
notificationCenterSetting 只读留在通知中心里
lockScreenSetting 只读在锁屏上展示
carPlaySetting 只读在 CarPlay 上展示
criticalAlertSetting 只读紧急通知
announcementSetting 只读由 Siri 念出来
timeSensitiveSetting 只读时效性通知
scheduledDeliverySetting 只读定时摘要
directMessagesSetting 只读作为直接消息穿过专注模式
alertStyle 只读手机没锁时通知怎么出现
showPreviewsSetting 只读通知的内容什么时候显示
providesAppNotificationSettings 只读申请授权时有没有带 'providesAppNotificationSettings'

三态 ​

alertSetting 到 directMessagesSetting 这十一项的取值都是下面三个之一:

取值含义
'enabled'开着
'disabled'关着
'notSupported'这个 App 没有这一项:没申请过,或者设备不支持

从没申请过授权时各项的值未在模拟器验证。

示例 ​

js
const center = UNUserNotificationCenter.currentNotificationCenter();
const settings = await center.getNotificationSettings();
console.log(settings.authorizationStatus, settings.soundSetting, settings.alertStyle);

效果:输出授权状态、声音这一项的状态和通知的出现方式,比如 authorized enabled banner。具体的值未在模拟器验证。

对应的 iOS API ​

ObjCJS
settings.authorizationStatus == UNAuthorizationStatusAuthorizedsettings.authorizationStatus === 'authorized'
settings.soundSetting == UNNotificationSettingEnabledsettings.soundSetting === 'enabled'

参见 ​