创建和使用低光增强客户端

如需使用 Google 弱光增强功能，您需要一个 弱光增强客户端。您可以使用该客户端检查是否已安装弱光增强模块，并检查您的应用运行的设备和相机是否支持 Google 弱光增强功能。您还需要使用该客户端创建 LowLightBoostSession。（您将使用该会话来开启和关闭弱光增强功能。）您还可以设置一个监听器，以便在弱光增强功能处于活动状态时接收回调。

LowLightBoostClient 方法不会直接指示成功或失败，而是会返回一个 Task 对象。您可以使用 Task 设置成功和失败监听器。这样，这些方法就可以异步指示成功或失败，这是必要的，因为这些方法需要与 Google Play 服务通信。

依赖项

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 由 Google Play 服务的 com.google.android.gms.cameralowlight 软件包提供。如需了解如何访问 Google Play 服务 API，请参阅 Google Play 服务文档。

创建客户端

您需要一个弱光增强客户端才能执行其他任何操作。以下代码会创建一个客户端：

Kotlin

val lowLightBoostClient = LowLightBoost.getClient(context)

Java

LowLightBoostClient lowLightBoostClient = LowLightBoost.getClient(context);

关于此代码的要点

LowLightBoost 类提供了静态方法 getClient，该方法会返回 LowLightBoostClient 的实例。

检查是否支持弱光增强功能

获得客户端后，您可以检查应用运行的设备是否支持弱光增强功能。以下代码会检查是否支持弱光增强功能：

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

关于此代码的要点

cameraId 假设是 Camera2 摄像头的 ID，在其他位置创建。
LowLightBoostClient.isCameraSupported() 会检查 Camera2 摄像头是否支持弱光增强功能。在某些情况下，设备可能支持弱光增强功能，但其某个摄像头可能不支持，因此您需要同时检查这两者。
LowLightBoostClient.isCameraSupported() 方法会返回一个 Task 对象。您可以使用此对象设置成功和失败监听器。在成功监听器内创建弱光增强会话。

检查是否已安装弱光增强模块

获得客户端后，您可以确认设备上是否已安装弱光增强模块。以下代码会检查是否已安装该模块：

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

关于此代码的要点

此代码会打开一个摄像头会话，以连接到由 cameraId 标识的摄像头。如需了解详情，请参阅 Camera2 文档。
The method LowLightBoostClient.isModuleInstalled() 会返回一个 Task 对象。您可以使用此对象设置成功和失败监听器。
使用 Task.addOnSuccessListener() 设置一个监听器，如果对 isModuleInstalled() 的调用成功，系统会调用该监听器。重要的是，如果调用了成功监听器，这只会告诉您客户端成功确定了设备上是否安装了该模块。在监听器的正文中，您需要检查该模块是否实际已安装。
如果该模块尚未安装，此代码段会通过调用 launchInstallRequest() 方法来安装该模块。该方法在安装弱光增强模块中的代码段中定义。

安装弱光增强模块

如果设备上尚未安装弱光增强模块，您需要从 Google Play 服务下载并安装该模块。以下代码展示了如何执行此操作：

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

关于此代码的要点

当您调用 LowLightBoostClient.installModule() 时，您会传递一个回调对象，该对象实现了 LowLightBoostClient.InstallStatusCallback。 installModule() 会调用该回调中的方法来指示下载状态。例如，如果下载已暂停，installModule() 会调用回调对象的 onDownloadPause() 方法。
在此代码段中，回调对象由 createInstallStatusCallback() 方法创建。您需要自行编写该方法，如下所示：

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() 会检查 Android 设备和操作系统是否支持 Google 弱光增强功能。如果不支持，请勿下载该模块。
方法会返回一个对象。LowLightBoostClient.installModule()Task您可以使用此对象设置成功和失败监听器。
安装完成后，成功监听器会通过打开摄像头来验证安装。在此代码段中，这是通过调用 openCamera() 完成的。您需要自行编写该方法。

创建和使用低光增强客户端 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

依赖项

Kotlin

Groovy

创建客户端

Kotlin

Java

关于此代码的要点

检查是否支持弱光增强功能

Kotlin

Java

关于此代码的要点

检查是否已安装弱光增强模块

Kotlin

Java

关于此代码的要点

安装弱光增强模块

Kotlin

Java

关于此代码的要点

Kotlin

Java

创建和使用低光增强客户端