Créer et utiliser un client de boost en basse luminosité

Pour utiliser l'amplification de la luminosité Google, vous avez besoin d'un client d'amplification de la luminosité. Vous pouvez utiliser le client pour vérifier si le module d'amplification de la luminosité est installé et pour vérifier si l'amplification de la luminosité Google est compatible avec l'appareil et l'appareil photo sur lesquels votre application s' exécute. Vous utiliserez également le client pour créer un LowLightBoostSession. (Vous utiliserez la session pour activer et désactiver l'amplification de la luminosité.) Vous pouvez également configurer un écouteur pour recevoir des rappels lorsque l'amplification de la luminosité est active.

consultez la documentation des services Google Play.

LowLightBoostClient méthodes ne signalent pas directement la réussite ou l'échec. Elles renvoient plutôt un Task objet. Vous utilisez un Task pour configurer des écouteurs de réussite et d'échec. Cela permet aux méthodes de signaler la réussite ou l'échec de manière asynchrone, ce qui est nécessaire, car les méthodes doivent communiquer avec les services Google Play.

Dépendances

Kotlin

dependencies {
  val low_light_boost_version = "16.0.1-beta04"
  implementation("org.jetbrains.kotlinx:kotlinx-coroutines-play-services:1.10.2")
  implementation("com.google.android.gms:play-services-base:18.7.0")
  implementation("com.google.android.gms:play-services-camera-low-light-boost:${low_light_boost_version}")
  implementation("com.google.android.gms:play-services-tasks:18.3.0")
}

Groovy

dependencies {
  def low_light_boost_version = "16.0.1-beta04"
  implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-play-services:1.10.2'
  implementation 'com.google.android.gms:play-services-base:18.7.0'
  implementation 'com.google.android.gms:play-services-camera-low-light-boost:${low_light_boost_version}'
  implementation 'com.google.android.gms:play-services-tasks:18.3.0'
}

LowLightBoostClient est fourni par le package des services Google Play com.google.android.gms.cameralowlight. Pour savoir comment accéder aux API des services Google Play, consultez la documentation des services Google Play.

Créer un client

Vous avez besoin d'un client d'amplification de la luminosité pour effectuer toute autre opération. Le code suivant crée un client :

Kotlin

val lowLightBoostClient = LowLightBoost.getClient(context)

Java

LowLightBoostClient lowLightBoostClient = LowLightBoost.getClient(context);

Points essentiels concernant ce code

  • La LowLightBoost classe fournit la méthode statique getClient, qui renvoie une instance de LowLightBoostClient.

Vérifier si l'amplification de la luminosité est compatible

Une fois que vous disposez d'un client, vous pouvez vérifier si l'amplification de la luminosité est compatible avec l' appareil sur lequel l'application s'exécute. Le code suivant vérifie si l'amplification de la luminosité est compatible :

Kotlin

launch {
  try {
    // Await the result of the Task in a non-blocking way
    val isSupported: Boolean = lowLightBoostClient
      .isCameraSupported(cameraId).await()
    Log.d(TAG, "isCameraSupported: $isSupported")
    if (isSupported) {
      // Create the low light boost session here
    }
  } catch (e: Exception) {
    Log.e(TAG, "isCameraSupported failed", e)
  }
}

Java

lowLightBoostClient
  .isCameraSupported(cameraId)
  .addOnSuccessListener(
    lowLightBoostExecutor,
    (isSupported) -> {
      Log.d(TAG, "isCameraSupported: " + isSupported);
      if (isSupported) {
        // Create the low light boost session here
      }
    )

Points essentiels concernant ce code

Vérifier si le module d'amplification de la luminosité est installé

Une fois que vous disposez d'un client, vous pouvez vérifier si le module d'amplification de la luminosité est installé sur votre appareil. Le code suivant vérifie si le module est installé :

Kotlin

// Handle the Google Play services Task API with Kotlin coroutines
// (kotlinx-coroutines-play-services)
launch {
  try {
    val isInstalled: Boolean = lowLightBoostClient
      .isModuleInstalled(context).await()

    if (isInstalled) {
      Log.d(TAG, "Module is installed")
      try {
        openCamera(cameraId)
      } catch (e: CameraAccessException) {
        Log.e(TAG, "Failed to open camera", e)
      }
    } else {
      Log.d(TAG, "Module is not installed")
      launchInstallRequest()
    }
  } catch (e: Exception) {
    Log.e(TAG, "Failed to check module availability", e)
  }
}

Java

lowLightBoostClient
  .isModuleInstalled(context)
  .addOnSuccessListener(
    (isInstalled) -> {
      if (isInstalled) {
        Log.d(TAG, "Module is installed");
        try {
          openCamera(cameraId);
        } catch (CameraAccessException e) {
          Log.e(TAG, "Failed to open camera", e);
        }
      } else {
        Log.d(TAG, "Module is not installed");
        launchInstallRequest();
      }
    })
  .addOnFailureListener(
    (e) -> {
      Log.e(TAG, "Failed to check module availability", e);
    });

Points essentiels concernant ce code

  • Ce code ouvre une session d'appareil photo qui se connecte à l'appareil photo identifié par cameraId. Pour en savoir plus, consultez la Camera2 documentation.
  • La méthode LowLightBoostClient.isModuleInstalled() renvoie un Task objet. Vous utilisez cet objet pour configurer des écouteurs de réussite et d'échec.
  • Utilisez Task.addOnSuccessListener() pour configurer un écouteur qui est appelé si l' appel à isModuleInstalled() réussit. Important : Si l'écouteur de réussite est appelé, cela vous indique simplement que le client a réussi à déterminer si le module est installé sur l'appareil. Dans le corps de votre écouteur, vous devez vérifier si le module est réellement installé ou non.
  • Si le module n'est pas déjà installé, cet extrait l'installe en appelant la méthode launchInstallRequest(). Cette méthode est définie dans l'extrait de code de la section Installer le module d'amplification de la luminosité.

Installer le module d'amplification de la luminosité

Si le module d'amplification de la luminosité n'est pas déjà installé sur l'appareil, vous devez le télécharger et l'installer à partir des services Google Play. Le code suivant montre comment procéder :

Kotlin

private suspend fun launchInstallRequest() {
  Log.v(TAG, "Launching install request")

  try {
    // Check if this device can support Google LLB.
    val isDeviceSupported: Boolean = lowLightBoostClient
      .isDeviceSupported(context).await()

    if (isDeviceSupported) {
      Log.d(TAG, "Device is supported")
      // Show download indicator, if needed.

      try {
        val isInstallSuccessful: Boolean = lowLightBoostClient
          .installModule(context,
                        createInstallStatusCallback()
          ).await()

        if (isInstallSuccessful) {
          Log.d(TAG, "Module installed")
          // Hide download indicator, if needed.
          try {
            openCamera()
          } catch (e: CameraAccessException) {
            Log.e(TAG, "Failed to open camera", e)
          }
        } else {
          Log.d(TAG, "Module install failed")
        }
      } catch (e: Exception) {
        Log.e(TAG, "An error occurred installing the module:", e)
      }
    } else {
      Log.d(TAG, "Device is not supported")
    }
  } catch (e: Exception) {
    Log.e(TAG, "An error occurred checking device support:", e)
  }
}

Java

private void launchInstallRequest() {
  Log.v(TAG, "Launching install request");
  // Check if this device can support Google LLB.
  lowLightBoostClient
    .isDeviceSupported(context)
    .addOnSuccessListener(
      (isDeviceSupported) -> {
        if (isDeviceSupported) {
          Log.d(TAG, "Device is supported");
          // Show download indicator, if needed.
          lowLightBoostClient
            .installModule(
              this,
              createInstallStatusCallback()
            )
            .addOnSuccessListener(
              (result) -> {
                if (result) {
                  Log.d(TAG, "Module installed");
                  // Hide download indicator, if needed.
                  try {
                    openCamera();
                  } catch (CameraAccessException e) {
                    Log.e(TAG, "Failed to open camera", e);
                  }
                } else {
                  Log.d(TAG, "Module install failed");
                }
              }
            );
        } else {
          Log.d(TAG, "Device is not supported");
        }
      })
    .addOnFailureListener(
      (e) -> {
        Log.e(TAG, "Failed to check device support", e);
      });
}

Points essentiels concernant ce code

  • Lorsque vous appelez LowLightBoostClient.installModule(), vous transmettez un objet de rappel qui implémente LowLightBoostClient.InstallStatusCallback. installModule() appelle des méthodes dans ce rappel pour indiquer l'état du téléchargement. Par exemple, si le téléchargement est mis en pause, installModule() appelle la méthode onDownloadPause() de l'objet de rappel.
  • Dans cet extrait de code, l'objet de rappel est créé par la createInstallStatusCallback() méthode. Vous devez écrire cette méthode vous-même, comme suit :

Kotlin

private fun createInstallStatusCallback(): LowLightBoostClient.InstallStatusCallback =
        object : LowLightBoostClient.InstallStatusCallback() {
    override fun onDownloadPending() {
      Log.d(TAG, "onDownloadPending")
      // Code here...
    }

    override fun onDownloadStart() {
      Log.d(TAG, "onDownloadStart")
      // Code here...
    }

    // other overrides here...
  }

Java

private InstallStatusCallback createInstallStatusCallback() {
  new LowLightBoostClient.InstallStatusCallback() {
    @Override
    public void onDownloadPending() {
      Log.d(TAG, "onDownloadPending");
      // Code here...
    }

    @Override
    public void onDownloadStart() {
      Log.d(TAG, "onDownloadStart");
      // Code here...
    }

  // other overrides here...
}

  • LowLightBoostClient.isDeviceSupported() vérifie si l'appareil Android et le système d'exploitation sont compatibles avec l'amplification de la luminosité Google. Si ce n'est pas le cas, ne téléchargez pas le module.

  • La méthode LowLightBoostClient.installModule() renvoie un objet Task. Vous utilisez cet objet pour configurer des écouteurs de réussite et d'échec.

  • Une fois l'installation terminée, l'écouteur de réussite vérifie l'installation en ouvrant l'appareil photo. Dans l'extrait de code, cela se fait avec un appel à openCamera(). Vous devez écrire cette méthode vous-même.