- Depth API の開発環境を設定する
- サンプルアプリでオクルージョンを試して深度マップを可視化する
Prerequisites
- Android Studio バージョン 3.1 以降（Android SDK Platform バージョン 7.0（API レベル 24）以降）
- 深度に対応している Android デバイス。詳細については、サポートされているデバイスのリストをご覧ください。
- Android 開発に関する基本的な知識Android を初めて使用する場合は、初心者向けの初めての Android アプリを作成するをご覧ください。
- Depth API に関する基礎知識。Depth を初めて使用する場合は、Depth API の概要をご覧ください。
サンプル プロジェクトを開く
このクイックスタートでは、OpenGL を使用します。これは、2D と 3D のベクター グラフィックをレンダリングするためのプログラミング インターフェースです。次の手順を開始する前に、ARCore を有効にするをご覧ください。
次のコマンドを使用して、リポジトリのクローンを作成してサンプル プロジェクトを取得します。
git clone https://github.com/google-ar/arcore-android-sdk.git
Android Studio で、arcore-android-sdk ディレクトリ内の samples サブディレクトリにある hello_ar_java サンプル プロジェクトを開きます。
サンプルの実行
Depth API サンプルアプリを使用すると、環境に Android の仮想人物を配置し、オクルージョンを切り替えて違いを確認できます。また、特定の空間で深度マップを可視化することもできます。
Android デバイスが開発マシンに接続されていて、Android Studio で Run 
をクリックします。
Google Play 開発者サービス（AR）をインストールまたは更新していない場合、デバイスにインストールまたは更新を求めるメッセージが表示されることがあります。CONTINUE をタップして Google Play ストアからインストールします。
深度を有効にする
アプリを実行して Android フィギュアを初めて配置するときに、深度を有効にするように促すダイアログが表示されます。アプリを初めて実行したときにのみ、最初に Android が配置されます。Enable をタップしてオクルージョンを追加します。
オクルージョンと深度マップの可視化を切り替える
歯車アイコンをタップして、オクルージョンと深度マップの表示を切り替えます。Enable depth を選択してオクルージョンを有効にします。Show depth map を選択すると、デバイスの画面に深度マップが可視化されます。
たとえば、以下の画像は、実際のスペースに Android の仮想人物を配置し、ドアにトランクが収められていることを示しています。最初の画像では、仮想 Android がトランクのエッジと非現実的に重複しています。2 つ目の画像では、Android が適切にオクルージョンされており、周囲のかなり現実的なものに見えています。
次の画像は、自転車が壁に設置された玄関のカメラ画像と、そのカメラ画像用に作成された深度マップを可視化したものです。
次のステップ
各アプリで Depth API の使用を開始しましょう。詳しくは、下記を参照してください。