在 Android SDK 上使用裝置('s) 閃光燈單元 (Kotlin/Java)

在 AR 工作階段中啟用裝置的閃光燈，有助於改善可見度。

確認目前的相機設定是否支援閃光燈

並非所有相機設定都支援啟用閃光燈。在啟用閃光燈或提供使用者啟用閃光燈的選項之前，請確認閃光燈單元可用於目前的相機設定：

Java

boolean flashAvailable;
try {
  CameraManager cameraManager =
      (CameraManager) context.getSystemService(Context.CAMERA_SERVICE);

  CameraCharacteristics characteristics =
      cameraManager.getCameraCharacteristics(session.getCameraConfig().getCameraId());
  flashAvailable = characteristics.get(CameraCharacteristics.FLASH_INFO_AVAILABLE);
} catch (Exception e) {
  flashAvailable = false;
}

Kotlin

val flashAvailable =
  runCatching {
      val cameraManager = context.getSystemService(Context.CAMERA_SERVICE) as CameraManager
      val characteristics = cameraManager.getCameraCharacteristics(session.cameraConfig.cameraId)
      characteristics.get(CameraCharacteristics.FLASH_INFO_AVAILABLE)
    }
    .getOrNull() ?: false

啟用閃光燈

使用 Config.FlashMode.TORCH 設定 AR 工作階段，啟用閃光燈單元：

Java

if (flashAvailable) {
  Config config = session.getConfig();
  config.setFlashMode(Config.FlashMode.TORCH);
  session.configure(config);
}

Kotlin

if (flashAvailable) {
  session.configure(session.config.apply { flashMode = Config.FlashMode.TORCH })
}

注意： 如果相機設定不支援閃光燈，設定 Config.FlashMode.TORCH 就不會生效。

停用閃光燈

使用 Config.FlashMode.OFF 設定 AR 工作階段，停用閃光燈單元：

Java

Config config = session.getConfig();
config.setFlashMode(Config.FlashMode.OFF);
session.configure(config);

Kotlin

session.configure(session.config.apply { flashMode = Config.FlashMode.OFF })