Usar a unidade flash do dispositivo no SDK do Android (Kotlin/Java)

Ativar a unidade de flash do dispositivo durante uma sessão de RA pode ajudar a melhorar visibilidade.

Verificar se a configuração atual da câmera é compatível com o flash

Nem todas as configurações de câmera são compatíveis com a ativação de uma unidade de flash. Antes de ativar o Flash ou de oferecer aos usuários a opção de ativá-lo, verifique se a unidade de flash está disponível para a câmera ativa configuração:

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

Ativar a unidade de flash

Ative a unidade de flash configurando a sessão de RA com Config.FlashMode.TORCH

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

Observação: como configurar o Config.FlashMode.TORCH com a configuração de uma câmera que não seja compatível com unidade de flash não terá efeito.

Desativar a unidade de flash

Desative a unidade de flash configurando a sessão de RA com o Config.FlashMode.OFF

Java

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

Kotlin

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