appSettings

来自于:开发者

概述

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