🔖

LeapMotion使い方&Unity接続方法

2025/06/06に公開

Unity

leapmotion

tech

概要

LeapMotionを使う機会があったので自分用のメモとして記述
基本的に公式マニュアル通りの手順で行う
初学者でも導入が可能になるはず
Unityは導入している前提で記述する

使用物

LeapMotionController(LookingGlass付属物)

Leap Motion SDK (Gemini Version v5.20.0)

Unity.2022.3.0 LTS

参考資料

①LeapMotion(Ultraleap)をPCと接続する

USBTypeA-USBTypeB(3.0)コードで接続

②Ultraleap実行アプリ(LeapMotionSDK)をダウンロードする

https://www.ultraleap.com/　(公式サイト)からSoftware→ダウンロード

→LeapMotionController

→SelectをWindowsに変更

→ Gemini Version v5.20.0をダウンロード

インストール後(tracking-software-windows-5.20.0)、ライセンスをacceptしてダウンロード先を決めてインストール

●インストール内容

Installing:

  Ultraleap Tracking

Components that will be installed:

  Ultraleap Tracking Service 

  Ultraleap Tracking SDK 

  Ultraleap Tracking Control Panel 

  Ultraleap Tracking OpenXR API Layer

完了後Windowsスタートから Ultra Control Panel を起動

正常に動作すれば以下の画像のようになる

※顔が下にくるようにLeapMotionカメラを設置

後述するUnity起動時もUltra Control Panelを起動し続ける

③Leap Motion用Unity Modulesを導入する

・OpenUPMを使う方法

Unity 2022.3.0 LTSの3Dコアで起動する

起動後、Unity上部 Edit -> Project Settings -> Package Managerを開く

Name:Ultraleap

URL: https://package.openupm.com 

Scope(s): com.ultraleap

を記入してインストール

Unity上部Window -> Package Managerを選択

上部のPackagesのIn Project から My Registries に変更

Ultraleap Tracking を選択してインストール

Samplesを選択し、Tabletop Examplesをインポートする

Assets > Samples > Ultraleap Tracking > バージョン名(7.2.0) > Tabletop Examples > 1.Capsule Hands (Desktop).unityを選択

仮の手と同期アセットが配置される

実行して同期して動けば成功

▽エラー例

・Ultra Control PanelでLeapMotionとの接続が感知されない

・Unityを実行しても手が感知されない

バージョンを確認する。2022.3以前では動かなかった

・インポートしたけどエラーが発生する

私は再インポートすることで改善できた

・公式パッケージの場合

Ultraleap.Tracking.unitypackageをダウンロード

Unity→Import package→Custum packageで上記を選択してインポート

Window→Package Manager→UnityRegistry→UniversalRPをインポート

OpenUPMと公式パッケージの違い

OpenUPM(Open Unity Package Manager)はコミュニティが運営するUnityのオープンソースパッケージの配信プラットフォーム
Unityで手軽にインストール・アップデートができるが非公式かつ公式の完全サポートがない

公式パッケージは公式が出しているパッケージのこと

あとがき

Ultra Control Panelで映像を映したときは顔が下側にないとうまく手が反映されなかった。また、今回はDeskTop版(机の上にLeapMotionを置いて上にカメラを向ける方法)で導入した。Tracking-softwareはGeminiとOrionでかなり違いがあるため、混合しないように気を付けたい

概要

使用物