ท่าทางสัมผัสมือเดียวด้วยฟีเจอร์ช่วยเขียน


ใน Wear OS 7 (API ระดับ 37) ขึ้นไป เฟรมเวิร์กท่าทางสัมผัสด้วยมือเดียวพร้อมกับ API ที่เป็นส่วนหนึ่งของ Compose สำหรับ Wear OS ช่วยให้ผู้ใช้โต้ตอบกับแอปของคุณได้โดยไม่ต้องสัมผัส

แม้ว่าในตอนแรกจะรองรับในอุปกรณ์ Pixel Watch (Pixel Watch 3 ขึ้นไป) แต่เฟรมเวิร์กนี้พร้อมใช้งานสำหรับ OEM ทั้งหมด การใช้ API นี้จะช่วยให้การรองรับท่าทางสัมผัสของแอปปรับขนาดโดยอัตโนมัติทั่วทั้งระบบนิเวศเมื่อการรองรับฮาร์ดแวร์ขยายตัว

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

ท่าทางสัมผัสและการดำเนินการที่รองรับ

เฟรมเวิร์กท่าทางสัมผัสของ Wear OS รองรับการดำเนินการด้วยท่าทางสัมผัส 2 ประเภท ได้แก่

  • การดำเนินการหลัก: แมปกับการดำเนินการหลักบนหน้าจอ เช่น การรับสายหรือการสลับการเล่นสื่อ ในอุปกรณ์ Pixel Watch การดำเนินการนี้จะเชื่อมโยงกับท่าทางสัมผัสบีบ 2 ครั้ง
  • การดำเนินการปิด: แมปกับการนำทางย้อนกลับ การปิดกล่องโต้ตอบ หรือการยกเลิกข้อความแจ้ง ในอุปกรณ์ Pixel Watch การดำเนินการนี้จะเชื่อมโยงกับท่าทางสัมผัสบิดข้อมือ

กำหนดค่าท่าทางสัมผัสใน Compose

แม้ว่า API ท่าทางสัมผัสด้วยมือเดียวจะช่วยปรับปรุง UI ได้ แต่สิ่งสำคัญคือต้องทราบว่าฮาร์ดแวร์และ OEM บางรายไม่รองรับท่าทางสัมผัสเหล่านี้ หาก API ตรวจพบว่าแอปของคุณทำงานบนอุปกรณ์ที่ไม่รองรับเหล่านี้ ไลบรารีจะไม่มีการดำเนินการโดยอัตโนมัติโดยไม่ส่งผลต่อการโต้ตอบด้วยการสัมผัสมาตรฐาน

เช่นเดียวกับลักษณะการทำงานของ Compose มาตรฐาน คุณสามารถเปิดใช้ท่าทางสัมผัสมือเดียวในองค์ประกอบ UI โดยใช้ตัวแก้ไข คุณกำหนดค่าท่าทางสัมผัสของแอปตามการดำเนินการที่จะทำ ไม่ว่าจะเป็นการดำเนินการหลักหรือการปิด และgestureIdเพื่อประสานงานกับค่ากำหนดของผู้ใช้ระดับระบบ เช่น ความถี่ในการแสดงคำแนะนำและการปิดเสียงตามความถี่ คุณแสดงการกำหนดค่านี้โดยการสร้างออบเจ็กต์ OneHandedGestureConfiguration เราขอแนะนำให้ใช้ฟังก์ชัน rememberOneHandedGestureConfiguration เพื่อสร้างออบเจ็กต์ OneHandedGestureConfiguration ยังเป็นที่ที่คุณสามารถระบุลำดับความสำคัญของท่าทางสัมผัสได้ด้วย

ฟังก์ชัน rememberOneHandedGestureConfiguration จะติดตามประวัติการโต้ตอบของผู้ใช้ในการจัดองค์ประกอบใหม่โดยไม่แสดงสถานะของแอปพลิเคชัน เมื่อแอปสร้างการกำหนดค่าแล้ว แอปควรส่งการกำหนดค่าไปยัง Modifier.oneHandedGesture ใน Composable แบบอินเทอร์แอกทีฟ

ไลบรารีมีเมธอด OneHandedGestureClickIndicator เพื่อช่วยให้ผู้ใช้ค้นพบท่าทางสัมผัสที่ใช้ได้ เมธอดนี้ทำหน้าที่เป็น Wrapper ที่แทนที่เนื้อหาที่อยู่เบื้องหลังเพื่อระบุให้ผู้ใช้ทราบว่ามีการดำเนินการด้วยท่าทางสัมผัส

