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及更高版本