mrr.sj.front/uni_modules/xtf-gpslocation/readme.md

3.0 KiB
Raw Permalink Blame History

xtf-gpslocation

android ios 原生gps 定位

长期维护,有任何问题在插件群联系

插件测试使用方法

  1. 选择试用绑定要试用的项目appid

  2. 选择后下载到对应的本地项目,

  3. 按照文档 -》把插件引入项目(即 import { KeepLive } from '@/uni_modules/android-keeplive' 需要先引入),

  4. 发布-》云打包-》选择制作基座-》打包等基座制作完成

  5. 运行 -》 运行到手机或模拟器-》运行到Androidapp基座-》选择使用自定义基座运行-》选择手机-》运行

若长期无法获取到定位,请到室外进行定位 室内大概率无gps 信号

推荐作者保活插件一起使用

uniappx

import { isProviderEnabled, openLocSetting,  onStartLocs,LocData,stop,requestBackgroundLocPer,getLastLocations,LocationData} from "@/uni_modules/xtf-gpslocation"



var on=isProviderEnabled();// 是否开启gps
if(!on){
	openLocSetting();// 打开gps 设置
}
requestBackgroundLocPer();// 申请后台定位权限 无权限则申请,有权限则直接跳过


// 获取上次定位
getLastLocations(function(loc:LocationData){
	console.log(loc)
})

onStartLoc({
	backgroud:true,
} as LocData,function(loc:LocationData){
	console.log(loc)
})
// stop(true);// 停止定位   参数为是否移除通知

uniapp

import { isProviderEnabled, openLocSetting,  onStartLocs,stop,requestBackgroundLocPer,getLastLocations} from "@/uni_modules/xtf-gpslocation"



var on=isProviderEnabled();// 是否开启gps
if(!on){
	openLocSetting();// 打开gps 设置
}

requestBackgroundLocPer();// 申请后台定位权限 无权限则申请,有权限则直接跳过
// 获取上次定位
getLastLocations(function(loc){
	console.log(loc)
})

onStartLoc({
	backgroud:true,
},function(loc){
	console.log(loc)
})
// stop(true);// 停止定位   参数为是否移除通知

请求参数 LocData

 export type LocData={
	 title?:string,// 通知栏标题
	 content?:string,// 通知栏内容
	 notifationIconName?:string, // 通知栏icon名称  插件目录 /app-android/res/drawable/
	 time?:number, // 定位时间间隔默认0  为仅定位一次 时间为毫秒
	 distance?:number,// 定位位置间隔距离  // 默认0
	 backgroud?:boolean,// 是否是后台定位,
	 getLastFast?:boolean,// 是否先获取上次定位 之后在返回新的定位 // 默认true
};

返回参数 LocationData

 export type LocationData={
	 msg:string,// 消息
	type:number,//  0 是上一次的  1 是最新的  2 定位失败
	lat:number, //经度
	lng:number,//纬度
	speed:number,//速度
	altitude:number,//海拔
	bearing:number,// 方向
};

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS