런타임에 오디오 글라스 및 디스플레이 글라스의 기기 기능 확인

적용 가능한 XR 기기
이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.
오디오 및
디스플레이 안경

오디오 글라스와 디스플레이 글라스의 유형에 따라 기능이 다릅니다. 다양한 유형의 AI 기기를 지원하는 방법을 계획한 후 런타임에 기기 기능을 확인하여 사용자 기기에 최적의 환경을 제공할 수 있습니다.

기기에 디스플레이가 있는지 확인

디스플레이 안경은 Jetpack Compose Glimmer로 빌드된 UI를 표시할 수 있습니다. 다음 예는 안경 기기에 디스플레이가 있는지 확인하는 방법을 보여줍니다.

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

디스플레이 상태 변경에 관한 반응

디스플레이 안경에서는 디스플레이가 타임아웃되거나 사용자가 디스플레이를 사용 중지할 수 있습니다. 디스플레이가 켜져 있든 꺼져 있든 실행되는 활동을 설계하려면 addPresentationModeChangedListener를 사용하여 디스플레이 상태가 변경될 때 알림을 받습니다. 디스플레이 상태에 따라 적절한 양의 오디오 정보가 제공되도록 활동을 조정할 수 있습니다.

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

    val areVisualsOff = !presentationModeFlags.hasPresentationMode(VISUALS_ON)
}

디스플레이를 켠 상태로 유지하세요.

디스플레이 안경에서는 addLayoutParamsFlags를 사용하여 시스템이 화면을 켜진 상태로 유지하고 화면이 시간 초과되지 않도록 요청할 수 있습니다.

var projectedDisplayController = ProjectedDisplayController.create(activity)

projectedDisplayController.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

배터리 상태 변경 모니터링

연결된 오디오 또는 디스플레이 안경의 실시간 배터리 상태를 추적하려면 ProjectedDeviceController에서 제공하는 addBatteryStateChangedListener 메서드를 사용합니다. 이 리스너는 배터리 잔량 또는 충전 상태가 변경될 때마다 앱에 알림을 전송하여 앱 성능을 최적화하거나, 절전 모드를 사용 설정하거나, 사용자 인터페이스를 업데이트할 수 있도록 합니다.

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

기기 모니터링을 완료하거나 구성요소가 소멸되면 ProjectedDeviceController에서 close를 호출하여 기본 리소스를 올바르게 해제합니다.

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

removeBatteryStateChangedListener를 사용하여 범위가 종료되기 전에 리스너를 명시적으로 등록 취소할 수도 있습니다.

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