เลย์เอาต์ท่าทางบนโต๊ะด้วย Grid และ mediaQuery

ไอคอนการให้ดาว 4 ดวง

ท่าทางแบบตั้งโต๊ะบนอุปกรณ์แบบพับได้จะแบ่งหน้าจอเดียวออกเป็นพื้นที่แสดงผลที่ใช้งานได้ 2 ส่วน โดยแบ่งตามรอยพับ (หรือบานพับ) ของอุปกรณ์ ท่าทางแบบตั้งโต๊ะช่วยให้คุณวางเนื้อหาหลักของแอป (เช่น วิดีโอเพลเยอร์หรือ Canvas ของเกม) ไว้ที่ครึ่งบน ขณะเดียวกันก็วางองค์ประกอบแบบอินเทอร์แอกทีฟ (เช่น ตัวควบคุมสื่อหรือแป้นควบคุม) ไว้ที่ครึ่งล่าง

อุปกรณ์แบบพับได้ในท่าตั้งบนโต๊ะแสดงเนื้อหาวิดีโอบนหน้าจอด้านบนและตัวควบคุมการเล่นบนหน้าจอด้านล่าง
รูปที่ 1 ท่าทางแบบตั้งโต๊ะจะแยกเนื้อหาและส่วนควบคุมแบบอินเทอร์แอกทีฟออกจากกันตามรอยพับ

แนวทางปฏิบัติแนะนำ

หากต้องการเพิ่มการรองรับโหมดตั้งโต๊ะลงในแอป ให้ใช้ Grid API เพื่อกำหนดเลย์เอาต์ที่มี 2 แถวและ 1 คอลัมน์ แล้วใช้ Media Query สำหรับท่าทางของหน้าต่างในโหมดตั้งโต๊ะ

  • ตรวจจับท่าทางแบบตั้งโต๊ะในเชิงรับ: ใช้ Composable mediaQuery เพื่อสังเกตสถานะของอุปกรณ์ เมื่อพับอุปกรณ์เป็นท่าทางแบบตั้งโต๊ะ (windowPosture == Posture.Tabletop) ให้เปลี่ยนเลย์เอาต์แบบไดนามิกโดยไม่ต้องรีสตาร์ทกิจกรรมหรือจัดการวงจรที่ซับซ้อน
  • จัดโครงสร้างเลย์เอาต์ด้วย Grid: เมื่ออยู่ในท่าตั้งบนโต๊ะ ให้ใช้ Grid API (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 ส่วนโดยแบ่งตามรอยพับโดยอัตโนมัติ

แหล่งข้อมูลเพิ่มเติม