ใน 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 ให้กำหนดการตั้งค่าอุปกรณ์และลบล้างข้อจำกัดดังนี้
ตรวจสอบว่าอุปกรณ์ Wear OS ใช้ Wear OS 7 (ระดับ API 37) ขึ้นไป
adb shell getprop ro.build.version.sdkหากคุณกำลังทดสอบในอุปกรณ์จริงที่ไม่ได้อยู่บนข้อมือหรือวางอยู่บนที่ชาร์จ ให้ลบล้างข้อจำกัดเมื่อไม่ได้อยู่บนร่างกายเพื่อให้เฟรมเวิร์กท่าทางสัมผัสยังคงทำงานอยู่ โดยทำดังนี้
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
แก้ปัญหาการแทรกท่าทางสัมผัส
หากแอปไม่ได้รับท่าทางสัมผัสจำลอง ให้ทำดังนี้
ตรวจสอบว่าหน้าจอนาฬิกาเปิดอยู่ เฟรมเวิร์กท่าทางสัมผัสจะไม่ส่งท่าทางสัมผัสไปยังแอปพลิเคชันขณะที่หน้าจอปิดอยู่หรืออยู่ในโหมดแอมเบียนท์ หากต้องการปลุกจอแสดงผลโดยใช้ ADB ให้เรียกใช้คำสั่งต่อไปนี้
adb shell input keyevent KEYCODE_WAKEUPตรวจสอบว่าแอปของคุณลงทะเบียนเป็นผู้สมัครใช้บริการท่าทางสัมผัสที่ใช้งานอยู่และกำลังโฟกัสหน้าต่างอยู่หรือไม่ โดยทำดังนี้
adb shell cmd IWearGestureService get-active-gestures -readableเมื่อหน้าจอท่าทางสัมผัสของแอปอยู่เบื้องหน้าและหน้าจอเปิดอยู่ คำสั่งนี้จะแสดงท่าทางสัมผัสที่ใช้งานอยู่สำหรับการดำเนินการที่สมัครไว้ (เช่น
[DoublePinch]หรือ[DoublePinch, WristTurn]) หากระบบแสดงรายการว่างเปล่า ([]) ให้ตรวจสอบว่าหน้าต่างของคุณมีการโฟกัสอยู่หรือไม่ หรือข้อจำกัดเมื่อไม่ได้สวมใส่อุปกรณ์กำลังบล็อกการเปิดใช้งานอยู่หรือไม่ตรวจสอบสถานะบริการท่าทางสัมผัสภายในและโทเค็นผู้สมัครใช้บริการที่ใช้งานอยู่
adb shell dumpsys IWearGestureService
แหล่งข้อมูลเพิ่มเติม
ดูคำแนะนำด้านการออกแบบเกี่ยวกับเวลาและตำแหน่งที่ควรใช้ท่าทางสัมผัสด้วยมือเดียวได้ที่ท่าทางสัมผัสด้วยมือเดียว
แนะนำสำหรับคุณ
- หมายเหตุ: ข้อความลิงก์จะแสดงเมื่อ JavaScript ปิดอยู่
- คู่มือการออกแบบท่าทางสัมผัสมือเดียว