Bật tính năng thực tế tăng cường (AR) trong ứng dụng Android

Bật công nghệ thực tế tăng cường (AR) để sử dụng các tính năng thực tế tăng cường trong ứng dụng mới hoặc ứng dụng hiện có.

Định cấu hình ứng dụng của bạn thành Bắt buộc phải sử dụng công nghệ thực tế tăng cường (AR) hoặc Không bắt buộc về công nghệ thực tế tăng cường

Để tiết kiệm dung lượng trên từng thiết bị, tất cả tính năng AR được lưu trữ trong một ứng dụng có tên là Dịch vụ Google Play cho AR. Ứng dụng này sẽ được Cửa hàng Play cập nhật riêng. Ứng dụng Android sử dụng tính năng thực tế tăng cường kết nối với Dịch vụ Google Play cho Thực tế tăng cường bằng SDK ARCore. Bạn có thể định cấu hình một ứng dụng hỗ trợ các tính năng thực tế tăng cường theo 2 cách: Bắt buộc thực tế tăng cường và Không bắt buộc đối với công nghệ thực tế tăng cường. Chỉ định này xác định cách ứng dụng tương tác với ứng dụng Dịch vụ Google Play cho thực tế tăng cường.

Ứng dụng Yêu cầu phải có AR không thể hoạt động nếu không có ARCore. Tính năng này yêu cầu thiết bị hỗ trợ ARCore đã cài đặt Dịch vụ Google Play cho Thực tế tăng cường.

• Cửa hàng Google Play sẽ chỉ cung cấp các ứng dụng Yêu cầu liên quan đến AR trên thiết bị hỗ trợ ARCore.
• Khi người dùng cài đặt một ứng dụng Yêu cầu về thực tế tăng cường (AR), Cửa hàng Google Play sẽ tự động cài đặt Dịch vụ Google Play cho thực tế tăng cường (AR) trên thiết bị của họ. Tuy nhiên, ứng dụng của bạn vẫn phải thực hiện các bước kiểm tra bổ sung trong thời gian chạy trong trường hợp Dịch vụ Google Play cho Thực tế tăng cường (AR) đã lỗi thời hoặc bị gỡ cài đặt theo cách thủ công.

Ứng dụng AR không bắt buộc sử dụng ARCore để cải thiện chức năng hiện có. Phiên bản này có các tính năng thực tế tăng cường (không bắt buộc) và chỉ được kích hoạt trên các thiết bị hỗ trợ ARCore đã cài đặt Dịch vụ Google Play cho thực tế tăng cường.

• Bạn có thể cài đặt và chạy các ứng dụng AR không bắt buộc trên thiết bị không hỗ trợ ARCore.
• Khi người dùng cài đặt một ứng dụng AR không bắt buộc, Cửa hàng Google Play sẽ không tự động cài đặt Dịch vụ Google Play cho AR trên thiết bị.

Để ứng dụng của bạn bắt buộc phải sử dụng tính năng thực tế tăng cường (AR), hãy cập nhật AndroidManifest.xml để thêm các mục sau:

<uses-permission android:name="android.permission.CAMERA" />

<!-- Limits app visibility in the Google Play Store to ARCore supported devices
     (https://developers.google.com/ar/devices). -->
<uses-feature android:name="android.hardware.camera.ar" />

<application …>
    …

    <!-- "AR Required" app, requires "Google Play Services for AR" (ARCore)
         to be installed, as the app does not include any non-AR features. -->
    <meta-data android:name="com.google.ar.core" android:value="required" />
</application>

<uses-permission android:name="android.permission.CAMERA" />

<!-- If your app was previously AR Required, don't forget to remove the
     `<uses-feature android:name="android.hardware.camera.ar" />` entry, as
     this would limit app visibility in the Google Play Store to only
     ARCore supported devices. -->

<application …>
    …

    <!-- "AR Optional" app, contains non-AR features that can be used when
         "Google Play Services for AR" (ARCore) is not available. -->
    <meta-data android:name="com.google.ar.core" android:value="optional" />
</application>

Sau đó, hãy sửa đổi build.gradle của ứng dụng để chỉ định minSdkVersion có giá trị tối thiểu là 24:

 android {
     defaultConfig {
         …
         minSdkVersion 24
     }
 }

Thêm phần phụ thuộc của bản dựng

Để thêm ARCore vào dự án Android Studio, hãy làm như sau:

1. Đảm bảo tệp build.gradle của dự án chứa kho lưu trữ Maven của Google.

   allprojects {
       repositories {
           google()
           …
       }
   }
   

2. Thêm thư viện ARCore mới nhất làm phần phụ thuộc trong tệp build.gradle của ứng dụng.

   dependencies {
       …
       implementation 'com.google.ar:core:1.33.0'
   }
   

Kiểm tra thời gian chạy

Trong thời gian chạy, hãy thực hiện những việc sau để đảm bảo các tính năng thực tế tăng cường trên ứng dụng của bạn hoạt động trơn tru.

Kiểm tra xem ARCore có được hỗ trợ hay không

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  // Enable AR-related functionality on ARCore supported devices only.
  maybeEnableArButton()
  …
}

