Быстрое начало работы с формой сцены для Android

Настройте среду разработки

Откройте пример проекта

Получите примеры проектов. Вы также можете:

  • Загрузите и распакуйте образцы Sceneform

    -или же-

  • Клонируйте репозиторий с помощью следующей команды:

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

В Android Studio откройте пример проекта Hello Sceneform , расположенный в подкаталоге app внутри каталога sceneform-android-sdk .

Подготовьте свое устройство или эмулятор

Вы можете запускать приложения дополненной реальности на поддерживаемом устройстве или в эмуляторе Android:

Существуют дополнительные требования для запуска приложений Sceneform в эмуляторе:

  • Вам нужен эмулятор Android версии 27.2.9 или новее.

  • OpenGL ES 3.0 или выше должен поддерживаться и быть включенным в эмуляторе Android.

    • Убедитесь, что ваш эмулятор настроен на использование последней версии. В расширенной панели управления (Более на панели инструментов) выберите « Настройки» > «Дополнительно» > «Уровень API OpenGL ES» > «Максимум рендерера» (до OpenGL ES 3.1) и перезапустите эмулятор.

    • Запустите эмулятор, кратко поработайте с эмулируемым устройством, затем проверьте, используется ли OpenGL ES 3.0 или выше:

      adb logcat | grep eglMakeCurrent

      Если вы видите версию 30 или выше, вы можете запускать приложения ver 3 0 . Если вы видите более раннюю версию, ваш настольный графический процессор не поддерживает OpenGL ES 3.0, и вы должны использовать поддерживаемое устройство для запуска приложений Sceneform.

Запустите образец

Убедитесь, что ваше устройство Android подключено к машине разработки, и нажмите « Выполнить» . в Android Studio. Затем выберите свое устройство в качестве цели развертывания и нажмите OK .

Android Studio преобразует ваш проект в отлаживаемый APK, устанавливает APK, а затем запускает приложение на вашем устройстве. Дополнительные сведения см. в разделе Сборка и запуск приложения .

Вам может быть предложено установить или обновить Сервисы Google Play для AR , если они отсутствуют или устарели. Выберите ПРОДОЛЖИТЬ , чтобы установить его из магазина Google Play.

Приложение Hello Sceneform позволяет размещать фигурки Android и управлять ими на плоских поверхностях.

Добавить Sceneform в существующий проект

Чтобы использовать Sceneform в существующем проекте:

  1. Следуйте инструкциям, чтобы включить ARCore в вашем приложении.

  2. Добавьте библиотеку 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'
}

Следующие шаги