# number VKSession.addOSDMarker(string path)

> 基础库 2.24.5 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：支持，需要小程序基础库版本不低于 [2.24.5](1003706)

## 功能描述

添加一个 OSD marker（one-shot detection marker），要求调 [wx.createVKSession](/miniprogram/dev/api/ai/visionkit/wx.createVKSession) 时传入的 track.OSD 为 true

## 参数

### string path

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

## 返回值

### number

marker id

## 使用提示

注意事项：
1. 使用 addOSDMarker 接口之前，需要在 createVKSession 的时候声明开启 OSD 跟踪。即 wx.createVKSession({ track: { OSD: true } })
2. 可以添加多个 OSDMarker 图片，但不能重复添加相同的 OSDMarker 图片。

对传入的图片有如下要求：
1. 格式：jpg 格式彩色图片
2. 分辨率：尺寸不低于 240x240
3. 宽高比：在 1:1 ~ 16:9 之间，要求尽量方正，避免狭长的图片
4. 质量：目标物体需要占画面主体，避免大面积留白，避免大面积文字，不能含其他物体。

示例：

![image.png](https://res.wx.qq.com/op_res/rg0BkiSl-LPBybgJtcQCq_Mq0ReXEA5nOzDIvnYYPttmwxn0V1e_yI6UUgkNT6K6aOQj2QRba5IHQglHULkrKg)

![image.png](https://res.wx.qq.com/op_res/rg0BkiSl-LPBybgJtcQCqwiRcyGk9oenkCpd3vAHWSTSZPPJcgIrPzcpwnSpmk_9bMiCqUdS8Ds789Rjhy0CtA)

![image.png](https://res.wx.qq.com/op_res/rg0BkiSl-LPBybgJtcQCqx8fYUYypBmFmB1_zX-APH06j1oMZDz7K0CE2To_982NDOB5fmM4Y2Rrr1uQF6J4gg)

建议：

1. 具有丰富的细节，避免纯色且形状特点不鲜明的物体，例如：

![image.png](https://res.wx.qq.com/op_res/rg0BkiSl-LPBybgJtcQCq-6WwSZKlNbN-if0NCag-Dm6AmNJeBFi5dvR-bRZINlZmuA9G1e4wpngvhlr2z6CXQ)

2. 避免模糊，最好采用高清图片