Zenn
🕶️

OculusHandTools を使おうとしたらエラーだった件 👋

2024/12/18に公開
VR
UE5
tech

MMA Advent Calendar 2024 18日目の記事です

初めまして！

UE5.4にOculusHandTools プラグインを取り込むまでの話です。
筆者は Unreal Engine と VR を半年触っていて、記事はこれが初投稿です。この記事の結論は、HandPoseShowcase を Visual Studio でビルドしたらなんか上手く取り込めるようになった、ということで、参考になるかはよくわかりません。ですが、このサンプルプロジェクトについての情報が少なく感じたので書きました。誰かの参考になればうれしいです。

前提条件

  • HMD：MetaQuest3
  • 開発ツール：UE5.4.4, Visual Studio 2022
  • MetaXR ver71.0導入済み
  • PCスペック：Windows 11 / Radeon RX6800 / intel CORE i7
  • この記事では HandPoseShowcase の 5.4.4-v71 をダウンロードします

UE5でジェスチャー認識をしたい。いい感じのプラグインが OculusHandTools だった。

OculusHandTools は、サンプルプロジェクト HandPoseShowcase の中に含まれています。そのため、OculusHandTools を使うためには HandPoseShowcase をダウンロードし、HandPoseShowcase の中のプラグインファイルを取り出してプラグインフォルダに配置するだけです。
これで使えるようになるはずですが、プラグインを配置してプロジェクトを起動すると次のようなエラーがでました。

エラーの内容

初心者が沼に落ちたので解決策を出してみた

さて、記事の本題です。HandPoseShowcase を UE5.4 で開くための手順が書かれています。▽

  1. サンプルプロジェクト HandPoseShowcase をダウンロードします。5.4.4-v71 を選んでください。
    5.4.4-v71を選択する
  2. UnrealEngine-oculus-5.4 をダウンロードします。 こちらのバージョンはデフォルトの oculus-5.4 を入れました。
  1. 2でダウンロードした UnrealEngine-oculus-5.4 を展開し、その中にある setup.bat を実行します。

  1. UnrealEngine-oculus-5.4 フォルダに移動 → 空いている場所を右クリック → [ターミナルで開く] を選ぶ

  2. ターミナルで以下のコマンドを実行します。

.\GenerateProjectFiles.bat -Game HandPoseShowcase -Engine <full path to Unreal-HandPoseShowcase directory>\HandPoseShowcase.uproject

こんな感じ▽

  1. UnrealEngine-oculus-5.4 フォルダに HandPoseShowcase.sln が作成されたので、Visual Studio で開きます。

  1. HandPoseShowcase を右クリックし、[スタートアッププロジェクトに設定] を選びます。

  2. キーボードの [F5] を押します。ビルドが始まります。もし途中でビルドを終了したい場合は、Visual Studio 上部のビルド > キャンセル で取り消せます。

  1. エクスプローラーに戻り、サンプルプロジェクトの HandPoseShowcase.uproject をクリックします。Unreal Engine が立ち上がり、HandPoseShowcase が開かれるはずです。OculusHandTools プラグインをコピーして自分のプロジェクトに配置するとジェスチャー認識が使えるようになります。お疲れ様でした！

開けない場合に確認すること

それでもエラー [Missing HandPoseShowcase Modules] が出てくるときに関係がありそうなことをメモしておきます。現時点では明確な解決策が見つかっていないため、参考程度に受け取ってください。

  • 手順6で開いた Visual Studio 上に、 Engine > UE5 > plugins > Marketplace > MetaXR が存在しない。▽
  • さらに下の方までスクロールし、MarketplaceRules が存在しない。▽
  • 51/51のプロジェクトが入っていない。(50/50のプロジェクトなどになっている)▽

おわりに

以上、UE5.4に OculusHandTools プラグインを取り込むまでの話でした。この方法でうまくいく場合とそうでない場合があること(成功率66%, n=3)がわかりました。まだまだ調べたりないというのが正直な感想です。プラグインを使えた方は、ジェスチャー認識の活用方法について記事やブログで共有していただけると筆者が喜びます！

Discussion