Skip to content

Latest commit

 

History

History
114 lines (68 loc) · 5.51 KB

step1.md

File metadata and controls

114 lines (68 loc) · 5.51 KB

Raspberry Pi Mouseのハードウェアモデルデータの読み込み

概要

Raspberry Pi Mouseのハードウェアモデルデータ（URDFモデル）をUnityにインポートします。

インポートにはUnity-Technologies/URDF-Importerを用います。

Unityプロジェクトの新規作成までの手順はSTEP0をご参照ください。 本ステップ実行後の状態のSceneファイルはMobileRobotUITutorialProject/Assets/Scenes/Step1.unityから入手できます。

動作確認済環境

  • Windows
    • Windows 10 Home バージョン 21H2
    • Windows 11 Pro バージョン 22H2
  • Unity
    • Unity 2021.3.4f1
    • Unity 2022.3.8f1
  • Unity-Technologies/URDF-Importer v0.5.2

手順

1. パッケージマネージャからURDF-Importerをインストール

パッケージマネージャからURDF-Importerをインストールします。パッケージマネージャはメニューバーのWindow -> Package Managerから開けます。

左上の＋ボタンからAdd package from git URLをクリックします。

URDF-ImporterのGitリポジトリへのURLを最新のタグを指定して入力し、Addをクリックします。2023年9月現在の最新のタグはv0.5.2です。 この場合のGitリポジトリへのURLは https://github.com/Unity-Technologies/URDF-Importer.git?path=/com.unity.robotics.urdf-importer#v0.5.2 となります。
※今後のバージョンアップによって使い方が変わる可能性があります。本チュートリアルでは「動作確認環境」に記載のバージョンでのみ動作確認をしています。

2. URDFモデルを入手

URDFモデルをダウンロードし、Unityプロジェクト内のAssets/URDFフォルダへ配置します。 今回はURDFモデルを予め本プロジェクトと一緒にダウンロードしているのでコピーして配置します。

まず、UnityのProjectパネルで、Assets/URDFフォルダを作成します。

次に作成したAssets/URDFをエクスプローラで開きます。

ROS/src/raspimouse_descriptionフォルダをURDFフォルダへコピーします。 Windowsの場合はCtrlキーを押しながらドラッグすると移動ではなくコピーができます。

次にコピーしてきたraspimouse_descriptionフォルダ内のurdf/raspimouse_with_urg.urdfを作成したAssets/URDFにコピーしておきます。 この配置とすることでURDFモデルをURDF-Importerを使ってインポートする時にモデルデータのパスが解決できるようになります。 （.metaファイルはUnityで自動的に生成されるものなので無視して構いません）

ここまででURDFモデルの準備は完了です。

3. URDFモデルをUnityで読み込む

URDFモデルをUnity上で読み込み、次のSTEP以降で必要な設定をしておきます。

まず、Assets/URDF内のraspimouse_with_urg.urdfを右クリックしてImport Robot from Selected URDF fileをクリックします。

その後URDF Import SettingsパネルでAxis TypeをY axisに、Mesh DecomposerをVHACDでImport URDFをクリックします。

エラーなくインポートできればSceneビューにRaspberry Pi Mouseが出現しているはずです。

URDF-Importerで読み込んだロボットモデルはUnity上で物理シミュレーションができるように Articulation Bodyが適用されます。 しかし、今回はUnityを物理シミュレーションではなくUI開発に使用するので、以下のGameObjectのArticulation Bodyを無効にします。

  • base_link
  • right_wheel_link
  • left_wheel_link
  • urg_mount_link
  • lidar_link

さらにraspimouseGameObjectにアタッチされているControllerスクリプトを無効にしておきます。

以上でURDFのインポートは完了です。

本STEPのまとめ

URDFモデルを準備し、URDF-Importerを使ってUnityのプロジェクトにインポートする方法を紹介しました。 さらにUnityの物理演算を使わない場合のGameObjectの設定についても紹介しました。

今回は同梱しているURDFモデルを使いましたが、他のURDFモデルを使用することもできます。 例えば、Raspberry Pi Mouseと同じくアールティから販売されているJetson Nano Mouseを使おうと思った場合はrt-net/jnmouse_descriptionからデータをダウンロードしてプロジェクトに取り込めばURDF-Importerを使って同じようにロボットを表示させることができるようになります。

また、付録ページにおいて、Raspberry Pi Mouse以外のURDFモデルを実際に使用する方法を紹介しています。