fun maybeEnableArButton() {
  ArCoreApk.getInstance().checkAvailabilityAsync(this) { availability ->
    if (availability.isSupported) {
      mArButton.visibility = View.VISIBLE
      mArButton.isEnabled = true
    } else { // The device is unsupported or unknown.
      mArButton.visibility = View.INVISIBLE
      mArButton.isEnabled = false
    }
  }
}

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  // Enable AR-related functionality on ARCore supported devices only.
  maybeEnableArButton();
  …
}

void maybeEnableArButton() {
  ArCoreApk.getInstance().checkAvailabilityAsync(this, availability -> {
    if (availability.isSupported()) {
      mArButton.setVisibility(View.VISIBLE);
      mArButton.setEnabled(true);
    } else { // The device is unsupported or unknown.
      mArButton.setVisibility(View.INVISIBLE);
      mArButton.setEnabled(false);
    }
  });
}

ArCoreApk.checkAvailability() có thể cần truy vấn tài nguyên mạng để xác định xem thiết bị có hỗ trợ ARCore hay không. Trong thời gian này, thiết bị sẽ trả về UNKNOWN_CHECKING. Để giảm độ trễ dự kiến và cửa sổ bật lên, ứng dụng nên gọi ArCoreApk.checkAvailability() một lần đầu trong vòng đời để bắt đầu truy vấn, bỏ qua giá trị được trả về. Bằng cách này, kết quả đã lưu vào bộ nhớ đệm sẽ có sẵn ngay khi hiển thị thành phần trên giao diện người dùng nhập vào AR.

Kiểm tra xem bạn đã cài đặt Dịch vụ Google Play cho Thực tế tăng cường hay chưa

Cả ứng dụng Bắt buộc thực tế tăng cường (AR) và Thực tế tăng cường (AR) đều phải gọi ArCoreApk.requestInstall() trước khi tạo phiên ARCore để kiểm tra xem phiên bản Dịch vụ Google Play cho Thực tế tăng cường tương thích đã được cài đặt hay chưa và để đảm bảo rằng mọi dữ liệu hồ sơ thiết bị ARCore cần thiết đều đã được tải xuống.

// requestInstall(Activity, true) will triggers installation of
// Google Play Services for AR if necessary.
var mUserRequestedInstall = true

override fun onResume() {
  super.onResume()

  // Check camera permission.
  …

  // Ensure that Google Play Services for AR and ARCore device profile data are
  // installed and up to date.
  try {
    if (mSession == null) {
      when (ArCoreApk.getInstance().requestInstall(this, mUserRequestedInstall)) {
        ArCoreApk.InstallStatus.INSTALLED -> {
          // Success: Safe to create the AR session.
          mSession = Session(this)
        }
        ArCoreApk.InstallStatus.INSTALL_REQUESTED -> {
          // When this method returns `INSTALL_REQUESTED`:
          // 1. ARCore pauses this activity.
          // 2. ARCore prompts the user to install or update Google Play
          //    Services for AR (market://details?id=com.google.ar.core).
          // 3. ARCore downloads the latest device profile data.
          // 4. ARCore resumes this activity. The next invocation of
          //    requestInstall() will either return `INSTALLED` or throw an
          //    exception if the installation or update did not succeed.
          mUserRequestedInstall = false
          return
        }
      }
    }
  } catch (e: UnavailableUserDeclinedInstallationException) {
    // Display an appropriate message to the user and return gracefully.
    Toast.makeText(this, "TODO: handle exception " + e, Toast.LENGTH_LONG)
        .show()
    return
  } catch (…) {
    …
    return  // mSession remains null, since session creation has failed.
  }
  …
}