องค์ประกอบแบบอินเทอร์แอกทีฟ

หากต้องการเปิดใช้ท่าทางสัมผัสในการควบคุมแบบอินเทอร์แอกทีฟ เช่น ปุ่ม ให้สร้างการกำหนดค่าที่ระบุ OneHandedGestureAction.Primary และใช้ตัวแก้ไข oneHandedGesture ส่ง MutableInteractionSource เดียวกันไปยังทั้งตัวควบคุมและตัวแก้ไขเพื่อให้เหตุการณ์ท่าทางสัมผัสแสดงการตอบสนองต่อการกดบนตัวควบคุม

หากต้องการเปิดใช้ตัวบอกสถานะท่าทางสัมผัส ให้สร้างและจดจำอินสแตนซ์ของ OneHandedGestureClickIndicatorState จากนั้น หากต้องการทริกเกอร์การตอบกลับด้วยภาพ ให้เรียกใช้ showIndicator ภายใน Callback onGestureAvailable ที่ตัวแก้ไข oneHandedGesture มีให้ ซึ่งจะส่งสัญญาณไปยังระบบว่ามีเหตุการณ์การบ่งชี้เกิดขึ้น เมื่อเรียกใช้ คอมโพเนนต์จะแทนที่เนื้อหาปกติด้วยภาพเคลื่อนไหวของท่าทางสัมผัสเป็นเวลาสั้นๆ

var isPlaying by remember { mutableStateOf(false) }
val onClick = { isPlaying = !isPlaying }

val gestureConfig = rememberOneHandedGestureConfiguration(
    action = OneHandedGestureAction.Primary
)
val indicatorState = remember { OneHandedGestureClickIndicatorState() }
val coroutineScope = rememberCoroutineScope()
val interactionSource = remember { MutableInteractionSource() }

Button(
    onClick = onClick,
    interactionSource = interactionSource,
    modifier = Modifier
        .fillMaxWidth()
        .oneHandedGesture(
            gestureConfiguration = gestureConfig,
            interactionSource = interactionSource,
            onGestureLabel = if (isPlaying) "pause" else "play",
            onGestureAvailable = { coroutineScope.launch { indicatorState.showIndicator() } },
            onGesture = onClick
        )
) {
    OneHandedGestureClickIndicator(
        gestureConfiguration = gestureConfig,
        state = indicatorState
    ) {
        Text(if (isPlaying) "Pause" else "Play", modifier = Modifier.fillMaxWidth())
    }
}

คอนเทนเนอร์แบบเลื่อนได้

สำหรับหน้าจอหรือรายการที่เลื่อนได้ ให้สร้างการกำหนดค่าที่ระบุ OneHandedGestureAction.Primary และใช้ตัวแก้ไข oneHandedGesture กับคอนเทนเนอร์ โดยเรียกใช้ตัวช่วยการเลื่อน เช่น scrollDown

หากต้องการแสดงภาพเพื่อตอบสนองต่อการเลื่อน คุณสามารถใช้ OneHandedGestureScrollIndicator คอมโพเนนต์นี้ทำหน้าที่เป็นตัวบ่งชี้การเลื่อนมาตรฐานที่แสดงตำแหน่งการเลื่อน แต่ยังสามารถระบุได้ด้วยว่าผู้ใช้สามารถใช้ท่าทางสัมผัสการเลื่อนได้ โดยปกติแล้ว ตัวบ่งชี้นี้จะส่งไปยังช่อง scrollIndicator ของ ScreenScaffold และเชื่อมโยงกับสถานะของคอนเทนเนอร์ที่เลื่อนได้ เช่น TransformingLazyColumn นอกจากนี้ยังสังเกต OneHandedGestureScrollIndicatorState เพื่อจัดการการเปลี่ยนภาพด้วย

หากต้องการเรียกใช้การตอบสนองด้วยภาพ ให้เรียกใช้ showIndicator ในสถานะนี้ ซึ่งโดยปกติจะอยู่ภายใน Callback onGestureAvailable ของตัวแก้ไข oneHandedGesture เมื่อทริกเกอร์แล้ว ตัวบ่งชี้จะแทนที่สถานะภาพมาตรฐานชั่วคราวด้วยลำดับภาพเคลื่อนไหวของท่าทางสัมผัสเพื่อแจ้งเตือนผู้ใช้

