更新记录

1.1.1（2025-03-27）

• 【更新】修复已知存在的Bug
• 【更新】更改以前不兼容的回调和传参数模式
• 大版本改写，4.28版本以下不受影响

1.1.0（2025-03-21）

• 【更新】增加demo示例

1.0.9（2025-03-21）

• 【检查】检查版本是否存在bug/修复bug

平台兼容性

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

• 测试Demo地址：前往demo

• 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版本，最新4.54往上版本，均无问题。
• 普通授权用户/试用用户/源码授权用户使用教程请看文档最下面（强烈建议）

示例代码

• 引入

import { 
    xSetKey,
    xSetUserAgreePrivacy,
    xGetLocation,
    xGetOnceLocation,
    xStopLocation,
    xGetSceneLocation,
    xStopSceneLocation,
    xGetBackstageLocation,
    xStopBackstageLocation,
    xApplyPermissions,
    xStartDrEngine,
    xStopDrEngine,
    xIsIgnoringBatteryOptimizations,
    xRequestIgnoreBatteryOptimizations,
    xSetSelfStart,
    X_RESULT_TYPE,
    X_LOCATION_OPTIONS
} 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() {
            // #ifdef APP-ANDROID
            xSetUserAgreePrivacy()
            // #endif
            // #ifdef APP-ANDROID
            xSetKey("你的KEY")
            // #endif
        },
        methods: {
            // 申请定位权限
            applyPermissions() {
                xApplyPermissions({
                    success: (result:X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result:X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 开启持续定位
            getLocation() {
                xGetLocation({
                    interval: 3000,
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                        this.address = (result.data as UTSJSONObject).getString("address") as string
                        this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
                        this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                } as X_LOCATION_OPTIONS)
            },
            // 开启单次定位
            getOnceLocation() {
                xGetOnceLocation({
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                        this.address = (result.data as UTSJSONObject).getString("address") as string
                        this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
                        this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 停止持续定位
            stopLocation() {
                xStopLocation({
                    success: (result:X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 开启场景定位
            getSceneLocation() {
                xGetSceneLocation({
                    scene: "SIGN_IN_SCENE",
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                        this.address = (result.data as UTSJSONObject).getString("address") as string
                        this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
                        this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 停止场景定位
            stopSceneLocation() {
                xStopSceneLocation({
                    scene: "SIGN_IN_SCENE",
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 开启后台定位
            getBackstageLocation(){
                xGetBackstageLocation({
                    interval: 5000,
                    locMode: "HIGH_ACCURACY",
                    success: (result: X_RESULT_TYPE) => {
                        this.address = (result.data as UTSJSONObject).getString("address") as string
                        this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
                        this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
                        console.log(result)
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 停止后台定位
            stopBackstageLocation(){
                xStopBackstageLocation({
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 开启北斗定位
            getBDSLocation(){},
            // 关闭北斗定位
            stopBDSLocation(){},
            // 开启步骑行惯导
            startDrEngine() {
                xStartDrEngine({
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result:X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 停止步骑行惯导
            stopDrEngine() {
                xStopDrEngine({
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            },
            // 申请白名单权限
            requestIgnoreBatteryOptimizations() {
                xRequestIgnoreBatteryOptimizations({
                    success: (result:X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (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({
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                })
            }
        }
    }
</script>

• Vue3使用示例

<script lang="uts" setup> 
// 申请定位权限
const applyPermissions = () => {
    xApplyPermissions({
        success: (result:X_RESULT_TYPE) => {
            console.log(result)
        },
        fail: (result:X_RESULT_TYPE) => {
            console.log(result)
        }
    })
}
// 开启持续定位
const getLocation = () => {
    xGetLocation({
        interval: 3000,
        success: (result: X_RESULT_TYPE) => {
            console.log(result)
            this.address = (result.data as UTSJSONObject).getString("address") as string
            this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
            this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
        },
        fail: (result: X_RESULT_TYPE) => {
            console.log(result)
        }
    } as X_LOCATION_OPTIONS)
}

onReady(() => {
    // #ifdef APP-ANDROID
    xSetUserAgreePrivacy()
    // #endif
    // #ifdef APP-ANDROID
    xSetKey("你的KEY")
    // #endif
})
</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_OPTIONS 传入参数

X_RESULT_TYPE 返回参数

X_RESULT_TYPE 的 code和msg

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

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

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

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

import { 
    X_RESULT_TYPE,
    X_LOCATION_OPTIONS
} 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_OPTIONS
} 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