อุปกรณ์ระบบสัมผัส

การดำเนินการของอุปกรณ์ระบบสัมผัส

ข้อมูลสรุปสั้นๆ เกี่ยวกับการทำงานของอุปกรณ์ระบบสัมผัสใน Android มีดังนี้

1. EventHub อ่านเหตุการณ์ดิบจากไดรเวอร์ evdev
2. InputReader จะใช้เหตุการณ์ดิบและอัปเดตสถานะภายในเกี่ยวกับตำแหน่งและลักษณะอื่นๆ ของเครื่องมือแต่ละรายการ รวมถึงติดตามสถานะของปุ่มด้วย
3. หากมีการกดหรือปล่อยBACK หรือ FORWARD InputReader จะแจ้งให้ InputDispatcher ทราบเกี่ยวกับเหตุการณ์สำคัญ
4. InputReader ระบุว่ามีการกดแป้นเสมือนหรือไม่ หากใช่ ระบบจะแจ้งให้ InputDispatcher ทราบเกี่ยวกับเหตุการณ์สำคัญ
5. InputReader กำหนดว่ามีการเริ่มการสัมผัสภายในขอบเขตของจอแสดงผลหรือไม่ หากใช่ ระบบจะแจ้งให้ InputDispatcher ทราบเกี่ยวกับเหตุการณ์การสัมผัส
6. หากไม่มีเครื่องมือการสัมผัส แต่มีเครื่องมือการวางเมาส์เหนืออย่างน้อย 1 รายการ InputReader จะแจ้งให้ InputDispatcher ทราบเกี่ยวกับเหตุการณ์การวางเมาส์เหนือ
7. หากประเภทอุปกรณ์ระบบสัมผัสคือตัวชี้ InputReader จะดำเนินการตรวจหาท่าทางสัมผัสของตัวชี้ ย้ายตัวชี้และจุดให้สอดคล้องกัน และแจ้ง InputDispatcher เกี่ยวกับเหตุการณ์ของตัวชี้
8. InputDispatcher ใช้ WindowManagerPolicy เพื่อระบุว่าควรส่งเหตุการณ์หรือไม่และควรปลุกอุปกรณ์หรือไม่ จากนั้น InputDispatcher จะส่งเหตุการณ์ไปยังแอปที่เหมาะสม

การกำหนดค่าอุปกรณ์ระบบสัมผัส

ลักษณะการทํางานของอุปกรณ์สัมผัสจะขึ้นอยู่กับแกน ปุ่ม พร็อพเพอร์ตี้อินพุต การกำหนดค่าอุปกรณ์อินพุต แผนที่แป้นเสมือน และเลย์เอาต์แป้น

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

• ป้อนไฟล์การกำหนดค่าอุปกรณ์
• ไฟล์คีย์แมปเสมือน

คุณสมบัติ

ระบบอาศัยคุณสมบัติการกำหนดค่าอุปกรณ์อินพุตหลายรายการในการกำหนดค่าและปรับเทียบลักษณะการทำงานของอุปกรณ์ระบบสัมผัส

สาเหตุหนึ่งก็คือไดรเวอร์ของอุปกรณ์สําหรับอุปกรณ์ระบบสัมผัสมักรายงานลักษณะของการแตะโดยใช้หน่วยเฉพาะของอุปกรณ์

ตัวอย่างเช่น อุปกรณ์แบบสัมผัสจํานวนมากจะวัดพื้นที่สัมผัสด้วยการสัมผัสโดยใช้มาตราส่วนเฉพาะอุปกรณ์ภายใน เช่น จํานวนโหนดเซ็นเซอร์ทั้งหมดที่เรียกให้แสดงด้วยการสัมผัส ค่าขนาดดิบนี้จะไม่มีความหมายสําหรับแอป เนื่องจากแอปจําเป็นต้องทราบเกี่ยวกับขนาดจริงและลักษณะอื่นๆ ของโหนดเซ็นเซอร์ของอุปกรณ์สัมผัส

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

รูปแบบเอกสารประกอบ

สำหรับจุดประสงค์ด้านเอกสาร เราใช้แบบแผนต่อไปนี้ในการอธิบายค่าที่ระบบใช้ในกระบวนการปรับเทียบ

ค่าแกนดิบ

นิพจน์ต่อไปนี้แสดงค่าดิบที่รายงานโดยไดรเวอร์อุปกรณ์สัมผัสเป็นเหตุการณ์ EV_ABS

raw.x

ค่าของแกน ABS_X หรือแกน ABS_MT_POSITION_X

raw.y

ค่าของแกน ABS_Y หรือ ABS_MT_POSITION_Y

raw.pressure

ค่าของแกน ABS_PRESSURE หรือ ABS_MT_PRESSURE หรือ 0 หากไม่มี

raw.touchMajor

ค่าของแกน ABS_MT_TOUCH_MAJOR หรือ 0 หากไม่มี

raw.touchMinor

ค่าของแกน ABS_MT_TOUCH_MINOR หรือ raw.touchMajor หากไม่มี

raw.toolMajor

