thiết bị bàn phím

Android hỗ trợ nhiều loại thiết bị bàn phím, bao gồm bàn phím chức năng đặc biệt (điều khiển âm lượng và nguồn), bàn phím QWERTY nhúng nhỏ gọn và bàn phím ngoài kiểu PC đầy đủ tính năng.

Tài liệu này chỉ mô tả bàn phím vật lý. Tham khảo SDK Android để biết thông tin về bàn phím mềm (Trình chỉnh sửa phương thức nhập).

Phân loại bàn phím

Thiết bị đầu vào được phân loại là bàn phím nếu có một trong các điều kiện sau:

• Thiết bị đầu vào báo cáo sự hiện diện của bất kỳ mã khóa Linux nào được sử dụng trên bàn phím, bao gồm từ 0 đến 0xff hoặc KEY_OK đến KEY_MAX .

• Thiết bị đầu vào báo cáo sự hiện diện của bất kỳ mã khóa Linux nào được sử dụng trên cần điều khiển và gamepad bao gồm BTN_0 đến BTN_9 , BTN_TRIGGER đến BTN_DEAD hoặc BTN_A đến BTN_THUMBR .

Cần điều khiển hiện được phân loại là bàn phím vì các nút cần điều khiển và tay cầm chơi game được báo cáo bởi các sự kiện EV_KEY giống như cách báo cáo các phím trên bàn phím. Do đó, cần điều khiển và gamepad cũng sử dụng các tệp bản đồ chính để cấu hình.

Sau khi thiết bị đầu vào được phân loại là bàn phím, hệ thống sẽ tải tệp cấu hình thiết bị đầu vào và bố cục bàn phím cho bàn phím.

Sau đó, hệ thống sẽ cố gắng xác định các đặc tính bổ sung của thiết bị.

• Nếu thiết bị đầu vào có bất kỳ phím nào được ánh xạ tới KEYCODE_Q thì thiết bị đó được coi là có bàn phím chữ cái (ngược lại với số). Khả năng bàn phím chữ cái được báo cáo trong đối tượng Configuration tài nguyên là KEYBOARD_QWERTY .

• Nếu thiết bị đầu vào có bất kỳ phím nào được ánh xạ tới KEYCODE_DPAD_UP , KEYCODE_DPAD_DOWN , KEYCODE_DPAD_LEFT , KEYCODE_DPAD_RIGHT và KEYCODE_DPAD_CENTER (tất cả đều phải có), thì thiết bị đó được coi là có bàn phím định hướng. Khả năng bàn phím định hướng được báo cáo trong đối tượng Configuration tài nguyên dưới dạng NAVIGATION_DPAD .

• Nếu thiết bị đầu vào có bất kỳ phím nào được ánh xạ tới KEYCODE_BUTTON_A hoặc các phím liên quan đến gamepad khác thì thiết bị đó được coi là có gamepad.

Yêu cầu trình điều khiển bàn phím

1. Trình điều khiển bàn phím chỉ nên đăng ký mã khóa cho các phím mà chúng thực sự hỗ trợ. Việc đăng ký mã khóa thừa có thể gây nhầm lẫn cho thuật toán phân loại thiết bị hoặc khiến hệ thống phát hiện không chính xác khả năng bàn phím được hỗ trợ của thiết bị.

2. Trình điều khiển bàn phím nên sử dụng EV_KEY để báo cáo các lần nhấn phím, sử dụng giá trị 0 để biểu thị rằng một phím được nhả, giá trị 1 để biểu thị rằng một phím được nhấn và giá trị lớn hơn hoặc bằng 2 để biểu thị rằng phím đó được nhấn. được lặp lại một cách tự động.

3. Android thực hiện lặp lại bàn phím của riêng mình. Chức năng tự động lặp lại phải bị tắt trong trình điều khiển.

4. Trình điều khiển bàn phím có thể tùy ý chỉ ra cách sử dụng HID hoặc mã quét cấp thấp bằng cách gửi EV_MSC cùng với MSC_SCANCODE và một giá trị cho biết cách sử dụng hoặc mã quét khi nhấn phím. Thông tin này hiện không được Android sử dụng.

