实景AR导航

实景AR导航,步行导航,根据地图接口获取步行导航线路,通过摄像头叠加方向箭头和距离信息实现AR步行导航,支持AI导游语音对话、3D小地图等交互。AR导航比较消耗手机电量,建议只用于短距离步行导航。

提示:个人认证的小程序引用的插件appId为:wx308518c879eedfeb(插件地址);企业认证的小程序引用的插件appId为:wx0b07b21a83347243(插件地址)。如需通过浏览器Web端调用,请联系我们:13916302767。

功能图例

  • 步行箭头方向
  • 显示步行距离
  • 在目标方向显示名称提示及直线距离
  • 设置除目标外的其他地点,显示名字及直线距离
  • 小地图上自定义覆盖图片
  • 拼接使用导航路径和自定义内部线路
  • 显示数字人交互(旗舰版)
  • AI导游(旗舰版)
  • AI图像识别交互(旗舰版)
  • 3d版小地图(旗舰版)

数据可视化

使用数据可视化展示:地图、热力图、调用导航数据及趋势、动态显示客流飞线等,支持生成公开外链展示,开通后使用链接:https://webar.mixwechat.com/insights/[您的小程序appid]
数据可视化

实际体验

微信扫下方小程序码,点击"实景AR导航"按钮
jfh|450

体验页面展示基本功能并可调整部分配置项,完整配置项请参考使用方式介绍

使用准备

  1. 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. 2. 小程序管理后台,「管理」-「开发管理」-「接口设置」- 「地理位置」申请如下接口权限:wx.onLocationChange、wx.startLocationUpdate、wx.getLocation。(接口wx.onLocationChange和wx.startLocationUpdate配合使用,省电但是准确度不高。接口wx.getLocation单独使用,准确度高但是更耗电。都有权限时插件优先用前2个接口。)
  3. 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. 1. 基础版 1200/年 包含:100万次调用、插件更新优化免费推送、提供多个风格选择、基础版数据可视化。可免费试用1个月、1万次调用量。
  2. 2. 旗舰版 6666/年 包含:100万次调用、基础版所有功能、3d版小地图、AI导游、AI识别、数字人交互、3d版数据可视化、在手机Web浏览器通过H5页面调用等。3d建模根据场景复杂度另外估算。
  3. 3. 无忧版 16666/年 包含:300万次调用量、旗舰版所有功能、无需配置地图key由插件提供商用地图服务。
  4. 4. 支付及管理:https://webar.mixwechat.com
  5. 5. 本插件由逆行科技提供,我们会持续完善。可定制导航界面及其他AR交互功能(仅无忧版支持定制开发,评估并支付之后再进行),欢迎咨询:13916302767。

后续计划

  1. 1. 导航算法优化、性能优化、更多手机型号兼容性处理
  2. 2. 实现多个可选页面风格模板,包括页面布局、箭头形式、提示文字样式、动效等
  3. 3. 旗舰版(3d版小地图、AI导游、AI识别、数字人、室内导航等)功能开发、升级优化
  4. 4. 用户反馈的其他功能需求汇总开发
  5. 5. 文档更新

更新日志

0.3.18 功能更新

  1. 1. 针对部分机型AR会话启动失败,降级为2D地图导航
  2. 2. 完善不同类型的AR会话启动失败的文案提示
  3. 3. 旗舰版不支持AR导航机型增加复制链接通过浏览器使用AR导航
  4. 4. 一些细节调整

0.3.17 功能更新

  1. 1. 增加定位精度提示配置
  2. 2. 管理端配置适配移动端
  3. 3. 视觉特征点定位功能更新调试
  4. 4. 3d地图调整
  5. 5. 部分细节调整

0.3.16 功能更新

  1. 1. 地点增加详细描述和图片列表
  2. 2. 地图增加客流热力图展示功能
  3. 3. 管理端「数据」弹窗升级为数据可视化界面,支持生成公开外链
  4. 4. 管理端配置方式简化优化,可直接在地图上直观选点并进行配置

0.3.15 功能更新

  1. 1. 支持没有小程序的用户通过平台自助方式使用AR导航功能
  2. 2. AI识别显示视频时增加播放模式、是否循环播放等配置
  3. 3. 一些已知问题修复

0.3.14 功能更新

  1. 1. AI导游与真人协助切换问题处理
  2. 2. 其他体验问题修复与优化

0.3.13 功能更新

  1. 1. AI导游增加真人协助入口,可共享画面
  2. 2. 增加根据视觉特征点定位功能(需先点云建图)
  3. 3. 增加初始化动效,从地球视角推进至目的地位置
  4. 4. 代码结构整理优化,性能优化
  5. 5. 一些已知问题修复

0.3.12 功能更新

  1. 1. 导航算法优化
  2. 2. AR导航与AI识别共存模式优化

0.3.11 功能更新

  1. 1. 版本规格调整,增加无忧版
  2. 2. AI识别增加可与AR导航同时存在的配置,不用按钮切换
  3. 3. 定位失败提示优化,引导用户打开设置页
  4. 4. 安卓部分机型兼容性问题处理
  5. 5. 性能优化
  6. 6. 部分UI细节调整

0.3.10 功能更新

  1. 1. 网络请求方式更新
  2. 2. 语音控制逻辑及部分UI细节调整
  3. 3. 部分音效更新
  4. 4. 一些已知问题修复

0.3.9 功能及UI更新

  1. 1. 语音的设置与控制逻辑优化
  2. 2. 部分UI细节调整

0.3.8 功能更新

  1. 1. AI导游通过语音对话控制切换目的地
  2. 2. 数字人增加性别gender配置(male/female),使回复语音支持男声、女声切换
  3. 3. 配置了内部路网数据时,如果从外部开始导航,支持第三方路径API导航到入口,进入场景内接续使用内部路网
  4. 4. 部分UI、交互细节及配置调整

0.3.7 功能更新

  1. 1. 增加AI导游功能,可以根据配置的场景资料通过语音智能对话
  2. 2. 数字人增加对话交互时相关动画
  3. 3. 点击按钮或页面动效增加声音效果,声音提示默认开启
  4. 4. 部分细节调整

0.3.6 功能及UI更新

  1. 1. 功能更新:3d地图增加立体遮罩和方位刻度,并优化交互
  2. 2. 功能更新:更换默认步行线路api,小规模使用可尝试
  3. 3. 功能更新:到达目的地切换点位问题处理
  4. 4. 功能更新:一些其他已知问题修复
  5. 5. UI更新:部分UI细节调整

0.3.5 功能更新

  1. 1. 功能更新:点位增加电子围栏配置,3d地图及AR空间中可以显示
  2. 2. 功能更新:AI识别图片,显示文字绘制和配置方式优化,不再限制文字内容
  3. 3. 功能更新:3d导游形象扩充
  4. 4. 功能更新:增加magic箭头模式下3d导游的显示

0.3.4 功能及UI更新

  1. 1. 功能更新:3d地图标签点击事件优化
  2. 2. 功能更新:点位分组模式下3d地图显示优化
  3. 3. 功能更新:数字人3d导游形象增加机器人和动物的模型类型
  4. 4. UI更新:其他UI细节调整

0.3.3 功能更新

  1. 1. 功能更新:地点显示配置增加POI图标类型和控制显示场景
  2. 2. 功能更新:3d地图交互操作和各类型标签显示更新
  3. 3. 功能更新:一些其他问题修复与优化

0.3.2 功能更新

  1. 1. 功能更新:3d地图模型元素动画优化
  2. 2. 功能更新:第三方路径一些问题修复

0.3.1 功能更新

  1. 1. 功能更新:3d地图增加地形高度图配置,增加2d/3d模式切换
  2. 2. 功能更新:增加内部路网数据配置,增强版customRoutes(方便及时更新内部路网,不依赖第三方地址服务,旗舰版功能)
  3. 3. 功能更新:3d地图其他细节问题调整
  4. 4. 功能更新:性能优化

0.3.0 功能更新

  1. 1. 功能更新:3d版小地图开放配置
  2. 2. 功能更新:路径所需时长校准优化
  3. 3. 功能更新:其他细节问题调整

0.2.30 功能更新

  1. 1. 功能更新:代码结构整理优化,性能优化
  2. 2. 功能更新:退出再进、熄屏再进时的状态处理优化
  3. 3. 功能更新:错误提示逻辑优化

0.2.29 功能及UI更新

  1. 1. UI更新:常显3D箭头UI效果更新
  2. 2. 功能更新:分组模式箭头方向初始化问题修复
  3. 3. 功能更新:其他细节问题调整

0.2.28 功能更新

  1. 1. 功能更新:代码结构整理优化,缩减代码量
  2. 2. 功能更新:增加常显3D箭头模式配置(themeConfig.arrow.type = “magic”)
  3. 3. 功能更新:一些已知问题修复

0.2.27 功能及UI更新

  1. 1. 功能更新:代码结构整理优化,缩减代码量
  2. 2. 功能更新:增加默认步行线路api,可用性不如腾讯地图和高德地图,小规模使用可尝试
  3. 3. 功能更新:目的地到达后,可以选择切换其他点位
  4. 4. UI更新:代表目标的3d标记light(动感光波)效果调整
  5. 5. UI更新:部分机型兼容性处理

0.2.26 功能及UI更新

  1. 1. UI更新:默认UI风格default更新
  2. 2. 功能更新:目的地事件类型,增加视频播放
  3. 3. 功能更新:AI图像识别增加识别后触发执行自定义函数、播放语音、播放视频
  4. 4. 功能更新:AI图像识别增加点击后交互事件设定视频播放
  5. 5. 功能更新:一些已知问题修复

0.2.25 功能及UI更新

  1. 1. UI更新:默认UI风格default更新
  2. 2. UI更新:代表目标的默认3d标记形状更新
  3. 3. 功能更新:目标的3d标记增加自定义glb格式模型配置
  4. 4. 功能更新:AR空间3d物体显示效果优化
  5. 5. 功能更新:AI识别增加提示按钮文字配置
  6. 6. 功能更新:AI图像识别增加提示点击配置,点击后再执行设定的交互事件
  7. 7. 功能更新:性能优化

0.2.24 功能及UI更新

  1. 1. 功能更新:标签位置重叠处理算法优化
  2. 2. 功能更新:标签弹出事件按钮交互和样式优化
  3. 3. 功能更新:标签弹出事件按钮部分事件增加数组类型配置,相同类型事件可配置多个
  4. 4. 功能更新:分组菜单增加默认icon
  5. 5. 功能更新:一些问题修复
  6. 6. UI更新:默认UI风格default更新

0.2.23 功能更新

  1. 1. 功能更新:跳转页面事件bugfix

0.2.22 功能更新

  1. 1. 功能更新:管理端同步更新最新配置项

0.2.21 功能更新

  1. 1. 功能更新:增加全局显示点位距离配置,默认值3千米与导航距离限制maxDistance一致,但没有最大范围限制
  2. 2. 功能更新:增加测试点位配置,仅用于测试,模拟用户在设定的位置使用AR导航
  3. 3. 功能更新:部分算法及UI细节更新

0.2.20 功能更新

  1. 1. 功能更新:增加点位分组的默认选中的分组索引配置
  2. 2. 功能更新:其他细节问题调整

0.2.19 功能更新

  1. 1. 功能更新:增加点位分组指示箭头配置
  2. 2. 功能更新:增加距离提示文字格式配置
  3. 3. 功能更新:取消初始目的地名称和地点必填限制,可从目的地列表或分组目的地点选