ค่าของแกน ABS_TOOL_WIDTH หรือ ABS_MT_WIDTH_MAJOR หรือ 0 หากไม่มี

raw.toolMinor

ค่าของแกน ABS_MT_WIDTH_MINOR หรือ raw.toolMajor หากไม่มี

raw.orientation

ค่าของแกน ABS_MT_ORIENTATION หรือ 0 หากไม่มี

raw.distance

ค่าของแกน ABS_DISTANCE หรือ ABS_MT_DISTANCE หรือ 0 หากไม่มี

raw.tiltX

ค่าของแกน ABS_TILT_X หรือ 0 หากไม่มี

raw.tiltY

ค่าของแกน ABS_TILT_Y หรือ 0 หากไม่มี

ช่วงแกนดิบ

นิพจน์ต่อไปนี้แสดงขอบเขตของค่าดิบ โดยรับค่าเหล่านี้ด้วยการเรียกใช้ EVIOCGABS ioctl สําหรับแต่ละแกน

raw.*.min

ค่าต่ำสุดแบบรวมของแกนข้อมูลดิบ

raw.*.max

ค่าสูงสุดแบบรวมของแกนข้อมูลดิบ

raw.*.range

เทียบเท่ากับ raw.*.max - raw.*.min

raw.*.fuzz

ความถูกต้องของแกนข้อมูลดิบ เช่น fuzz = 1 หมายความว่าค่ามีความแม่นยำ +/- 1 หน่วย

raw.width

ความกว้างรวมของพื้นที่สัมผัส ซึ่งเท่ากับ raw.x.range + 1

raw.height

ความสูงรวมของพื้นที่สัมผัส ซึ่งเท่ากับ raw.y.range + 1

ช่วงเอาต์พุต

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

output.width

ความกว้างของเอาต์พุต สำหรับหน้าจอสัมผัส (ที่เชื่อมโยงกับจอแสดงผล) ค่านี้คือความกว้างของจอแสดงผลเป็นพิกเซล สำหรับแท็บเล็ต (ไม่ได้เชื่อมโยงกับจอแสดงผล) ความกว้างของเอาต์พุตจะเท่ากับ raw.width ซึ่งบ่งบอกว่าไม่มีการปัดเศษ

output.height

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

output.diag

ความยาวเส้นทแยงมุมของระบบพิกัดเอาต์พุต ซึ่งเท่ากับ sqrt(output.width ^2 + output.height ^2)

การกำหนดค่าพื้นฐาน

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

touch.deviceType

คําจํากัดความ: touch.deviceType = touchScreen | touchPad | pointer | default

ระบุประเภทอุปกรณ์แบบสัมผัส

• หากค่าเป็น touchScreen แสดงว่าอุปกรณ์ระบบสัมผัสจะเป็นหน้าจอสัมผัสที่เชื่อมโยงกับจอแสดงผล

• หากค่าคือ touchPad แสดงว่าอุปกรณ์สัมผัสคือทัชแพดที่ไม่ได้เชื่อมโยงกับจอแสดงผล

• หากค่าคือ pointer อุปกรณ์สัมผัสคือแทร็กแพดที่ไม่ได้เชื่อมโยงกับจอแสดงผล และระบบจะใช้การเคลื่อนไหวของอุปกรณ์เพื่อท่าทางสัมผัสแบบใช้หลายนิ้วโดยอ้อม

• หากค่าคือ default ระบบจะตรวจหาประเภทอุปกรณ์โดยอัตโนมัติตามอัลกอริทึมการจัดประเภท

ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีที่ประเภทอุปกรณ์ส่งผลต่อลักษณะการทํางานของอุปกรณ์แบบสัมผัสได้ที่ส่วนการจัดประเภท

ใน Android 3 และต่ำกว่า อุปกรณ์ระบบสัมผัสทั้งหมดจะถือว่าเป็นหน้าจอสัมผัส

touch.orientationAware

คําจํากัดความ: touch.orientationAware = 0 | 1

ระบุว่าอุปกรณ์แบบสัมผัสควรตอบสนองต่อการเปลี่ยนแปลงการวางแนวของจอแสดงผลหรือไม่

• หากค่าเป็น 1 ระบบจะหมุนตำแหน่งการสัมผัสที่อุปกรณ์สัมผัสรายงานทุกครั้งที่การวางแนวของจอแสดงผลเปลี่ยนแปลง

• หากค่าเป็น 0 ตำแหน่งการสัมผัสที่อุปกรณ์สัมผัสรายงานจะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงการวางแนวของหน้าจอ

ค่าเริ่มต้นคือ 1 หากอุปกรณ์เป็นหน้าจอสัมผัส หรือ 0 หากไม่ใช่

ระบบจะแยกความแตกต่างระหว่างหน้าจอสัมผัสและจอแสดงผลภายในและภายนอก หน้าจอสัมผัสภายในที่รับรู้การวางแนวจะหมุนตามการวางแนวของจอแสดงผลภายใน หน้าจอสัมผัสภายนอกที่รับรู้การวางแนวจะหมุนตามการวางแนวของจอแสดงผลภายนอก

