更新记录

1.0.8（2024-10-13）

• 【更新】兼容iOS

1.0.7（2024-08-27）

• 【修复】修复AndroidManifest.xml的bug

1.0.6（2024-08-26）

• 【新增】设置自启动（支持小米，华为，红米，oppo，vivo厂商）
• 【新增】申请白名单权限和检查白名单权限
• 【新增】开启北斗定位和关闭北斗定位
• 【新增】开启步骑行惯导和关闭步骑行惯导
• 【新增】判断设备是否支持GPS定位
• 【新增】两个点以经纬度的形式计算距离

平台兼容性

x-tencent-s【腾讯定位】保姆和小白式的完美解决方案

• x-tencent-u【腾讯地图】https://ext.dcloud.net.cn/plugin?id=19957

常见问题

• 注意：本插件已实现https://lbs.qq.com/mobile/androidLocationSDK/androidGeoGuide/androidGeoBack该文档后台定位
• 运行之前需要打包自定义基座，并且需要提前引入在页面使用之后再打包，防止官方摇树
• 如有问题请及时在uni-im的x-tencent-s群反馈
• 本文档只支持Hbuilder X4.23，Hbuilder X4.24，Hbuilder X4.26版本
• 普通授权用户/试用用户/源码授权用户使用教程请看文档最下面（强烈建议）

示例代码

• 引入

import { 
    xSetKey,
    xSetUserAgreePrivacy,
    xGetLocation,
    xGetOnceLocation,
    xStopLocation,
    xGetSceneLocation,
    xStopSceneLocation,
    xGetBackstageLocation,
    xStopBackstageLocation,
    xApplyPermissions,
    xStartDrEngine,
    xStopDrEngine,
    xIsIgnoringBatteryOptimizations,
    xRequestIgnoreBatteryOptimizations,
    xSetSelfStart,
    X_RESULT_TYPE,
    X_LOCATION_TYPE
} from "@/uni_modules/x-tencent-s"

• template示例

<template>
    <scroll-view style="flex: 1;">
        <view class="cell">
            <text>经度：{{longitude}}</text>
            <text>纬度：{{latitude}}</text>
            <text>地址：{{address}}</text>
        </view>
        <view class="cell">
            <button class="cell-btn" @click="setSelfStart">设置自启动</button>
            <button class="cell-btn" @click="requestIgnoreBatteryOptimizations">申请白名单权限</button>
            <button class="cell-btn" @click="isIgnoringBatteryOptimizations">检查白名单权限</button>
            <button class="cell-btn" @click="applyPermissions">申请定位权限</button>
            <button class="cell-btn" @click="getLocation">开启前台持续定位</button>
            <button class="cell-btn" @click="stopLocation">关闭前台持续定位</button>
            <button class="cell-btn" @click="getOnceLocation">开启单次定位</button>
            <button class="cell-btn" @click="getSceneLocation">开启场景定位</button>
            <button class="cell-btn" @click="stopSceneLocation">关闭场景定位</button>
            <button class="cell-btn" @click="getBackstageLocation">开启后台持续定位</button>
            <button class="cell-btn" @click="stopBackstageLocation">关闭后台持续定位</button>
            <button class="cell-btn" @click="getBDSLocation">开启北斗定位</button>
            <button class="cell-btn" @click="stopBDSLocation">关闭北斗定位</button>
            <button class="cell-btn" @click="startDrEngine">开启步骑行惯导</button>
            <button class="cell-btn" @click="stopDrEngine">关闭步骑行惯导</button>
        </view>
    </scroll-view>
</template>

• Vue2使用示例

