Thiết bị bàn phím

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Android hỗ trợ nhiều loại thiết bị bàn phím, bao gồm cả 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 tích hợp nhỏ gọn và bàn phím ngoài kiểu máy tính đầy đủ tính năng.

Tài liệu này chỉ mô tả bàn phím thực. 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

Một thiết bị đầu vào được phân loại là bàn phím nếu đáp ứng 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ã phím Linux nào được sử dụng trên bàn phím, bao gồm cả 0 thông qua 0xff hoặc KEY_OK thông qua KEY_MAX.

• Thiết bị đầu vào báo cáo sự hiện diện của bất kỳ mã phím Linux nào được sử dụng trên cần điều khiển và tay điều khiển trò chơi, 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 điều khiển trò chơi được báo cáo bằng 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 đó, tay điều khiển và tay điều khiển trò chơi cũng sử dụng các tệp ánh xạ phím để định cấu hình.

Sau khi một 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 điểm khác của thiết bị.

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

• Nếu thiết bị đầu vào có bất kỳ phím nào được liên kết vớ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 tài nguyên Configuration là NAVIGATION_DPAD.

• Nếu thiết bị đầu vào có bất kỳ phím nào được liên kết với KEYCODE_BUTTON_A hoặc các phím khác liên quan đến tay điều khiển trò chơi, thì thiết bị đó được coi là có tay điều khiển trò chơi.

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

1. Trình điều khiển bàn phím chỉ được đăng ký mã phím cho các phím mà chúng thực sự hỗ trợ. Việc đăng ký mã phím 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 các chức 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 phải sử dụng EV_KEY để báo cáo các thao tác nhấn phím, sử dụng giá trị 0 để cho biết một phím đã được nhả, giá trị 1 để cho biết một phím đã được nhấn và giá trị lớn hơn hoặc bằng 2 để cho biết phím đang được lặp lại tự động.

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

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

5. Trình điều khiển bàn phím phải hỗ trợ việc đặ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 sẽ 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. Bạn chỉ cần hỗ trợ các đèn LED này khi bàn phím thực sự có đèn chỉ báo được liên kết.

6. Trình điều khiển bàn phím cho bàn phím tích hợp (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ị là 0 cho mọi phím vẫn được nhấn khi thiết bị chuyển sang trạng thái 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 trên bàn phím

Sau đây là thông tin tóm tắt ngắn gọn về thao tác trên 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à liên kết mã phím Linux (đôi khi được gọi là mã quét) vào mã phím 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 phím meta. Ví dụ: nếu bạn nhấn hoặc nhả phím shift trái, thì trình đọc sẽ đặt hoặc đặt lại các bit META_SHIFT_LEFT_ON và META_SHIFT_ON cho phù hợp.

3. InputReader thông báo cho InputDispatcher về sự kiện chính.

4. InputDispatcher hỏi WindowManagerPolicy cần làm gì với sự kiện phím bằng cách gọi WindowManagerPolicy.interceptKeyBeforeQueueing. Phương thức 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ữ khoá chế độ 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 khoá sẽ chạy đến khi hoàn tất.

5. Nếu InputFilter đang được sử dụng, InputDispatcher sẽ cho phép sử dụng hoặc biến đổi khoá. Bạn có thể dùng InputFilter để triển khai các chính sách hỗ trợ tiếp cận cấp thấp trên toàn hệ thống.

6. InputDispatcher đưa khoá vào hàng đợi để xử lý trên luồng điều phối.

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

8. Sau đó, InputDispatcher xác định mục tiêu sự kiện chính (cửa sổ được lấy tiêu điểm) và chờ các mục tiêu đó sẵn sàng. Sau đó, InputDispatcher sẽ phân phối sự kiện phím đến ứng dụng.

9. Bên trong ứng dụng, sự kiện phím sẽ truyền xuống hệ phân cấp khung hiển thị đến khung hiển thị được lấy tiêu điểm để gửi phím trước IME.

10. Nếu sự kiện nhấn phím không được xử lý trong quá trình gửi trước IME và IME đang được sử dụng, thì sự kiện nhấn phím sẽ được gửi đến IME.

11. Nếu IME không sử dụng sự kiện phím, thì sự kiện phím sẽ truyền xuống hệ phân cấp khung hiển thị đến khung hiển thị được lấy tiêu điểm để gửi phím tiêu chuẩn.

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

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

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

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

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

Thuộc tính

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

keyboard.layout

Định nghĩa: keyboard.layout = <tên>

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

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

Hãy tham khảo tài liệu về tệp bố cục khoá để biết thêm thông tin chi tiết.

keyboard.characterMap

Định nghĩa: keyboard.characterMap = <tên>

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

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

Hãy tham khảo tài liệu về tệp bản đồ ký tự chính để biết thêm thông tin chi tiết.

keyboard.orientationAware

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

Chỉ định xem bàn phím có phản ứng với các 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ẽ xoay khi hướng màn hình liên kết thay đổi.

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

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

Tính năng nhận biết hướng được 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, KEYCODE_DPAD_UP sẽ được ánh xạ lại để tạo ra KEYCODE_DPAD_RIGHT vì phím "lên" sẽ chỉ về "phải" khi thiết bị được giữ theo hướng đó.

keyboard.builtIn

Đị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ào thiết bị) 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 mã thiết bị là 0. Các bàn phím khác không tích hợp sẽ được chỉ định mã thiết bị duy nhất khác 0.

Việc sử dụng mã nhận dạ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 mã nhận dạng của bàn phím tích hợp và có giá trị là 0. Trường này không còn được dùng trong API nhưng các ứng dụng cũ có thể vẫn đang sử dụng trường này.

