# number VKSession.addMarker(string path)

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

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

# 功能描述

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

# 参数

# string path

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

# 返回值

# number

marker id

# 使用提示

注意事项：

使用 addMarker 接口之前，需要在 createVKSession 的时候声明开启 marker 跟踪。即 wx.createVKSession({ track: { marker: true } })
可以添加多个 marker 图片，但不能重复添加相同的 marker 图片。
在v2模式下同时支持水平面检测与marker检测，同时可输出多个2d/3d marker位姿（需要基础库版本不低于 2.33.0

# 2Dmarker

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

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

示例：

建议：

图片具有丰富的细节
避免重复单一的纹理，例如：

避免使用柔和平滑边缘的纹理及大量渐变图像，例如：

避免模糊，建议采用高清、高对比度图像作为识别对象
建议图像有均匀的特征（角点）分布，正确示例：

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

# 3Dmarker

现小程序demo支持通过上传视频, 生成对应模型的3dmarker识别文件,后缀名为.map

对传入的视频有如下要求： 1.视频长宽比为16:9或4:3; 短边大于480px 2.目标物体易于和背景物体区分出来，同时目标物体放置与背景物体一定距离，放置底面与物体易于区分，底面可以放置一张白纸，例如：

3.目标物体最好为刚体，本身不会发生较大形变，容易变形的物体不适合用作识别对象 4.视频匀速移动，避免模糊，对目标识别面环绕物体拍摄，需要保证相机有足够的平移移动 5.marker物体要求与2d图像要求类似，具有丰富细节，避免重复单一纹理，不反光，无高光 6.拍摄视频中特征纹理丰富，如果marker本身问题较弱，可以在背景中适当添加纹理物体服务耗时：当前版本30s视频耗时约20分钟，请静待算法返回模型

建议：

1.视频格式：视频帧率30fps，分辨率建议1080p 2.视频时长：视频建议时长在20s~30s，超过30s会被截断，时长过短会导致marker效果欠佳