ノウハウ 2018/03/23

OptiTrackのSDKとAPI

OptiTrackのSDKとAPI

OptiTrackから得た情報は、ご自身で開発されるソフトウェアやシステムに活用する事ができます。ここでは、OptiTrackが無償で提供しているSDKとAPIについてご紹介いたします。

SDKとAPI

モーションキャプチャシステム「OptiTrack」は、ソフトウェア開発者向けにSDK(ソフトウェア開発キット)と、コントロールソフトウェア「Motive」のAPI(アプリケーションプログラミングインタフェース)を公開しています。いずれもOptiTrackユーザーの皆さまは無償でご利用いただけます。それぞれの概要は次の通りです。

  NatNet SDK Camera SDK Motive API
主な用途 モーションキャプチャデータのリアルタイムな取得 OptiTrackカメラを使用した画像処理ソフトウェアの開発 Motiveを起動しないOptiTrackの制御(*1)
入手方法 ソフトウェアダウンロードページよりダウンロード ソフトウェアダウンロードページよりダウンロード Motiveと共にインストールされます
対応OS Windows7/8/10
(32bit/64bit)
Windows7/8/10
(32bit/64bit)
Windows7/8/10
(32bit/64bit)
開発言語 C++
C# / VB.NET
C++ C++
サンプルコードの開発環境 Visual Studio 2015 Visual Studio 2008 Visual Studio 2010
サンプルコードの言語 C++/C#/MatLab/
LabVIEW(*2)
Python(*3)
C++ C++

*1 Motiveのライセンスが必要になります。
*2 LabVIEWサンプルは弊社が独自に作成し、公開しているものです。NatNet SDKには含まれていないため、必要な方はお問い合わせください。
*3 Pythonサンプルは、厳密にはNatNet SDKを使用していません。Motiveから送信されたUDPパケットを直接受け取り、データを取得するサンプルになります。

SDK/APIのご利用にあたって

・SDK/APIを使用するには、ソフトウェア開発に関する知識や経験が必要です。独自のソフトウェアを作成するために基本的に必要とされる、統合開発環境(IDE)の使用方法・プロジェクトの設定・コンパイル・リンク等はサポートできかねますのでご了承ください。
・SDK/APIを使用してユーザー様が作成したソフトウェアはサポートいたしかねますのでご了承ください。

OptiTrackのSDK「NatNet SDK」

「NatNet SDK」は、OptiTrackのデータをリアルタイムで取得することができるSDKです。具体的には、MotiveからデータをネットワークにUDP(ユニキャストまたはマルチキャスト)でストリーミングし、そのデータをユーザー様の独自ソフトウェアで受信することができます(同一PC内へのストリーミングも可)。NatNet SDKを利用して、ロボットやドローンのフィードバック制御などを行うことも可能です。

OptiTrackのSDK「NatNet SDK」

【NatNet SDKのスタートアップ】

NatNet SDKはソフトウェアダウンロードページよりZipファイルをダウンロードいただけます。これには、C++用のヘッダーファイル(.h)、スタティックリンクライブラリ(.lib)、ダイナミックリンクライブラリ(.dll)と、.NET用のダイナミックリンクライブラリ(.dll)及び、サンプルコード、ユーザーガイド(英語)が含まれます。また、下記の情報もご参照ください。

ユーザーガイド(日本語/PDF)

・NatNet SDKについて(クラスリファレンスあり)
 Motive1.10以下
 Motive2.0以上

・Motiveのデータストリーミング設定
 Motive1.10以下
 Motive2.0以上

なお、UnityやMayaなどで同様にOptiTrackのデータを使用したい場合、各ソフトウェアのOptiTrackプラグインを公開しています。ソフトウェアダウンロードページよりダウンロードいただけます。

OptiTrackのSDK「Camera SDK」

Camera SDKを使用すると、OptiTrackカメラの機能を利用する独自の画像処理ソフトウェアを開発することができます。Camera SDKは、ハードウェア(カメラおよびハブ)の制御と、各カメラのグレースケール画像や、画像上のマーカーの位置(X,Y座標)など、最も基本的なフレームデータへのアクセスを提供します。

OptiTrackのSDK「Camera SDK」

【Camera SDKのスタートアップ】

Camera SDKはソフトウェアダウンロードページよりZipファイルをダウンロードいただけます。この中身のExeファイルを実行してインストールを行ってください。C++用のヘッダーファイル(.h)、スタティックリンクライブラリ(.lib)、ダイナミックリンクライブラリ(.dll)及び、ドキュメントとサンプルコードがインストールされます。なお、インストール先はデスクトップに作成される「OptiTrack Camera SDK」というショートカットからご確認できます。また、下記の情報もご参照ください。

・Camera SDKについて
 Motive1.10以下
 Motive2.0以上

OptiTrackのAPI「Motive API」

「Motive API」は、Motiveを起動せずにMotiveの機能を使用できるAPIです。Motive APIを使用することで、①キャリブレーションデータを読み込み、②事前に設定されたカメラパラメータにより、③データを取得し処理する といった一連の流れを独自に開発できます。例えば、生産や検査ラインなどのシステムの一部としてOptiTrackを組み込み、作業者がMotiveを操作せずにシステムの立ち上げを完了できます。

OptiTrackのAPI「Motive API」

【Motive APIのスタートアップ】

Motive APIはMotiveと同時にインストールされます。インストール先は下記の通りです。
C:¥Program Files¥OptiTrack¥Motive

¥lib スタティックリンクライブラリ(.lib)
ダイナミックリンクライブラ(.dll)
¥inc ヘッダーファイル(.h)
¥Samples¥markers サンプルコード(C++)

詳細は下記の情報をご参照ください。

・Motive APIについて
 Motive1.10以下
 Motive2.0以上