ตรวจสอบความสามารถของอุปกรณ์ในขณะรันไทม์สำหรับแว่นตาเสียงและแว่นตาแสดงผล

อุปกรณ์ XR ที่รองรับ
คำแนะนำนี้จะช่วยคุณสร้างประสบการณ์การใช้งานสำหรับอุปกรณ์ XR ประเภทนี้
แว่นตาที่มีจอแสดงผล
และเสียง

แว่นตาที่มีระบบเสียงและแว่นตาที่มีจอแสดงผลประเภทต่างๆ มีความสามารถที่แตกต่างกัน หลังจากวางแผนวิธีรองรับอุปกรณ์ AI ประเภทต่างๆ แล้ว คุณสามารถตรวจสอบความสามารถของอุปกรณ์ที่รันไทม์เพื่อมอบประสบการณ์ที่ดีที่สุดสำหรับอุปกรณ์ของผู้ใช้

ตรวจสอบว่าอุปกรณ์มีจอแสดงผลหรือไม่

แว่นตาที่มีจอแสดงผลสามารถแสดง UI ที่สร้างด้วย Jetpack Compose Glimmer ได้ ตัวอย่างต่อไปนี้แสดงวิธีตรวจสอบว่าอุปกรณ์แว่นตามีจอแสดงผลหรือไม่

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

ตรวจสอบการเปลี่ยนแปลงสถานะแบตเตอรี่

หากต้องการติดตามสถานะแบตเตอรี่แบบเรียลไทม์ของแว่นตาที่มีจอแสดงผลหรือแว่นตาที่มีลำโพงในตัวซึ่งเชื่อมต่ออยู่ ให้ใช้เมธอด addBatteryStateChangedListener ที่ ProjectedDeviceController มีให้ Listener นี้จะแจ้งเตือนแอปของคุณเมื่อระดับแบตเตอรี่หรือสถานะการชาร์จมีการเปลี่ยนแปลง ซึ่งจะช่วยให้คุณเพิ่มประสิทธิภาพของแอป เปิดใช้โหมดประหยัดพลังงาน หรืออัปเดตอินเทอร์เฟซผู้ใช้ได้

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

เมื่อตรวจสอบอุปกรณ์เสร็จแล้วหรือเมื่อคอมโพเนนต์ถูกทำลาย ให้เรียกใช้ close ใน ProjectedDeviceController เพื่อปล่อยทรัพยากรที่เกี่ยวข้องอย่างเหมาะสม

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

นอกจากนี้ คุณยังยกเลิกการลงทะเบียน Listener อย่างชัดแจ้งก่อนที่ขอบเขตจะสิ้นสุดลงได้โดยใช้ removeBatteryStateChangedListener

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