Hướng dẫn bắt đầu nhanh về biểu mẫu dành cho Android

Thiết lập môi trường lập trình của bạn

Mở dự án mẫu

Lấy dự án mẫu. Bạn có thể:

  • Tải và trích xuất Mẫu mẫu

    –hoặc–

  • Hãy sao chép kho lưu trữ bằng lệnh sau:

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

Trong Android Studio, hãy mở dự án mẫu Hello Sceneform (Biểu mẫu Xin chào) nằm trong thư mục con của app (ứng dụng) trong thư mục sceneform-android-sdk.

Chuẩn bị thiết bị hoặc trình mô phỏng

Bạn có thể chạy các ứng dụng thực tế tăng cường trên một thiết bị được hỗ trợ hoặc trong Trình mô phỏng Android:

Có một số yêu cầu bổ sung để chạy các ứng dụng theo dõi trong trình mô phỏng:

  • Bạn cần có Trình mô phỏng Android phiên bản 27.2.9 trở lên.

  • OpenGL ES 3.0 trở lên phải được hỗ trợ và bật trong Trình mô phỏng Android.

    • Đảm bảo trình mô phỏng của bạn được định cấu hình để dùng phiên bản mới nhất. Trong bảng Điều khiển mở rộng (Thêm trên Thanh công cụ), hãy chọn Settings > Advanced > OpenGL ES API level > Trình kết xuất tối đa (lên đến OpenGL ES 3.1), rồi khởi động lại trình mô phỏng.

    • Chạy trình mô phỏng, tương tác nhanh với trình mô phỏng, sau đó kiểm tra xem bạn có đang sử dụng OpenGL ES 3.0 trở lên hay không:

      adb logcat | grep eglMakeCurrent

      Nếu thấy ver 3 0 trở lên, bạn có thể chạy các ứng dụng Sceneform. Nếu bạn thấy phiên bản thấp hơn, thì GPU máy tính để bàn của bạn không hỗ trợ OpenGL ES 3.0 và bạn phải dùng một thiết bị được hỗ trợ để chạy các ứng dụng Sceneform.

Chạy mẫu

Đảm bảo thiết bị Android của bạn đã kết nối với máy phát triển và nhấp vào Run (Chạy) trong Android Studio. Sau đó, hãy chọn thiết bị của bạn làm mục tiêu triển khai rồi nhấp vào OK.

Android Studio tạo dự án của bạn thành một tệp APK có thể gỡ lỗi, cài đặt tệp APK, sau đó chạy ứng dụng trên thiết bị. Để biết thêm thông tin, hãy xem phần Tạo và chạy ứng dụng của bạn.

Bạn có thể được nhắc cài đặt hoặc cập nhật Google Play Services for AR (nếu bị thiếu hoặc lỗi thời). Chọn TIẾP TỤC để cài đặt từ Cửa hàng Google Play.

Ứng dụng Hello Sceneform (Biểu mẫu Xin chào) cho phép bạn đặt và thao tác các mô hình Android nhỏ trên các bề mặt phẳng.

Thêm Sceneform vào một dự án hiện có

Cách sử dụng Sceneform trong một dự án hiện có:

  1. Làm theo các bước để Bật ARCore trong ứng dụng

  2. Thêm thư viện Sceneform vào tệp build.gradle của ứng dụng:

    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'
}

Các bước tiếp theo