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 体验。