การตรวจหาการวางแนวใช้เพื่อรองรับการหมุนหน้าจอสัมผัสในอุปกรณ์ เช่น Nexus One ตัวอย่างเช่น เมื่ออุปกรณ์หมุนตามเข็มนาฬิกา 90 องศาจากการวางแนวตามธรรมชาติ ตำแหน่งสัมบูรณ์ของการสัมผัสจะมีการกำหนดตำแหน่งใหม่ โดยที่การแตะที่มุมซ้ายบนของระบบพิกัดสัมบูรณ์ของหน้าจอสัมผัสจะรายงานว่าเป็นการแตะที่มุมซ้ายบนของระบบพิกัดที่มีการหมุนของจอแสดงผล โดยมีจุดประสงค์เพื่อให้รายงานการแตะด้วยระบบพิกัดเดียวกันกับที่แอปใช้ในการวาดองค์ประกอบภาพ

ก่อนที่จะมี Honeycomb ระบบจะถือว่าอุปกรณ์แบบสัมผัสทั้งหมดรับรู้การวางแนว

touch.gestureMode

คําจํากัดความ: touch.gestureMode = pointer | spots | default

ระบุโหมดการนำเสนอสำหรับท่าทางสัมผัสของตัวชี้ พร็อพเพอร์ตี้การกําหนดค่านี้จะมีผลเฉพาะเมื่ออุปกรณ์สัมผัสเป็นประเภท pointer

• หากค่าเป็น pointer ระบบจะแสดงท่าทางสัมผัสบนแท็บเล็ตด้วยการเคอร์เซอร์ซึ่งคล้ายกับเคอร์เซอร์ของเมาส์

• หากค่าคือ spots ท่าทางสัมผัสบนแท็บเล็ตจะแสดงโดยจุดยึดที่แสดงจุดศูนย์กลางของท่าทางสัมผัสและจุดกลมชุดหนึ่งที่แสดงตำแหน่งของนิ้วแต่ละนิ้ว

ค่าเริ่มต้นคือ pointer เมื่อมีการตั้งค่าพร็อพเพอร์ตี้อินพุต INPUT_PROP_SEMI_MT หรือจะเป็น spots ในกรณีอื่นๆ

ฟิลด์ X และ Y

ช่อง X และ Y จะมีข้อมูลตำแหน่งสำหรับจุดศูนย์กลางของพื้นที่ติดต่อ

การคำนวณ

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

xScale = output.width / raw.width
yScale = output.height / raw.height

If not orientation aware or screen rotation is 0 degrees:
output.x = (raw.x - raw.x.min) * xScale
output.y = (raw.y - raw.y.min) * yScale
Else If rotation is 90 degrees:
    output.x = (raw.y - raw.y.min) * yScale
    output.y = (raw.x.max - raw.x) * xScale
Else If rotation is 180 degrees:
    output.x = (raw.x.max - raw.x) * xScale
    output.y = (raw.y.max - raw.y) * yScale
Else If rotation is 270 degrees:
    output.x = (raw.y.max - raw.y) * yScale
    output.y = (raw.x - raw.x.min) * xScale
End If

touchMajor, touchMinor, ToolMajor, ToolMinor, ฟิลด์ขนาด

ช่อง touchMajor และ touchMinor อธิบายขนาดโดยประมาณของพื้นที่สัมผัสในหน่วยเอาต์พุต (พิกเซล)

ช่อง toolMajor และ toolMinor จะอธิบายขนาดโดยประมาณของเครื่องมือในหน่วยเอาต์พุต (พิกเซล)

ช่อง size อธิบายขนาดการแตะปกติที่สัมพันธ์กับขนาดการสัมผัสที่ใหญ่ที่สุดที่อุปกรณ์ระบบสัมผัสสามารถรับรู้ได้ ขนาดที่ปรับมาตรฐานได้น้อยที่สุดคือ 0.0 (ไม่มีสัมผัสหรือวัดไม่ได้) และขนาดที่ปรับมาตรฐานได้มากที่สุดคือ 1.0 (พื้นที่เซ็นเซอร์มีสัญญาณเต็ม)

เมื่อวัดได้ทั้งความยาวและความกว้างโดยประมาณ ช่อง touchMajor จะระบุมิติข้อมูลที่ยาวกว่า ส่วนช่อง touchMinor จะระบุมิติข้อมูลที่สั้นกว่าของพื้นที่ติดต่อ เมื่อวัดได้เฉพาะเส้นผ่านศูนย์กลางโดยประมาณของพื้นที่สัมผัส ช่อง touchMajor และ touchMinor จะเท่ากับ

ในทำนองเดียวกัน ช่อง toolMajor จะระบุขนาดที่ยาวกว่า และช่อง toolMinor จะระบุขนาดที่สั้นกว่าของพื้นที่หน้าตัดของเครื่องมือ

หากไม่มีขนาดการสัมผัสแต่มีขนาดเครื่องมือ ระบบจะตั้งค่าขนาดเครื่องมือให้เท่ากับขนาดการสัมผัส ในทางกลับกัน หากไม่มีขนาดเครื่องมือแต่มีขนาดการแตะ ระบบจะตั้งค่าขนาดการแตะเท่ากับขนาดเครื่องมือ

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

คําจํากัดความ: touch.size.calibration = none | geometric | diameter | area | default

ระบุประเภทการวัดที่ไดรเวอร์การสัมผัสใช้เพื่อรายงานขนาดการสัมผัสและขนาดเครื่องมือ

• หากค่าเป็น none ระบบจะตั้งค่าขนาดเป็น 0

• หากค่าคือ geometric ระบบจะถือว่าระบุขนาดไว้ในหน่วยพื้นผิวเดียวกันกับตำแหน่ง จึงมีการปรับขนาดในลักษณะเดียวกัน

• หากค่าคือ diameter ระบบจะถือว่าขนาดนั้นสัมพันธ์กับเส้นผ่านศูนย์กลาง (ความกว้าง) ของการสัมผัสหรือเครื่องมือ

• หากค่าคือ area ระบบจะถือว่าขนาดเป็นสัดส่วนกับพื้นที่ของการแตะหรือเครื่องมือ

• หากค่าคือ default ระบบจะใช้การปรับเทียบ geometric หากแกน raw.touchMajor หรือ raw.toolMajor พร้อมใช้งาน ไม่เช่นนั้นจะใช้การปรับเทียบ none

touch.size.scale

คําจํากัดความ: touch.size.scale = <a non-negative floating point number>

ระบุค่าตัวคูณมาตราส่วนคงที่ที่ใช้ในการปรับเทียบ

ค่าเริ่มต้นคือ 1.0

touch.size.bias

คําจํากัดความ: touch.size.bias = <a non-negative floating point number>

ระบุค่าความเบี่ยงเบนคงที่ที่ใช้ในการสอบเทียบ

ค่าเริ่มต้นคือ 0.0

touch.size.isSummed

คําจํากัดความ: touch.size.isSummed = 0 | 1

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

• หากค่าคือ 1 ระบบจะหารขนาดที่รายงานด้วยจํานวนรายชื่อติดต่อก่อนใช้งาน

• หากค่าคือ 0 ระบบจะใช้ขนาดที่รายงานตามที่เป็นอยู่

ค่าเริ่มต้นคือ 0

อุปกรณ์แบบสัมผัสบางรุ่น โดยเฉพาะอุปกรณ์ "Semi-MT" จะแยกแยะมิติข้อมูลแต่ละรายการของรายชื่อติดต่อหลายรายการไม่ได้ จึงรายงานการวัดขนาดที่แสดงถึงพื้นที่หรือความกว้างทั้งหมด คุณควรตั้งค่าพร็อพเพอร์ตี้นี้เป็น 1 สำหรับอุปกรณ์ดังกล่าวเท่านั้น หากไม่แน่ใจ ให้ตั้งค่านี้เป็น 0

การคำนวณ

การคํานวณฟิลด์ touchMajor, touchMinor, toolMajor, toolMinor และ size ขึ้นอยู่กับพารามิเตอร์การสอบเทียบที่ระบุ

If raw.touchMajor and raw.toolMajor are available:
    touchMajor = raw.touchMajor
    touchMinor = raw.touchMinor
    toolMajor = raw.toolMajor
    toolMinor = raw.toolMinor
Else If raw.touchMajor is available:
    toolMajor = touchMajor = raw.touchMajor
    toolMinor = touchMinor = raw.touchMinor
Else If raw.toolMajor is available:
    touchMajor = toolMajor = raw.toolMajor
    touchMinor = toolMinor = raw.toolMinor
Else
    touchMajor = toolMajor = 0
    touchMinor = toolMinor = 0
    size = 0
End If

size = avg(touchMajor, touchMinor)

If touch.size.isSummed == 1:
    touchMajor = touchMajor / numberOfActiveContacts
    touchMinor = touchMinor / numberOfActiveContacts
    toolMajor = toolMajor / numberOfActiveContacts
    toolMinor = toolMinor / numberOfActiveContacts
    size = size / numberOfActiveContacts
End If

If touch.size.calibration == "none":
    touchMajor = toolMajor = 0
    touchMinor = toolMinor = 0
    size = 0
Else If touch.size.calibration == "geometric":
    outputScale = average(output.width / raw.width, output.height / raw.height)
    touchMajor = touchMajor * outputScale
    touchMinor = touchMinor * outputScale
    toolMajor = toolMajor * outputScale
    toolMinor = toolMinor * outputScale
Else If touch.size.calibration == "area":
    touchMajor = sqrt(touchMajor)
    touchMinor = touchMajor
    toolMajor = sqrt(toolMajor)
    toolMinor = toolMajor
Else If touch.size.calibration == "diameter":
    touchMinor = touchMajor
    toolMinor = toolMajor
End If

If touchMajor != 0:
    output.touchMajor = touchMajor * touch.size.scale + touch.size.bias
Else
    output.touchMajor = 0
End If

If touchMinor != 0:
    output.touchMinor = touchMinor * touch.size.scale + touch.size.bias
