Controllare le funzionalità del dispositivo in fase di runtime per occhiali audio e occhiali con display

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Audio e
occhiali con display

I diversi tipi di occhiali audio e occhiali con display hanno funzionalità diverse. Dopo aver pianificato come supporterai i diversi tipi di dispositivi AI, puoi verificare le funzionalità del dispositivo in fase di runtime per offrire l'esperienza migliore per il dispositivo di un utente.

Controlla se un dispositivo ha un display

Gli occhiali con display possono mostrare UI create con Jetpack Compose Glimmer. L'esempio seguente mostra come verificare se un dispositivo per occhiali ha un display:

// Check device capabilities
val projectedDeviceController = ProjectedDeviceController.create(this@ProjectedMainActivity)
isVisualUiSupported = projectedDeviceController.capabilities.contains(CAPABILITY_VISUAL_UI)

Reagisci alle modifiche dello stato del display

Sugli occhiali con display, il display può andare in timeout o l'utente può disattivarlo. Per progettare attività che vengono eseguite indipendentemente dal fatto che il display sia acceso o spento, utilizza addPresentationModeChangedListener per ricevere una notifica quando lo stato del display cambia. Puoi ottimizzare la tua attività per la quantità appropriata di informazioni audio a seconda dello stato del display.

ProjectedDisplayController.create(activity).addPresentationModeChangedListener {
    presentationModeFlags ->

    val areVisualsOff = !presentationModeFlags.hasPresentationMode(VISUALS_ON)
}

Tieni il display acceso

Sugli occhiali con display, puoi richiedere al sistema di mantenere lo schermo acceso e impedire il timeout dello schermo utilizzando addLayoutParamsFlags.

var projectedDisplayController = ProjectedDisplayController.create(activity)

projectedDisplayController.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

Monitora le modifiche dello stato della batteria

Per monitorare lo stato della batteria in tempo reale degli occhiali con display o audio connessi, utilizza il metodo addBatteryStateChangedListener fornito da ProjectedDeviceController. Questo listener invia una notifica alla tua app ogni volta che il livello batteria o lo stato di ricarica cambiano, consentendoti di ottimizzare le prestazioni dell'app, attivare le modalità di risparmio energetico o aggiornare l'interfaccia utente.

@OptIn(ExperimentalProjectedApi::class)
private var deviceController: ProjectedDeviceController? = null

private val batteryListener = { batteryState: BatteryState ->
    val batteryLevel = batteryState.batteryLevel
    val isCharging = batteryState.isCharging

    if (batteryLevel <= 15 && !isCharging) {
        switchToLowPowerMode()
    }

    updateBatteryUi(batteryLevel, isCharging)
}
// ...

@OptIn(ExperimentalProjectedApi::class)
private fun monitorBatteryStatus() {
    lifecycleScope.launch {
        try {
            if (deviceController == null) {
                deviceController = ProjectedDeviceController.create(this@PhoneMainActivity)
            }

            if (lifecycle.currentState.isAtLeast(Lifecycle.State.RESUMED)) {
                deviceController?.addBatteryStateChangedListener(coroutineContext, batteryListener)
            }
        } catch (e: Exception) {
            Log.e("BatteryMonitor", "Unexpected error: ${e.message}")
        }
    }
}

Quando hai finito di monitorare il dispositivo o quando il componente viene eliminato, chiama close su ProjectedDeviceController per rilasciare correttamente le risorse sottostanti.

@OptIn(ExperimentalProjectedApi::class)
override fun onDestroy() {
    super.onDestroy()
    // Unregisters the active listeners
    deviceController?.close()
    deviceController = null
}

Puoi anche annullare la registrazione di un listener in modo esplicito prima della fine dell'ambito utilizzando removeBatteryStateChangedListener.

@OptIn(ExperimentalProjectedApi::class)
override fun onPause() {
    super.onPause()
    // Explicitly unregister the listener when it is no longer needed
    deviceController?.removeBatteryStateChangedListener(batteryListener)
}