privacy

来自于:官方立即使用

基础类

概述

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

location

判断是否有定位权限

location(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.location(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

contacts

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

contacts(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.contacts(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

calendars

判断是否有访问日历权限

calendars(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.calendars(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

reminders

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

reminders(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.reminders(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

photos

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

photos(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.photos(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

bluetooth

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

bluetooth(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.bluetooth(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

microphone

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

microphone(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status: true     //布尔型;是否有访问该功能权限;true(有权限)||false (无权限)
}

示例代码

var privacy = api.require('privacy');
privacy.microphone(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本

camera

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

camera(callback(ret, err))

callback(ret, err)

ret:

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

示例代码

var privacy = api.require('privacy');
privacy.camera(function(ret, err) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS 系统

可提供的1.0.0及更高版本