实景AR导航
实景AR导航,步行导航,根据地图接口获取步行导航线路,通过摄像头叠加方向箭头和距离信息实现AR步行导航,支持AI导游语音对话、3D小地图等交互。AR导航比较消耗手机电量,建议只用于短距离步行导航。
提示:个人认证的小程序引用的插件appId为:wx308518c879eedfeb(插件地址);企业认证的小程序引用的插件appId为:wx0b07b21a83347243(插件地址)。如需通过浏览器Web端调用,请联系我们:13916302767。
功能图例
- 步行箭头方向
- 显示步行距离
- 在目标方向显示名称提示及直线距离
- 设置除目标外的其他地点,显示名字及直线距离
- 小地图上自定义覆盖图片
- 拼接使用导航路径和自定义内部线路
- 显示数字人交互(旗舰版)
- AI导游(旗舰版)
- AI图像识别交互(旗舰版)
- 3d版小地图(旗舰版)
数据可视化
使用数据可视化展示:地图、热力图、调用导航数据及趋势、动态显示客流飞线等,支持生成公开外链展示,开通后使用链接:https://webar.mixwechat.com/insights/[您的小程序appid]
实际体验
微信扫下方小程序码,点击"实景AR导航"按钮
体验页面展示基本功能并可调整部分配置项,完整配置项请参考使用方式介绍
使用准备
- 1. 需要使用地址服务,申请地图key(腾讯地图 或 高德地图 二选一):
1.1 腾讯地图:https://lbs.qq.com/service/webService/webServiceGuide/webServiceOverview
1.2 高德地图:https://lbs.amap.com/api/wx/gettingstarted
1.3 使用插件默认路径服务(非商用路径服务),则不用配置地图key,可用性不如腾讯地图和高德地图,小规模使用可尝试。 - 2. 小程序管理后台,「管理」-「开发管理」-「接口设置」- 「地理位置」申请如下接口权限:wx.onLocationChange、wx.startLocationUpdate、wx.getLocation。(接口wx.onLocationChange和wx.startLocationUpdate配合使用,省电但是准确度不高。接口wx.getLocation单独使用,准确度高但是更耗电。都有权限时插件优先用前2个接口。)
- 3. 微信小程序需要开启定位和摄像头的权限,在您的小程序app.json中配置:
"permission": {
"scope.userLocation": {
"desc": "用于地址导航定位"
},
"scope.camera": {
"desc": "用于AR实景导航"
},
"scope.record": {
"desc": "用于AI导游语音对话"
}
}使用方式
首先引用本插件,在您的小程序app.json中引入:
"plugins": {
"ar-walking-navigation": {
"version": "latest", // 请使用线上最新版本号,本插件发布新版本时会开启极速发布,可免审核小程序快速更新插件版本;同时也建议直接填写“latest”以自动获取最新版插件
"provider": "wx0b07b21a83347243", // 提示:个人认证的小程序引用的插件appId为:wx308518c879eedfeb;企业认证的小程序引用的插件appId为:wx0b07b21a83347243
"export": "libs/export.js(小程序内自定义文件)" // [可选] 抛出可以给插件内调用的方法,其他地点的配置action为'outerFunction'时使用
},
"WechatSI": { // 微信官方「微信同声传译」插件,播放语音时更流畅 [可选,启用AI导游功能时必选,使用时需要先在第三方设置中添加该插件。该插件有配额限制,可参见插件官方文档:https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx069ba97219f66d99]
"version": "latest",
"provider": "wx069ba97219f66d99"
}
}跳转至导航页面,目的地需要在配置范围内(默认3公里,可以配置成1至10公里范围),配置方法及参数说明如下:
(也可在管理端设置配置项,方便随时动态调整配置项,可免params参数的配置;针对需要动态设置的部分可在params参数中配置,会覆盖管理端的配置项)
wx.navigateTo({
url: 'plugin://ar-walking-navigation/ar-page?params=' + encodeURIComponent(JSON.stringify({
name: '测试目的地', // 配置目的地名字[可选]
location: { // [可选, 若未配置,则moreLocations或groups需要配置]
longitude: 121.27693, // 目的地经度
latitude: 31.319695 // 目的地纬度
},
icon: 'https://.../testicon.png', // 目的地图标[可选]
iconWidth: 90, // 目的地图标宽度[可选,单位rpx,默认90rpx]
iconHeight: 124, // 目的地图标高度[可选,单位rpx,默认124rpx]
iconPosition: 'top', // 目的地图标位置,top:标签上方,bottom:标签下方,left:标签左侧,right:标签右侧,[默认top]
desc: '目的地的详细介绍文字', // 详细描述[可选,点击地点弹窗中展示]
images: ['https://.../photo1.jpg', 'https://.../photo2.jpg'], // 地点图片列表[可选,可多图,点击地点弹窗中轮播展示]
// 下面4个获取地图路径api配置只需选一个,优先使用顺序:tencentMapApi > aMapApi > tencentMapKey > aMapKey [不配置则使用插件提供的步行线路api,可用性不及高德地图和腾讯地图]
tencentMapKey: '...', // 腾讯地址服务申请的地图key [可选]
tencentMapApi: 'https://...', // 腾讯地图API转发url,转发腾讯地图api,地图key由提供的api转发url在服务器配置 [可选,以nginx为例配置转发见下方"nginx代理api配置示例"部分]
aMapKey: '...', // 高德地址服务申请的地图key [可选]
aMapApi: 'https://...', // 高德地图API转发url,转发高德地图api,地图key由提供的api转发url在服务器配置 [可选,以nginx为例配置转发见下方"nginx代理api配置示例"部分]
// ===========================================================
// 提示:有前面的主要配置项即可开启AR导航,后面的配置项都是可选配置!
// ===========================================================
// 下列为控制配置:
useGetLocation: false, // 定位方式是否强制使用wx.getLocation接口,准确度更高但是更耗电 [可选]
gpsTip: { // GPS 精度提示:accuracy 是定位误差半径(米),不是真实偏移量,只能提示"精度约 ±X 米",用来说明位置/距离可能偏移
show: false, // 是否显示[默认false]
accuracy: 5, // 提示阈值,默认 5 米,可填 1~100
},
audioTip: true, // 是否使用语音提示,包括:向左、向右、到达目的地、偏离导航路径、刷新路径、提示语音、按键反馈声音等 [可选,默认true]
labelName: true, // 是否在目的地标签上显示目标名称,[可选,默认true]
labelDistance: true, // 是否在目的地标签上显示目标直线距离,[可选,默认true]
labelDistanceFormat: '直线距离{distance}米', // 距离提示文字格式,[可选,默认 '直线距离{distance}米',其中{distance}会被实际距离替换]
turnVibrate: true, // 转弯时,是否振动提示,默认:true
framesPerSecond: 10, // 画面每秒渲染帧数配置,范围 1-60,值越大画面越流畅但更耗电甚至导致小程序闪崩,需根据实际需求配置 [可选,默认值10]
maxDistance: 3, // 公里范围限制配置,范围限制在1-10公里(千米),超过配置的范围提示AR导航不可用 [可选,默认值3]
showDistance: 3, // 显示点位距离配置,单位千米,[可选,默认值3](与maxDistance保持一致,但没有最大范围限制)
testLocation: { // 测试点位配置 [可选,仅用于测试,模拟用户在设定的位置使用AR导航]
location: {
longitude: 121.27693, // 经度
latitude: 31.319695 // 纬度
},
enable: false // 是否启用测试点位
},
reachDistance: 10, // 距离目的地多少米算已经到达,配置范围:1-100米 [可选,默认值10米]
turnTipDistance: 10, // 距离转弯处多少米内箭头朝将要拐弯的方向偏转,配置范围:0-100米 [可选,默认值10米]
turnDistance: 5, // 靠近转弯前多少距离时直接算进入下一段路径,定位有偏差,设置提前量,配置范围:1-100米[可选,默认值5米]
// 下列为交互事件配置:
action: ['switch', 'redirectTo', 'outerFunction', 'audio', 'tel', 'cancel'], // 主目的地的点击事件[可选],switch(点击切换为新目的地)可以不添加,会自动添加;可配置数组形式多个事件,需点击标签后显示多个事件按钮,点击事件按钮触发事件后再次隐藏;若只配置了一个事件,则点击目的地标签后直接触发配置的事件,不弹出事件按钮;除去switch和cancel的事件可以配置多个,如需配置多个则对应的配置需配置为相同长度的数组,例如:redirectToLabel和redirectToPath都是3个数据的数组,分别对应3个跳转
// switch事件(切换目的地)相关配置:
switchLabel: '前往', // 切换目的地按钮提示文字[可选,默认:"前往"]
// redirectTo事件(跳转页面)相关配置:
redirectToLabel: '跳转', // 跳转页面提示文字[可选,默认:"跳转"]
redirectToPath: 'redirectTo:/pages/index/index', // action为redirectTo时宿主小程序的路径(冒号前面的内容为使用的路由方式,可以不写,默认是redirectTo)
// outerFunction事件(调用宿主函数)相关配置:
outerFunctionLabel: '执行', // 调用宿主函数提示文字[可选,默认:"执行"]
outerFunction: '...', // 宿主函数的名字 需要是引入插件时抛出的文件里的函数
// audio事件(播放介绍语音)相关配置:
audioLabel: '介绍', // 介绍语音提示文字[可选,默认:"介绍"]
audio: "https://.../test.mp3", // 介绍语音https网络地址
// tel事件(拨打电话)相关配置:
telLabel: '电话', // 拨打电话提示文字[可选,默认:"电话"]
tel: "13xxxxxxxxx", // 拨打的电话配置
// cancel事件(关闭事件按钮,一般不单独使用,只是关闭显示的事件按钮)相关配置:
cancelLabel: '取消', // 取消提示文字[可选]
reachAction: { // 到达目的地时回调事件配置[可选],类型可参考前面action的类型与配套属性配置,因为是直接调用所以不用配置Label,也不用cancel和tel这些事件;如果某类事件配置了数组只执行第一个
// 跳转页面
action: 'redirectTo', // 支持跳转路由,需要同时配置redirectToPath[可选]
redirectToPath: 'redirectTo:/pages/index/index', // action为redirectTo时宿主小程序的路径(冒号前面的内容为使用的路由方式,可以不写,默认是redirectTo)
// 或调用宿主自定义函数、或播放介绍语音、或切换目的地,也可同时配置多个类型
// action: 'outerFunction', // 支持调用宿主函数,宿主函数内不可使用页面跳转方法,若要跳转页面用前面一个例子的方法,需要同时配置宿主函数名outerFunctions[可选]
// outerFunction: '...', // 宿主函数的名字 需要是引入插件时抛出的文件里的函数
// action: 'audio', // 播放介绍语音[可选]
// audio: "https://.../test.mp3", // 介绍语音https网络地址
// action: 'switch', // 切换目的地[可选],插件支持到达目的地后再切换目的地,但是需要配置全目的地信息,且不是很合理可能会造成混乱
// name: '其他地点' // action为switch时目的地名字
// location: { // action为switch时目的地经纬度
// longitude: 121.27993,
// latitude: 31.319895,
// },
// action: 'video', // 播放介绍视频[可选]
// video: "https://.../test.mp4", // 介绍视频https网络地址
waitTime: 3 // 到达目的地后调用回调事件前的等待时间[可选,单位秒]
},
backBtnPath: 'redirectTo:/pages/index/index', // 返回按钮 配置路由方式和路由页面地址 [可选,默认返回上一页。冒号前面的内容为使用的路由方式,可以不写,默认是redirectTo]
// 下列为提示引导配置:
loadingTip: {
// 加载动画(地球视角推进至目的地位置的开场动画)
show: true, // 是否显示 [默认true]
time: 4, // 动画时长,范围:1 - 60 [单位秒,默认4秒]
},
enterTip: { // 进入导航提示信息
show: false, // 是否显示提示信息 [默认false]
image: 'https://.../test-tip.png', // 提示信息图片
audio: 'https://.../test-audio.mp3', // 提示语音
countText: '我知道了', // 倒计时按钮文字
countTime: 5, // 倒计时时间,范围:1 - 60 [单位秒,默认5秒]
scanShow: false, // 是否显示扫描识别提示 [默认false]
scanTime: 3, // 扫描并提示保持手机稳定最短时长,范围:1 - 60 [单位秒,默认3秒]
scanText: '正在识别中\n请保持手机稳定', // 提示保持手机稳定文字
},
liftTip: { // 抬起手机提示,手机放平时是否提示抬起手机
show: false, // 是否显示提示,默认:false
minBeta: 40, // 如果显示提示,则手机放平低于多少度时显示提示,默认:40度
tipText: '抬起手机对准道路', // 提示文案
},
tipImages: [{ // 自定义提示图片,导航过程中一直显示,可以是gif,jpg,png等小程序支持的图片类型,可以配置多个图片(可选)
idle: 'https://.../testidle.gif', // 静止状态显示图片地址
talk: 'https://.../testtalk.gif', // 说话状态显示图片地址
position: 'bottom', // 图片位置 在屏幕上位置: center(中间)、left(左边)、right(右边)、top(上面)、bottom(下面)、left-bottom(左下角)、left-top(左上角)、right-bottom(右下角)、right-top(右上角)、arrow(跟随指示箭头)
offsetRight: 0, // 位置往右偏移量,单位rpx
offsetTop: 0, // 位置往上偏移量,单位rpx
width: 400, // 假设屏幕宽度为750,所得图片的宽度
height: 400, // 假设屏幕宽度为750,所得图片的高度
hideWhenMapShow: true, // 小地图显示时是否隐藏提示图片
}],
// 下列为UI主题配置:
theme: 'default', // UI风格主题 [目前可选配置: default、default_2、default_3,默认:default]
themeConfig: { // UI风格元素的细节配置,theme是整体风格选择,themeConfig可配置具体细节覆盖theme的默认值 [可选,配置项完善中]
arrow: { // 前方箭头[可选]
show: true, // 是否显示[默认true]
type: "default", // 箭头类型: default(默认导航箭头), magic(常显3D箭头)
color: '#387ef4', // 箭头颜色,可以是字符串(单颜色),或者数组(箭头交替使用数组中颜色)
scale: 1, // 箭头大小比例
shadow: true, // 是否在地面显示箭头阴影 [默认true]
turnArrow: false, // 是否在靠近转弯前时在前方叠加指向拐弯方向的箭头 [默认false]
turnArrowDistance: 20, // 靠近转弯前多少距离时在前方叠加指向拐弯方向的箭头[单位米,默认20]
turnArrowType: 'floor', // 叠加指向拐弯方向的箭头形式:floor(贴地)、wall(垂直于地面)
tipFollow: false, // 直行、转弯等文字提示是否跟随箭头,[默认false,手机居中显示]
tipRoad: false, // 下一段带road时显示带道路名箭头
tipRoadDistance: 20, // 距离下一段道路有道路名的路径多远时显示带道路名箭头
tipRoadOnly: false, // 叠加指向道路箭头时,是否不显示向前的指向箭头,tipRoad为true时有效,[默认false]
},
textArrow: { // 箭头左侧距离文字提示[可选]
show: true, // 是否显示[默认true]
color: '#387ef4', // 文字颜色
fontWeight: 'bold', // 字体粗细 粗体:bold、正常:normal、细体:lighter
fontSizeScale: 1, // 文字大小缩放比例 [默认1,不缩放]
fontThickScale: 1, // 文字厚度缩放比例 [默认1,不缩放]
type: '3d', // 文字类型:3d(默认)、plane(平面)
arrowCount: 3, // 文字右侧箭头字符">"的数量 [限定个数:0-5,默认3]
effect: 'light', // 文字动态效果,可选项:none(无效果),light(扫光效果,默认值)
shadow: true, // 是否在地面显示文字阴影 [默认true]
},
rightArrow: { // 右侧箭头[可选]
show: true, // 是否显示[默认true]
color: '#ffffff', // 箭头颜色
// effect: 'none', // 'flow'(默认,循环高亮向前移动) / 'none'(无高亮移动效果)
borderColor: "#ffeb3d", // 描边颜色
},
targetObject: { // 代表目标的3d标记[可选]
show: true, // 是否显示[默认true]
color: '#387ef4', // 默认目标3d标记的颜色
model: '', // 自行配置的模型,[可选,默认没有,配置后color无效]
modelScale: 1, // 模型尺寸缩放
effect: "none", // 动态效果,可选项:none(无效果,默认值),light(动感光波)
scale: 1, // 标记缩放比例
shadow: true, // 是否在地面显示目标物阴影 [默认true]
},
group: { // 分组样式配置[可选]
arrow: { // 指示箭头配置
show: true, // 是否显示[默认true]
color: '#387ef4', // 箭头颜色
scale: 1, // 箭头大小比例
shadow: true, // 是否在地面显示箭头阴影 [默认true]
}
}
},
// 下列为地图显示配置:
mapConfig: { // 地图细节配置 [可选]
showMap: true, // 是否默认显示地图
showTip: true, // 是否显示地图上方的提示文字和控制按钮
enableRotate: true, // 地图是否跟随用户方向旋转
autoCenter: false, // 拖动后是否自动将用户位置置于地图中心,默认:false
centerBtn: true, // 将用户位置置于地图中心按钮,地图拖动后显示,默认:true
labelName: true, // 是否在小地图的目的地标签上显示目标名称
iconScaleWidth: 1, // 小图标宽度缩放比例,默认:1
iconScaleHeight: 1, // 小图标高度缩放比例,默认:1
scale: 16, // 地图初始缩放级别
skew: 0, // 地图倾斜角度,范围 0 ~ 40 , 关于 z 轴的倾角[可选,默认:0]
lineColor: '#387ef4e6', // 路线颜色,[可选,默认:#387ef4e6]
passedLineColor: '#999999', // 已经走完了的路线颜色,[可选,默认:#999999]
dottedLineColor: '#cf5915e6', // 偏离路线时指向导航路线的指示路线颜色,[可选,默认:#cf5915e6]
markerCustom: { // marker自定义样式配置(参考小程序地图组件配置,rotate、alpha、callout、label、anchor,其中带content的都替换为位置的name,可选)
callout: { // 除了content取地点的name值,其他的按文档说明配置
// show: true, // 是否显示,前值条件labelName为true才显示
// color: '',
// fontSize: '',
// ...
},
// label: { // 除了content取地点的name值,其他的按文档说明配置
// show: false, // 是否显示,前值条件labelName为true才显示
// // ...
// },
// rotate: 0,
// alpha: 1,
// collisionRelation: '',
// collision: '',
},
roadNetwork: "https://.../your_road_network.json", // 本地路网数据(增强版 customRoutes,不依赖第三方地址服务,旗舰版功能)
},
groundOverlay: [ // 地图覆盖图片[可选,可配置多张]
{
src: 'https://.../mapCover.png', // 支持https网络图片
bounds: {
// 图片左下角对应经纬度
southwest: {
longitude: "121.271945",
latitude: "31.318674",
},
// 图片右上角对应经纬度
northeast: {
longitude: "121.279262",
latitude: "31.321347",
},
},
visible: true, // 是否可见
zIndex: 1, // 图层绘制顺序
opacity: 1, // 图层透明度
},
],
// 下列为附加内容配置,配置导航中显示的其他地点和自定义线路:
moreLocations: [ // 设置除目标外的其他地点,显示名字及直线距离 [可选]
{
name: '其他地点1',
location: {
longitude: 119.476327,
latitude: 31.400476,
// 电子围栏:选中该点位后在3D地图和AR空间显示多边形范围框
fence: [
{ longitude: 119.476155, latitude: 31.400916 },
{ longitude: 119.476882, latitude: 31.400748 },
{ longitude: 119.476652, latitude: 31.399823 },
{ longitude: 119.476115, latitude: 31.400088 },
{ longitude: 119.475954, latitude: 31.400132 },
{ longitude: 119.47606, latitude: 31.400693 },
],
fenceReached: true, // 是否进入电子围栏内就判断为到达目的地
},
icon: 'https://.../testicon.png', // 目的地图标[可选]
iconWidth: 90, // 目的地图标宽度[可选,单位rpx,默认90rpx]
iconHeight: 124, // 目的地图标高度[可选,单位rpx,默认124rpx]
iconPosition: 'top', // 目的地图标位置,top:标签上方,bottom:标签下方,left:标签左侧,right:标签右侧,[默认top]
desc: '地点的详细介绍文字', // 详细描述[可选,点击地点弹窗中展示]
images: ['https://.../photo1.jpg', 'https://.../photo2.jpg'], // 地点图片列表[可选,可多图,点击地点弹窗中轮播展示]
showDistance: 100, // 显示地点标签的距离(米)[可选,默认不限制距离]
action: 'switch', // 支持点击切换为新目的地[可选]
switchLabel: '前往', // 切换提示文字[可选,默认:"前往"]
type: 'scenic', // POI 图标类型(parking/toilet/restaurant/scenic/shop/hospital/bus 或自定义 {image,name,color,bg})3d地图中显示,配置icon时则在3d地图中复用icon。
showIn: ['map'], // 控制显示场景 ['ar', 'map'] ar: AR 空间显示 map: 2D/3D 地图显示,不配默认全显示
},
{
name: '其他地点2',
location: {
longitude: 121.27993,
latitude: 31.319895
},
action: 'redirectTo', // 支持点击跳转路由,需要同时配置redirectToPath[可选]
redirectToLabel: '跳转', // 跳转提示文字[可选,默认:"跳转"]
redirectToPath: 'redirectTo:/pages/index/index' // action为redirectTo时宿主小程序的路径(冒号前面的内容为使用的路由方式,可以不写,默认是redirectTo)
},
{
name: '其他地点3',
location: { // 相同位置提示文字会挤压显示(相同的位置也不能太多了)
longitude: 121.27993,
latitude: 31.319895
},
showDistance: 100, // 显示地点标签的距离(米)[可选,默认不限制距离]
action: 'outerFunction', // 支持点击调用宿主函数,宿主函数内不可使用页面跳转方法,若要跳转页面用前面一个例子的方法,需要同时配置宿主函数名outerFunctions[可选]
outerFunctionLabel: '执行', // 调用宿主函数提示文字[可选,默认:"执行"]
outerFunction: '...' // 宿主函数的名字 需要是引入插件时抛出的文件里的函数
},
{
name: '其他地点4',
location: {
longitude: 121.27993,
latitude: 31.319895
},
showDistance: 100, // 显示地点标签的距离(米)[可选,默认不限制距离]
action: "audio", // 提示存在介绍语音,点击语音图标时播放audio配置的语音,主动点击的语音介绍忽略是否使用语音提示的配置[可选]
audioLabel: '介绍', // 介绍语音提示文字[可选,默认:"介绍"]
audio: "https://.../test.mp3", // 介绍语音https网络地址
// 提示语音并非action为audio时才有用,没有action配置也可以设置提示语音
tipAudio: "https://.../test2.mp3", // 在距离地点指定距离时,播放的提示语音https网络地址 [可选]
tipAudioPlayDistance: 20, // 播放提示语音的距离,单位米 [可选,默认20米]
tipAudioPlayGap: 10 // 当前提示语音播放后多久内禁止重复播放,单位分钟 [可选,默认10分钟]
},
{
name: "其他地点5",
location: {
longitude: 121.27993,
latitude: 31.319895,
},
action: ["audio", 'switch'], // action通过数组形式来支持配置多种类型,audio和switch功能与前面的对应配置功能一致
audioLabel: '介绍', // 介绍语音提示文字[可选,默认:"介绍"]
audio: "https://.../test.mp3", // 介绍语音https网络地址
switchLabel: '前往' // 切换提示文字[可选,默认:"前往"]
},
{
name: "其他地点6",
location: {
longitude: 121.27993,
latitude: 31.319895,
},
action: 'tel', // 支持点击调起电话拨打界面
telLabel: '电话', // 拨打电话提示文字[可选,默认:"电话"]
tel: "13xxxxxxxxx", // 拨打的电话配置
},
],
// 点位分组显示,只显示所选分组中的点位,可返回重选分组;与moreLocations互斥,配置了groups时,moreLocations无效
groups: [ // 分组点位数据 [可选]
{
name: "景区", // 最长4个字
icon: "https://.../scenes.png", // 分组图标
iconActive:
"https://.../scenes.active.png", // 选中分组图标
points: [ // 分组地点配置,与moreLocations列表中配置使用方式一致
{
name: "景区A",
location: {
longitude: 121.28093,
latitude: 31.322695,
},
icon: 'https://.../testicon.png', // 目的地图标[可选]
iconWidth: 90, // 目的地图标宽度[可选,单位rpx,默认90rpx]
iconHeight: 124, // 目的地图标高度[可选,单位rpx,默认124rpx]
iconPosition: 'top', // 目的地图标位置,top:标签上方,bottom:标签下方,left:标签左侧,right:标签右侧,[默认top]
desc: '地点的详细介绍文字', // 详细描述[可选,点击地点弹窗中展示]
images: ['https://.../photo1.jpg', 'https://.../photo2.jpg'], // 地点图片列表[可选,可多图,点击地点弹窗中轮播展示]
showDistance: 100, // 显示地点标签的距离(米)[可选,默认不限制距离]
action: 'switch', // 支持点击切换为新目的地[可选]
switchLabel: '前往', // 切换提示文字[可选,默认:"前往"]
type: 'scenic', // 3D 地图 POI 类型 与moreLocations中使用方式一致
showIn: ['ar', 'map'], // 控制显示场景 与moreLocations中使用方式一致
},
],
},
{
name: "餐饮",
icon: "https://.../food.png",
iconActive:
"https://.../food.active.png",
points: [ // 分组地点配置,与moreLocations列表中配置使用方式一致
{
name: "餐饮A", // 地点名字
location: {
longitude: 121.27693,
latitude: 31.319695,
},
icon: "https://.../food.png",
},
{
name: "餐饮B",
location: {
longitude: 121.27893,
latitude: 31.320695,
},
},
],
},
],
currentGroupIndex: 0, // 默认选中的分组索引,[可选,默认:0]
customRoutes: { // 自定义线路[可选],用于第三方导航路径导航不到的地方或新建设的地方
type: 'combine', // 线路类型 only: 仅支持配置的线路; combine: 拼接使用第三方导航路径和自定义线路
routes: [ // 可配置多条线路 仅显示终点与目的地的配置一致且总体线路最短的一条线路
{
color: '#ff000099', // 线路颜色[可选]
locations: [
{ // 线路起点
longitude: 121.27507, // 起点经度
latitude: 31.320072 // 起点纬度
},
{ // 中间转弯处点位,任意配置
longitude: 121.274408,
latitude: 31.319089
},
{ // 中间转弯处点位
longitude: 121.275985,
latitude: 31.318593
},
{ // 线路终点
longitude: 121.27693, // 目的地经度
latitude: 31.319695 // 目的地纬度
}
]
},
{
color: '#ffff0099', // 线路颜色[可选]
locations: [
{ // 线路起点
longitude: 121.274121, // 起点经度
latitude: 31.321644 // 起点纬度
},
{ // 中间转弯处点位,任意配置
longitude: 121.274203,
latitude: 31.322263
},
{ // 线路终点
longitude: 121.27693, // 目的地经度
latitude: 31.319695 // 目的地纬度
}
]
}
]
},
}))
});Nginx 代理 api 配置示例:
server {
listen 443 ssl;
server_name [您的域名];
#...其他配置
# Web服务API代理腾讯地图API,location后名字任意,按示例配置则导航中tencentMapApi配置为:https://[您的域名]/tencentMapApi
location /tencentMapApi/ {
set $args "$args&key=[您的腾讯地图API key]";
proxy_pass https://apis.map.qq.com/;
proxy_set_header Host apis.map.qq.com; # 强制设置Host头
}
# Web服务API代理高德地图API,location后名字任意,按示例配置则导航中aMapApi配置为:https://[您的域名]/aMapApi
location /aMapApi/ {
set $args "$args&key=[您的高德地图API key]";
proxy_pass https://restapi.amap.com/;
}
}旗舰版专有配置参数说明如下:
wx.navigateTo({
url: 'plugin://ar-walking-navigation/ar-page?params=' + encodeURIComponent(JSON.stringify({
// 下列为旗舰功能配置:
// 客流热力图,旗舰版功能配置
heatmap: {
enable: true, // 是否开启客流热力图
source: 'internal', // 数据源:internal=按平台已有导航数据汇总,custom=第三方数据接口
hours: 24, // internal数据源:按最近N小时的导航数据汇总,范围1-720,[默认24]
url: 'https://.../your_heatmap.json', // custom数据源:第三方数据接口地址,返回格式见下方"客流热力图第三方数据接口格式"说明
radius: 40, // 热力点半径,单位米,[默认40]
opacity: 0.6, // 热力层不透明度,范围0-1,[默认0.6]
},
// 配置3d小地图模型,旗舰版功能配置
map3dConfig: {
show: false, // 启用3d小地图
mapModel: "https://.../your_3dmap.glb", // 3d地图模型
heightMap: "https://.../your_heightMap.json", // 3d地图模型对应的地形高度图
leftTopLocation: { // 3d地图模型左上角经纬度及对应坐标位置
longitude: 119.463956, // 3d地图模型左上角经纬度
latitude: 31.405158,
x: -103.5, // 3d地图模型左上角位置x、y轴的数值
y: 125,
},
rightBottomLocation: { // 3d地图模型右下角经纬度及对应坐标位置
longitude: 119.478315, // 3d地图模型右下角经纬度
latitude: 31.390284,
x: 103.5, // 3d地图模型右下角位置x、y轴的数值
y: -125,
},
},
// 放置数字人3d模型,旗舰版功能配置
models: [
{
// 模型放置模式,left:指示箭头左侧,center:指示箭头前方,right:指示箭头右侧,location:固定坐标位置
type: 'left',
// 数字人模型地址,可以是自定义模型的https网络地址(自定义模型不要DRACO压缩,否则无法加载),也可选插件默认形象(默认形象有:man1、man2、man3、woman1、woman2、woman3、robot1、robot2、robot3、animal1、animal2、animal3、default_1、default_2等)
model: 'default_1',
speaker: true, // 设置根据AI对话状态执行相应动画的数字人
gender: "female", // 数字人语音性别:male(男声,默认)/female(女声),影响AI对话发音
location: { // 模型固定放置在某个坐标位置(仅type为location时候有效)
longitude: 121.28043,
latitude: 31.325665,
showDistance: 100, // 用户距离该位置多少米时显示模型
},
scale: 4, // 模型尺寸缩放
rotate: 0, // 旋转角度,坐标位置定位时相对北方;跟随指示箭头附近时相对箭头反方向(面向镜头方向)
animations: { // 模型动画名称匹配
forward: 'BackCharge', // 向前进
beckon: ['Waving', 'Dance1', 'Dance2'], // 打招呼,数组类型随机选其中一个
idle: 'Idle', // 空闲
looking: 'Looking', // 查看寻找
dance: ['Dance1', 'Dance2'], // 跳舞,数组类型随机选其中一个
listening: "Listening", // AI对话时,正在听
thinking: "Thinking", // AI对话时,在思考
talking: "Talking" // AI对话时,在说话
}
}
],
// AI识别交互,旗舰版功能配置
markers: {
navCoexist: true, // AI识别是否与导航同时存在,不用通过按钮切换模式,安卓暂不支持
tips: { // 存在AI识别物提示
startText: "AI识别开启", // 存在AI识别物,提示点击开始识别的文字,[默认:AI识别]
stopText: "关闭AI识别", // 退出AI识别提示文字,[默认:返回导航]
targetReachText: "搜寻一下", // 到达目的地有AI识别的提示文字,[默认:附近有AI可识别物!]
coexistText: "前方有可识别展品", // 自定义共存提示文案
},
list: [
{
type: "target", // 识别类型, target:到达目的地附近,识别相关图像,location:导航途中识别相关图像,在位置附近时提示有AI识别物,用户点击切换开始AI识别或返回AR导航
marker: "https://.../...png", // 识别图像 识别图要小点 宽小于500px 辨别性高的景物图像
size: {
// 配置识别图的实际宽高,单位米(参考单位,不精准,可开启图像遮罩实际调试)
width: 1.5,
height: .5,
},
cover: {
// 识别图像遮罩配置(显示遮罩后可方便设置识别宽高值,识别物宽高值是后续交互位置设置的基础)
show: true, // 是否显示
color: "#ff00ff", // 遮罩颜色
opacity: 0.5, // 识别图像遮罩透明度
},
actions: [
// 识别后交互形式,info:显示点位信息形式, model:3d模型交互形式,等
{
type: "info", // 点位信息形式 通过info配置项暂时可配置1-3行:text1、text2、text3
position: "left", // 信息相对标识物位置: center(中间)、left(左边)、right(右边)、top(上面)、bottom(下面)、left-bottom(左下角)、left-top(左上角)、right-bottom(右下角)、right-top(右上角)
info: {
// 点位信息配置
text1: "欢迎光临",
text2: "联系电话: 13916302767",
text3: "周一至周五 上午9:00 - 12:00 下午14:00 - 17:00",
},
scale: 1, // 信息尺寸缩放
rotate: {
x: Math.PI / 4, // 旋转角度,相对识别物横向轴
y: 0, // 旋转角度,相对识别物纵向轴
z: 0, // 旋转角度,相对识别物前方(面向镜头方向)
},
offset: {
// 偏移量 单位米(参考单位,不精准,需实际调试)
x: .1, // 左右方向偏移,正数向右,负数向左
y: .1, // 上下方向偏移,正数向上,负数向下
z: .1, // 前后方向偏移,正数向前,负数向后
},
},
{
type: "model", // 3d模型交互形式 参考数字人3d模型配置项
position: "left-bottom",
model: "default_1",
animations: {
// 模型动画名称匹配
talk: "Talking", // 说话
beckon: ["Waving", "Dance1", "Dance2"], // 打招呼,数组类型随机选其中一个
idle: "Idle", // 空闲
dance: ["Dance1", "Dance2"], // 跳舞,数组类型随机选其中一个
},
scale: .5, // 模型尺寸缩放
rotate: {
x: 0, // 旋转角度,相对识别物横向轴
y: Math.PI / 4, // 旋转角度,相对识别物纵向轴
z: 0, // 旋转角度,相对识别物前方(面向镜头方向)
},
offset: {
// 偏移量 单位米(参考单位,不精准,需实际调试)
x: 0, // 左右方向偏移,正数向右,负数向左
y: -1.2, // 上下方向偏移,正数向上,负数向下
z: .05, // 前后方向偏移,正数向前,负数向后
},
},
{
type: "audio", // 播放音频,与clickActions里的audio区别是这里直接执行不需要点击触发
audio: "https://.../test.mp3", // 音频地址
},
{
type: "outerFunction", // 调用宿主函数,与clickActions里的outerFunction区别是这里直接执行不需要点击触发
outerFunction: 'outerFn', // 宿主函数的名字 需要是引入插件时抛出的文件里的函数
},
{
type: "video", // 播放视频,与clickActions里的video区别是这里直接执行不需要点击触发
playMode: "ar", // 播放模式,ar:视频贴附在 AR 空间识别物之上(默认);popup:全屏弹窗
replay: true, // 重新识别到识别物时是否重新播放(默认 true,与文字显示行为一致;false=播一次后不再播)
video: "https://.../test.mp4", // 视频地址
size: { // 视频的宽高,单位米(参考单位,不精准,未配置时默认与识别图配置的宽高一致)
width: 1.5,
height: .5,
},
scale: 1, // 视频尺寸缩放
},
],
clickActions: { // 点击事件,配置方式与点位事件一致,除了没有switch [可选]
action: ['redirectTo', 'outerFunction', 'audio', 'tel', 'cancel'] // 主目的地的点击事件[可选],可配置数组形式多个事件,需点击标签后显示多个事件按钮,点击事件按钮触发事件后再次隐藏;若只配置了一个事件,则点击目的地标签后直接触发配置的事件,不弹出事件按钮;除去switch和cancel的事件可以配置多个,如需配置多个则对应的配置需配置为相同长度的数组,例如:redirectToLabel和redirectToPath都是3个数据的数组,分别对应3个跳转
// redirectTo事件(跳转页面)相关配置:
redirectToLabel: '跳转', // 跳转页面提示文字[可选,默认:"跳转"]
redirectToPath: 'redirectTo:/pages/index/index', // action为redirectTo时宿主小程序的路径(冒号前面的内容为使用的路由方式,可以不写,默认是redirectTo)
// outerFunction事件(调用宿主函数)相关配置:
outerFunctionLabel: '执行', // 调用宿主函数提示文字[可选,默认:"执行"]
outerFunction: '...', // 宿主函数的名字 需要是引入插件时抛出的文件里的函数
// audio事件(播放介绍语音)相关配置:
audioLabel: '介绍', // 介绍语音提示文字[可选,默认:"介绍"]
audio: "https://.../test.mp3", // 介绍语音https网络地址
// tel事件(拨打电话)相关配置:
telLabel: '电话', // 拨打电话提示文字[可选,默认:"电话"]
tel: "13xxxxxxxxx", // 拨打的电话配置
// cancel事件(关闭事件按钮,一般不单独使用,只是关闭显示的事件按钮)相关配置:
cancelLabel: '取消', // 取消提示文字[可选]
}
},
{
type: "location", // 识别类型, target:到达目的地附近,识别相关图像,location:导航途中识别相关图像,在位置附近时提示有AI识别物,用户点击切换开始AI识别或返回AR导航
marker: "https://.../...jpg", // 识别图像 识别图要小点 宽小于500px 辨别性高的景物图像
size: {
// 配置识别图的实际宽高,单位米
width: 1.5,
height: .3,
},
cover: {
// 识别图像遮罩配置(显示遮罩后可方便设置识别宽高值,识别物宽高值是后续交互位置设置的基础)
show: true, // 是否显示
color: "#ffffff", // 遮罩颜色
opacity: 0.3, // 识别图像遮罩透明度
},
location: {
// 提示AI识别交互的坐标位置(仅type为location时候有效)
longitude: 121.276794,
latitude: 31.321051,
showDistance: 100, // 用户距离该位置多少米时提示存在AI识别交互,默认50米
},
actions: [
// 识别后交互形式,info:显示点位信息形式, model:3d模型交互形式,等
{
type: "info", // 点位信息形式 通过info配置项暂时可配置1-3行:text1、text2、text3
position: "left",
info: {
// 点位信息配置
text1: "欢迎光临",
text2: "联系电话: 13916302767",
text3: "工作时间: 周一至周五 9:00-12:00 / 14:00-17:00",
},
scale: 1, // 信息尺寸缩放
rotate: {
x: 0, // 旋转角度,相对识别物横向轴
y: 0, // 旋转角度,相对识别物纵向轴
z: 0, // 旋转角度,相对识别物前方(面向镜头方向)
},
offset: {
// 偏移量 单位米(参考单位,不精准,需实际调试)
x: .06, // 左右方向偏移,正数向右,负数向左
y: -.05, // 上下方向偏移,正数向上,负数向下
z: 0, // 前后方向偏移,正数向前,负数向后
},
},
{
type: "model", // 3d模型交互形式 参考数字人3d模型配置项
position: "bottom",
model: "default_1",
animations: {
// 模型动画名称匹配
talk: "Talking", // 说话
beckon: ["Waving", "Dance1", "Dance2"], // 打招呼,数组类型随机选其中一个
idle: "Idle", // 空闲
dance: ["Dance1", "Dance2"], // 跳舞,数组类型随机选其中一个
},
scale: .5, // 模型尺寸缩放
rotate: {
x: 0, // 旋转角度,相对识别物横向轴
y: Math.PI / 8, // 旋转角度,相对识别物纵向轴
z: 0, // 旋转角度,相对识别物前方(面向镜头方向)
},
offset: {
// 偏移量 单位米(参考单位,不精准,需实际调试)
x: -.5, // 左右方向偏移,正数向右,负数向左
y: -1.2, // 上下方向偏移,正数向上,负数向下
z: .1, // 前后方向偏移,正数向前,负数向后
},
},
],
},
],
},
}))
});- • 配置项中经纬度需要使用GCJ-02坐标(中国国家测绘局加密坐标),建议使用腾讯位置服务获取:https://lbs.qq.com/getPoint/
- • 参数整体使用encodeURIComponent方法编码,以防止有些配置如网络图片地址存在特殊字符导致JSON解析失败
- • 参数中网络资源配置如图片、音频、3d模型等应尽可能的减小尺寸和数量,以免加载文件资源过多导致小程序闪退
- • 参数中所有网络资源的域名需要添加到小程序的合法域名中(服务器域名配置官方文档)
- • 插件本身比较大,建议通过分包的方式引用 (分包加载官方文档)
客流热力图第三方数据接口格式
配置 heatmap.source 为 'custom' 时,需提供一个可公开访问的 HTTPS 数据接口(GET 请求),返回如下格式的 JSON:
{
"points": [
{ "lng": 121.5012, "lat": 31.2397, "weight": 0.7 },
{ "lng": 121.5034, "lat": 31.2402, "weight": 0.3 }
]
}- • points:热力点数组,元素包含 lng(经度)、lat(纬度)、weight(热度权重数值,插件内按返回数据中的最大值归一化到 0~1)
- • 坐标使用 GCJ-02(与配置项坐标系一致);建议单次返回点数不超过 800,插件按配置的 radius(米) 渲染贴地热力光斑
- • 接口由平台服务端代为请求(插件端不直连第三方域名,无需在小程序后台添加域名白名单),请保证接口响应在 10 秒内
- • 热力数据每 5 分钟自动刷新一次
费用说明
- 1. 基础版 1200/年 包含:100万次调用、插件更新优化免费推送、提供多个风格选择、基础版数据可视化。可免费试用1个月、1万次调用量。
- 2. 旗舰版 6666/年 包含:100万次调用、基础版所有功能、3d版小地图、AI导游、AI识别、数字人交互、3d版数据可视化、在手机Web浏览器通过H5页面调用等。3d建模根据场景复杂度另外估算。
- 3. 无忧版 16666/年 包含:300万次调用量、旗舰版所有功能、无需配置地图key由插件提供商用地图服务。
- 4. 支付及管理:https://webar.mixwechat.com
- 5. 本插件由逆行科技提供,我们会持续完善。可定制导航界面及其他AR交互功能(仅无忧版支持定制开发,评估并支付之后再进行),欢迎咨询:13916302767。
后续计划
- 1. 导航算法优化、性能优化、更多手机型号兼容性处理
- 2. 实现多个可选页面风格模板,包括页面布局、箭头形式、提示文字样式、动效等
- 3. 旗舰版(3d版小地图、AI导游、AI识别、数字人、室内导航等)功能开发、升级优化
- 4. 用户反馈的其他功能需求汇总开发
- 5. 文档更新
更新日志
0.3.18 功能更新
- 1. 针对部分机型AR会话启动失败,降级为2D地图导航
- 2. 完善不同类型的AR会话启动失败的文案提示
- 3. 旗舰版不支持AR导航机型增加复制链接通过浏览器使用AR导航
- 4. 一些细节调整
0.3.17 功能更新
- 1. 增加定位精度提示配置
- 2. 管理端配置适配移动端
- 3. 视觉特征点定位功能更新调试
- 4. 3d地图调整
- 5. 部分细节调整
0.3.16 功能更新
- 1. 地点增加详细描述和图片列表
- 2. 地图增加客流热力图展示功能
- 3. 管理端「数据」弹窗升级为数据可视化界面,支持生成公开外链
- 4. 管理端配置方式简化优化,可直接在地图上直观选点并进行配置
0.3.15 功能更新
- 1. 支持没有小程序的用户通过平台自助方式使用AR导航功能
- 2. AI识别显示视频时增加播放模式、是否循环播放等配置
- 3. 一些已知问题修复
0.3.14 功能更新
- 1. AI导游与真人协助切换问题处理
- 2. 其他体验问题修复与优化
0.3.13 功能更新
- 1. AI导游增加真人协助入口,可共享画面
- 2. 增加根据视觉特征点定位功能(需先点云建图)
- 3. 增加初始化动效,从地球视角推进至目的地位置
- 4. 代码结构整理优化,性能优化
- 5. 一些已知问题修复
0.3.12 功能更新
- 1. 导航算法优化
- 2. AR导航与AI识别共存模式优化
0.3.11 功能更新
- 1. 版本规格调整,增加无忧版
- 2. AI识别增加可与AR导航同时存在的配置,不用按钮切换
- 3. 定位失败提示优化,引导用户打开设置页
- 4. 安卓部分机型兼容性问题处理
- 5. 性能优化
- 6. 部分UI细节调整
0.3.10 功能更新
- 1. 网络请求方式更新
- 2. 语音控制逻辑及部分UI细节调整
- 3. 部分音效更新
- 4. 一些已知问题修复
0.3.9 功能及UI更新
- 1. 语音的设置与控制逻辑优化
- 2. 部分UI细节调整
0.3.8 功能更新
- 1. AI导游通过语音对话控制切换目的地
- 2. 数字人增加性别gender配置(male/female),使回复语音支持男声、女声切换
- 3. 配置了内部路网数据时,如果从外部开始导航,支持第三方路径API导航到入口,进入场景内接续使用内部路网
- 4. 部分UI、交互细节及配置调整
0.3.7 功能更新
- 1. 增加AI导游功能,可以根据配置的场景资料通过语音智能对话
- 2. 数字人增加对话交互时相关动画
- 3. 点击按钮或页面动效增加声音效果,声音提示默认开启
- 4. 部分细节调整
0.3.6 功能及UI更新
- 1. 功能更新:3d地图增加立体遮罩和方位刻度,并优化交互
- 2. 功能更新:更换默认步行线路api,小规模使用可尝试
- 3. 功能更新:到达目的地切换点位问题处理
- 4. 功能更新:一些其他已知问题修复
- 5. UI更新:部分UI细节调整
0.3.5 功能更新
- 1. 功能更新:点位增加电子围栏配置,3d地图及AR空间中可以显示
- 2. 功能更新:AI识别图片,显示文字绘制和配置方式优化,不再限制文字内容
- 3. 功能更新:3d导游形象扩充
- 4. 功能更新:增加magic箭头模式下3d导游的显示
0.3.4 功能及UI更新
- 1. 功能更新:3d地图标签点击事件优化
- 2. 功能更新:点位分组模式下3d地图显示优化
- 3. 功能更新:数字人3d导游形象增加机器人和动物的模型类型
- 4. UI更新:其他UI细节调整
0.3.3 功能更新
- 1. 功能更新:地点显示配置增加POI图标类型和控制显示场景
- 2. 功能更新:3d地图交互操作和各类型标签显示更新
- 3. 功能更新:一些其他问题修复与优化
0.3.2 功能更新
- 1. 功能更新:3d地图模型元素动画优化
- 2. 功能更新:第三方路径一些问题修复
0.3.1 功能更新
- 1. 功能更新:3d地图增加地形高度图配置,增加2d/3d模式切换
- 2. 功能更新:增加内部路网数据配置,增强版customRoutes(方便及时更新内部路网,不依赖第三方地址服务,旗舰版功能)
- 3. 功能更新:3d地图其他细节问题调整
- 4. 功能更新:性能优化
0.3.0 功能更新
- 1. 功能更新:3d版小地图开放配置
- 2. 功能更新:路径所需时长校准优化
- 3. 功能更新:其他细节问题调整
0.2.30 功能更新
- 1. 功能更新:代码结构整理优化,性能优化
- 2. 功能更新:退出再进、熄屏再进时的状态处理优化
- 3. 功能更新:错误提示逻辑优化
0.2.29 功能及UI更新
- 1. UI更新:常显3D箭头UI效果更新
- 2. 功能更新:分组模式箭头方向初始化问题修复
- 3. 功能更新:其他细节问题调整
0.2.28 功能更新
- 1. 功能更新:代码结构整理优化,缩减代码量
- 2. 功能更新:增加常显3D箭头模式配置(themeConfig.arrow.type = “magic”)
- 3. 功能更新:一些已知问题修复
0.2.27 功能及UI更新
- 1. 功能更新:代码结构整理优化,缩减代码量
- 2. 功能更新:增加默认步行线路api,可用性不如腾讯地图和高德地图,小规模使用可尝试
- 3. 功能更新:目的地到达后,可以选择切换其他点位
- 4. UI更新:代表目标的3d标记light(动感光波)效果调整
- 5. UI更新:部分机型兼容性处理
0.2.26 功能及UI更新
- 1. UI更新:默认UI风格default更新
- 2. 功能更新:目的地事件类型,增加视频播放
- 3. 功能更新:AI图像识别增加识别后触发执行自定义函数、播放语音、播放视频
- 4. 功能更新:AI图像识别增加点击后交互事件设定视频播放
- 5. 功能更新:一些已知问题修复
0.2.25 功能及UI更新
- 1. UI更新:默认UI风格default更新
- 2. UI更新:代表目标的默认3d标记形状更新
- 3. 功能更新:目标的3d标记增加自定义glb格式模型配置
- 4. 功能更新:AR空间3d物体显示效果优化
- 5. 功能更新:AI识别增加提示按钮文字配置
- 6. 功能更新:AI图像识别增加提示点击配置,点击后再执行设定的交互事件
- 7. 功能更新:性能优化
0.2.24 功能及UI更新
- 1. 功能更新:标签位置重叠处理算法优化
- 2. 功能更新:标签弹出事件按钮交互和样式优化
- 3. 功能更新:标签弹出事件按钮部分事件增加数组类型配置,相同类型事件可配置多个
- 4. 功能更新:分组菜单增加默认icon
- 5. 功能更新:一些问题修复
- 6. UI更新:默认UI风格default更新
0.2.23 功能更新
- 1. 功能更新:跳转页面事件bugfix
0.2.22 功能更新
- 1. 功能更新:管理端同步更新最新配置项
0.2.21 功能更新
- 1. 功能更新:增加全局显示点位距离配置,默认值3千米与导航距离限制maxDistance一致,但没有最大范围限制
- 2. 功能更新:增加测试点位配置,仅用于测试,模拟用户在设定的位置使用AR导航
- 3. 功能更新:部分算法及UI细节更新
0.2.20 功能更新
- 1. 功能更新:增加点位分组的默认选中的分组索引配置
- 2. 功能更新:其他细节问题调整
0.2.19 功能更新
- 1. 功能更新:增加点位分组指示箭头配置
- 2. 功能更新:增加距离提示文字格式配置
- 3. 功能更新:取消初始目的地名称和地点必填限制,可从目的地列表或分组目的地点选
0.2.18 功能及风格更新
- 1. 功能更新:增加点位分组显示及选择点位功能
- 2. 功能更新:取消初始目的地必填限制,可从其他地点列表或分组点位中点选
- 3. UI更新:新UI风格主题
0.2.17 功能更新
- 1. 功能更新:小地图配置优化,管理端同步更新
- 2. 功能更新:网络较差情况启动优化
- 3. 功能更新:偏离路径时计算逻辑优化
- 4. 功能更新:其他细节调整
0.2.16 功能及风格更新
- 1. 功能更新:增加小地图拖动后是否自动将用户位置置于地图中心的配置
- 2. 功能更新:增加小地图是否显示用户回到地图中心的按钮配置
- 3. UI更新:增加地图marker自定义样式配置,将原map组件的样式配置引入
0.2.15 功能及风格更新
- 1. 功能更新:地点标签增加是否显示名称和icon位置配置
- 2. 功能更新:小地图地点标签增加是否显示名称和icon缩放比例配置
- 3. UI更新:新UI风格主题更新
0.2.14 功能及风格更新
- 1. 功能更新:事件增加“取消”按钮
- 2. 功能更新:小地图上点击地点标签也可触发事件
- 3. 功能更新:配置项更新合理分组,与管理端分组对应
- 4. UI更新:新UI风格主题更新
0.2.13 功能及风格更新
- 1. 功能更新:提示语音有多个时按顺序依次播放
- 2. 功能更新:安卓地图旋转问题处理
- 3. 功能更新:目的地icon增加宽高设置
- 4. 功能更新:滤波器算法稳定位置数据调整
- 5. UI更新:新UI风格主题更新
0.2.12 功能及风格更新
- 1. 功能更新:方位角算法更新,实时修正
- 2. 功能更新:初始化偶尔超时导致的bug修复
- 3. UI更新:点位标签事件按钮交互方式更新
- 4. UI更新:新增默认UI主题theme: default_3
- 5. UI更新:其他UI细节更新
0.2.11 功能及风格更新
- 1. 功能更新:转弯设置提前量,并增加转弯时振动提示配置
- 2. 功能更新:转弯距离bugfix
- 3. 功能更新:默认值调整
- 4. 功能更新:位置算法更新,性能优化
- 5. 功能更新:新增支持引用微信官方「微信同声传译」插件,播放语音时更流畅
- 6. UI更新:新UI风格主题更新
- 7. UI更新:其他UI细节更新
0.2.10 功能及风格更新
- 1. 功能更新:新增目的地的图标配置
- 2. 功能更新:新增目的地的事件按钮展开收起配置
- 3. 功能更新:自定义提示图片位置增加跟随箭头显示
- 4. 功能更新:新增地图倾斜角度和不同路线颜色配置
- 5. 功能更新:新增抬起手机提示
- 6. 功能更新:新增进入导航界面时候提示信息(图片、语音)配置
- 7. 功能更新:优化偏转角获取
- 8. 功能更新:新增地图切换全屏显示功能
- 9. UI更新:新UI风格主题
0.2.9 功能更新
- 1. 功能更新:管理端设置配置项功能更新
- 2. 功能更新:管理端设置配置增加忽略小程序的params参数选项
- 3. 功能更新:到达目的地和其他点位中的跳转页面事件添加页面路由方式配置
0.2.8 功能及风格更新
- 1. 功能更新:增加插件管理端设置配置项功能,方便随时动态调整配置项,跳转导航插件的代码中可免配置
- 2. 功能更新:自定义返回按钮功能增加路由方式配置
0.2.7 功能及风格更新
- 1. UI更新:新UI风格处理文字过长的问题
- 2. UI更新:标签重叠算法更新
- 3. 功能更新:性能优化
0.2.6 功能及风格更新
- 1. 功能更新:切换了目的地时,小程序隐藏后重新打开时保持切换过的目的地
- 2. 功能更新:点位增加点击拨打电话配置
- 3. 功能更新:修复部分安卓手机地图旋转角度与实际不符的情况
- 4. UI更新:默认UI主题default_2更新
- 5. UI更新:代表目标的3d标记增加动态效果配置
- 6. UI更新:增加在靠近转弯前时是否在前方叠加指向拐弯方向箭头的配置
- 7. UI更新:新UI风格更新
0.2.5 功能及风格更新
- 1. 功能更新:增加稳定位置数据算法
- 2. 功能更新:新增目标的3d标记样式配置
- 3. 功能更新:性能优化
- 4. UI更新:新增默认UI主题theme: default_2
- 5. UI更新:新UI风格更新
0.2.4 功能及风格更新
- 1. 功能更新:新增箭头颜色、尺寸等配置
- 2. 功能更新:距离提示文字增加字体粗细配置
- 3. 功能更新:导航准确度优化
- 4. 功能更新:部分样式和性能问题处理
- 5. UI更新:新UI风格更新
0.2.3 功能及风格更新
- 1. 功能更新:新增导航结束到达目的地后的回调事件配置
- 2. 功能更新:提示语音播放声道冲突处理
- 3. 功能更新:新增距离提示文字颜色、尺寸等配置
- 4. 功能更新:新增自定义提示图片配置
- 5. UI更新:新UI风格主题
0.2.2 功能更新
- 1. 功能更新:点位增加立即播放的提示语音配置
- 2. 功能更新:点位切换导航目的地功能增加切换图标,点击切换图标时执行切换
- 3. 功能更新:点位支持同时配置多种交互类型,例如:既可以点击切换导航目的地,也可以点击触发语音提示等
- 4. 功能更新:其他点位距离计算bugfix
- 5. 功能更新:自定义线路颜色与第三方线路进行区分
- 6. 功能更新:部分性能优化和旗舰版功能更新
0.2.1 功能更新
- 1. 功能更新:增加腾讯地图和高德地图api转发配置,避免暴露地图API Key
0.2.0 功能更新
- 1. 功能更新:3d版小地图初步调试
- 2. 功能更新:新增默认数字人模型“default_3”
- 3. 功能更新:新增支持个人主体小程序引用插件
0.1.28 功能更新
- 1. 功能更新:切换导航和AI识别模式时方位角设置问题处理
- 2. 功能更新:插件打开时如果手机快速原地旋转方位角计算优化
- 3. 功能更新:性能优化
0.1.27 功能更新
- 1. 功能更新:3d模型制作、加载及使用方面的性能优化
- 2. 功能更新:新增默认数字人模型“default_2”
- 3. 功能更新:AI图像识别功能相关配置项及尺寸单位调整
- 4. 功能更新:在终点附近时打开插件时候存在的AI识别问题处理
0.1.26 功能更新
- 1. 功能更新:新增AI图像识别功能(旗舰版功能)
- 2. 功能更新:新增固定位置添加语音提示配置,点击标签可播放配置的语音
- 3. 功能更新:因插件后台接口不通导致无法进行权限检测时,放行小程序插件使用权限
- 4. 功能更新:性能优化
0.1.25 功能更新
- 1. 功能更新:优化AR实现方式,缓解卡顿
- 2. 功能更新:未设置目的地位置信息调用插件时增加错误提示
0.1.24 功能更新
- 1. 功能更新:自定义线路支持配置同一个目的地的多条线路,并根据当前位置判断距离哪条线路近就选用哪条
- 2. 功能更新:自定义线路实现combine类型,拼接使用第三方导航路径和自定义线路,第三方导航路径可导航到入口处然后接续上自定义内部路径,自动选择总体线路最短的线路
- 3. 功能更新:数字人动画逻辑更新整理
- 4. 功能更新:实现多个3d模型固定空间位置放置
- 5. 功能更新:偏离路线时,到导航路线的线路优化
- 6. 功能更新:性能优化
0.1.23 功能更新
- 1. 功能更新:glb格式模型某些情况加载错误处理、默认数字人模型更新
- 2. 功能更新:正在导航线路上时,如果忽然定位跳跃距离较大弱化处理
- 3. 功能更新:获取设备信息接口更新等优化
0.1.22 功能更新
- 1. 功能更新:简化实景AR导航在测试小程序中实际体验的步骤,并在体验时可修改部分插件配置项方便调试
- 2. 功能更新:距离超过配置的公里范围限制时逻辑优化
0.1.21 功能更新
- 1. 功能更新:默认数字人模型动作更新
- 2. 功能更新:部分配置默认值调整
0.1.20 功能更新
- 1. 功能更新:页面启动及销毁流程优化调整
- 2. 功能更新:android手机页面从后台运行返回到前台显示时摄像头画面显示问题处理
0.1.19 功能及风格更新
- 1. 功能更新:新增配置距离转弯处多少米内箭头朝将要拐弯的方向偏转,配置范围:1-100米,默认值50米
- 2. 功能更新:偏离逻辑调整,减弱定位偶然偏差过大时的位置跳跃现象
- 3. 功能更新:添加地图初始缩放级别配置,取值范围为3-20
- 4. UI更新:新UI风格样式微调
0.1.18 功能及风格更新
- 1. 功能更新:新增配置定位方式是否强制使用wx.getLocation接口,准确度更高但是更耗电
- 2. 功能更新:自定义线路地图组件特定情况自动刷新bugfix
- 3. UI更新:指向箭头实现方式优化
- 4. UI更新:新UI风格主题调整
0.1.17 功能及风格更新
- 1. 功能更新:添加UI风格主题theme配置
- 2. 功能更新:增加配置项距离目的地多少米算已经到达,配置范围:1-100米,默认值10米
- 3. 功能更新:自定义路线时间计算bugfix
- 4. 功能更新:增加配置项地图是否跟随用户方向旋转
- 5. UI更新:其他UI微调,相关显示逻辑优化
0.1.16 功能更新
- 1. 功能更新:地图覆盖图片在地图切换收起打开状态的时候有时不显示bugfix
- 2. 功能更新:自定义返回按钮点击返回的页面路由
0.1.15 功能更新
- 1. 功能更新:添加配置点击其他地点切换导航目的地
- 2. 功能更新:添加配置点击其他地点可以调用宿主小程序方法(调用的宿主方法里路由方法wx.redirectTo无效,可以通过配置其他地点的action类型为redirectTo在插件里调用wx.redirectTo)
- 3. 功能更新:小地图上自定义覆盖图片
- 4. 功能更新:更新数字人调试配置(旗舰版功能)
- 5. 功能更新:自定义线路,用于第三方导航路径导航不到的地方或新建设的地方
0.1.14 功能更新
- 1. 功能更新:目的地修改后再次进入AR导航界面时目的地点位没有更新bugfix
- 2. 功能更新:性能优化
0.1.13 功能bugfix
- 1. 功能更新:腾讯地图返回的步骤数据处理错误bugfix
0.1.12 功能更新
- 1. 功能更新:添加数字人交互调试配置(旗舰版功能,暂未开放配置)
- 2. 功能更新:部分功能性能优化
- 3. 功能更新:android罗盘和设备方向在AR中失效初步处理
- 4. 功能更新:微信小程序map组件rotate配置在android上无效初步处理
- 5. 功能更新:信息记录导致的bugfix
0.1.11 功能更新
- 1. 功能更新:为数据可视化提供位置和时间信息记录
- 2. 功能更新:新增公里范围限制配置,范围限制在1-10公里(千米),默认3公里(千米)
0.1.10 功能更新
- 1. 功能更新:修复部分机型出现摄像头画面左右翻转的问题
- 2. 功能更新:添加画面每秒渲染帧数配置,配置范围1-60,值越大画面越流畅但更耗电甚至导致小程序闪崩,需根据实际需求配置,默认值:10
- 3. 功能更新:android罗盘和设备方向与预期不一致做部分处理
- 4. 功能更新:部分交互性能初步优化
0.1.9 功能更新
- 1. 功能更新:定位使用新接口wx.onLocationChange减少电量消耗(如开通了权限并且手机微信版本有该方法)
- 2. 功能更新:语音提示时机逻辑优化,并添加关闭语音按钮
0.1.8 功能及风格更新
- 1. 功能更新:加入插件计费逻辑(插件申请即通过,赠送3个月试用时间、1万次调用量)
- 2. UI更新:部分提示信息样式调整
0.1.7 功能hotfix
- 1. 功能更新:加入的语音功能需要去除第三方插件
0.1.6 功能更新(该版本不可用)
- 1. 功能更新:初始化时判断是否有开启摄像头和用户定位权限,没有的话提示开启,防止用户误关相关权限
- 2. 功能更新:加入语音提示,可选功能
0.1.5 功能及风格更新
- 1. 功能更新:尽量弱化手机定位飘忽不定的影响
- 2. 功能更新:导航算法调整优化(最近点算法、箭头方向算法、坐标系初始化逻辑)
- 3. UI更新:3d物体添加地面阴影效果
- 4. UI更新:减小目的地3d标记在距离很近的时候的尺寸
0.1.4 功能及风格更新
- 1. 功能更新:线路中拐弯等各节点进行提示
- 2. 功能更新:用户朝向不在箭头方向时,提示用户往左或往右转查看(位置在偏移导航路线的状态时提示目标方向)
- 3. 功能更新:部分导航算法调整优化
- 4. UI更新:自定义小地图中用户当前位置标记
- 5. UI更新:样式微调,提示文字简化
0.1.3 功能及风格更新
- 1. 功能更新:修改手机打开导航在初始化时正好用户在原地旋转,导致目标方位角识别不对的问题
- 2. 功能更新:根据路径接口返回路线和当前位置计算行走线路,自动补全用户不在路线上时的方向路线(红色)并响应位置的改变
- 3. 功能更新:添加“重新导航”按钮,点击后再次触发第三方路径接口调用
- 4. 功能更新:添加地图收起和展开按钮
- 5. UI更新:距离文字也以3d的方式显示
- 6. UI更新:目的地和其他点位标签根据方位添加倾斜效果;其他点位根据距离与目的地距离比较相应设置标签大小(远小近大)
- 7. UI更新:界面简化和其他样式微调
0.1.2 bugfix,功能及风格更新完善
- 1. 高德地图返回的步行时间为秒,单位需要转换
- 2. 风格样式微调
- 3. 添加3d指向箭头
0.1.1 功能及风格更新完善
- 1. 目标位置添加3d上下闪动标记
- 2. 添加获取路径可选项:高德地图API
- 3. 可配置展示多个点位
- 4. 可配置不显示腾讯地图或路径步骤的文字提示
0.1.0 首发版本
- 1. AR导航功能:开启摄像头AR导航,地图路径显示