Android のシーンのクイックスタート

開発環境を設定する

サンプル プロジェクトを開く

サンプル プロジェクトを取得します。次のいずれかの方法でご対応ください。

  • シーンサンプルをダウンロードして解凍する。

    - または -

  • 次のコマンドを使用して、リポジトリのクローンを作成します。

    git clone https://github.com/google-ar/sceneform-android-sdk.git

Android Studio で、sceneform-android-sdk ディレクトリ内の app サブディレクトリにある Hello Sceneform サンプル プロジェクトを開きます。

デバイスまたはエミュレータを準備する

AR アプリは、サポートされているデバイスまたは Android Emulator で実行できます。

エミュレータでシナリオ アプリを実行するには、追加で要件があります。

  • Android Emulator バージョン 27.2.9 以降が必要です。

  • OpenGL ES 3.0 以降をサポートし、Android エミュレータで有効にする必要があります。

    • エミュレータが最新バージョンを使用するように構成されていることを確認してください。[Extended controls] パネル（ツールバーの その他）で Settings > Advanced > OpenGL ES API level > Renderer maximum (up to Open Open ES 3.1) を選択して、エミュレータを再起動します。

    • エミュレータを実行し、エミュレートされたデバイスを一時的に操作して、OpenGL ES 3.0 以降が使用されているかどうかを確認します。

      adb logcat | grep eglMakeCurrent

      ver 3 0 以上のバージョンが表示されたら、Seneform アプリを実行できます。これより前のバージョンが表示された場合、デスクトップ GPU は OpenGL ES 3.0 をサポートしていないため、サポートされているデバイスを使用してシーンアプリを実行する必要があります。

サンプルの実行

Android デバイスが開発マシンに接続していることを確認し、Android Studio で実行ボタン をクリックします。次に、デプロイの対象としてデバイスを選択し、[OK] をクリックします。

Android Studio でデバッグ可能な APK にプロジェクトがビルドされ、APK がインストールされて、デバイスでアプリが実行されます。詳細については、アプリをビルドして実行するをご覧ください。

Google Play 開発者サービス（AR）がインストールされていないか、古くなっている場合は、インストールまたは更新するように求められることがあります。[続行] を選択して、Google Play ストアからインストールします。

Hello シーン アプリでは、Android のフィギュアを平らなサーフェス上に配置して操作できます。

既存のプロジェクトにシーンを追加する

既存のプロジェクトでシーンを使用するには:

  1. アプリで ARCore を有効にする手順を行います。

  2. シナリオ ライブラリを app's build.gradle ファイルに追加します。

    android {
    // Sceneform libraries use language constructs from Java 8.
    // Add these compile options if targeting minSdkVersion < 26.
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

dependencies {
    …

    // Provides ArFragment, and other UX resources.
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.15.0'

    // Alternatively, use ArSceneView without the UX dependency.
    implementation 'com.google.ar.sceneform:core:1.15.0'
}

次のステップ