// requestInstall(Activity, true) will trigger installation of
// Google Play Services for AR if necessary.
private boolean mUserRequestedInstall = true;

@Override
protected void onResume() {
  super.onResume();

  // Check camera permission.
  …

  // Ensure that Google Play Services for AR and ARCore device profile data are
  // installed and up to date.
  try {
    if (mSession == null) {
      switch (ArCoreApk.getInstance().requestInstall(this, mUserRequestedInstall)) {
        case INSTALLED:
          // Success: Safe to create the AR session.
          mSession = new Session(this);
          break;
        case INSTALL_REQUESTED:
          // When this method returns `INSTALL_REQUESTED`:
          // 1. ARCore pauses this activity.
          // 2. ARCore prompts the user to install or update Google Play
          //    Services for AR (market://details?id=com.google.ar.core).
          // 3. ARCore downloads the latest device profile data.
          // 4. ARCore resumes this activity. The next invocation of
          //    requestInstall() will either return `INSTALLED` or throw an
          //    exception if the installation or update did not succeed.
          mUserRequestedInstall = false;
          return;
      }
    }
  } catch (UnavailableUserDeclinedInstallationException e) {
    // Display an appropriate message to the user and return gracefully.
    Toast.makeText(this, "TODO: handle exception " + e, Toast.LENGTH_LONG)
        .show();
    return;
  } catch (…) {
    …
    return;  // mSession remains null, since session creation has failed.
  }
  …
}

Yêu cầu cấp quyền truy cập vào máy ảnh

Cả ứng dụng Không bắt buộc về thực tế tăng cường (AR) và bắt buộc phải có thực tế tăng cường (AR) đều phải đảm bảo rằng đã được cấp quyền sử dụng máy ảnh trước khi tạo một Phiên thực tế tăng cường.

override fun onResume() {
  super.onResume()

  // ARCore requires camera permission to operate.
  if (!CameraPermissionHelper.hasCameraPermission(this)) {
    CameraPermissionHelper.requestCameraPermission(this)
    return
  }

  …
}

@Override
protected void onResume() {
  super.onResume();

  // ARCore requires camera permission to operate.
  if (!CameraPermissionHelper.hasCameraPermission(this)) {
    CameraPermissionHelper.requestCameraPermission(this);
    return;
  }

  …
}

Hoạt động thực tế tăng cường (AR) của bạn cũng phải triển khai onRequestPermissionsResult().

override fun onRequestPermissionsResult(
  requestCode: Int,
  permissions: Array<String>,
  results: IntArray
) {
  super.onRequestPermissionsResult(requestCode, permissions, results)
  if (!CameraPermissionHelper.hasCameraPermission(this)) {
    Toast.makeText(this, "Camera permission is needed to run this application", Toast.LENGTH_LONG)
      .show()
    if (!CameraPermissionHelper.shouldShowRequestPermissionRationale(this)) {
      // Permission denied with checking "Do not ask again".
      CameraPermissionHelper.launchPermissionSettings(this)
    }
    finish()
  }
}

@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] results) {
  super.onRequestPermissionsResult(requestCode, permissions, results);
  if (!CameraPermissionHelper.hasCameraPermission(this)) {
    Toast.makeText(this, "Camera permission is needed to run this application", Toast.LENGTH_LONG)
        .show();
    if (!CameraPermissionHelper.shouldShowRequestPermissionRationale(this)) {
      // Permission denied with checking "Do not ask again".
      CameraPermissionHelper.launchPermissionSettings(this);
    }
    finish();
  }
}

Tuân thủ các yêu cầu về quyền riêng tư của người dùng

Để phát hành ứng dụng trên Cửa hàng Play, hãy đảm bảo ứng dụng của bạn tuân thủ Các yêu cầu về quyền riêng tư của người dùng của ARCore.

Bước tiếp theo

• Tìm hiểu cách định cấu hình phiên ARCore.