# number VKSession.addMarker(string path)

基础库 2.24.5 开始支持,低版本需做兼容处理

小程序插件:支持,需要小程序基础库版本不低于 2.24.5

# 功能描述

添加一个 marker,要求调 wx.createVKSession 时传入的 track.marker 为 true

# 参数

# string path

图片路径,目前只支持本地用户图片

# 返回值

# number

marker id

# 使用提示

注意事项:

  1. 使用 addMarker 接口之前,需要在 createVKSession 的时候声明开启 marker 跟踪。即 wx.createVKSession({ track: { marker: true } })
  2. 可以添加多个 marker 图片,但不能重复添加相同的 marker 图片。

对传入的图片有如下要求:

  1. 格式:jpg/png 格式三通道彩图或者 1 通道灰度图
  2. 分辨率:尺寸在 480x480 ~ 1920x1920 之间,建议为 1080 分辨率
  3. 宽高比:在 1:1 ~ 16:9 之间,要求尽量方正,避免狭长的图片
  4. 质量:目标图像为平面模型,需要占画面主体,避免大面积留白,建议用扫描件

示例:

image.png

建议:

  1. 图片具有丰富的细节
  2. 避免重复单一的纹理,例如:
image.png
image.png
image.png
  1. 避免使用柔和平滑边缘的纹理及大量渐变图像,例如:
image.png
  1. 避免模糊,建议采用高清、高对比度图像作为识别对象
  2. 建议图像有均匀的特征(角点)分布,正确示例:
image.png

避免角点较少、中间大量空白、没有特征及角点的图像,错误示例:

image.png