0.2.18 功能及风格更新

  1. 1. 功能更新:增加点位分组显示及选择点位功能
  2. 2. 功能更新:取消初始目的地必填限制,可从其他地点列表或分组点位中点选
  3. 3. UI更新:新UI风格主题

0.2.17 功能更新

  1. 1. 功能更新:小地图配置优化,管理端同步更新
  2. 2. 功能更新:网络较差情况启动优化
  3. 3. 功能更新:偏离路径时计算逻辑优化
  4. 4. 功能更新:其他细节调整

0.2.16 功能及风格更新

  1. 1. 功能更新:增加小地图拖动后是否自动将用户位置置于地图中心的配置
  2. 2. 功能更新:增加小地图是否显示用户回到地图中心的按钮配置
  3. 3. UI更新:增加地图marker自定义样式配置,将原map组件的样式配置引入

0.2.15 功能及风格更新

  1. 1. 功能更新:地点标签增加是否显示名称和icon位置配置
  2. 2. 功能更新:小地图地点标签增加是否显示名称和icon缩放比例配置
  3. 3. UI更新:新UI风格主题更新

0.2.14 功能及风格更新

  1. 1. 功能更新:事件增加“取消”按钮
  2. 2. 功能更新:小地图上点击地点标签也可触发事件
  3. 3. 功能更新:配置项更新合理分组,与管理端分组对应
  4. 4. UI更新:新UI风格主题更新

0.2.13 功能及风格更新

  1. 1. 功能更新:提示语音有多个时按顺序依次播放
  2. 2. 功能更新:安卓地图旋转问题处理
  3. 3. 功能更新:目的地icon增加宽高设置
  4. 4. 功能更新:滤波器算法稳定位置数据调整
  5. 5. UI更新:新UI风格主题更新

0.2.12 功能及风格更新

  1. 1. 功能更新:方位角算法更新,实时修正
  2. 2. 功能更新:初始化偶尔超时导致的bug修复
  3. 3. UI更新:点位标签事件按钮交互方式更新
  4. 4. UI更新:新增默认UI主题theme: default_3
  5. 5. UI更新:其他UI细节更新

0.2.11 功能及风格更新

  1. 1. 功能更新:转弯设置提前量,并增加转弯时振动提示配置
  2. 2. 功能更新:转弯距离bugfix
  3. 3. 功能更新:默认值调整
  4. 4. 功能更新:位置算法更新,性能优化
  5. 5. 功能更新:新增支持引用微信官方「微信同声传译」插件,播放语音时更流畅
  6. 6. UI更新:新UI风格主题更新
  7. 7. UI更新:其他UI细节更新

0.2.10 功能及风格更新

  1. 1. 功能更新:新增目的地的图标配置
  2. 2. 功能更新:新增目的地的事件按钮展开收起配置
  3. 3. 功能更新:自定义提示图片位置增加跟随箭头显示
  4. 4. 功能更新:新增地图倾斜角度和不同路线颜色配置
  5. 5. 功能更新:新增抬起手机提示
  6. 6. 功能更新:新增进入导航界面时候提示信息(图片、语音)配置
  7. 7. 功能更新:优化偏转角获取
  8. 8. 功能更新:新增地图切换全屏显示功能
  9. 9. UI更新:新UI风格主题

0.2.9 功能更新

  1. 1. 功能更新:管理端设置配置项功能更新
  2. 2. 功能更新:管理端设置配置增加忽略小程序的params参数选项
  3. 3. 功能更新:到达目的地和其他点位中的跳转页面事件添加页面路由方式配置

0.2.8 功能及风格更新

  1. 1. 功能更新:增加插件管理端设置配置项功能,方便随时动态调整配置项,跳转导航插件的代码中可免配置
  2. 2. 功能更新:自定义返回按钮功能增加路由方式配置

0.2.7 功能及风格更新

  1. 1. UI更新:新UI风格处理文字过长的问题
  2. 2. UI更新:标签重叠算法更新
  3. 3. 功能更新:性能优化

