# 6DoF-平面 AR能力

# 方法定义

6DoF-平面AR能力，提供基础AR功能，提供旋转和平移6自由度的定位功能。

包括 V1 和 V2 两种适用不同场景的算法，两种平面AR能力各有优劣，用户根据适用场景及产品需求，自行判断调用接口类型，具体介绍如下：

1. V1平面接口，适用于用户在平面场景下，例如桌面，地面，泛平面场景，放置虚拟物体，不提供真实世界距离。用户放置物体时，手机相机倾斜向下对着目标平面点击即可，具有广泛的机型支持。
2. V2平面接口，提供真实物理距离的ar定位功能，提供平面识别功能，用户在平面范围点击放置虚拟物体的功能，具有有限的支持机型。

# 能力扩展

在 V2 平面基础上，可以通过配置开启多种扩展能力，比如：

1. marker 识别能力，即平面空间下多个不同识别目标的识别。
2. 虚实遮挡的能力，即虚拟物体和真实世界的交互遮挡能力。

更多使用效果与开关配置细节，可以参考 平面AR能力扩展。

# 如何开启 V1 或 V2

初始化时，通过 VKSession 配置 version 确定。

const session = wx.createVKSession({
  track: {
    plane: {
        mode: 1
    },
  },
  version: 'v2' // 在满足设备条件时开启，否则会使用 v1
  // version: "v1" 强制开启v1
})

有关完整的VKSession配置，详见 VKSession配置参考。

# V1 与 V2 对比

# 应用场景示例

V1平面demo

V2平面demo

V2平面+虚实遮挡demo

# 程序示例

1. 可以在 V1平面 页面查看示例代码。
2. 可以在 V2平面 页面查看示例代码。
3. 可以在 V2平面+虚实遮挡 页面查看示例代码，在小程序示例中的接口-VisionKit视觉能力-水平面AR-v2-虚实遮挡中体验。

# 附录

# V1平面接口系统要求

1. IOS机型要求: iphone 6s及以上机型
2. Android机型要求：Android 7.0, Android SDK 24及以上

# V2平面AR接口支持列表

1. IOS机型要求: iphone 7及以上机型

2. Android机型支持会逐步增加，如测试机型效果有误可论坛反馈，目前支持机型包括: