สไตลัสเป็นเครื่องมือที่ช่วยให้ทำงานและสร้างสรรค์ได้อย่างมีประสิทธิภาพเป็นพิเศษ แต่เมื่อผู้ใช้วาด เขียน หรือโต้ตอบกับแอปโดยใช้สไตลัส บางครั้งผู้ใช้จะสัมผัสหน้าจอด้วยฝ่ามือ ระบบอาจรายงานการโต้ตอบแบบสัมผัสไปยังแอปของคุณก่อนที่ระบบจะจดจำและปิดเหตุการณ์ดังกล่าวเนื่องจากเป็นการสัมผัสด้วยฝ่ามือโดยไม่ตั้งใจ
แนวทางปฏิบัติแนะนำ
แอปของคุณต้องระบุการโต้ตอบแบบสัมผัสที่ไม่เกี่ยวข้องและละเว้นการโต้ตอบเหล่านั้น ใน Jetpack Compose คุณสามารถเข้าถึง MotionEvent ของ Android ที่สำคัญได้จาก PointerEvent ตรวจสอบ MotionEvent เพื่อหา ACTION_CANCEL ซึ่งบ่งชี้ว่าควรหยุดท่าทางสัมผัสและอาจต้องย้อนกลับ ใน Android 13 (ระดับ API 33) ขึ้นไป ให้ตรวจสอบแฟล็ก FLAG_CANCELED ในเหตุการณ์ ACTION_CANCEL และ ACTION_POINTER_UP ซึ่งเป็นสัญญาณที่ชัดเจนว่าการแตะไม่ได้เกิดจากความตั้งใจ เช่น การแตะด้วยฝ่ามือ
ส่วนผสม
Modifier.pointerInput(): ตัวแก้ไข Compose ที่ใช้ประมวลผลอินพุตเคอร์เซอร์PointerEvent: แสดงถึงเหตุการณ์ตัวชี้ใน Compose ซึ่งมีการเปลี่ยนแปลงอย่างน้อย 1 รายการPointerEvent.motionEvent: พร็อพเพอร์ตี้ส่วนขยายที่ให้สิทธิ์เข้าถึงMotionEventของ Android ที่เกี่ยวข้อง (เป็นค่า Null ได้)MotionEvent: แสดงเหตุการณ์การแตะและการเคลื่อนไหว มีข้อมูลที่จำเป็นในการพิจารณาว่าควรละเว้นเหตุการณ์หรือไม่ACTION_CANCEL: ค่าคงที่MotionEventที่ระบุว่าท่าทางสัมผัสถูกยกเลิกแล้ว ท่าทางสัมผัสควรหยุดและอาจต้องย้อนกลับACTION_POINTER_UP: ค่าคงที่MotionEventที่ระบุว่าตัวชี้อื่นที่ไม่ใช่ตัวชี้แรกได้ยกขึ้น (นั่นคือ ไม่ได้สัมผัสกับหน้าจออุปกรณ์แล้ว)FLAG_CANCELED: ค่าคงที่MotionEventที่ระบุว่าตัวชี้ที่เลื่อนขึ้นทำให้เกิดการโต้ตอบแบบสัมผัสโดยไม่ตั้งใจ เพิ่มลงในเหตุการณ์ACTION_POINTER_UPและACTION_CANCELใน Android 13 (ระดับ API 33) ขึ้นไป
ขั้นตอน
ตรวจสอบออบเจ็กต์ MotionEvent ที่ส่งไปยังแอปของคุณ ใช้ API MotionEvent เพื่อระบุลักษณะของเหตุการณ์
- เหตุการณ์ตัวชี้เดียว - ตรวจหา
ACTION_CANCELซึ่งบ่งบอกว่าควรหยุดท่าทางสัมผัส ใน Android 13 ขึ้นไป ให้ตรวจสอบFLAG_CANCELEDเพื่อยืนยันว่าการแตะไม่ได้เกิดขึ้นโดยตั้งใจ - เหตุการณ์แบบหลายตัวชี้ - ใน Android 13 ขึ้นไป ให้ตรวจสอบ
ACTION_POINTER_UPและFLAG_CANCELEDเพื่อระบุการแตะโดยไม่ตั้งใจ
ตอบสนองต่อเหตุการณ์เหล่านี้โดยหยุดท่าทางสัมผัสและย้อนกลับการเปลี่ยนแปลงชั่วคราว
1. รับออบเจ็กต์เหตุการณ์การเคลื่อนไหว
ใช้ Modifier.pointerInput เพื่อประมวลผลอินพุตเคอร์เซอร์ใน Composable ภายในขอบเขตอินพุตเคอร์เซอร์ ให้ใช้ awaitPointerEventScope และ awaitPointerEvent เพื่อรับเหตุการณ์ และดึงข้อมูล MotionEvent ของ Android ที่เกี่ยวข้องโดยใช้พร็อพเพอร์ตี้ motionEvent ดังนี้
import androidx.compose.ui.input.pointer.pointerInput Box( modifier = Modifier .fillMaxSize() .pointerInput(Unit) { awaitPointerEventScope { while (true) { val event = awaitPointerEvent() val motionEvent = event.motionEvent if (motionEvent != null) { // Process motion event. } } } } )
2. กำหนดการดำเนินการและแฟล็กของเหตุการณ์
ตรวจสอบ MotionEvent สำหรับ ACTION_CANCEL ซึ่งระบุเหตุการณ์ตัวชี้เดียวในระดับ API ทั้งหมด ใน Android 13 ขึ้นไป ให้ตรวจสอบ ACTION_POINTER_UP เพื่อดูFLAG_CANCELED
import androidx.compose.ui.input.pointer.pointerInput Box( modifier = Modifier .fillMaxSize() .pointerInput(Unit) { awaitPointerEventScope { while (true) { val event = awaitPointerEvent() val motionEvent = event.motionEvent ?: continue when (motionEvent.actionMasked) { MotionEvent.ACTION_CANCEL -> { // Process canceled single-pointer motion event for all SDK versions. } MotionEvent.ACTION_POINTER_UP -> { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU && (motionEvent.flags and MotionEvent.FLAG_CANCELED) == MotionEvent.FLAG_CANCELED ) { // Process canceled multi-pointer motion event for Android 13 and higher. } } } } } } )
3. เลิกทำท่าทางสัมผัส
เมื่อระบุการสัมผัสด้วยฝ่ามือแล้ว คุณสามารถยกเลิกเอฟเฟกต์บนหน้าจอของท่าทางสัมผัสดังกล่าวได้
แอปของคุณต้องเก็บประวัติการดำเนินการของผู้ใช้เพื่อให้สามารถยกเลิกการป้อนข้อมูลโดยไม่ตั้งใจ เช่น การสัมผัสด้วยฝ่ามือ ดูตัวอย่างได้ที่ใช้แอปวาดภาพพื้นฐานใน Codelab ปรับปรุงการรองรับสไตลัสในแอป Android
ผลลัพธ์
ตอนนี้แอปของคุณสามารถระบุและปฏิเสธการสัมผัสด้วยฝ่ามือสำหรับเหตุการณ์แบบหลายตัวชี้ใน Android 13 และระดับ API ที่สูงขึ้น รวมถึงเหตุการณ์แบบตัวชี้เดียวใน API ทุกระดับ
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้
- ฟีเจอร์และ API ของ Android 13 - การปฏิเสธการสัมผัสจากฝ่ามือที่ได้รับการปรับปรุง
- คู่มือนักพัฒนาซอฟต์แวร์
- ฟีเจอร์ขั้นสูงของสไตลัส
- ส่วนการปฏิเสธฝ่ามือของความเข้ากันได้ของอินพุตบนหน้าจอขนาดใหญ่
- Codelab — ปรับปรุงการรองรับสไตลัสในแอป Android