gps

getGpsState

openGpsSettingView

概述

gps封装了手机获取定位服务开关状态(包括GPS定位、网络定位)和打开系统gps设置界面的功能。

注意由于此插件使用了私有API，会导致iOS上架App Store被拒绝。 如需上架App Store，请不要使用此插件。

插件接口

getGpsState

获取定位服务开关状态。在Android上定位服务分3种，1、同时使用网络和GPS定位；2、仅使用GPS定位；3、仅使用网络定位。在iOS的设置界面上设置定位服务时只有一个开关，即打开和关闭定位服务。所以该接口的返回值需要把iOS和Android两个平台分开处理，请开发者注意。

getGpsState(callback(ret))

callback(ret)

ret:

  • 类型：JSON对象
  • 描述：返回gps状态
  • 内部字段：
{
    status:1     //注意：这里两个平台的返回值含义不一样，返回值和对应含义如下：
                 //对于iOS:  1：定位服务已打开，0:定位服务未打开  
                 //对于Android：1：同时使用网络和GPS定位；
                               2：仅使用GPS定位；
                               3：仅使用网络定位
                                0：定位服务未打开 
}

示例代码

var demo = api.require('gps');
demo.getGpsState(function(ret){
        alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

openGpsSettingView

打开系统自带的gps设置界面，用户可在此界面打开或关闭gps

openGpsSettingView(callback(ret))

callback(ret)

ret:

  • 类型：JSON对象
  • 内部字段：
{
    status: 1  //1：打开界面成功，0:打开界面失败  
}

示例代码

var demo = api.require('gps');
demo.openGpsSettingView(function(ret){
        alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18