0.2.6 功能及风格更新

  1. 1. 功能更新:切换了目的地时,小程序隐藏后重新打开时保持切换过的目的地
  2. 2. 功能更新:点位增加点击拨打电话配置
  3. 3. 功能更新:修复部分安卓手机地图旋转角度与实际不符的情况
  4. 4. UI更新:默认UI主题default_2更新
  5. 5. UI更新:代表目标的3d标记增加动态效果配置
  6. 6. UI更新:增加在靠近转弯前时是否在前方叠加指向拐弯方向箭头的配置
  7. 7. UI更新:新UI风格更新

0.2.5 功能及风格更新

  1. 1. 功能更新:增加稳定位置数据算法
  2. 2. 功能更新:新增目标的3d标记样式配置
  3. 3. 功能更新:性能优化
  4. 4. UI更新:新增默认UI主题theme: default_2
  5. 5. UI更新:新UI风格更新

0.2.4 功能及风格更新

  1. 1. 功能更新:新增箭头颜色、尺寸等配置
  2. 2. 功能更新:距离提示文字增加字体粗细配置
  3. 3. 功能更新:导航准确度优化
  4. 4. 功能更新:部分样式和性能问题处理
  5. 5. UI更新:新UI风格更新

0.2.3 功能及风格更新

  1. 1. 功能更新:新增导航结束到达目的地后的回调事件配置
  2. 2. 功能更新:提示语音播放声道冲突处理
  3. 3. 功能更新:新增距离提示文字颜色、尺寸等配置
  4. 4. 功能更新:新增自定义提示图片配置
  5. 5. UI更新:新UI风格主题

0.2.2 功能更新

  1. 1. 功能更新:点位增加立即播放的提示语音配置
  2. 2. 功能更新:点位切换导航目的地功能增加切换图标,点击切换图标时执行切换
  3. 3. 功能更新:点位支持同时配置多种交互类型,例如:既可以点击切换导航目的地,也可以点击触发语音提示等
  4. 4. 功能更新:其他点位距离计算bugfix
  5. 5. 功能更新:自定义线路颜色与第三方线路进行区分
  6. 6. 功能更新:部分性能优化和旗舰版功能更新

0.2.1 功能更新

  1. 1. 功能更新:增加腾讯地图和高德地图api转发配置,避免暴露地图API Key

0.2.0 功能更新

  1. 1. 功能更新:3d版小地图初步调试
  2. 2. 功能更新:新增默认数字人模型“default_3”
  3. 3. 功能更新:新增支持个人主体小程序引用插件

0.1.28 功能更新

  1. 1. 功能更新:切换导航和AI识别模式时方位角设置问题处理
  2. 2. 功能更新:插件打开时如果手机快速原地旋转方位角计算优化
  3. 3. 功能更新:性能优化

0.1.27 功能更新

  1. 1. 功能更新:3d模型制作、加载及使用方面的性能优化
  2. 2. 功能更新:新增默认数字人模型“default_2”
  3. 3. 功能更新:AI图像识别功能相关配置项及尺寸单位调整
  4. 4. 功能更新:在终点附近时打开插件时候存在的AI识别问题处理

0.1.26 功能更新

  1. 1. 功能更新:新增AI图像识别功能(旗舰版功能)
  2. 2. 功能更新:新增固定位置添加语音提示配置,点击标签可播放配置的语音
  3. 3. 功能更新:因插件后台接口不通导致无法进行权限检测时,放行小程序插件使用权限
  4. 4. 功能更新:性能优化

0.1.25 功能更新

  1. 1. 功能更新:优化AR实现方式,缓解卡顿
  2. 2. 功能更新:未设置目的地位置信息调用插件时增加错误提示

