Table of Contents

ヘッドマウントディスプレイ拡張パッケージテンプレートの紹介

com.easyar.sense.ext.hmdtemplate パッケージは、ヘッドマウントディスプレイ拡張開発のためのサンプルとテンプレートを提供します。これは SDK の実装であり、アプリ開発者向けのサンプルを含んでいます。

テンプレートの内容

このパッケージの構造は Unity 推奨のファイルレイアウト に従っています:

.
├── CHANGELOG.md
├── Documentation~
├── Editor
├── LICENSE.md
├── package.json
├── Runtime
└── Samples~
    └── Combination_BasedOn_HMD

主な内容は以下の通りです:

  • Runtime:ランタイムプラットフォームアセットを格納するフォルダ。テンプレートで最も重要なフォルダです。
  • Samples~:パッケージ内のすべてのサンプルを格納するフォルダ。下流で使用するサンプルを含み、拡張機能をテストするデモとして使用できます。このサンプルをその場で開発するには、フォルダ名を Samples に変更する必要があります。Client.Pack メソッドを使用すると、新しいリリースをパッケージ化する際に自動的に Samples~ に名前が変更されます。
  • Editor:編集時プラットフォームアセットを格納するフォルダ。このフォルダのスクリプトは主にメニュー項目の作成に使用されます。
  • package.json:パッケージのマニフェストファイル。

テンプレートサンプルの作成手順

  1. AR セッションの追加

    Hierarchy ビューで:

    • 空白 を右クリックし、メニュー EasyAR Sense > Mega > AR Session (Mega Block Default Preset) から ARSession を追加します。
    • AR Session (EasyAR) を選択して右クリックし、メニュー EasyAR Sense > Image Tracking > Frame Filter : Image Tracker から ImageTrackerFrameFilter をセッションに追加します。
    • AR Session (EasyAR) を選択して右クリックし、メニュー EasyAR Sense > SpatialMap > Frame Filter : Dense SpatialMap Builder から DenseSpatialMapBuilderFrameFilter をセッションに追加します。
    • AR Session (EasyAR) を選択して右クリックし、メニュー EasyAR Sense > SpatialMap > Frame Filter : Sparse SpatialMap Builder から SparseSpatialMapBuilderFrameFilter をセッションに追加します。
    • AR Session (EasyAR) を選択して右クリックし、メニュー EasyAR Sense > Extensions > Frame Source : HMD Template (keep it only) から HMD Template の FrameSource を追加し、これのみを保持します。

    alt text

  2. ImageTargetController の追加

    Hierarchy ビューで、空白 を右クリックし、メニュー EasyAR Sense > Image Tracking > Target : Image Target から ImageTargetController をセッションに追加します。

    ImageTargetController の設定:

    alt text

    上記の設定後、Scene ビューに表示される画像は gizmo です。このサンプルでは、同じ画像を表示するために quad を使用しています。

    ターゲット上に表示する仮想オブジェクトの追加:

    alt text

  3. モーショントラッキングの原点参照としてモデルを追加

    このモデルは、デバイスのモーショントラッキングと EasyAR アルゴリズムを分離するために、開発者および下流ユーザーにとって重要です。

    alt text

  4. 機能選択用 UI の追加

    alt text

  5. 起動時に有効化される EasyAR 機能を無効にし、UI スイッチで有効化

    例えば、イメージトラッキング機能は起動時に無効にできます。対応するコンポーネントの enable を false に設定するだけです:

    alt text

    次に UI スイッチ処理を追加します:

    alt text

関連トピック