appSettings

来自于：开发者

checkNotification open

概述

appSettings 模块封装了 iOS 平台上打开 APP 设置页与检查是否已开启 APP 通知权限的接口。当用户关闭 APP 通知权限时，可以提醒用户并快捷的打开 APP 设置页来开启权限。由于 Android 平台上机制不同，所以本模块仅支持 iOS 平台。

appSettings模块有可能导致上架App Store被拒绝。不推荐需要上架App Store的App使用。

checkNotification

检查 APP 是否开启了通知权限。（iPhone4s上没有允许通知的按钮，所以检测是否打开了通知权限一直是打开状态。）

checkNotification(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: true,      //布尔型；true||false，通知权限是否打开
    msg: "通知已打开"
}

示例代码

var appSettings = api.require('appSettings');
appSettings.checkNotification(function(ret){
    if (ret.status) {
        api.alert({msg: "已打了开通知权限"});
    }else{
        api.alert({msg: "没有打开通知权限"});
    }
});

可用性

iOS系统

可提供的1.0.0及更高版本

open

打开 APP 的设置页面

open({params}, callback(ret, err))

params

type：

• 类型：字符串
• 描述：由于 iOS7 及以下版本不支持打开 APP 的设置页面，而只能打开系统的设置页面，故此参数用来指定 iOS7 及以下版本打开哪一项系统设置页，默认打开系统通知中心设置页。 iOS8 及以上版本不受此参数影响。
• 默认值：NOTIFICATIONS_ID

callback(ret, err)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: true,      //布尔型；true||false，是否打开成功
    msg: "打开成功"
}

err：

• 类型：JSON对象
• 内部字段：

{
    msg: "打开失败"   //错误信息；
}

示例代码

var appSettings = api.require('appSettings');
appSettings.open({
    type:"NOTIFICATIONS_ID"
},function(ret){
   if(ret.status){
        console.log(ret.msg);
   }else{
        console.log(err.msg);
   }    
});

补充说明

type：

• 系统通知：NOTIFICATIONS_ID (不设置 type 参数，则默认使用此值)
• 定位服务：LOCATION_SERVICES
• 通用设置：General
• 蓝牙设置：Bluetooth
• 隐私设置：Privacy
• 关于本机：General&path=About
• 辅助功能：General&path=ACCESSIBILITY
• 自动锁定：General&path=AUTOLOCK
• 日期与时间：General&path=DATE_AND_TIME
• FaceTime：FACETIME
• 键盘设置：General&path=Keyboard
• iCloud设置：CASTLE
• iCloud-存储与备份：CASTLE&path=STORAGE_AND_BACKUP //需要注册iCloud账号并激活邮箱才能调用
• 多语言环境：General&path=INTERNATIONAL
• 邮件、通讯录、日历：ACCOUNT_SETTINGS
• 音乐设置：MUSIC
• 音乐-均衡器：MUSIC&path=EQ
• 备忘录设置：NOTES
• 电话设置：Phone //插过一次电话卡才能调用到
• 照片与相机：Photos
• 描述文件：General&path=ManagedConfigurationList
• 还原设置：General&path=Reset
• 电话铃声：Sounds&path=Ringtone
• Safari设置：Safari
• 声音设置：Sounds
• iOS软件更新：General&path=SOFTWARE_UPDATE_LINK
• iTunes Store 和 App Store：STORE
• 用量：General&path=USAGE
• 视频设置：VIDEO
• 壁纸与亮度：Wallpaper
• WIFI设置：WIFI
• 蜂窝网路：MOBILE_DATA_SETTINGS_ID //装上手机卡才能调用到

可用性

iOS系统

可提供的1.0.0及更高版本