0.1.24 功能更新

  1. 1. 功能更新:自定义线路支持配置同一个目的地的多条线路,并根据当前位置判断距离哪条线路近就选用哪条
  2. 2. 功能更新:自定义线路实现combine类型,拼接使用第三方导航路径和自定义线路,第三方导航路径可导航到入口处然后接续上自定义内部路径,自动选择总体线路最短的线路
  3. 3. 功能更新:数字人动画逻辑更新整理
  4. 4. 功能更新:实现多个3d模型固定空间位置放置
  5. 5. 功能更新:偏离路线时,到导航路线的线路优化
  6. 6. 功能更新:性能优化

0.1.23 功能更新

  1. 1. 功能更新:glb格式模型某些情况加载错误处理、默认数字人模型更新
  2. 2. 功能更新:正在导航线路上时,如果忽然定位跳跃距离较大弱化处理
  3. 3. 功能更新:获取设备信息接口更新等优化

0.1.22 功能更新

  1. 1. 功能更新:简化实景AR导航在测试小程序中实际体验的步骤,并在体验时可修改部分插件配置项方便调试
  2. 2. 功能更新:距离超过配置的公里范围限制时逻辑优化

0.1.21 功能更新

  1. 1. 功能更新:默认数字人模型动作更新
  2. 2. 功能更新:部分配置默认值调整

0.1.20 功能更新

  1. 1. 功能更新:页面启动及销毁流程优化调整
  2. 2. 功能更新:android手机页面从后台运行返回到前台显示时摄像头画面显示问题处理

0.1.19 功能及风格更新

  1. 1. 功能更新:新增配置距离转弯处多少米内箭头朝将要拐弯的方向偏转,配置范围:1-100米,默认值50米
  2. 2. 功能更新:偏离逻辑调整,减弱定位偶然偏差过大时的位置跳跃现象
  3. 3. 功能更新:添加地图初始缩放级别配置,取值范围为3-20
  4. 4. UI更新:新UI风格样式微调

0.1.18 功能及风格更新

  1. 1. 功能更新:新增配置定位方式是否强制使用wx.getLocation接口,准确度更高但是更耗电
  2. 2. 功能更新:自定义线路地图组件特定情况自动刷新bugfix
  3. 3. UI更新:指向箭头实现方式优化
  4. 4. UI更新:新UI风格主题调整

0.1.17 功能及风格更新

  1. 1. 功能更新:添加UI风格主题theme配置
  2. 2. 功能更新:增加配置项距离目的地多少米算已经到达,配置范围:1-100米,默认值10米
  3. 3. 功能更新:自定义路线时间计算bugfix
  4. 4. 功能更新:增加配置项地图是否跟随用户方向旋转
  5. 5. UI更新:其他UI微调,相关显示逻辑优化

0.1.16 功能更新

  1. 1. 功能更新:地图覆盖图片在地图切换收起打开状态的时候有时不显示bugfix
  2. 2. 功能更新:自定义返回按钮点击返回的页面路由

0.1.15 功能更新

  1. 1. 功能更新:添加配置点击其他地点切换导航目的地
  2. 2. 功能更新:添加配置点击其他地点可以调用宿主小程序方法(调用的宿主方法里路由方法wx.redirectTo无效,可以通过配置其他地点的action类型为redirectTo在插件里调用wx.redirectTo)
  3. 3. 功能更新:小地图上自定义覆盖图片
  4. 4. 功能更新:更新数字人调试配置(旗舰版功能)
  5. 5. 功能更新:自定义线路,用于第三方导航路径导航不到的地方或新建设的地方

0.1.14 功能更新

  1. 1. 功能更新:目的地修改后再次进入AR导航界面时目的地点位没有更新bugfix
  2. 2. 功能更新:性能优化

0.1.13 功能bugfix

  1. 1. 功能更新:腾讯地图返回的步骤数据处理错误bugfix

