Google is committed to advancing racial equity for Black communities. See how.

Android 快速入门

设置您的开发环境

打开示例项目

此快速入门使用 Sceneform,这个 3D 框架可让 Java 开发者在不使用 OpenGL 的情况下轻松地构建 ARCore 应用。 要在不使用 Sceneform 的情况下在您的应用中利用 ARCore,请查阅启用 ARCore 文档。

要继续使用 Sceneform,请获取示例项目。 您可以:

  • 下载并提取 Sceneform 示例

    -或-

  • 通过以下命令克隆代码库:

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

在 Android Studio 中,打开位于 sceneform-android-sdk/ 目录中的 Hello Sceneform 示例项目。

准备您的设备或模拟器

您可以在支持的设备或 Android Emulator 上运行 AR 应用。

  • 在该模拟器中,您必须登录应用商店或手动更新 ARCore

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

  • 您需要 Android Emulator 27.2.9 或更高版本。
  • Android Emulator 必须支持并启用 OpenGL ES 3.0 或更高版本。

    • 确保您的模拟器已配置为使用最新版本。 在扩展的控制面板中(工具栏上的更多 )中,选择 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 。 然后,选择您的设备作为部署目标并点击 OK

Android Studio 将您的项目构建成一个可调试 APK,安装该 APK,然后在您的设备上运行该应用。 如需了解详细信息,请参阅构建和运行您的应用

如果 ARCore 应用缺失或过时,系统可能会提示您进行安装或更新。 选择 CONTINUE,从 Google 应用商店安装它。

hellosceneform 应用允许您在平坦表面上放置和操纵 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.5.0'
    
        // Alternatively, use ArSceneView without the UX dependency.
        implementation 'com.google.ar.sceneform:core:1.5.0'
    }
    

后续步骤

  • 尝试在 ARCore SDK 和 Sceneform 示例中构建和运行其他示例项目。
  • 了解如何在您的应用中启用 ARCore
  • 使用增强图像来构建能对用户环境中的海报或徽标等 2D 图像作出响应的应用。
  • 利用云锚点来打造 Android 和 iOS 用户可共享的 AR 体验。