val scrollState = rememberTransformingLazyColumnState()
val gestureConfig = rememberOneHandedGestureConfiguration(
    action = OneHandedGestureAction.Primary,
    priority = OneHandedGesturePriority.Scrollable
)
val indicatorState = remember(gestureConfig) { OneHandedGestureScrollIndicatorState() }
val coroutineScope = rememberCoroutineScope()

ScreenScaffold(
    scrollState = scrollState,
    scrollIndicator = {
        OneHandedGestureScrollIndicator(
            gestureConfiguration = gestureConfig,
            indicatorState = indicatorState,
            scrollState = scrollState,
            modifier = Modifier.align(Alignment.CenterEnd)
        )
    }
) { contentPadding ->
    TransformingLazyColumn(
        state = scrollState,
        contentPadding = contentPadding,
        modifier = Modifier
            .fillMaxSize()
            .oneHandedGesture(
                gestureConfiguration = gestureConfig,
                onGestureLabel = "scroll",
                onGestureAvailable = {
                    coroutineScope.launch { indicatorState.showIndicator() }
                },
                onGesture = { OneHandedGestureDefaults.scrollDown(scrollState) }
            )
    ) {
        items(10) { index ->
            Text("Item $index", modifier = Modifier.padding(8.dp))
        }
    }
}

รวมท่าทางสัมผัสหลายรายการ

คุณสามารถกำหนดค่าทั้งท่าทางสัมผัสแบบเลื่อนและท่าทางสัมผัสแบบคลิกด้วยการดำเนินการหลักเดียวกันได้โดยเพิ่ม gesturePriority ลงในออบเจ็กต์ OneHandedGestureConfiguration ดังนี้

  • OneHandedGesturePriority.Clickable (สูงสุด): กำหนดให้กับการควบคุมแบบอินเทอร์แอกทีฟ เช่น การควบคุมที่มีประเภท Button หรือ Card เพื่อให้จับท่าทางสัมผัสเมื่อปรากฏบนหน้าจอ
  • OneHandedGesturePriority.Scrollable (ปานกลาง): กำหนดให้กับคอนเทนเนอร์ที่เลื่อนได้หรือแบ่งหน้าได้เพื่อให้แสดงผลเป็นองค์ประกอบย่อยที่คลิกได้ แต่จะเลื่อนเมื่อไม่มีการควบคุมที่คลิกได้ปรากฏอยู่
  • OneHandedGesturePriority.Unspecified (ต่ำสุด): ลำดับความสำคัญที่ไม่ได้กำหนด ค่านี้เป็นค่าเริ่มต้นสำหรับท่าทางสัมผัสที่ไม่ได้ตั้งค่า priority ไว้

การตั้งค่า priority = OneHandedGesturePriority.Clickable อย่างชัดเจนในปุ่มด้านในและ priority = OneHandedGesturePriority.Scrollable ในรายการหลักจะช่วยให้ระบบแสดงลักษณะการทำงานที่ให้ความสำคัญกับท่าทางสัมผัสนี้ได้ เมื่อผู้ใช้เรียกใช้การดำเนินการหลักด้วยท่าทางสัมผัสด้วยมือเดียว ระบบจะเลื่อนรายการลงก่อนจนกว่าปุ่มจะปรากฏขึ้น แล้วจึงจับภาพการดำเนินการคลิกของปุ่ม

ทดสอบและแก้ไขข้อบกพร่องของท่าทางสัมผัสด้วย ADB

คุณสามารถทดสอบท่าทางสัมผัสด้วยมือเดียวในอุปกรณ์จริงหรือโปรแกรมจำลองได้โดยไม่ต้องขยับข้อมือจริง โดยใช้ Android Debug Bridge (adb) และบริการระบบ IWearGestureService

เปิดใช้การจำลองท่าทางสัมผัส

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

  1. ตรวจสอบว่าอุปกรณ์ Wear OS ใช้ Wear OS 7 (ระดับ API 37) ขึ้นไป

    adb shell getprop ro.build.version.sdk
    
  2. หากคุณกำลังทดสอบในอุปกรณ์จริงที่ไม่ได้อยู่บนข้อมือหรือวางอยู่บนที่ชาร์จ ให้ลบล้างข้อจำกัดเมื่อไม่ได้อยู่บนร่างกายเพื่อให้เฟรมเวิร์กท่าทางสัมผัสยังคงทำงานอยู่ โดยทำดังนี้

    adb shell cmd IWearGestureService override-constraints offbody-state
    