5. Trình điều khiển bàn phím phải hỗ trợ cài đặt trạng thái đèn LED khi EV_LED được ghi vào thiết bị. Trình điều khiển hid-input tự động xử lý việc này. Tại thời điểm viết bài này, Android sử dụng LED_CAPSLOCK , LED_SCROLLLOCK và LED_NUMLOCK . Những đèn LED này chỉ cần được hỗ trợ khi bàn phím thực sự có đèn báo liên quan.

6. Trình điều khiển bàn phím cho bàn phím nhúng (ví dụ: sử dụng ma trận GPIO) phải đảm bảo gửi các sự kiện EV_KEY có giá trị 0 cho bất kỳ phím nào vẫn được nhấn khi thiết bị chuyển sang chế độ ngủ. Nếu không, các phím có thể bị kẹt và sẽ tự động lặp lại mãi mãi.

Thao tác bàn phím

Sau đây là tóm tắt ngắn gọn về thao tác bàn phím trên Android.

1. EventHub đọc các sự kiện thô từ trình điều khiển evdev và ánh xạ mã khóa Linux (đôi khi được gọi là mã quét) vào mã khóa Android bằng cách sử dụng bản đồ bố cục phím của bàn phím.

2. InputReader sử dụng các sự kiện thô và cập nhật trạng thái khóa meta. Ví dụ: nếu nhấn hoặc nhả phím shift trái, đầu đọc sẽ đặt hoặc đặt lại các bit META_SHIFT_LEFT_ON và META_SHIFT_ON tương ứng.

3. InputReader thông báo cho Đầu InputDispatcher về sự kiện quan trọng.

4. InputDispatcher hỏi WindowManagerPolicy phải làm gì với sự kiện quan trọng bằng cách gọi WindowManagerPolicy.interceptKeyBeforeQueueing . Phương pháp này là một phần của đường dẫn quan trọng chịu trách nhiệm đánh thức thiết bị khi nhấn một số phím nhất định. EventHub giữ khóa đánh thức một cách hiệu quả dọc theo đường dẫn quan trọng này để đảm bảo rằng nó sẽ chạy đến khi hoàn thành.

5. Nếu một InputFilter hiện đang được sử dụng, InputDispatcher sẽ cho nó cơ hội sử dụng hoặc chuyển đổi khóa. InputFilter có thể được sử dụng để triển khai các chính sách trợ năng trên toàn hệ thống ở cấp độ thấp.

6. InputDispatcher liệt kê khóa để xử lý trên luồng điều phối.

7. Khi InputDispatcher loại bỏ khóa, nó sẽ cho WindowManagerPolicy cơ hội thứ hai để chặn sự kiện quan trọng bằng cách gọi WindowManagerPolicy.interceptKeyBeforeDispatching . Phương pháp này xử lý các phím tắt hệ thống và các chức năng khác.

8. Sau đó, InputDispatcher sẽ xác định mục tiêu sự kiện chính (cửa sổ được tập trung) và đợi chúng sẵn sàng. Sau đó, InputDispatcher sẽ gửi sự kiện quan trọng tới ứng dụng.

9. Bên trong ứng dụng, sự kiện quan trọng sẽ truyền tải thứ bậc chế độ xem xuống chế độ xem tập trung để gửi khóa trước IME.

10. Nếu sự kiện quan trọng không được xử lý trong bản gửi trước IME và IME đang được sử dụng thì sự kiện quan trọng sẽ được gửi tới IME.

11. Nếu sự kiện khóa không được IME sử dụng thì sự kiện khóa sẽ truyền xuống phân cấp chế độ xem đến chế độ xem tập trung để gửi khóa tiêu chuẩn.

12. Ứng dụng sẽ báo cáo lại cho InputDispatcher xem liệu sự kiện quan trọng đã được sử dụng hay chưa. Nếu sự kiện không được sử dụng, thì InputDispatcher sẽ gọi WindowManagerPolicy.dispatchUnhandledKey để áp dụng hành vi "dự phòng". Tùy thuộc vào hành động dự phòng, chu kỳ gửi sự kiện quan trọng có thể được khởi động lại bằng mã khóa khác. Ví dụ: nếu ứng dụng không xử lý KEYCODE_ESCAPE thì thay vào đó, hệ thống có thể gửi lại sự kiện quan trọng dưới dạng KEYCODE_BACK .