Else
    output.touchMinor = 0
End If

If toolMajor != 0:
    output.toolMajor = toolMajor * touch.size.scale + touch.size.bias
Else
    output.toolMajor = 0
End If

If toolMinor != 0:
    output.toolMinor = toolMinor * touch.size.scale + touch.size.bias
Else
    output.toolMinor = 0
End If

output.size = size

สนามแรงดัน

ช่อง pressure อธิบายแรงกดบนอุปกรณ์แบบสัมผัสโดยประมาณเป็นค่ามาตรฐานระหว่าง 0.0 (ไม่มีการสัมผัส) ถึง 1.0 (แรงกดปกติ)

แรงดันเป็น 0 แสดงว่าเครื่องมือกำลังลอยอยู่

touch.pressure.calibration

คําจํากัดความ: touch.pressure.calibration = none | physical | amplitude | default

ระบุประเภทการวัดที่ไดรเวอร์การสัมผัสใช้เพื่อรายงานแรงกด

• หากค่าเป็น none ระบบจะไม่ทราบความดันจึงตั้งค่าเป็น 1.0 เมื่อแตะ และ 0.0 เมื่อวางเมาส์เหนือ

• หากค่าคือ physical ระบบจะถือว่าแกนแรงกดจะวัดความเข้มของแรงกดจริงที่กระทำต่อแผ่นสัมผัส

• หากค่าเป็น amplitude ระบบจะถือว่าแกนความดันจะวัดแอมพลิจูดของสัญญาณ ซึ่งเกี่ยวข้องกับขนาดของหน้าสัมผัสและแรงกดที่ใช้

• หากค่าคือ default ระบบจะใช้การปรับเทียบ physical หากแกนความดันพร้อมใช้งาน ไม่เช่นนั้นจะใช้ none

touch.pressure.scale

คําจํากัดความ: touch.pressure.scale = <a non-negative floating point number>

ระบุค่าตัวคูณมาตราส่วนคงที่ที่ใช้ในการปรับเทียบ

ค่าเริ่มต้นคือ 1.0 / raw.pressure.max

การคำนวณ

การคํานวณของช่อง pressure จะขึ้นอยู่กับพารามิเตอร์การสอบเทียบที่ระบุ

If touch.pressure.calibration == "physical" or "amplitude":
    output.pressure = raw.pressure * touch.pressure.scale
Else
    If hovering:
        output.pressure = 0
    Else
        output.pressure = 1
    End If
End If

ช่องการวางแนวและการเอียง

ช่อง orientation อธิบายการวางแนวของการแตะและเครื่องมือว่าเป็นการวัดเชิงมุม การวางแนว 0 บ่งบอกว่าแกนหลักวางแนวในแนวตั้ง -PI/2 บ่งบอกว่าแกนหลักวางแนวไปทางซ้าย และ PI/2 บ่งบอกว่าแกนหลักวางแนวไปทางขวา เมื่อมีเครื่องมือสไตลัสอยู่ ช่วงการวางแนวจะอธิบายเป็นช่วงวงกลมเต็มรูปแบบจาก -PI หรือ PI

ช่อง tilt อธิบายความเอียงของเครื่องมือในฐานะการวัดเชิงมุม การเอียง 0 บ่งบอกว่าเครื่องมือตั้งฉากกับพื้นผิว การเอียง PI/2 บ่งบอกว่าเครื่องมือวางอยู่บนพื้นผิวอย่างราบเรียบ

touch.orientation.calibration

คําจํากัดความ: touch.orientation.calibration = none | interpolated | vector | default

ระบุประเภทการวัดที่ไดรเวอร์การสัมผัสใช้เพื่อรายงานการวางแนว

• หากค่าเป็น none ระบบจะตั้งค่าเป็น 0 เนื่องจากไม่ทราบการวางแนว
• หากค่าเป็น interpolated จะมีการสลับรูปแบบเป็นเชิงเส้นเพื่อให้ค่าดิบของ raw.orientation.min แมปกับ -PI/2 และค่าดิบของ raw.orientation.max จะแมปกับ PI/2 ค่ากลางของ (raw.orientation.min + raw.orientation.max) / 2 จะแมปกับ 0
• หากค่าคือ vector ระบบจะตีความการวางแนวเป็นเวกเตอร์แบบแพ็กประกอบด้วยฟิลด์ 4 บิตแบบมีเครื่องหมาย 2 ฟิลด์ การแสดงข้อมูลนี้ใช้ในชิ้นส่วนของโปรโตคอลที่อิงตามออบเจ็กต์ของ Atmel เมื่อถอดรหัสแล้ว เวกเตอร์จะให้มุมการวางแนวและระดับความเชื่อมั่น ระบบจะใช้ความเชื่อมั่นของขนาดเพื่อปรับขนาดข้อมูลขนาด เว้นแต่ว่าข้อมูลจะเป็นแบบเรขาคณิต
• หากค่าคือ default ระบบจะใช้การปรับเทียบ interpolated หากแกนการวางแนวพร้อมใช้งาน ไม่เช่นนั้นจะใช้ none

