# 6DoF-Plane AR capabilities

# Definition of method

6DoF - Planar AR capabilities, providing basic AR capabilities, providing 6 degrees of freedom of positioning for rotation and translation.

Include V1 and V2 Two algorithms for different scenarios, two kinds of planar AR capabilities have their own advantages and disadvantages, the user according to the applicable scenarios and product needs, determine the call interface type, the specific introduction is as follows:

1. V1 plane interface, suitable for users in a plane scene, such as desktop, ground, pan-plane scene, place virtual objects, do not provide real world distance. When the user places the object, the mobile phone camera can tilt down to the target plane and click, with a wide range of models to support.
2. V2 plane interface, provide real physical distance AR positioning function, provide plane recognition function, the user click on the plane to place the function of virtual objects, with limited support models.

# Capacity expansion

in V2 On a flat basis, multiple expansion capabilities can be enabled through configuration, such as:

1. marker Recognition ability, that is, the recognition of multiple different recognition targets in plane space.
2. The ability of virtual occlusion, that is, the ability of interactive occlusion between virtual objects and the real world.

More use effect and switch configuration details, you can refer to the Flat AR Capability Expansion。

# How to open V1 or V2

When initialized, by VKSession To configure version Yeah.

const session = wx.createVKSession({
  track: {
    plane: {
        mode: 1
    },
  },
  version: 'v2' // Turned on when the device conditions are met, otherwise it will be used v1
  // version: "v1" Force v1 on
})

For the full VKSession configuration, see [VKSession Configuration Reference ](https://developers.weixin.qq.com/miniprogram/dev/api/ai/Visionkit /wx.createVKSession.html)。

# V1 and V2 Contrast

# Application Scenario Examples

V1 Flat Demo

V2 Flat Demo

V2 plane + virtual and real occlusion demo

# Program Examples

1. Can be found at [V1 plane](https://github.com/WeChat mini-program /miniprogram-demo/tree/master/miniprogram/packageAPI/pages/ar/Plane-ar ) Page to view the sample code.
2. Can be found at [V2 plane](https://github.com/WeChat mini-program /miniprogram-demo/tree/master/miniprogram/packageAPI/pages/ar/Plane-ar-v2 ) Page to view the sample code.
3. Can be found at [V2 plane + virtual and real occlusion](https://github.com/WeChat mini-program /miniprogram-demo/tree/master/miniprogram/packageAPI/pages/ar/plane-ar-v2-depth) Page to view the sample code, in the Mini Program exampleInterface - VisionKit Visual Capabilities - Horizontal AR-v2 - Virtual OcclusionExperience in.

# appendix

# V1 Flat Interface System Requirements

1. IOS model requirements: iphone 6s and above
2. Android Model Requirements: Android 7.0, Android SDK 24 and above

# V2 Flat AR Interface Support List

1. IOS model requirements: iphone 7 and above models

2. Android models support will gradually increase, such as the test model effect error can be forum feedback, currently supported models include: