Per utilizzare Google Low Light Boost, devi avere un client per la modalità scarsa illuminazione.
Puoi utilizzare il client per verificare se il modulo Low Light Boost è installato e se Google Low Light Boost è supportato dal dispositivo e dalla fotocamera su cui è in esecuzione l'app. Utilizzerai il client anche per creare un LowLightBoostSession.
(Utilizzerai la sessione per attivare e disattivare la funzionalità Luce scarsa avanzata.) Puoi anche configurare un listener per ricevere callback quando la modalità Luce scarsa è attiva.
I metodi LowLightBoostClient non segnalano direttamente l'esito positivo o negativo. ma restituiscono un oggetto Task. Utilizza un Task per configurare i listener di esito positivo e negativo. In questo modo, i metodi possono segnalare l'esito positivo o negativo in modo asincrono, il che è necessario poiché i metodi devono comunicare con Google Play Services.
Dipendenze
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")
}
Alla moda
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 è fornito dal pacchetto Google Play Services
com.google.android.gms.cameralowlight. Per informazioni su come accedere alle API di Google Play Services, consulta la documentazione di Google Play Services.
Crea un client
Per eseguire altre operazioni, è necessario un client per la funzionalità Luce scarsa+. Il seguente codice crea un client:
Kotlin
val lowLightBoostClient = LowLightBoost.getClient(context)
Java
LowLightBoostClient lowLightBoostClient = LowLightBoost.getClient(context);
Punti chiave su questo codice
- La classe
LowLightBoostfornisce il metodo staticogetClient, che restituisce un'istanza diLowLightBoostClient.
Controlla se la funzionalità Luce scarsa+ è supportata
Una volta ottenuto un client, puoi verificare se il dispositivo su cui è in esecuzione l'app supporta l'ottimizzazione per scarsa illuminazione. Il seguente codice controlla se l'ottimizzazione della luce scarsa è supportata:
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
}
)
Punti chiave su questo codice
- Si presume che
cameraIdsia l'ID di una fotocamera Camera2, creata altrove. LowLightBoostClient.isCameraSupported()controlla se la fotocamera Camera2 supporta la modalità Luce scarsa. In alcuni casi, un dispositivo potrebbe supportare la funzionalità Luce scarsa, ma una delle sue fotocamere no, quindi devi controllare entrambe.- Il metodo
LowLightBoostClient.isCameraSupported()restituisce un oggettoTask. Utilizza questo oggetto per configurare i listener di esito positivo e negativo. Crea la sessione di aumento della luce all'interno del listener di esecuzione riuscita.
Controlla se il modulo di ottimizzazione per scarsa luminosità è installato
Una volta ottenuto un client, puoi verificare se il modulo di ottimizzazione in condizioni di scarsa illuminazione è installato sul tuo dispositivo. Il seguente codice controlla se il modulo è installato:
Kotlin
// Handle the Google Play services Task API with Kotlin coroutines // (kotlinx-coroutines-play-services). launch { try { val isInstalled: Boolean = lowLightBoostClient .isModuleInstalled().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);
});
Punti chiave su questo codice
- Questo codice apre una sessione della fotocamera che si connette alla fotocamera identificata da
cameraId. Per saperne di più, consulta la documentazione di Camera2. - Il metodo
LowLightBoostClient.isModuleInstalled()restituisce un oggettoTask. Utilizza questo oggetto per configurare i listener di esito positivo e negativo. - Utilizza
Task.addOnSuccessListener()per configurare un listener che viene chiamato se la chiamata aisModuleInstalled()va a buon fine. È importante notare che, se viene chiamato l'ascoltatore di esito positivo, questo indica solo che il client è riuscito a scoprire se il modulo è installato sul dispositivo. Nel corpo del listener, devi verificare se il modulo è effettivamente installato o meno. - Se il modulo non è già installato, questo snippet lo installa chiamando il metodo
launchInstallRequest(). Questo metodo è definito nello snippet in Installa il modulo di ottimizzazione della luce scarsa.
Installa il modulo di aumento luce
Se il modulo di ottimizzazione in condizioni di scarsa illuminazione non è già installato sul dispositivo, dovrai scaricarlo e installarlo da Google Play Services. Questo codice mostra come farlo:
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().await() if (isDeviceSupported) { Log.d(TAG, "Device is supported") // Show download indicator, if needed. try { val isInstallSuccessful: Boolean = lowLightBoostClient .installModule( 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);
});
}
Punti chiave su questo codice
- Quando chiami
LowLightBoostClient.installModule(), passi un oggetto di callback che implementaLowLightBoostClient.InstallStatusCallback.installModule()chiama i metodi in quel callback per indicare lo stato del download. Ad esempio, se il download viene messo in pausa,installModule()chiama il metodoonDownloadPause()dell'oggetto di callback. In questo snippet di codice, l'oggetto di callback viene creato dal metodo
createInstallStatusCallback(). Dovresti scrivere tu questo metodo, in questo modo:
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()controlla se il dispositivo e il sistema operativo Android supportano Google Low Light Boost. In caso contrario, non scaricare il modulo.Il metodo
LowLightBoostClient.installModule()restituisce un oggettoTask. Utilizza questo oggetto per configurare i listener di esito positivo e negativo.Al termine dell'installazione, il listener di esito positivo verifica l'installazione aprendo la fotocamera. Nello snippet, questa operazione viene eseguita con una chiamata a
openCamera(). Dovrai scrivere tu questo metodo.