Android 版 Sceneform 快速入门

设置您的开发环境

打开示例项目

获取示例项目。您可以选择以下任一解决办法：

  • 下载并提取 Sceneform 示例

    也可以

  • 使用以下命令克隆代码库：

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

在 Android Studio 中，打开 Hello Sceneform 示例项目，该项目位于 sceneform-android-sdk 目录下的 app 子目录中。

准备设备或模拟器

您可以在受支持的设备或 Android 模拟器上运行 AR 应用：

在模拟器中运行 Sceneform 应用还有其他要求：

  • 您需要 27.2.9 或更高版本的 Android 模拟器。

  • Android 模拟器必须支持并启用 OpenGL ES 3.0 或更高版本。

    • 确保您的模拟器已配置为使用最新版本。在“Extended controls”面板（工具栏上的 了解详情）中，依次选择 Settings > Advanced > OpenGL ES API level > Renderer maximum (up to OpenGL ES 3.1)，然后重启模拟器。

    • 运行模拟器，与模拟设备进行短暂的互动，然后检查是否使用了 OpenGL ES 3.0 或更高版本：

      adb logcat | grep eglMakeCurrent

      如果您看到 ver 3 0 或更高版本，则可以运行 Sceneform 应用。如果您看到的是更低版本，则表示您的桌面设备 GPU 不支持 OpenGL ES 3.0，并且您必须使用受支持的设备才能运行 Sceneform 应用。

运行示例

确保您的 Android 设备已连接到开发机器，然后点击 Android Studio 中的 Run 图标 。然后，选择您的设备作为部署目标并点击确定。

Android Studio 将您的项目构建为可调试的 APK，安装该 APK，然后在您的设备上运行该应用。如需了解详情，请参阅构建和运行应用。

如果适用于 AR 的 Google Play 服务缺失或已过期，系统可能会提示您安装或更新。选择继续即可从 Google Play 商店安装它。

借助 Hello Sceneform 应用，您可以在平面上放置和操控 Android 小雕像。

将 Sceneform 添加到现有项目中

如需在现有项目中使用 Sceneform，请执行以下操作：

  1. 按照相关步骤在您的应用中启用 ARCore

  2. 将 Sceneform 库添加到您的 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'
}

后续步骤