ทริกเกอร์เหตุการณ์ท่าทางสัมผัสโดยใช้ ADB

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

adb shell cmd IWearGestureService get-supported-actions -readable

คำสั่งนี้จะแสดงเอาต์พุตจากคำสั่งเป็นออบเจ็กต์ JSON ที่แสดงท่าทางสัมผัสทางกายภาพที่แมปกับ PrimaryAction และ DismissAction สำหรับผู้สมัครใช้บริการ local (ในนาฬิกา) และ remote เช่น ในโปรแกรมจำลอง Pixel Watch หรือ Wear OS ให้ทำดังนี้

{
  "remote": {
    "PrimaryAction": "DoublePinch",
    "DismissAction": "WristTurn"
  },
  "local": {
    "PrimaryAction": "DoublePinch",
    "DismissAction": "WristTurn"
  }
}

ใช้ชื่อท่าทางสัมผัสที่แสดงในส่วน "local" เพื่อจำลองท่าทางสัมผัสสำหรับแอปสมาร์ทวอทช์ โดยทำดังนี้

  • หากต้องการจำลองท่าทางสัมผัสที่แมปกับ PrimaryAction (เช่น DoublePinch) ให้เรียกใช้คำสั่ง ADB Shell ต่อไปนี้

    adb shell cmd IWearGestureService gesture DoublePinch
    
  • หากต้องการจำลองท่าทางสัมผัสที่แมปกับ DismissAction (เช่น WristTurn) ให้เรียกใช้คำสั่ง ADB Shell ต่อไปนี้

    adb shell cmd IWearGestureService gesture WristTurn
    

รีเซ็ตการติดตามคำแนะนำท่าทางสัมผัส

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

  • ในบิลด์หรือโปรแกรมจำลอง userdebug:

    adb shell cmd IWearGestureService hint clear <your_package_name>
    
  • ในบิลด์เวอร์ชันค้าปลีก (user)

    ในอุปกรณ์เชิงพาณิชย์ที่ไม่มีสิทธิ์เข้าถึงระดับรูท hint clear จะถูกบล็อกโดยสิทธิ์ของระบบ ล้างข้อมูลในเครื่องของแอปเพื่อรีเซ็ตการค้นพบคำแนะนำ โดยทำดังนี้

    adb shell pm clear <your_package_name>
    

คืนค่าข้อจำกัดเริ่มต้น

วิธีรีเซ็ตการลบล้างข้อจำกัดการแก้ไขข้อบกพร่องทั้งหมดเมื่อทดสอบเสร็จแล้ว

adb shell cmd IWearGestureService override-constraints reset

แก้ปัญหาการแทรกท่าทางสัมผัส

หากแอปไม่ได้รับท่าทางสัมผัสจำลอง ให้ทำดังนี้

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

    adb shell input keyevent KEYCODE_WAKEUP
    
  2. ตรวจสอบว่าแอปของคุณลงทะเบียนเป็นผู้สมัครใช้บริการท่าทางสัมผัสที่ใช้งานอยู่และกำลังโฟกัสหน้าต่างอยู่หรือไม่ โดยทำดังนี้

    adb shell cmd IWearGestureService get-active-gestures -readable
    

    เมื่อหน้าจอท่าทางสัมผัสของแอปอยู่เบื้องหน้าและหน้าจอเปิดอยู่ คำสั่งนี้จะแสดงท่าทางสัมผัสที่ใช้งานอยู่สำหรับการดำเนินการที่สมัครไว้ (เช่น [DoublePinch] หรือ [DoublePinch, WristTurn]) หากระบบแสดงรายการว่างเปล่า ([]) ให้ตรวจสอบว่าหน้าต่างของคุณมีการโฟกัสอยู่หรือไม่ หรือข้อจำกัดเมื่อไม่ได้สวมใส่อุปกรณ์กำลังบล็อกการเปิดใช้งานอยู่หรือไม่

  3. ตรวจสอบสถานะบริการท่าทางสัมผัสภายในและโทเค็นผู้สมัครใช้บริการที่ใช้งานอยู่

    adb shell dumpsys IWearGestureService
    

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

ดูคำแนะนำด้านการออกแบบเกี่ยวกับเวลาและตำแหน่งที่ควรใช้ท่าทางสัมผัสด้วยมือเดียวได้ที่ท่าทางสัมผัสด้วยมือเดียว