การคำนวณ

การคำนวณช่อง orientation และ tilt จะขึ้นอยู่กับพารามิเตอร์การสอบเทียบที่ระบุและอินพุตที่ใช้ได้

If touch.tiltX and touch.tiltY are available:
    tiltXCenter = average(raw.tiltX.min, raw.tiltX.max)
    tiltYCenter = average(raw.tiltY.min, raw.tiltY.max)
    tiltXAngle = (raw.tiltX - tiltXCenter) * PI / 180
    tiltYAngle = (raw.tiltY - tiltYCenter) * PI / 180
    output.orientation = atan2(-sin(tiltXAngle), sinf(tiltYAngle))
    output.tilt = acos(cos(tiltXAngle) * cos(tiltYAngle))
Else If touch.orientation.calibration == "interpolated":
    center = average(raw.orientation.min, raw.orientation.max)
    output.orientation = PI / (raw.orientation.max - raw.orientation.min)
    output.tilt = 0
Else If touch.orientation.calibration == "vector":
    c1 = (raw.orientation & 0xF0) >> 4
    c2 = raw.orientation & 0x0F

    If c1 != 0 or c2 != 0:
        If c1 >= 8 Then c1 = c1 - 16
        If c2 >= 8 Then c2 = c2 - 16
        angle = atan2(c1, c2) / 2
        confidence = sqrt(c1*c1 + c2*c2)

        output.orientation = angle

        If touch.size.calibration == "diameter" or "area":
            scale = 1.0 + confidence / 16
            output.touchMajor *= scale
            output.touchMinor /= scale
            output.toolMajor *= scale
            output.toolMinor /= scale
        End If
    Else
        output.orientation = 0
    End If
    output.tilt = 0
Else
    output.orientation = 0
    output.tilt = 0
End If

If orientation aware:
    If screen rotation is 90 degrees:
        output.orientation = output.orientation - PI / 2
    Else If screen rotation is 270 degrees:
        output.orientation = output.orientation + PI / 2
    End If
End If

ช่องระยะทาง

ช่อง distance จะอธิบายระยะห่างระหว่างเครื่องมือกับพื้นผิวของอุปกรณ์ที่สัมผัส ค่า 0.0 หมายถึงการสัมผัสโดยตรง ส่วนค่าที่มากขึ้นหมายถึงระยะห่างจากพื้นผิวที่เพิ่มขึ้น

touch.distance.calibration

คําจํากัดความ: touch.distance.calibration = none | scaled | default

ระบุประเภทการวัดที่ไดรเวอร์ระบบสัมผัสเพื่อรายงานระยะทาง

• หากค่าคือ none แสดงว่าไม่ทราบระยะทาง ระบบจึงตั้งค่าเป็น 0

• หากค่าคือ scaled ระบบจะคูณระยะทางที่รายงานด้วยปัจจัยการแปลงค่าคงที่

• หากค่าคือ default ระบบจะใช้การสอบเทียบ scaled หากแกนระยะทางพร้อมใช้งาน ไม่เช่นนั้นจะใช้ none

touch.distance.scale

คําจํากัดความ: touch.distance.scale = <a non-negative floating point number>

ระบุค่าตัวคูณมาตราส่วนที่คงที่ซึ่งใช้ในการปรับเทียบ

ค่าเริ่มต้นคือ 1.0

การคำนวณ

การคํานวณของช่อง distance จะขึ้นอยู่กับพารามิเตอร์การปรับเทียบที่ระบุ

If touch.distance.calibration == "scaled":
    output.distance = raw.distance * touch.distance.scale
Else
    output.distance = 0
End If

ตัวอย่าง

# Input device configuration file for a touch screen that supports pressure,
# size and orientation. The pressure and size scale factors were obtained
# by measuring the characteristics of the device itself and deriving
# useful approximations based on the resolution of the touch sensor and the
# display.
#
# Note that these parameters are specific to a particular device model.
# Different parameters need to be used for other devices.

# Basic Parameters
touch.deviceType = touchScreen
touch.orientationAware = 1

# Size
# Based on empirical measurements, we estimate the size of the contact
# using size = sqrt(area) * 28 + 0.
touch.size.calibration = area
touch.size.scale = 28
touch.size.bias = 0
touch.size.isSummed = 0

# Pressure
# Driver reports signal strength as pressure.
#
# A normal index finger touch typically registers about 80 signal strength
# units although we don't expect these values to be accurate.
touch.pressure.calibration = amplitude
touch.pressure.scale = 0.0125

# Orientation
touch.orientation.calibration = vector

หมายเหตุเกี่ยวกับความเข้ากันได้

พร็อพเพอร์ตี้การกําหนดค่าสําหรับอุปกรณ์แบบสัมผัสมีการเปลี่ยนแปลงอย่างมากใน Android Ice Cream Sandwich 4.0 ไฟล์การกำหนดค่าอุปกรณ์อินพุตทั้งหมดสำหรับอุปกรณ์แบบสัมผัสต้องได้รับการอัปเดตเพื่อใช้พร็อพเพอร์ตี้การกําหนดค่าใหม่