Bàn phím có 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ể chế độ cài đặt của thuộc tính này. Lý do là theo định nghĩa, bàn phím chức năng đặc biệt không được dùng để nhập văn bản cho mục đích chung.

Cấu hình mẫu

# 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ú về khả năng 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ả bàn phím đều được giả định là được gắn vào thiết bị và nhận biết được hướng. Bố cục phím và bản đồ ký tự phím mặc định được đặt tên là qwerty thay vì Generic. Định dạng bản đồ ký tự phím cũng rất khác và khung này không hỗ trợ bàn phím đầy đủ kiểu máy tính hoặc bàn phím bên ngoài.

Khi nâng cấp thiết bị lên Honeycomb, hãy nhớ tạo hoặc cập nhật cấu hình và tệp ánh xạ khoá cần thiết.

Cách sử dụng HID, mã phím Linux và mã phím Android

Hệ thống tham chiếu đến các khoá bằng một số giá trị nhận dạng khác nhau, tuỳ thuộc vào lớp trừu tượng.

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

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

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

Xin lưu ý rằng Android không sử dụng thông tin sử dụng HID hoặc chuyển thông tin này đến các ứng dụng.

Bảng mã

Các bảng sau đây cho thấy mối liên hệ giữa cách sử dụng HID, mã phím Linux và mã phím Android.

Cột LKC chỉ định mã phím Linux theo hệ thập lục phân.

Cột AKC chỉ định mã khoá Android theo hệ 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 khoá này vào bản đồ khoá mặc định. Nhiều hàng sẽ xuất hiện trong trường hợp sơ đồ bàn 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 đó, bản đồ phím mặc định là qwerty.kl. Bản đồ phím này chỉ dùng cho Trình mô phỏng Android và không dùng để hỗ trợ bàn phím bên ngoài tuỳ ý. Tuy nhiên, một số OEM đã thêm tính năng 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 đó, các ánh xạ cũ này có thể được các nhà sản xuất thiết bị gốc (OEM) quan tâm khi họ xây dựng các thiết bị ngoại vi cho những thiết bị cụ thể này. Xin lưu ý rằng các mối liên kết này khác đáng kể so với các mối liên kết hiện tại, đặc biệt là liên quan đến việc xử lý khoá HOME. Bạn nên phát triển tất cả thiết bị ngoại vi mới theo Honeycomb hoặc các bản đồ phím gần đây hơn (tức là HID tiêu chuẩn).

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

Việc ánh xạ mã phím có thể khác nhau giữa các phiên bản hạt nhân Linux và Android. Khi có thay đổi xảy ra trong bản đồ phím mặc định của Android, các thay đổi đó sẽ được chỉ báo trong cột phiên bản.

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

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

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

Trang người dùng HID (0x0c)

Các mối liên kết không phải HID bổ sung

Các ánh xạ này mô tả các hàm không xuất hiện trong HID nhưng có mã phím Linux.

Các khoá cũ không được hỗ trợ

Các mối liên kết này xuất hiện trong các phiên bản Android trước nhưng không nhất quán với HID hoặc sử dụng mã phím Linux không chuẩn. Các tính năng này không còn được hỗ trợ nữa.

Ghi chú

1. Mã phím Android liên kết với các phím chữ và số phổ biến cũng như các phím biểu tượng có thể khác nhau tuỳ theo bố cục và ngôn ngữ của bàn phím. Vì lý do lịch sử, mã quét thực và cách sử dụng HID liên kết với các phím trên bàn phím thường được xác định theo vị trí mặc dù nhãn in trên các phím đó có thể khác nhau giữa các ngôn ngữ.

   Trên bàn phím tiếng Anh (Mỹ) (QWERTY), phím chữ cái ở trên cùng bên trái được gắn nhãn Q. Trên bàn phím tiếng Pháp (AZERTY), phím ở cùng vị trí được gắn nhãn A. Mặc dù có nhãn, nhưng trên cả hai bàn phím, phím chữ cái ở trên cùng bên trái được tham chiếu bằng cách sử dụng cách sử dụng HID 0x07 0x0014 được liên kết với mã phím Linux KEY_Q.

   Khi Android được định cấu hình bằng bố cục bàn phím tiếng Anh (Mỹ), thì mã phím Linux KEY_Q sẽ được liên kết với mã phím Android KEYCODE_Q và sẽ tạo ra các ký tự "Q" và "q". Tuy nhiên, khi Android được định cấu hình với bố cục bàn phím tiếng Pháp, thì mã phím Linux KEY_Q sẽ được liên kết với mã phím Android KEYCODE_A và sẽ tạo ra các ký tự "A" và "a".

   Mã khoá Android thường phản ánh cách diễn giải khoá theo từng ngôn ngữ, vì vậy, bạn có thể sử dụng một mã khoá Android khác nhau cho các ngôn ngữ khác nhau.

2. 0x0c 0x022f AC Zoom được xác định trong HID là một chức năng điều khiển tuyến tính nhưng hạt nhân ánh xạ nó dưới dạng một khoá, điều này có thể không chính xác.

3. Các phím chức năng Linux KEY_FN_* được liên kết với các mã phím đơn giản hơn nhưng được gửi bằng 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 phím mặc định chứa các mối liên kết cho một số mã phím bổ sung không được xác định trong tiêu đề nhân Linux chính. Các mối liên kết này đã bị xoá vì các mã phím chưa xác định trước đó đã được gán các ý nghĩa khác nhau trong các phiên bản mới hơn của nhân Linux.

Nguồn

1. Bảng sử dụng USB HID phiên bản 1.12
2. Hạt nhân Linux 2.6.39: include/linux/input.h, drivers/hid/hid-input.c
3. Android ICS: qwerty.kl, Generic.kl, KeyEvent.java