室内AR导航插件

版本号：1.0.15

插件介绍

腾讯位置服务为小程序开发者提供“室内AR导航”插件，通过增强现实技术，提供室内环境中的实时路径引导，帮助用户直观地导航到目标位置。该插件仅提供了室内AR导航能力，若有室内导览、室内外一体化步导诉求，则按需接入“室内地图导览”、“室内外一体化步导”（注：导航播报能力，需自行接入）。

该插件为高级服务，插件使用需配合室内图采集，如有需求可提交商务合作购买。

接入指引

1、申请key

使用腾讯位置服务微信小程序插件需提前申请key，以作为唯一身份认证标识，开通指南如下：
1）登录腾讯位置服务官网，完成企业账号注册
2）进入“控制台->应用管理->我的应用“，点击”创建应用“，勾选如下信息，并提交

2、接口额度购买

室内地图导览插件，引用了如下高级接口服务，请前往腾讯位置服务官网，进入“控制台->配额管理->key额度“，搜索如下接口，并根据小程序流量情况购买合适的配额。

接口	服务路径
室内搜索	/ws/indoor/v1/search
室内关键词输入提示	/ws/indoor/v1/suggestion
室内地图选点	/ws/indoor/v1/explore
地点搜索	/ws/place/v1/search

3、插件申请接入

在微信公众平台中， “微信小程序官方后台-设置-第三方服务-插件管理” 里点击 “添加插件”，搜索 “室内AR导航” 申请，审核通过后，小程序开发者可在小程序内使用该插件。

4、开通室内权限

完成如上步骤后，开发者请提供key和小程序AppID，由腾讯位置服务团队为其开通室内图权限（室内图制作、采集需额外提交商务合作）。

5、室内设备及AR采集

室内AR导航依赖：1. 蓝牙等定位设备的安装，开发团队请部署好定位设置后，按照《腾讯室内图&蓝牙供应商合作方案V1.1》要求，提交蓝牙成果数据；2. AR视觉采集，开发团队请提交商务合作购买采集服务。

6、引入插件包

在您的小程序app.json中引入相关插件（注：导航播报能力，需自行接入）

"plugins": {
   //腾讯地图AR导航插件
   "TencentmapAR": {
     "version": "1.0.0",//请使用线上最新版本号
     "provider": "wx7e0f043c0a7eeb4b"
   },
}

并，在app.json中增加语音讲解依赖相关接口权限配置

 "requiredBackgroundModes": ["audio"],
  "lazyCodeLoading": "requiredComponents"

7、初始化插件

在开发者主小程序中，使用插件：

const plugin = requirePlugin("TencentmapAR")
//app.js
App({
    onLaunch: function(options) {
      plugin.init({
        appId: 'wxd45b334f68fc3XXXX', // 主小程序的appId 
        mapKey: 'XVYBZ-3V6KJ-GVYFU-FKLVH-XXXXX-XXXXX', // 地图key
        appName: 'XXXAR导航小程序',
        needlocationAccuracy: 20,
        // 管理平台配置信息
        platformInfo: {
          loadFromPlatform: true, // 是否从平台中加载配置
          type: 1, //1-景区 2-博物馆
          id: '49XXXX', // 管理平台配置ID
          radius: 30000, // 周边半径
        },
        // 地图配置信息(室外)
        mapSettingInfo: {
          longitude: 118.06715,
          latitude: 24.44464,
          scale: 18,
        },
        success: () => { }
      });
      // 设置导航配置信息，indoor-室内， outdoor-室外
      plugin.setNavConfig({
        indoor: {
          matchDistance: 5, // 绑路距离
          yawDistance: 5, // 偏航判断距离 5米
          yawCount: 5, // 超出绑路距离5 次
          arriveDistance: 8, // 到达距离
          enableVoiceGuide: true, // 是否允许语音播报
        },
        outdoor: {
          matchDistance: 20, // 绑路距离
          yawDistance: 20, // 偏航判断距离 5米
          yawCount: 8, // 超出绑路距离8 次
          arriveDistance: 20, // 到达距离
          enableVoiceGuide: true, // 是否允许语音播报
        },
      })
      // 设置楼梯区, 室外时floorName不传, 室内时floorName传正常楼层名
      plugin.setStairAreaList(
        [
          {
            floorName: "F1",
            points: [{ "longitude": 101.547827432958, "latitude": 25.0240077883207 }, { "longitude": 101.547862999141, "latitude": 25.024008088096 }, { "longitude": 101.547861658037, "latitude": 25.0236641815255 }, { "longitude": 101.547825448215, "latitude": 25.0236641815255 }, { "longitude": 101.547827432958, "latitude": 25.0240077883207 }]
          }
        ],
      )
    }
})

8、业务参数设置及插件页跳转应用

参考室内AR导航小程序插件文档根据室内图需求，设置对应参数

效果图