Cấu hình bàn phím

Hoạt động của bàn phím được xác định bởi bố cục phím, sơ đồ ký tự phím và cấu hình thiết bị đầu vào của bàn phím.

Tham khảo các phần sau để biết thêm chi tiết về các tệp tham gia cấu hình bàn phím:

• Tệp bố cục chính
• Tệp bản đồ ký tự chính
• File cấu hình thiết bị đầu vào

Của cải

Các thuộc tính cấu hình thiết bị đầu vào sau đây được sử dụng cho bàn phím.

bàn phím.layout

Định nghĩa: keyboard.layout = <name>

Chỉ định tên của tệp bố cục khóa được liên kết với thiết bị đầu vào, ngoại trừ phần mở rộng .kl . Nếu không tìm thấy tệp này, hệ thống nhập liệu sẽ sử dụng bố cục phím mặc định để thay thế.

Khoảng trắng trong tên được chuyển đổi thành dấu gạch dưới trong quá trình tra cứu.

Tham khảo tài liệu về tệp bố cục chính để biết thêm chi tiết.

keyboard.characterMap

Định nghĩa: keyboard.characterMap = <name>

Chỉ định tên của tệp bản đồ ký tự chính được liên kết với thiết bị đầu vào, ngoại trừ phần mở rộng .kcm . Nếu không tìm thấy tệp này, hệ thống đầu vào sẽ sử dụng bản đồ ký tự khóa mặc định để thay thế.

Khoảng trắng trong tên được chuyển đổi thành dấu gạch dưới trong quá trình tra cứu.

Tham khảo tài liệu về tệp bản đồ ký tự chính để biết thêm chi tiết.

bàn phím.orientationAware

Định nghĩa: keyboard.orientationAware = 0 | 1

Chỉ định xem bàn phím có phản ứng với những thay đổi về hướng hiển thị hay không.

• Nếu giá trị là 1 , các phím trên bàn phím định hướng sẽ được xoay khi hướng hiển thị liên quan thay đổi.

• Nếu giá trị là 0 , bàn phím sẽ không bị thay đổi hướng hiển thị.

Giá trị mặc định là 0 .

Nhận biết định hướng được sử dụng để hỗ trợ xoay các phím trên bàn phím định hướng, chẳng hạn như trên Motorola Droid. Ví dụ: khi thiết bị được xoay theo chiều kim đồng hồ 90 độ so với hướng tự nhiên của nó, KEYCODE_DPAD_UP được ánh xạ lại để tạo ra KEYCODE_DPAD_RIGHT vì phím 'lên' cuối cùng sẽ trỏ 'phải' khi thiết bị được giữ theo hướng đó.

bàn phím.buildIn

Định nghĩa: keyboard.builtIn = 0 | 1

Chỉ định xem bàn phím có phải là bàn phím tích hợp (được gắn vật lý) hay không.

Giá trị mặc định là 1 nếu tên thiết bị kết thúc bằng -keypad , nếu không thì là 0 .

Bàn phím tích hợp luôn được gán id thiết bị là 0 . Các bàn phím khác không được tích hợp sẵn sẽ được gán các id thiết bị khác 0 duy nhất.

Việc sử dụng id bằng 0 cho bàn phím tích hợp là rất quan trọng để duy trì khả năng tương thích với trường KeyCharacterMap.BUILT_IN_KEYBOARD , trường này chỉ định id của bàn phím tích hợp và có giá trị là 0 . Trường này không được dùng nữa trong API nhưng các ứng dụng cũ hơn vẫn có thể sử dụng nó.

Bàn phím chức năng đặc biệt (bàn phím có bản đồ ký tự phím chỉ định loại SPECIAL_FUNCTION ) sẽ không bao giờ được đăng ký làm bàn phím tích hợp, bất kể cài đặt của thuộc tính này. Điều này là do bàn phím chức năng đặc biệt theo định nghĩa không được sử dụng cho mục đích gõ phím thông thường.