คุณอาจต้องอัปเดตไดรเวอร์ของอุปกรณ์แบบสัมผัสรุ่นเก่าด้วย

ไฟล์การแมปแป้นเสมือน

สามารถใช้อุปกรณ์ระบบสัมผัสเพื่อติดตั้งคีย์เสมือนได้

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

เมื่อติดตั้งใช้งานคีย์เสมือนในซอฟต์แวร์ เคอร์เนลต้องส่งออกไฟล์การแมปคีย์เสมือนชื่อ virtualkeys.<devicename> เป็นพร็อพเพอร์ตี้ของบอร์ดและ เช่น หากไดรเวอร์อุปกรณ์หน้าจอสัมผัสรายงานชื่อเป็น "touchyfeely" ไฟล์การแมปแป้นเสมือนต้องมีเส้นทางเป็น /sys/board_properties/virtualkeys.touchyfeely

ไฟล์การแมปแป้นเสมือนจะอธิบายพิกัดและรหัสแป้นของ Linux สำหรับแป้นเสมือนบนหน้าจอสัมผัส

นอกเหนือจากไฟล์คีย์แมปเสมือนแล้ว ต้องมีไฟล์เลย์เอาต์คีย์ที่เกี่ยวข้องและไฟล์การแมปอักขระคีย์เพื่อแมปโค้ดคีย์ Linux กับโค้ดคีย์ Android และเพื่อระบุประเภทอุปกรณ์แป้นพิมพ์ (โดยปกติจะเป็น SPECIAL_FUNCTION)

วากยสัมพันธ์

ไฟล์การแมปแป้นเสมือนคือไฟล์ข้อความธรรมดาที่ประกอบด้วยลำดับคำอธิบายเลย์เอาต์แป้นเสมือนที่คั่นด้วยบรรทัดใหม่หรือโคลอน

บรรทัดความคิดเห็นจะขึ้นต้นด้วย "#" และต่อไปจนถึงท้ายบรรทัด

คีย์เสมือนแต่ละรายการจะอธิบายด้วยคอมโพเนนต์ 6 รายการที่คั่นด้วยโคลอน ดังนี้

• 0x01: รหัสเวอร์ชัน ต้องเป็น 0x01 เสมอ
• <Linux key code>: รหัสคีย์ Linux ของคีย์เสมือน
• <centerX>: พิกัดพิกเซล X ของกึ่งกลางของแป้นเสมือน
• <centerY>: พิกัดพิกเซล Y ของกึ่งกลางของปุ่มเสมือน
• <width>: ความกว้างของแป้นเสมือนในหน่วยพิกเซล
• <height>: ความสูงของแป้นเสมือนในหน่วยพิกเซล

พิกัดและขนาดทั้งหมดจะระบุในแง่ของระบบพิกัดการแสดงผล

ต่อไปนี้คือไฟล์การแมปคีย์เสมือนที่เขียนทั้งหมดในบรรทัดเดียว

# All on one line
0x01:158:55:835:90:55:0x01:139:172:835:125:55:0x01:102:298:835:115:55:0x01:217:412:835:95:55

ไฟล์คีย์แมปเสมือนเดียวกันยังเขียนได้หลายบรรทัดอีกด้วย

# One key per line
0x01:158:55:835:90:55
0x01:139:172:835:125:55
0x01:102:298:835:115:55
0x01:217:412:835:95:55

ในตัวอย่างด้านบน หน้าจอสัมผัสมีความละเอียด 480x800 ดังนั้น ปุ่มเสมือนทั้งหมดจึงมีพิกัด <centerY> เท่ากับ 835 ซึ่งอยู่ต่ำกว่าพื้นที่ที่มองเห็นได้ของหน้าจอสัมผัสเล็กน้อย

คีย์แรกมีโค้ดสแกนของ Linux ที่ 158 (KEY_BACK), centerX ของ 55, กึ่งกลาง Y ของ 835, กว้าง 90 และสูง 55

ตัวอย่าง

ไฟล์การแมปคีย์เสมือน: /sys/board_properties/virtualkeys.touchyfeely

0x01:158:55:835:90:55
0x01:139:172:835:125:55
0x01:102:298:835:115:55
0x01:217:412:835:95:55

ไฟล์เลย์เอาต์คีย์: /system/usr/keylayout/touchyfeely.kl

key 158 BACK
key 139 MENU
key 172 HOME
key 217 SEARCH

ไฟล์การแมปอักขระคีย์: /system/usr/keychars/touchyfeely.kcm

type SPECIAL_FUNCTION

ท่าทางสัมผัสแบบใช้เคอร์เซอร์แบบหลายนิ้วโดยอ้อม

ในโหมดเคอร์เซอร์ ระบบจะตีความท่าทางสัมผัสต่อไปนี้

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

การปฏิเสธฝ่ามือ

