jp.keijiro.apriltag - AprilTag package for Unity
jp.keijiro.apriltag is a Unity package that provides an implementation of
the AprilTag tracker.
AprilTag is a marker based tracking system developed by the APRIL Robotics
Laboratory at the University of Michigan. Please see the AprilTag web page
for further details.
System requirements
At the moment, this package supports the following systems:
- Windows (x86-64), macOS (x86-64), Linux (x86-64), iOS (arm64), Android (arm64)
How to try the sample project
Clone this repository and play the WebCamTest.unity
scene on Unity Editor.
The current version of the TagDetector component only supports the
tagStandard41h12
tag set. You can download those tag images from
the apriltag-imgs repository. Print some of them using a printer. You also can
use a smartphone screen to display the tags.
The WebCamTest
component uses the Field of View value of the main camera to
estimate tag positions. You can try the sample without adjusting it, but it may
give incorrect depth information. To get accurate tag positions, you should
match the FoV value with the actual camera FoV.
For example, I'm using Zoom Q2n-4K video camera for testing, which gives about
78 degrees horizontal FoV at the mid-angle mode. So I changed the FOV Axis to
"Horizontal" and the Field of View value to 78.
How to install the package
This package uses the scoped registry feature to import dependent packages.
Please add the following sections to the package manifest file
(Packages/manifest.json
).
To the scopedRegistries
section:
{
"name": "Unity NuGet",
"url": "https://unitynuget-registry.azurewebsites.net",
"scopes": [ "org.nuget" ]
},
{
"name": "Keijiro",
"url": "https://registry.npmjs.com",
"scopes": [ "jp.keijiro" ]
}
To the dependencies
section:
"jp.keijiro.apriltag": "1.0.0"
After changes, the manifest file should look like below:
{
"scopedRegistries": [
{
"name": "Unity NuGet",
"url": "https://unitynuget-registry.azurewebsites.net",
"scopes": [ "org.nuget" ]
},
{
"name": "Keijiro",
"url": "https://registry.npmjs.com",
"scopes": [ "jp.keijiro" ]
}
],
"dependencies": {
"jp.keijiro.apriltag": "1.0.0",
...