ToF AR は、Time-of-Flight(ToF)/Light detection and ranging(Lidar)などの距離計測センサーを持つiOS/Andoroidスマートフォン向けの、Unity用ツールキットライブラリです。
サンプルアプリケーションのビルドと実行には、この ToF AR の他に、UnityとToFセンサを搭載した対応スマートフォンが必要です。
ToF AR のパッケージや開発ドキュメント、ToF ARを使ったアプリケーションソフト、対応スマートフォンのリストにつきましては、
ToF AR サイトをご覧ください。
ToF AR Samples AR は ToF AR の機能を使ったサンプルアプリケーションを提供しています。
各シーンは、アプリケーショントップ画面のシーン一覧から選んでください。
シーンからトップ画面に戻るには、4本の指で画面をタップします。
TofARとUnityARFoundationの機能を併用したシンプルなシーン。
Hand、Mesh、Modelingそれぞれの動作を確認することができます。
腕の位置に合わせてパペットを表示します。
ハンド認識を利用して、手の甲に模様を表示します。
手の甲をカメラに向けることで、手の甲に模様を表示します。
ハンド認識を利用したじゃんけんゲーム。
サムズアップジェスチャーを認識すると、ガイダンス音声を再生し、ゲームを開始します。
フェイス、ハンド認識を利用したジャグリング。
セットアップUIに従い、両手を正しい位置に持っていくと、ゲームを開始します。
ボールが落下してきますので、キャッチしてください。
ボールを持っている手を上に振ると、反対側の手に向かってボールが投げられます。
ボールを5回キャッチする度に、新しいボールを追加します。
ハンドや空を検出し、背景を変化させます。
サムズアップジェスチャーを認識すると、背景を変化させます。
認識した環境のMeshに対してテキストアニメーションや写真をマッピングします。
モードは右下の手のアイコンを押し、"Mode DropDown"から変更可能です。
-
TextureAnimationモード： 認識した環境のMeshに対してテキストアニメーションをマッピングします。
-
TextInputモード： 左下にinputfieldが表示します。こちらにテキストを入力すると入力したテキストをマッピングします。
-
Stampモード： "Add Stamp Button"を押すことでカメラロールから写真を選択でき(複数選択可)、マッピングすることができます。
認識した空間にARボールを出現させます。
シーン起動後、空間の認識を行い3DMeshを作成します。
BallのToggleをOnにすると画面上部からボールが出現します。
手や足を画面上に映すと、ボールに触れることが出来ます。
接触した場所から草花が出現します。
シーン起動後、空間の平面認識を行います。
手や足が壁、床に触れるとその場所に草花が出現するアニメーションが表示されます。
サンプルアプリケーションのシーンと、各シーンが利用するToF AR コンポーネントの関係を示すテーブルです。縦にシーン名、横にコンポート名を並べています。チェックマークは、コンポーネント利用を示します。
| ToF | Color | Mesh | Coordinate | Hand | MarkRecog | Body | Segmentation | Face | Plane | Modeling | |
|---|---|---|---|---|---|---|---|---|---|---|---|
| SimpleARFoundation | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
| Puppet | ✓ | ✓ | ✓ | ||||||||
| Hand Decoration | ✓ | ✓ | ✓ | ||||||||
| Rock Paper Scissors | ✓ | ✓ | ✓ | ||||||||
| Juggling | ✓ | ✓ | ✓ | ✓ | |||||||
| BGChange | ✓ | ✓ | ✓ | ✓ | |||||||
| TextureRoom | ✓ | ✓ | ✓ | ✓ | |||||||
| BallPool | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
| StepOn | ✓ | ✓ | ✓ | ✓ |
ToF AR Samples AR は、以下のアセットを提供します。
サンプルシーンのスクリプトやリソースが、コンポーネントごとに格納されています。
各コンポーネントが使用する設定変更UIとして、プレハブやスクリプトが格納されています。
| File | Description |
|---|---|
| Settings.Prefab | 設定操作用UI |
| XXXController.Prefab | 各コンポーネントの設定変更を管理 |
ビルドには、ToF AR と AR Foundation が必要です。
ToF AR はToF AR サイトからダウンロードし、インポートして使用してください。
AR FoundationはToF AR user manualのSetting up AR Foundationを参照して、セットアップを行ってください。
インポート前にプロジェクトを開くと、設定によってはセーフモードへの移行確認メッセージが表示されます。
セーフモードに移行した場合、セーフモードメニューなどからセーフモードを終了してインポートを行ってください。
ToF ARの開発ドキュメントも、ToF AR サイトで公開しています。
- 概要や使い方についてのマニュアルはToF AR user manual
- 各コンポーネントの詳細記事はToF AR reference articles
- APIリファレンスはToF AR API references
動作検証は、下記の環境で行っています。
- Unity Version : 2021.3.31f1
- ToF AR Version : 1.4.0
- AR Foundation : 4.2.8
認識可能なハンドジェスチャーは国・地域によって異なる意味を有する場合があります。
事前に確認されることをお勧めします。
現在、プルリクエストは受け付けておりません。 バグ報告や新規機能のリクエストがありましたらissueとして登録して下さい。
このサンプルプログラムはToF ARを広く利用して頂けるようリリースしております。ご報告頂いたissueについては、検討の上、更新で対応する可能性があります。