0.1.12 功能更新

  1. 1. 功能更新:添加数字人交互调试配置(旗舰版功能,暂未开放配置)
  2. 2. 功能更新:部分功能性能优化
  3. 3. 功能更新:android罗盘和设备方向在AR中失效初步处理
  4. 4. 功能更新:微信小程序map组件rotate配置在android上无效初步处理
  5. 5. 功能更新:信息记录导致的bugfix

0.1.11 功能更新

  1. 1. 功能更新:为数据可视化提供位置和时间信息记录
  2. 2. 功能更新:新增公里范围限制配置,范围限制在1-10公里(千米),默认3公里(千米)

0.1.10 功能更新

  1. 1. 功能更新:修复部分机型出现摄像头画面左右翻转的问题
  2. 2. 功能更新:添加画面每秒渲染帧数配置,配置范围1-60,值越大画面越流畅但更耗电甚至导致小程序闪崩,需根据实际需求配置,默认值:10
  3. 3. 功能更新:android罗盘和设备方向与预期不一致做部分处理
  4. 4. 功能更新:部分交互性能初步优化

0.1.9 功能更新

  1. 1. 功能更新:定位使用新接口wx.onLocationChange减少电量消耗(如开通了权限并且手机微信版本有该方法)
  2. 2. 功能更新:语音提示时机逻辑优化,并添加关闭语音按钮

0.1.8 功能及风格更新

  1. 1. 功能更新:加入插件计费逻辑(插件申请即通过,赠送3个月试用时间、1万次调用量)
  2. 2. UI更新:部分提示信息样式调整

0.1.7 功能hotfix

  1. 1. 功能更新:加入的语音功能需要去除第三方插件

0.1.6 功能更新(该版本不可用)

  1. 1. 功能更新:初始化时判断是否有开启摄像头和用户定位权限,没有的话提示开启,防止用户误关相关权限
  2. 2. 功能更新:加入语音提示,可选功能

0.1.5 功能及风格更新

  1. 1. 功能更新:尽量弱化手机定位飘忽不定的影响
  2. 2. 功能更新:导航算法调整优化(最近点算法、箭头方向算法、坐标系初始化逻辑)
  3. 3. UI更新:3d物体添加地面阴影效果
  4. 4. UI更新:减小目的地3d标记在距离很近的时候的尺寸

0.1.4 功能及风格更新

  1. 1. 功能更新:线路中拐弯等各节点进行提示
  2. 2. 功能更新:用户朝向不在箭头方向时,提示用户往左或往右转查看(位置在偏移导航路线的状态时提示目标方向)
  3. 3. 功能更新:部分导航算法调整优化
  4. 4. UI更新:自定义小地图中用户当前位置标记
  5. 5. UI更新:样式微调,提示文字简化

0.1.3 功能及风格更新

  1. 1. 功能更新:修改手机打开导航在初始化时正好用户在原地旋转,导致目标方位角识别不对的问题
  2. 2. 功能更新:根据路径接口返回路线和当前位置计算行走线路,自动补全用户不在路线上时的方向路线(红色)并响应位置的改变
  3. 3. 功能更新:添加“重新导航”按钮,点击后再次触发第三方路径接口调用
  4. 4. 功能更新:添加地图收起和展开按钮
  5. 5. UI更新:距离文字也以3d的方式显示
  6. 6. UI更新:目的地和其他点位标签根据方位添加倾斜效果;其他点位根据距离与目的地距离比较相应设置标签大小(远小近大)
  7. 7. UI更新:界面简化和其他样式微调

0.1.2 bugfix,功能及风格更新完善

  1. 1. 高德地图返回的步行时间为秒,单位需要转换
  2. 2. 风格样式微调
  3. 3. 添加3d指向箭头

0.1.1 功能及风格更新完善

  1. 1. 目标位置添加3d上下闪动标记
  2. 2. 添加获取路径可选项:高德地图API
  3. 3. 可配置展示多个点位
  4. 4. 可配置不显示腾讯地图或路径步骤的文字提示

0.1.0 首发版本

  1. 1. AR导航功能:开启摄像头AR导航,地图路径显示