更新日期：     浏览次数：

1. 设备能力

1.1. 位置

本页介绍了获得位置信息相关的JS-API方法，开发者可以根据应用的需求进行相应的配置。本页方法会不定期更新以满足更多应用个性化的开发需求。如果您有什么需求，欢迎在云之家开发者交流社区留言反馈，我们会根据您的需求进行优化。

1.1.1. 获取定位

调用代码:

//0.9.6及以上支持
qing.call('getLocation', {
    success: function(result){}
});

参数说明：无

回调说明:

{
    success: true or false 是否成功(String)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data:{
        'latitude'：22.2748379,                         //维度,国测GCJ-02标准
        'longitude':133.2324334,                        //经度,国测GCJ-02标准
        'province':'广东省',                            //省
        'city':'深圳市',                                //市
        'district':'南山区',                            //区
        'name':'金蝶软件园',                            //名称
        'address':'科技南十二道',                       //地址
        'addressdetail':广东省深圳市南山区科技南十二道'   //详细地址
    }
}

1.1.2. 选取周边位置

调用代码:

//0.9.6及以上支持
qing.call('selectLocation', {
    'latitude':22.394839,
    'longitude':133.374833,
    'isLocation':false,
    'isFullMap':true,
    'success': function(result){}
});

参数说明:

参数名称 数据类型 必选 说明
latitude double 否，isLocation为false时，必填 周边位置的中心纬度,国测GCJ-02标准。
longitude double 否，isLocation为false时，必填 周边位置的中心经度,国测GCJ-02标准。
isLocation boolean 是 false为传过来的经纬度来获取周边，true获取自动定位获取周边。
isFullMap boolean 否 true获取地图任意位置。

回调说明:

{
    success: true or false 是否成功(String)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data:{'latitude'：22.2748379,                         //维度
          'longitude':133.2324334,                        //经度
          'province':'广东省',                            //省
          'city':'深圳市',                                //市
          'district':'南山区',                            //区
          'name':'金蝶软件园',                            //名称
          'address':'科技南十二道',                       //地址
          'addressdetail':广东省深圳市南山区科技南十二道'   //详细地址
    }
}

1.1.3. 开始持续定位接口

qing.call('startLocation', {
    interval: 2,
    success: function (res) {
        alert(JSON.stringify(res))
    }
})
参数名称 数据类型 必选 说明
interval int 默认是2，区间1-60

返回值格式：

{
    success: "true",
    errorCode: 0,
    error: "",
    data: {
        latitude: 22.123123, //纬度
        longitude: 12.121212, //经度
        name: "金蝶大厦", //位置名称
        address: "金蝶大厦", //位置地址
        addressdetail: "金蝶大厦", //位置详细地址
        province: "广东省", //省份
        city: "深圳市", //城市
        district: "南山区" //区
    }
}

备注：errorCode为16601时，error字段为："未获取位置的权限" errorCode为16602时，error字段为："位置获取失败"

1.1.4. 停止持续定位接口

qing.call('stopLocation', {
    success: function (res) {
        alert(JSON.stringify(res))
    }
})

返回值格式：

{
    success: "true",
    errorCode: 0,
    error: "",
    data: {
        latitude: 22.123123, //纬度
        longitude: 12.121212, //经度
        name: "asdasdasd", //位置名称
        address: "深圳市南山区科技南12路", //位置地址
        addressdetail: "深圳市南山区科技南12路", //位置详细地址
        province: "广东省", //省份
        city: "qweqweqwe", //城市
        district: "q2w3eqweqwe" //区
    }
}

1.2. 获取或者设置粘贴板内容

调用代码:

//0.9.12及以上支持
qing.call('clipBoard', {
    'type':'getString or setString',
    'string':'设置的内容',
    'success': function(result){}
});

参数说明:

参数名称 数据类型 必选 说明
type string 是 getString表示获取粘贴板内容，setString表示设置粘贴板内容
string string 否 getString时传空，setString时传入需要设置的内容

回调说明:

{
    success: true or false 是否成功(String)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data:{
        'string': '粘贴板内容' //getString才会返回此值，此参数做了url encode，使用时需要decode
    }
}

1.3. 网络

1.3.1. 获取用户网络类型

调用代码:

qing.call('getNetworkType', {
    success: function(result){
        alert('用户网络状态：' + JSON.stringify(result));
    }
});

参数说明:无

回调说明:

{
    success: true or false 是否成功(string)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data: {
      network_type: 网络类型(string)
    }
}

data中字段说明:

字段名称 数据类型 说明
network_type string 网络类型。

1.3.2. 监听网络状态的变化

qing.on('networkAvailable', function (e) {
    alert('网络连接恢复')
})

qing.on('networkDisAvailable', function (e) {
    alert('网络连接断开')
})

1.4. 扫码

1.4.1. 唤起扫一扫

调用代码:

qing.call("scanQRCode",  {
    "needResult":0,
    "success": function(result) { }
});

参数说明:

参数名称 数据类型 必选 说明
needResult int 否 是否需要处理，默认为0，扫描结果由云之家处理，1则直接返回扫描结果。

回调说明:

{
    success: true or false 是否成功(String)
    error: 错误信息(String)
    errorCode: 错误码(int)
    data:{
         "qrcode_str":"xxx"
    }
}

data字段说明:

字段名称 数据类型 说明
qrcode_str string 扫码返回的结果，该结果在needResult为1的时候；当needResult为0时，data字段不返回。

1.4.2. 扫码打开轻应用

协议 二维码生成地址为：https://host:port?yf=la&laid=${appid}

说明如下：

  • yf=la：固定格式，表示该链接为轻应用
  • laid=${appid}：appid为轻应用ID

使用说明

使用云之家移动端（包括iOS和Android客户端）扫一扫功能，扫描上一步协议地址生成的二维码图片，成功后会在该协议地址后累加ticket，并使用WebView打开该地址。

示例二维码

使用云之家移动端扫描以上二维码可体验，二维码地址为：https://www.yunzhijia.com/mywork/index.html?laid=10619&yf=la&isNavTransparent=true

results matching ""

    No results matching ""