mcpField
A
ar-vr-design

ar-vr-design

github.com/alphaonedevデザイン・UI45 回インストール
リポジトリ

ar-vr-design について

ar-vr-design は、没入型アプリを開発する人向けの AR/VR 体験設計スキルです。3D アセットの処理、空間インタラクション、デバイス向け UI 最適化、シミュレーションを扱います。

主な機能

  1. 01GLTF・OBJ モデルの入出力
  2. 02ルームスケールマッピングと遮蔽・衝突検出
  3. 03AR/VR デバイス向けレンダリング最適化
  4. 04ジェスチャーと触覚操作のシミュレーション

活用シーン

  1. 01AR 商品オーバーレイの作成
  2. 02VR トレーニングシミュレーションの構築

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill ar-vr-design

インストール後、Claude Code で/ar-vr-designを入力して読み込まれたか確認します。

詳細

ar-vr-design

目的

このスキルは、3D モデリング、空間コンピューティング、UI の最適化を組み合わせて、インタラクティブな AR/VR 体験を設計します。バーチャルトレーニングや拡張オーバーレイなどのアプリケーション向けに、没入型の環境を作成できます。

使用するタイミング

バーチャル美術館ツアーや、eコマースアプリでの AR 製品ビジュアライゼーションなど、3D アセットの操作、空間インタラクション、または VR 固有の UI 調整が必要なプロジェクトで使用します。

主な機能

  • 組み込みのパーサーを使用して、GLTF や OBJ などの形式で 3D モデルをインポートおよびエクスポートします。
  • オクルージョンや衝突検知のアルゴリズムを使用したルームスケールマッピングなど、空間コンピューティングのタスクを実行します。
  • Oculus や HoloLens などのヘッドセット向けにレンダリングを調整し、レイテンシーを 20ms 未満に抑えるなど、AR/VR デバイス向けに UI を最適化します。
  • 仮想環境でユーザーのインタラクションをシミュレーションし、ジェスチャー操作や触覚フィードバックをテストします。

使用パターン

タスクを実行するには、次の手順に従います。まず、必要な設定でプロジェクトを初期化し、次に 3D アセットを作成して操作します。その後、インタラクションに空間コンピューティングを適用し、最後に最適化とシミュレーションを行います。コマンドを実行する前に、認証用の環境変数を必ず設定してください。例：export SERVICE_API_KEY=your_key。統合する際は、このスキルの出力をメインのアプリケーションループ内でラップします。

主なコマンド/API

基本操作には arvr-cli ツールを使用します。環境変数 $ARVR_API_KEY を使用して認証します。

  • コマンド：arvr-cli init --project myvrapp --type vr

    • 新しい VR プロジェクトを初期化します。AR モードにするには --ar フラグを追加します。
    • 使用例： 
      export ARVR_API_KEY=abc123
arvr-cli init --project myvrapp

  • API エンドポイント：POST /api/vr/models

    • 3D モデルをアップロードします。{ "model": "path/to/model.gltf", "scale": 1.5 } を含む JSON ペイロードが必要です。
    • 使用例： 
      curl -H "Authorization: Bearer $ARVR_API_KEY" -X POST -d '{"model": "asset.gltf"}' https://api.openclaw.com/api/vr/models

  • コマンド：arvr-cli optimize --input model.obj --device oculus

    • 特定のデバイス向けにモデルを最適化し、最適化されたファイルを出力します。
    • 使用例： 
      arvr-cli optimize --input scene.glb --device hololens

  • API エンドポイント：GET /api/ar/spatial-map

    • 空間データを取得します。?roomSize=10x10 などのパラメーターを指定してクエリします。
    • 使用例： 
      curl -H "Authorization: Bearer $ARVR_API_KEY" https://api.openclaw.com/api/ar/spatial-map?roomSize=5x5

設定形式：プロジェクト設定には JSON を使用します。例：{ "assets": ["model1.obj"], "spatialSettings": { "gravity": 9.8 } }。

統合に関する注意

Unity や Unreal などのエンジンに出力をインポートして、このスキルをワークフローに統合します。たとえば、arvr-cli init を実行した後、生成されたファイルを Unity プロジェクトにコピーし、スクリプトから参照します。カスタムコードでの API 呼び出しには $ARVR_API_KEY を使用します。他のスキルと連携させるには、標準入力／標準出力を介して出力をパイプします。例：3D モデリングスキルの出力をこのスキルの入力に渡します。互換性を確保するため、形式を合わせてください。統合前にモデルを必ず GLTF に変換します。

エラー処理

コマンドの終了コードを確認してエラーを処理し、API 呼び出しでは HTTP レスポンスを解析します。よくある問題：

  • 認証エラー：$ARVR_API_KEY が無効な場合、コマンドはコード 401 を返します。正しいキーを確認してエクスポートし、修正します。
  • 無効なモデル形式：arvr-cli validate --file model.obj を使用します。コード 400 で失敗する場合は、Blender などのツールでファイルを変換します。
  • エラー確認の使用例： 
    response=$(curl ...); if [ $? -ne 0 ]; then echo "API error: $response"; fi

スクリプト内では、API 呼び出しを必ず try-catch ブロックで囲みます。例：Python では try: requests.post(url) except Exception as e: log_error(e) のようにします。

具体的な使用例

  1. モバイルアプリ向けのシンプルなARオーバーレイを設計する：まず、arvr-cli init --project ar-overlay --type ar を実行します。次に、curl -X POST -d '{"model": "overlay.glb"}' https://api.openclaw.com/api/vr/models で3Dモデルをアップロードします。モバイル向けに最適化するには、arvr-cli optimize --input overlay.glb --device android を実行します。最後に、Unity の AR Foundation を使用して、出力を Android アプリに統合します。

  2. トレーニング用のVRシミュレーションを作成する：arvr-cli init --project vr-training --type vr で初期化します。空間マッピングを追加するには、curl https://api.openclaw.com/api/ar/spatial-map?roomSize=10x10 を実行します。インタラクションを構築するには、API を使用してジェスチャーをシミュレートし、arvr-cli simulate --project vr-training でテストします。Unreal Engine にエクスポートしてインポートし、本番環境にデプロイします。

グラフの関係

  • 関連クラスター：ar-vr（例：ar-vr-development などのスキルとタグを共有します）。
  • タグによる関連付け：["ar-vr"] は他のAR/VRスキルにリンクし、["design"] は ui-design および 3d-modeling スキルに関連付けます。
  • 依存関係：入力として 3d-modeling スキルの出力が必要です。

コメント

Markdown 対応