Cấu hình ví dụ

# This is an example input device configuration file for a built-in
# keyboard that has a DPad.

# The keyboard is internal because it is part of the device.
device.internal = 1

# The keyboard is the default built-in keyboard so it should be assigned
# an id of 0.
keyboard.builtIn = 1

# The keyboard includes a DPad which is mounted on the device.  As the device
# is rotated the orientation of the DPad rotates along with it, so the DPad must
# be aware of the display orientation.  This ensures that pressing 'up' on the
# DPad always means 'up' from the perspective of the user, even when the entire
# device has been rotated.
keyboard.orientationAware = 1

Ghi chú tương thích

Trước Honeycomb, trình ánh xạ đầu vào bàn phím không sử dụng bất kỳ thuộc tính cấu hình nào. Tất cả các bàn phím đều được cho là được gắn vật lý và nhận biết được hướng. Bố cục khóa và bản đồ ký tự khóa mặc định được đặt tên là qwerty thay vì Generic . Định dạng bản đồ ký tự chính cũng rất khác và khung không hỗ trợ bàn phím đầy đủ kiểu PC hoặc bàn phím ngoài.

Khi nâng cấp thiết bị lên Honeycomb, hãy đảm bảo tạo hoặc cập nhật các tệp cấu hình và sơ đồ khóa cần thiết.

Cách sử dụng HID, mã khóa Linux và mã khóa Android

Hệ thống đề cập đến các khóa bằng cách sử dụng một số mã định danh khác nhau, tùy thuộc vào lớp trừu tượng.

Đối với thiết bị HID, mỗi khóa có cách sử dụng HID liên quan. Trình điều khiển hid-input của Linux cũng như trình điều khiển HID dành riêng cho thiết bị và nhà cung cấp có liên quan chịu trách nhiệm phân tích cú pháp các báo cáo HID và ánh xạ cách sử dụng HID tới mã khóa Linux.

Khi Android đọc các sự kiện EV_KEY từ nhân Linux, nó sẽ dịch từng mã khóa Linux thành mã khóa Android tương ứng theo tệp bố cục khóa của thiết bị.

Khi sự kiện quan trọng được gửi đến một ứng dụng, phiên bản android.view.KeyEvent sẽ báo cáo mã khóa Linux là giá trị của getScanCode() và mã khóa Android là giá trị của getKeyCode() . Đối với mục đích của khung, chỉ có giá trị của getKeyCode() là quan trọng.

Lưu ý rằng thông tin sử dụng HID không được chính Android sử dụng hoặc chuyển cho các ứng dụng.

Bảng mã

Các bảng sau đây cho thấy cách sử dụng HID, mã khóa Linux và mã khóa Android có liên quan với nhau như thế nào.

Cột LKC chỉ định mã khóa Linux ở dạng thập lục phân.

Cột AKC chỉ định mã khóa Android ở dạng thập lục phân.

Cột Ghi chú đề cập đến các ghi chú được đăng sau bảng.

Cột Phiên bản chỉ định phiên bản đầu tiên của nền tảng Android đã đưa khóa này vào sơ đồ khóa mặc định của nó. Nhiều hàng được hiển thị trong trường hợp sơ đồ phím mặc định đã thay đổi giữa các phiên bản. Phiên bản cũ nhất được chỉ định là 1.6.

• Trong Gingerbread (2.3) và các bản phát hành trước đó, sơ đồ khóa mặc định là qwerty.kl . Sơ đồ phím này chỉ nhằm mục đích sử dụng với Trình mô phỏng Android và không nhằm mục đích sử dụng để hỗ trợ bàn phím bên ngoài tùy ý. Tuy nhiên, một số OEM đã thêm hỗ trợ bàn phím Bluetooth vào nền tảng và dựa vào qwerty.kl để cung cấp các ánh xạ bàn phím cần thiết. Do đó, những ánh xạ cũ hơn này có thể được các OEM đang xây dựng thiết bị ngoại vi cho các thiết bị cụ thể này quan tâm. Lưu ý rằng các ánh xạ khác biệt đáng kể so với các ánh xạ hiện tại, đặc biệt là về cách xử lý phím HOME . Chúng tôi khuyến nghị rằng tất cả các thiết bị ngoại vi mới nên được phát triển theo Honeycomb hoặc các bản đồ chính mới hơn (tức là HID tiêu chuẩn).