ตั้งแต่ Android 13 เป็นต้นไป ระบบจะปฏิเสธการป้อนข้อมูลจากฝ่ามือโดยอัตโนมัติเมื่อเปิดใช้เฟรมเวิร์กในตัว ระบบยังคงรองรับโซลูชันที่สร้างขึ้นเองภายในแม้ว่าอาจต้องแก้ไขให้แสดง Flag TOOL_TYPE_PALM เมื่อตรวจพบฝ่ามือ เฟรมเวิร์กในตัวยังทำงานร่วมกับโซลูชันที่กําหนดเองได้ด้วย

โมเดลจริงจะดูข้อมูลท่าทางสัมผัสในช่วง 90 มิลลิวินาทีแรก ที่เคอร์เซอร์ปัจจุบัน และที่เคอร์เซอร์รอบข้าง จากนั้นจะพิจารณาระยะห่างของการแตะจากขอบจอแสดงผล จากนั้นจะพิจารณาว่าปลายนิ้วใดเป็นฝ่ามือ โดยพิจารณาทีละปลายนิ้ว นอกจากนี้ ยังพิจารณาขนาดของรายชื่อติดต่อแต่ละรายการตามที่ touchMajor และ touchMinor รายงาน จากนั้นเฟรมเวิร์ก Android จะนําเคอร์เซอร์ที่ทำเครื่องหมายว่าเป็นฝ่ามือออกจากสตรีมการสัมผัส

หากส่งเคอร์เซอร์ไปยังแอปแล้ว ระบบจะทำอย่างใดอย่างหนึ่งต่อไปนี้

• (หากมีเคอร์เซอร์อื่นๆ ที่ใช้งานอยู่) ยกเลิกเคอร์เซอร์ที่มีการตั้งค่า ACTION_POINTER_UP และ FLAG_CANCELED
• (หากนี่เป็นเคอร์เซอร์เดียว) ยกเลิกตัวชี้ที่มี ACTION_CANCEL

API สาธารณะ MotionEvent.FLAG_CANCELED ระบุว่าเหตุการณ์ปัจจุบันไม่ควรทริกเกอร์การดําเนินการของผู้ใช้ ธงนี้ตั้งค่าไว้สำหรับทั้ง ACTION_CANCEL และ ACTION_POINTER_UP

หากไม่ได้ส่งเคอร์เซอร์จากฝ่ามือไปยังแอป ระบบจะวางเคอร์เซอร์ไว้

เปิดใช้ฟีเจอร์ปฏิเสธฝ่ามือ

1. ในไดรเวอร์การสัมผัส ให้ใช้มาโคร input_abs_set_res เพื่อตั้งค่าความละเอียดสำหรับช่องต่อไปนี้ (หน่วยคือพิกเซลต่อมม.)
   • ABS_MT_POSITION_X
   • ABS_MT_POSITION_Y
   • ABS_MT_TOUCH_MAJOR
   • ABS_MT_TOUCH_MINOR

   การสนับสนุนสำหรับ ABS_MT_TOUCH_MINOR เป็นตัวเลือกที่ไม่บังคับ แต่หากอุปกรณ์ของคุณรองรับ โปรดตั้งค่าความละเอียดให้ถูกต้อง

2. หากต้องการยืนยันว่าได้ตั้งค่าช่องอย่างถูกต้อง ให้เรียกใช้คำสั่งต่อไปนี้

       $ adb shell getevent -li
   

3. หากต้องการเปิดใช้ฟีเจอร์ระหว่างรันไทม์ ให้เรียกใช้คำสั่งต่อไปนี้

       $ adb shell device_config put input_native_boot palm_rejection_enabled 1
   

4. เริ่มกระบวนการ system_server อีกครั้ง

        $ adb shell stop && adb shell start
       

5. ตรวจสอบว่า adb shell dumpsys input แสดงว่ามีตัวป้องกันฝ่ามืออยู่ภายใน UnwantedInteractionBlocker หากไม่ ให้ตรวจสอบบันทึกที่เกี่ยวข้องกับอินพุตเพื่อหาเบาะแสว่าอาจมีการกําหนดค่าอะไรไม่ถูกต้อง

   โปรดดูตัวอย่างต่อไปนี้เพื่อเป็นข้อมูลอ้างอิง

   UnwantedInteractionBlocker:
     mEnablePalmRejection: true
     isPalmRejectionEnabled (flag value): true
     mPalmRejectors:
       deviceId = 3:
         mDeviceInfo:
           max_x = 
           max_y = 
           x_res = 11.00
           y_res = 11.00
           major_radius_res = 1.00
           minor_radius_res = 1.00
           minor_radius_supported = true
           touch_major_res = 1
           touch_minor_res = 1
         mSlotState:
           mSlotsByPointerId:
   
           mPointerIdsBySlot:
   
         mSuppressedPointerIds: {}
   

6. หากต้องการเปิดใช้ฟีเจอร์นี้อย่างถาวร ให้เพิ่มคำสั่ง sysprop ที่เกี่ยวข้องในไฟล์ init**rc ดังนี้

   setprop persist.device_config.input_native_boot.palm_rejection_enabled 1
   

อ่านเพิ่มเติม

• Linux โปรโตคอลการสัมผัสหลายจุด