<script>
    export default {
        onReady() {
            xSetUserAgreePrivacy()
            xSetKey("你的KEY")
        },
        methods: {
            // 申请定位权限
            applyPermissions() {
                xApplyPermissions((data: X_RESULT_TYPE)=>{
                    console.log(data)
                })
            },
            // 开启持续定位
            getLocation() {
                xGetLocation({interval: 3000} as X_LOCATION_TYPE,(data:X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 开启单次定位
            getOnceLocation() {
                xGetOnceLocation((data: X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 停止持续定位
            stopLocation() {
                xStopLocation((data: X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 开启场景定位
            getSceneLocation() {
                xGetSceneLocation("SIGN_IN_SCENE",(data: X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 停止场景定位
            stopSceneLocation() {
                xStopSceneLocation("SIGN_IN_SCENE",(data: X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 开启后台定位
            getBackstageLocation(){
                xGetBackstageLocation({interval: 3000} as X_LOCATION_TYPE,(data: X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 停止后台定位
            stopBackstageLocation(){
                xStopBackstageLocation((data: X_RESULT_TYPE) => {
                    console.log(data)
                })
            },
            // 开启北斗定位
            getBDSLocation(){},
            // 关闭北斗定位
            stopBDSLocation(){},
            // 开启步骑行惯导
            startDrEngine() {
                xStartDrEngine("",(result: X_RESULT_TYPE) => {
                    console.log(result)
                })
            },
            // 停止步骑行惯导
            stopDrEngine() {
                xStopDrEngine((result: X_RESULT_TYPE) => {
                    console.log(result)
                })
            },
            // 申请白名单权限
            requestIgnoreBatteryOptimizations() {
                xRequestIgnoreBatteryOptimizations((result: X_RESULT_TYPE) => {
                    console.log(result)
                })
            },
            // 判断是否在白名单
            isIgnoringBatteryOptimizations() {
                let isIgnore = xIsIgnoringBatteryOptimizations()
                if(isIgnore){
                    uni.showToast({title: "已申请白名单权限", icon: "none"})
                    return
                }
                uni.showToast({title: "未申请白名单权限", icon: "none"})
            },
            // 设置自启动
            setSelfStart() {
                xSetSelfStart((result: X_RESULT_TYPE) => {
                    console.log(result)
                })
            }
        }
    }
</script>

• Vue3使用示例

<script lang="uts" setup> 
// 申请定位权限
const applyPermissions = () => {
    xApplyPermissions((data: X_RESULT_TYPE)=>{
        console.log(data)
    })
}
// 开启持续定位
const getLocation = () => {
    xGetLocation({interval: 3000} as X_LOCATION_TYPE,(data:X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 开启单次定位
const getOnceLocation = () => {
    xGetOnceLocation((data: X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 停止持续定位
const stopLocation = () => {
    xStopLocation((data: X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 开启场景定位
const getSceneLocation = () => {
    xGetSceneLocation("SIGN_IN_SCENE",(data: X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 停止场景定位
const stopSceneLocation = () => {
    xStopSceneLocation("SIGN_IN_SCENE",(data: X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 开启后台定位
const getBackstageLocation = () => {
    xGetBackstageLocation({interval: 3000} as X_LOCATION_TYPE,(data: X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 停止后台定位
const stopBackstageLocation = () => {
    xStopBackstageLocation((data: X_RESULT_TYPE) => {
        console.log(data)
    })
}
// 开启北斗定位
const getBDSLocation = () => {}
// 关闭北斗定位
const stopBDSLocation = () => {}
// 开启步骑行惯导
const startDrEngine = () => {
    xStartDrEngine("",(result: X_RESULT_TYPE) => {
        console.log(result)
    })
}
// 停止步骑行惯导
const stopDrEngine = () => {
    xStopDrEngine((result: X_RESULT_TYPE) => {
        console.log(result)
    })
}
// 申请白名单权限
const requestIgnoreBatteryOptimizations = () => {
    xRequestIgnoreBatteryOptimizations((result: X_RESULT_TYPE) => {
        console.log(result)
    })
}
// 判断是否在白名单
const isIgnoringBatteryOptimizations = () => {
    let isIgnore = xIsIgnoringBatteryOptimizations()
    if(isIgnore){
        uni.showToast({title: "已申请白名单权限", icon: "none"})
        return
    }
    uni.showToast({title: "未申请白名单权限", icon: "none"})
}
// 设置自启动
const setSelfStart = () => {
    xSetSelfStart((result: X_RESULT_TYPE) => {
        console.log(result)
    })
}

onReady(() => {
    xSetUserAgreePrivacy()
    xSetKey("你的KEY")
})
</script>

• 如果定位权限存在并且xSetKey方法失效，出现KEY配置错误（解决方案）
  • 在你的根目录下创建AndroidManifest.xml文件
  • 将以下代码放在该文件，修改你的包名和你的KEY

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
    package="你的包名">
    <application>
        <meta-data android:name="TencentMapSDK" android:value="你的KEY" />
        <service android:name="com.tencent.map.geolocation.s" android:foregroundServiceType="location" />
    </application>
</manifest>

方法

X_LOCATION_TYPE 传入参数

X_RESULT_TYPE 返回参数

X_RESULT_TYPE 的 code和msg

普通授权用户/试用用户 使用教程

• 1.将以下代码，引入到你要使用的文件里面，确保该函数被页面调用或自调用。

import { 
    X_RESULT_TYPE,
    X_LOCATION_TYPE
} from "@/uni_modules/x-tencent-s"

• 2.进行自定义基座打包，打包成功之后，可以直接引用以下代码进行使用
  • 打包自定义基座需要修改版本号和版本名称，防止打包不进去
• 3.由于代码进行了加密，所以普通授权用户引入的函数可能会爆红，但不影响正常使用

import { 
    xSetKey,
    xSetUserAgreePrivacy,
    xGetLocation,
    xGetOnceLocation,
    xStopLocation,
    xGetSceneLocation,
    xStopSceneLocation,
    xGetBackstageLocation,
    xStopBackstageLocation,
    xApplyPermissions,
    xStartDrEngine,
    xStopDrEngine,
    xIsIgnoringBatteryOptimizations,
    xRequestIgnoreBatteryOptimizations,
    xSetSelfStart,
    X_RESULT_TYPE,
    X_LOCATION_TYPE
} from "@/uni_modules/x-tencent-s"

源码授权用户 使用教程

• 1.将以下代码，引入到你要使用的文件里面，确保该函数被页面调用或自调用。
• 2.进行自定义基座打包，打包成功之后，可以直接引用以下代码进行使用
  • 打包自定义基座需要修改版本号和版本名称，防止打包不进去

import { 
    xSetKey,
    xSetUserAgreePrivacy,
    xGetLocation,
    xGetOnceLocation,
    xStopLocation,
    xGetSceneLocation,
    xStopSceneLocation,
    xGetBackstageLocation,
    xStopBackstageLocation,
    xApplyPermissions,
    xStartDrEngine,
    xStopDrEngine,
    xIsIgnoringBatteryOptimizations,
    xRequestIgnoreBatteryOptimizations,
    xSetSelfStart,
    X_RESULT_TYPE,
    X_LOCATION_TYPE
} from "@/uni_modules/x-tencent-s"

iOS修改腾讯定位密钥Key指南

• 找到 uni_modules/x-tencent-s/utssdk/app-ios/info.plist 文件
• 将你的KEY修改为你的KEY

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>TencentLBSAPIKey</key>
        <string>你的KEY</string>
        <key>UIBackgroundModes</key>
        <array>
            <string>location</string>
        </array>
        <key>NSLocationAlwaysUsageDescription</key>
        <string>用于提供精确的定位</string>
        <key>NSLocationWhenInUseUsageDescription</key>
        <string>用于提供精确的定位</string>
    </dict>
</plist>

X插件系列

x-base-s【基础插件】安卓好用的基础工具

x-sms【短信插件】为X系列插件打造完美轮子

x-tencent-u【腾讯地图】

x-tencent-s【腾讯定位】保活和持久，保姆和小白式的完美解决方案

x-gaode-s【高德定位】保姆和小白式完美解决方案

x-icon-u【图标组件】

x-short-video-u是一个高性能，高度配置的短视频组件

x-im-sdk 为即时通讯量身打造, 适配Android，iOS，Web