• Kể từ Honeycomb (3.0), sơ đồ khóa mặc định là Generic.kl . Sơ đồ phím này được thiết kế để hỗ trợ bàn phím kiểu PC đầy đủ. Hầu hết các chức năng của bàn phím HID tiêu chuẩn đều hoạt động tốt.

Ánh xạ mã khóa có thể khác nhau giữa các phiên bản nhân Linux và Android. Khi các thay đổi được biết là đã xảy ra trong sơ đồ khóa mặc định của Android, chúng sẽ được biểu thị trong cột phiên bản.

Trình điều khiển HID và sơ đồ chính dành riêng cho thiết bị có thể áp dụng các ánh xạ khác với những ánh xạ được chỉ ra ở đây.

Trang bàn phím và bàn phím HID (0x07)

Trang máy tính để bàn chung HID (0x01)

Trang tiêu dùng HID (0x0c)

Ánh xạ không ẩn khác

Các ánh xạ này mô tả các chức năng không xuất hiện trong HID mà là mã khóa Linux tồn tại.

Các chìa khóa không được hỗ trợ

Các ánh xạ này xuất hiện trong các phiên bản trước của Android nhưng không phù hợp với các mã khóa Linux không chuẩn hoặc được sử dụng. Họ không còn được hỗ trợ.

Ghi chú

1. Mã khóa Android được liên kết với các khóa chữ và số phổ biến và biểu tượng có thể thay đổi dựa trên bố cục và ngôn ngữ bàn phím. Vì lý do lịch sử, các mã quét vật lý và ẩn sử dụng liên quan đến các phím trên bàn phím thường được xác định vị trí mặc dù các nhãn được in trên các khóa đó có thể thay đổi từ ngôn ngữ này sang ngôn ngữ khác.

   Trên bàn phím tiếng Anh (QWERTY) của Hoa Kỳ, phím chữ cái trên cùng bên trái được dán nhãn Q. Trên bàn phím Pháp (Azerty) được đề cập đến bằng cách sử dụng sử dụng HID 0x07 0x0014 được ánh xạ tới Key Code Key_Q.

   Khi Android được cấu hình với bố cục bàn phím tiếng Anh Hoa Kỳ, thì mã khóa Linux key_Q sẽ được ánh xạ tới mã khóa Android keyCode_Q và sẽ tạo các ký tự 'Q' và 'Q'. Tuy nhiên, khi Android được cấu hình với bố cục bàn phím Pháp, thì mã khóa Linux Key_Q sẽ được ánh xạ tới mã khóa Android KeyCode_A và sẽ tạo ra các ký tự 'A' và 'A'.

   Mã khóa Android thường phản ánh cách giải thích cụ thể về ngôn ngữ của khóa, do đó, một mã khóa Android khác nhau có thể được sử dụng cho các ngôn ngữ khác nhau.

2. 0x0c 0x022f AC Zoom được xác định trong HID là điều khiển tuyến tính nhưng hạt nhân ánh xạ nó là phím, có lẽ không chính xác.

3. Các phím chức năng Linux KEY_FN_* được ánh xạ tới các mã khóa đơn giản hơn nhưng được gửi với bit trạng thái meta META_FUNCTION được đặt thành true.

4. Trước Android Ice Cream Sandwich 4.0, bố cục khóa mặc định chứa ánh xạ cho một số mã khóa bổ sung không được xác định trong các tiêu đề nhân Linux chính. Các ánh xạ này đã bị xóa vì các mã khóa chưa được xác định trước đó đã được chỉ định các ý nghĩa khác nhau trong các phiên bản gần đây của nhân Linux.

Nguồn

1. Bảng sử dụng USB HID v1.12
2. Linux 2.6.39 Kernel: Bao gồm/linux/input.h, trình điều khiển/hid/hid input.c
3. Android ICS: qwerty.kl, generic.kl, keyevent.java