privacy

来自于：官方立即使用

基础类

location contacts calendars reminders photos bluetooth microphone camera

概述

privacy 模块封装了 iOS 平台上设备访问权限判断的接口，包括定位服务、通讯录、日历、提醒事项、照片、蓝牙共享、麦克风、相机、健康。由于 Android 平台上机制不同，所以本模块仅支持 iOS 平台。（Android 上是在应用打包时候注册某一项权限，用户安装时系统弹出提示，若用户同意则安装该 app，若不同意则取消安装。所以若应用被安装成功，则必定有 app 开发者注册给该应用的权限，应用内无需判断。）

注意：

使用本模块需在云编译时勾选添加定位、通讯录、日历、提醒、相册、蓝牙、麦克风、相机的权限提示，否则发布App Store时候不通过。如果只是用来判断相机、通讯录、麦克风、相册、定位、日历的话请使用api对象下的 hasPermission 接口，不要使用本模块，这样云编译时就不用添加日历、提醒、蓝牙的权限提醒语了。

privacy - 图1

location

判断是否有定位权限

location(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,     //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法使用定位服务，该状态用户无法改变
  6.                      //denied：户拒绝该应用使用定位服务，或是定位服务总开关处于关闭状态
  7.                      //authorizedAlways：用户允许该程序无论何时都可以使用地理信息
  8.                      //whenInUse：用户同意程序在可见时使用地理位置
  9. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.location(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

contacts

判断是否有访问联系人权限

contacts(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,    //布尔型；是否有访问该功能权限；true（有权限）||false （无权限））
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法访问手机通讯录，该状态用户无法改变
  6.                      //denied：户拒绝该应用访问手机通讯录，或是访问手机通讯录服务总开关处于关闭状态
  7.                      //authorized：用户允许该程序可以访问手机通讯录
  8. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.contacts(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

calendars

判断是否有访问日历权限

calendars(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,     //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法访问手机日历，该状态用户无法改变
  6.                      //denied：户拒绝该应用访问手机日历，或是访问手机日历服务总开关处于关闭状态
  7.                      //authorized：用户允许该程序可以访问手机日历
  8. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.calendars(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

reminders

判断是否有访问提醒事项的权限

reminders(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,    //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法访问手机提醒，该状态用户无法改变
  6.                      //denied：户拒绝该应用访问手机提醒，或是访问手机提醒服务总开关处于关闭状态
  7.                      //authorized：用户允许该程序可以访问手机提醒
  8. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.reminders(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

photos

判断是否有访问相册的权限

photos(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true, //布尔型；是否有访问该功能权限；true（有权限）||false （无权限））
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法访问手机相册，该状态用户无法改变
  6.                      //denied：户拒绝该应用访问手机相册，或是访问手机相册服务总开关处于关闭状态
  7.                      //authorized：用户允许该程序可以访问手机相册
  8. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.photos(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

bluetooth

判断是否有访问蓝牙的权限

bluetooth(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,    //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法访问手机蓝牙，该状态用户无法改变
  6.                      //denied：户拒绝该应用访问手机蓝牙，或是访问手机蓝牙服务总开关处于关闭状态
  7.                      //authorized：用户允许该程序可以访问手机蓝牙
  8. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.bluetooth(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

microphone

判断是否有访问录音器的权限

microphone(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true     //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
  3. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.microphone(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本

camera

判断是否有访问摄像头的权限

camera(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,    //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
  3.     details: ''      //字符串类型；权限详情，取值范围如下：
  4.                      //notDetermined： 用户从未选择过权限
  5.                      //restricted：无法访问手机摄像头，该状态用户无法改变
  6.                      //denied：户拒绝该应用访问手机摄像头，或是访问手机摄像头服务总开关处于关闭状态
  7.                      //authorized：用户允许该程序可以访问手机摄像头
  8. }

示例代码

  1. var privacy = api.require('privacy');
  2. privacy.camera(function(ret, err) {
  3.     if (ret.status) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS 系统

可提供的1.0.0及更高版本