Skip to main content Link Search Menu Expand Document (external link)

@idsensor attribute

:electric_plug: dp.kinect3 dp.oak
:information_source: signature
idsensor ID_STRING
:house: values
sensor specific default
:bulb: examples
@idsensor 14442C10C1A1C6D200
@idsensor USB\VID_045E&PID_02C2\5&1C8A28AD&0&9
@idsensor camera123.mynetwork
@idsensor ip:camera123.mynetwork
@idsensor ip:
@idsensor 2001:db8::1234:5678
@idsensor ip:2001:db8::1234:5678

Bind specific sensor to the plugin. If @idsensor is not set when the plugin receives an open method, it will automatically select the first found sensor.

Consult your sensor manufacturer’s documentation for the id type and format. Examples include: serial number, usb path, network hostname, IP address, etc.

IP network identifiers may be prefixed with ip: to distinguish them.

Get the list of supported sensors with getusbidlist.

:memo: Plugins before v1.3.20210818 use the old name @idkinect. It is deprecated.


Microsoft’s Kinect v1 SDK identifiers are USB connection strings. They are unique to a specific USB port – not to the Kinect itself.


Microsoft’s Kinect v2 SDK only supports one single Kinect v2 per host computer. The identifier is always defaultkinectid.


Microsoft’s Kinect v3 SDK identifiers are serial numbers.


Luxonis OAK SDK identifiers are MXID serial numbers, IP addresses, and network hostnames. Hostnames must be distinguished from MXID serial numbers. Therefore, hostnames must have a dot . in them or be prefixed with ip:

  • ✅Good names camera123.mynetwork,, ip:camera123
  • ❌Bad name camera123