ท่าทางแบบตั้งโต๊ะบนอุปกรณ์แบบพับได้จะแบ่งหน้าจอเดียวออกเป็นพื้นที่แสดงผลที่ใช้งานได้ 2 ส่วน โดยแบ่งตามรอยพับ (หรือบานพับ) ของอุปกรณ์ ท่าทางแบบตั้งโต๊ะช่วยให้คุณวางเนื้อหาหลักของแอป (เช่น วิดีโอเพลเยอร์หรือ Canvas ของเกม) ไว้ที่ครึ่งบน ขณะเดียวกันก็วางองค์ประกอบแบบอินเทอร์แอกทีฟ (เช่น ตัวควบคุมสื่อหรือแป้นควบคุม) ไว้ที่ครึ่งล่าง
แนวทางปฏิบัติแนะนำ
หากต้องการเพิ่มการรองรับโหมดตั้งโต๊ะลงในแอป ให้ใช้ Grid API เพื่อกำหนดเลย์เอาต์ที่มี 2 แถวและ 1 คอลัมน์ แล้วใช้ Media Query สำหรับท่าทางของหน้าต่างในโหมดตั้งโต๊ะ
- ตรวจจับท่าทางแบบตั้งโต๊ะในเชิงรับ: ใช้ Composable
mediaQueryเพื่อสังเกตสถานะของอุปกรณ์ เมื่อพับอุปกรณ์เป็นท่าทางแบบตั้งโต๊ะ (windowPosture == Posture.Tabletop) ให้เปลี่ยนเลย์เอาต์แบบไดนามิกโดยไม่ต้องรีสตาร์ทกิจกรรมหรือจัดการวงจรที่ซับซ้อน - จัดโครงสร้างเลย์เอาต์ด้วย
Grid: เมื่ออยู่ในท่าตั้งบนโต๊ะ ให้ใช้GridAPI (2 rows,1 column) เพื่อแยกเนื้อหาภาพหลักออกเป็นแถวบนครึ่งหน้าบนและตัวควบคุมแบบอินเทอร์แอกทีฟออกเป็นแถวล่างครึ่งหน้าล่างอย่างชัดเจน - ใช้ประโยชน์จากการจัดทำดัชนีลำดับ Z โดยนัยสำหรับการวางซ้อน: ในท่าทางมาตรฐาน (ไม่ใช่แบบตั้งโต๊ะ) ให้กำหนดรหัสพื้นที่หลายรหัสให้กับเซลล์เดียวกันเพื่อวางซ้อนตัวควบคุมบนโปรแกรมเล่น
Gridจะแสดงผลรายการจากหลังไปหน้าโดยอัตโนมัติตามลำดับการประกาศ - เปลี่ยนโหมดได้อย่างราบรื่น: ตรวจสอบว่าระบบคงสถานะและตำแหน่งการเลื่อนไว้เมื่อเปลี่ยนระหว่างเลย์เอาต์แบบเต็มหน้าจอมาตรฐานกับท่าทางแบบตั้งโต๊ะ
ส่วนผสม
Grid: คอนเทนเนอร์เลย์เอาต์แบบปรับอัตโนมัติที่ช่วยให้คุณจัดตำแหน่งรายการในแถวและคอลัมน์ที่กำหนดค่าได้ เหมาะสำหรับการแยกเนื้อหาในพื้นที่หน้าจอที่แตกต่างกันmediaQuery: Jetpack Compose API ที่ใช้เพื่อค้นหาลักษณะท่าทางของหน้าต่างปัจจุบัน คลาสขนาด และลักษณะฮาร์ดแวร์ของแอปโดยตรงภายใน Composable
ขั้นตอน
ค้นหาสถานะของอุปกรณ์โดยใช้ mediaQuery() เมื่ออุปกรณ์อยู่ในท่าตั้งบนโต๊ะ ให้จัดเรียงเนื้อหาของแอปเป็นตารางกริดแนวตั้งที่มี 2 แถวและ 1 คอลัมน์ โดยตรวจสอบว่าเนื้อหาหลักอยู่ด้านบนและตัวควบคุมยังคงเข้าถึงได้ที่ด้านล่าง
1. กำหนดค่าตารางกริดสำหรับโหมดตั้งโต๊ะ
ภายในฟังก์ชันที่ประกอบกันได้ ให้กำหนดรหัสพื้นที่เลย์เอาต์โดยใช้ enum และตั้งค่าบล็อก GridConfigurationScope สำหรับท่าทางเริ่มต้นและท่าทางแบบตั้งโต๊ะ
ใน defaultConfig พื้นที่ทั้งสองจะได้รับการกำหนดให้กับเซลล์เดียวกัน (row = 1, column = 1) Grid ใช้การจัดทำดัชนี Z โดยนัยซึ่งคอมโพสิเบิลที่ประกาศในภายหลังในเลย์เอาต์จะแสดงผลที่ด้านบนของคอมโพสิเบิลก่อนหน้า ซึ่งช่วยให้ตัวควบคุมวางซ้อนเพลเยอร์ได้โดยไม่ต้องฝังคอนเทนเนอร์เพิ่มเติม (ดูรายละเอียดเพิ่มเติมได้ที่การวางซ้อนองค์ประกอบ UI ด้วย Grid)
enum class VideoPlayerArea { Player, Controller } object PlayerGridConfig { // Default: Single area layout with overlay (controls on top of player) val defaultConfig: GridConfigurationScope.() -> Unit = { row(1f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) area(areaId = VideoPlayerArea.Controller, row = 1, column = 1) } // Tabletop: Two rows splitting content across the fold val tabletopConfig: GridConfigurationScope.() -> Unit = { row(0.5f) row(0.5f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) // Top half above fold area(areaId = VideoPlayerArea.Controller, row = 2, column = 1) // Bottom half below fold } }
2. ตรวจจับท่าทางแบบตั้งโต๊ะและใช้การกำหนดค่ากับตารางกริด
ใช้ mediaQuery เพื่อเลือกการกำหนดค่าที่ใช้งานอยู่ตาม windowPosture, ส่ง config ไปยัง Grid และเชื่อมโยงเนื้อหา Composable กับรหัสพื้นที่ การประกาศ VideoPlayerArea.Player ก่อน VideoPlayerArea.Controller จะช่วยให้มั่นใจได้ว่าเมื่อทั้ง 2 รายการแชร์เซลล์ใน defaultConfig ตัวควบคุมจะแสดงผลเหนือเพลเยอร์
val config = mediaQuery { when (windowPosture) { Posture.Tabletop -> PlayerGridConfig.tabletopConfig else -> PlayerGridConfig.defaultConfig } } Grid(config = config) { Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Player) ) { // VideoPlayerContent } Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Controller) ) { // PlaybackControlsContent } }
ผลลัพธ์
เมื่อรวม mediaQuery และ Grid เข้าด้วยกัน แอปจะตรวจจับแบบไดนามิกเมื่ออุปกรณ์แบบพับได้ถูกพับบางส่วนให้อยู่ในท่าตั้งบนโต๊ะ และปรับ UI ให้เป็นพื้นที่แสดงผลที่ใช้งานได้ 2 ส่วนโดยแบ่งตามรอยพับโดยอัตโนมัติ
แหล่งข้อมูลเพิ่มเติม
- เริ่มต้นใช้งานแอปที่ปรับเปลี่ยนตามอุปกรณ์
- รองรับโหมดการแสดงผลแบบพับได้
- การวางซ้อนองค์ประกอบ UI ด้วยตารางกริด