Gerätefunktionen für Audio- und Displaybrillen zur Laufzeit prüfen

XR‑Geräte, für die der Leitfaden gilt
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für die folgenden Arten von XR-Geräten zu entwickeln.
Audio- und
Display-Brillen

Die verschiedenen Arten von Audio- und Display-Brillen haben unterschiedliche Funktionen. Nachdem Sie geplant haben, wie Sie verschiedene Arten von KI-Geräten unterstützen, können Sie die Gerätefunktionen zur Laufzeit prüfen, um die bestmögliche Nutzererfahrung für das Gerät eines Nutzers zu bieten.

Prüfen, ob ein Gerät ein Display hat

Auf Display-Brillen können mit Jetpack Compose Glimmer erstellte Benutzeroberflächen angezeigt werden. Im folgenden Beispiel wird gezeigt, wie Sie prüfen, ob eine Brille ein Display hat:

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

Auf Änderungen des Anzeigestatus reagieren

Bei Display-Brillen kann das Display nach einer bestimmten Zeit ausgehen oder der Nutzer kann es ausschalten. Wenn du Aktivitäten entwerfen möchtest, die unabhängig davon ausgeführt werden, ob das Display ein- oder ausgeschaltet ist, verwende addPresentationModeChangedListener, um benachrichtigt zu werden, wenn sich der Displaystatus ändert. Sie können Ihre Aktivität je nach Anzeigestatus auf die entsprechende Menge an Audioinformationen abstimmen.

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

    val areVisualsOff = !presentationModeFlags.hasPresentationMode(VISUALS_ON)
}

Display eingeschaltet lassen

Bei Display-Brillen können Sie mit addLayoutParamsFlags anfordern, dass das System das Display eingeschaltet lässt und ein Zeitlimit verhindert.

var projectedDisplayController = ProjectedDisplayController.create(activity)

projectedDisplayController.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

Änderungen des Akkustatus überwachen

Wenn du den Akkustand verbundener Audio- oder Display-Brillen in Echtzeit im Blick behalten möchtest, verwende die Methode addBatteryStateChangedListener, die von ProjectedDeviceController bereitgestellt wird. Dieser Listener benachrichtigt Ihre App, wenn sich der Akkustand oder der Ladestatus ändert. So können Sie die App-Leistung optimieren, Energiesparmodi aktivieren oder die Benutzeroberfläche aktualisieren.

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

Wenn du das Gerät nicht mehr überwachen möchtest oder deine Komponente zerstört wird, rufe close für ProjectedDeviceController auf, um die zugrunde liegenden Ressourcen ordnungsgemäß freizugeben.

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

Sie können einen Listener auch explizit vor dem Ende des Bereichs mit removeBatteryStateChangedListener abmelden.

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