কী লেআউট ফাইল

কী লেআউট ফাইল ( .kl ফাইল) লিনাক্স কী কোড এবং অক্ষ কোডগুলিকে অ্যান্ড্রয়েড কী কোড এবং অক্ষ কোডগুলিতে ম্যাপ করে এবং সংশ্লিষ্ট নীতি পতাকা নির্দিষ্ট করে। ডিভাইস-নির্দিষ্ট কী লেআউট ফাইলগুলি হল:

  • ভলিউম, পাওয়ার এবং হেডসেট মিডিয়া কীগুলির মতো বিশেষ কীগুলি সহ কী সহ অভ্যন্তরীণ (বিল্ট-ইন) ইনপুট ডিভাইসগুলির জন্য প্রয়োজনীয় ৷
  • অন্যান্য ইনপুট ডিভাইসের জন্য ঐচ্ছিক কিন্তু বিশেষ-উদ্দেশ্য কীবোর্ড এবং জয়স্টিকগুলির জন্য সুপারিশ করা হয় ।

কোনো ডিভাইস-নির্দিষ্ট কী বিন্যাস ফাইল উপলব্ধ না হলে, সিস্টেম পরিবর্তে একটি ডিফল্ট নির্বাচন করে।

অবস্থান

মূল বিন্যাস ফাইলগুলি USB বিক্রেতা, পণ্য (এবং ঐচ্ছিকভাবে সংস্করণ) আইডি বা ইনপুট ডিভাইসের নাম দ্বারা অবস্থিত। নিম্নলিখিত পথ ক্রমানুসারে পরামর্শ করা হয়:

  • /odm/usr/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /vendor/usr/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /system/usr/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /data/system/devices/keylayout/Vendor_XXXX_Product_XXXX_Version_XXXX.kl
  • /odm/usr/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /vendor/usr/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /system/usr/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /data/system/devices/keylayout/Vendor_XXXX_Product_XXXX.kl
  • /odm/usr/keylayout/DEVICE_NAME.kl
  • /vendor/usr/keylayout/DEVICE_NAME.kl
  • /system/usr/keylayout/DEVICE_NAME.kl
  • /data/system/devices/keylayout/DEVICE_NAME.kl
  • /odm/usr/keylayout/Generic.kl
  • /vendor/usr/keylayout/Generic.kl
  • /system/usr/keylayout/Generic.kl
  • /data/system/devices/keylayout/Generic.kl

ডিভাইসের নাম ধারণ করে এমন একটি ফাইল পাথ তৈরি করার সময়, '0'-'9', 'a'-'z', 'A'-'Z', '-' বা '_' ছাড়া ডিভাইসের নামের সমস্ত অক্ষর '_' দ্বারা প্রতিস্থাপিত হয়।

জেনেরিক কী লেআউট ফাইল

সিস্টেমটি Generic.kl নামে একটি বিশেষ বিল্ট-ইন জেনেরিক কী লেআউট ফাইল সরবরাহ করে। এই কী লেআউটটি বিভিন্ন স্ট্যান্ডার্ড এক্সটার্নাল কীবোর্ড এবং জয়স্টিক সমর্থন করার উদ্দেশ্যে তৈরি করা হয়েছে। জেনেরিক কী লেআউট পরিবর্তন করবেন না!

বাক্য গঠন

একটি কী লেআউট ফাইল হল একটি প্লেইন টেক্সট ফাইল যাতে কী বা অক্ষের ঘোষণা এবং পতাকা থাকে।

মূল ঘোষণা

মূল ঘোষণায় কীওয়ার্ড key এর পরে একটি লিনাক্স কী কোড নম্বর এবং অ্যান্ড্রয়েড কী কোড নাম, অথবা কীওয়ার্ড ব্যবহার এবং একটি HID ব্যবহার এবং অ্যান্ড্রয়েড কী কোড নাম অনুসরণ করে। HID ব্যবহার একটি 32-বিট পূর্ণসংখ্যা হিসাবে উপস্থাপন করা হয়, যেখানে উচ্চ 16-বিট HID ব্যবহার পৃষ্ঠাকে প্রতিনিধিত্ব করে এবং কম 16-বিটগুলি HID ব্যবহার ID উপস্থাপন করে। যে কোনো ঘোষণার পরে সাদা স্থান-সীমাবদ্ধ নীতি পতাকার একটি ঐচ্ছিক সেট অনুসরণ করা যেতে পারে।

key 1     ESCAPE
key 114   VOLUME_DOWN
key 16    Q                 VIRTUAL
key usage 0x0c006F          BRIGHTNESS_UP

নিম্নলিখিত নীতি পতাকা স্বীকৃত:

  • FUNCTION : কীটি এমনভাবে ব্যাখ্যা করা উচিত যেন ফাংশন কীটিও চাপানো হয়।
  • GESTURE : ব্যবহারকারীর অঙ্গভঙ্গি দ্বারা উত্পন্ন কী, যেমন টাচস্ক্রিন পামিং করা।
  • VIRTUAL : কী হল একটি ভার্চুয়াল সফ্ট কী (ক্যাপাসিটিভ বোতাম) যা প্রধান টাচ স্ক্রিনের সংলগ্ন। এর ফলে বিশেষ ডিবাউন্সিং লজিক সক্রিয় হতে পারে (নীচে দেখুন)।

অক্ষ ঘোষণা

অক্ষ axis প্রতিটিতে একটি লিনাক্স অক্ষ কোড নম্বর এবং কোয়ালিফায়ার যা অন্তত একটি অ্যান্ড্রয়েড অক্ষ কোড নাম সহ অক্ষের আচরণ নিয়ন্ত্রণ করে কীওয়ার্ড অক্ষ নিয়ে গঠিত।

মৌলিক অক্ষ

একটি মৌলিক অক্ষ সহজভাবে একটি লিনাক্স অক্ষ কোডকে একটি অ্যান্ড্রয়েড অক্ষ কোড নামের সাথে ম্যাপ করে। নিম্নলিখিত ঘোষণা মানচিত্র ABS_X ( 0x00 দ্বারা নির্দেশিত) থেকে AXIS_X ( X দ্বারা নির্দেশিত)।

axis 0x00 X

উপরের উদাহরণে, ABS_X এর মান 5 হলে AXIS_X 5 এ সেট করা হয়েছে।

বিভক্ত অক্ষ

একটি বিভক্ত অক্ষ একটি লিনাক্স অক্ষ কোডকে দুটি অ্যান্ড্রয়েড অক্ষ কোড নামের সাথে ম্যাপ করে, যেমন একটি থ্রেশহোল্ডের চেয়ে কম বা বেশি মানগুলি ম্যাপ করার সময় দুটি ভিন্ন অক্ষে বিভক্ত হয়। এই ম্যাপিংটি কার্যকর হয় যখন ডিভাইস দ্বারা রিপোর্ট করা একটি একক শারীরিক অক্ষ দুটি ভিন্ন পারস্পরিক একচেটিয়া লজিক্যাল অক্ষকে এনকোড করে।

নিম্নলিখিত ঘোষণা ABS_Y অক্ষের মান মানচিত্র ( 0x01 দ্বারা নির্দেশিত) যখন 0x7f এর কম হয় তখন AXIS_GAS বা 0x7f এর বেশি হলে AXIS_BRAKE ।

axis 0x01 split 0x7f GAS BRAKE

উপরের উদাহরণে, যদি ABS_Y এর মান 0x7d হয় তাহলে AXIS_GAS 2 ( 0x7f - 0x7d ) এবং AXIS_BRAKE 0 এ সেট করা হয়েছে। বিপরীতভাবে, যদি ABS_Y এর মান 0x83 হয় তাহলে AXIS_GAS 0 এ সেট করা হয়েছে এবং AXIS_BRAKE 4 ( 0x83 - 0x7f ) এ সেট করা হয়েছে। অবশেষে, যদি ABS_Y এর মান 0x7f এর বিভক্ত মানের সমান হয় তবে AXIS_GAS এবং AXIS_BRAKE উভয়ই 0 এ সেট করা হয়েছে।

উল্টানো অক্ষ

একটি উল্টানো অক্ষ অক্ষের মানের চিহ্নকে উল্টে দেয়। নিম্নলিখিত ঘোষণাটি ABS_RZ ( 0x05 দ্বারা নির্দেশিত) AXIS_BRAKE ( BRAKE দ্বারা নির্দেশিত) এর মানচিত্র তৈরি করে এবং এটিকে অস্বীকার করে আউটপুটকে উল্টে দেয়।

axis 0x05 invert BRAKE

উপরের উদাহরণে, যদি ABS_RZ এর মান 2 হয় তাহলে AXIS_BRAKE -2 সেট করা হয়েছে।

কেন্দ্র সমতল বিকল্প

একটি জয়স্টিক ডিভাইস আওয়াজের কারণে জয়স্টিক ব্যবহার না করা সত্ত্বেও ইনপুট ইভেন্টের রিপোর্ট করতে পারে। এই শব্দটি সাধারণত বাম এবং/অথবা ডান স্টিক থেকে আসে এবং ড্রাইভারকে 0 এর কাছাকাছি অবস্থানের মান রিপোর্ট করতে দেয়। "সেন্টার ফ্ল্যাট" মানটি বিশ্রামে কন্ট্রোলার থেকে আশা করা শব্দের পরিমাণ নির্দিষ্ট করে।

লিনাক্স ইনপুট প্রোটোকল ইনপুট ডিভাইস ড্রাইভারদের জন্য জয়স্টিক অক্ষের কেন্দ্রের সমতল মান নির্দিষ্ট করার একটি উপায় প্রদান করে, কিন্তু সমস্ত ড্রাইভার এটি রিপোর্ট করে না এবং তাদের মধ্যে কিছু ভুল মান প্রদান করে। এই সমস্যাটি সমাধান করার জন্য, একটি অক্ষ ঘোষণা একটি flat বিকল্প দ্বারা অনুসরণ করা যেতে পারে যা অক্ষের কেন্দ্র অবস্থানের চারপাশের অঞ্চলের প্রস্থকে নির্দিষ্ট করে যা কেন্দ্রীভূত হিসাবে বিবেচনা করা উচিত।

উদাহরণস্বরূপ, যদি কোনো ডিভাইস ড্রাইভার AXIS_X এর জন্য 0 এবং 100-এর মধ্যে মান রিপোর্ট করে, তাহলে 0-কে -1-এ ম্যাপ করা হবে এবং Android ইনপুট সিস্টেম দ্বারা 100-কে ম্যাপ করা হবে। পরিসরের কেন্দ্রটি আনস্কেল করা স্থানাঙ্কে 50 এবং স্কেল করা স্থানাঙ্কে 0 হবে। যদি একটি সমতল মান 10 এর সমান হয়, তাহলে ডেভেলপারদের অনুমান করা উচিত যে -0.1 এবং 0.1 এর মধ্যে রিপোর্ট করা যেকোন AXIS_X মান (আনস্কেল করা স্থানাঙ্কে 40 এবং 60 এর মধ্যে) নয়েজ, এবং জয়স্টিক থেকে আসা সেই মানগুলিকে শূন্য হিসাবে বিবেচনা করা উচিত।

দ্রষ্টব্য : যখন কী লেআউট ফাইলটি ড্রাইভার স্থানাঙ্ক স্থানের মান নির্দিষ্ট করে, android.view.InputDevice.MotionRange#getFlat() দ্বারা রিপোর্ট করা মানটি Android স্থানাঙ্ক স্থানের মধ্যে রয়েছে৷

axis 0x03 Z flat 4096

উপরের উদাহরণে, কেন্দ্র সমতল মান 4096 সেট করা হয়েছে।

মন্তব্য

মন্তব্য লাইনগুলি # দিয়ে শুরু হয় এবং লাইনের শেষ পর্যন্ত চলতে থাকে:

# A comment!

ফাঁকা লাইন উপেক্ষা করা হয়.

উদাহরণ

কীবোর্ড

# This is an example of a key layout file for a keyboard.

key 1     ESCAPE
key 2     1
key 3     2
key 4     3
key 5     4
key 6     5
key 7     6
key 8     7
key 9     8
key 10    9
key 11    0
key 12    MINUS
key 13    EQUALS
key 14    DEL

# etc...

সিস্টেম নিয়ন্ত্রণ

# This is an example of a key layout file for basic system controls,
# such as volume and power keys which are typically implemented as GPIO pins
# the device decodes into key presses.

key 114   VOLUME_DOWN
key 115   VOLUME_UP
key 116   POWER

ক্যাপাসিটিভ বোতাম

# This is an example of a key layout file for a touch device with capacitive buttons.

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

হেডসেট জ্যাক মিডিয়া নিয়ন্ত্রণ

# This is an example of a key layout file for headset mounted media controls.
# A typical headset jack interface might have special control wires or detect known
# resistive loads as corresponding to media functions or volume controls.
# This file assumes that the driver decodes these signals and reports media
# controls as key presses.

key 163   MEDIA_NEXT
key 165   MEDIA_PREVIOUS
key 226   HEADSETHOOK

জয়স্টিক

# This is an example of a key layout file for a joystick.

# These are the buttons that the joystick supports, represented as keys.
key 304   BUTTON_A
key 305   BUTTON_B
key 307   BUTTON_X
key 308   BUTTON_Y
key 310   BUTTON_L1
key 311   BUTTON_R1
key 314   BUTTON_SELECT
key 315   BUTTON_START
key 316   BUTTON_MODE
key 317   BUTTON_THUMBL
key 318   BUTTON_THUMBR

# Left and right stick.
# The reported value for flat is 128 in a range of -32767 to 32768, which is absurd.
# This confuses applications that rely on the flat value because the joystick
# actually settles in a flat range of +/- 4096 or so. We override it here.
axis 0x00 X flat 4096
axis 0x01 Y flat 4096
axis 0x03 Z flat 4096
axis 0x04 RZ flat 4096

# Triggers.
axis 0x02 LTRIGGER
axis 0x05 RTRIGGER

# Hat.
axis 0x10 HAT_X
axis 0x11 HAT_Y

ভার্চুয়াল সফট কী

ইনপুট সিস্টেম নিম্নলিখিত ব্যবহারের ক্ষেত্রে ভার্চুয়াল সফ্ট কীগুলি বাস্তবায়নের জন্য বিশেষ বৈশিষ্ট্য সরবরাহ করে:

  1. যদি ভার্চুয়াল সফ্ট কীগুলি স্ক্রিনে গ্রাফিকভাবে প্রদর্শিত হয় (যেমন গ্যালাক্সি নেক্সাসে), সেগুলি সিস্টেম UI প্যাকেজে নেভিগেশন বার উপাদান দ্বারা প্রয়োগ করা হয়। যেহেতু গ্রাফিকাল ভার্চুয়াল সফট কীগুলি সিস্টেমের একটি উচ্চ স্তরে প্রয়োগ করা হয়, কী লেআউট ফাইলগুলি জড়িত নয় এবং নিম্নলিখিত তথ্যগুলি প্রযোজ্য নয়।
  2. যদি ভার্চুয়াল সফ্ট কীগুলি একটি বর্ধিত স্পর্শযোগ্য অঞ্চল হিসাবে প্রয়োগ করা হয় যা প্রধান টাচ স্ক্রিনের অংশ (যেমন নেক্সাস ওয়ানে), ইনপুট সিস্টেমটি লিনাক্স কী কোডগুলিতে X/Y টাচ স্থানাঙ্ক অনুবাদ করতে একটি ভার্চুয়াল কী ম্যাপ ফাইল ব্যবহার করে, তারপর লিনাক্স কী কোডগুলিকে অ্যান্ড্রয়েড কী কোডগুলিতে অনুবাদ করতে কী লেআউট ফাইল ব্যবহার করে (ভার্চুয়াল কী ম্যাপ ফাইলগুলির বিশদ বিবরণের জন্য, টাচ ডিভাইস দেখুন)। টাচ স্ক্রীন ইনপুট ডিভাইসের জন্য কী লেআউট ফাইলটি অবশ্যই উপযুক্ত কী ম্যাপিং নির্দিষ্ট করতে হবে এবং প্রতিটি কীর জন্য VIRTUAL পতাকা অন্তর্ভুক্ত করতে হবে।
  3. যদি ভার্চুয়াল সফ্ট কীগুলি প্রধান টাচ স্ক্রীন থেকে পৃথক ক্যাপাসিটিভ বোতাম হিসাবে প্রয়োগ করা হয় (যেমন নেক্সাস এস), কার্নেল ডিভাইস ড্রাইভার বা ফার্মওয়্যার লিনাক্স কী কোডগুলিতে স্পর্শ অনুবাদ করার জন্য দায়ী যা ইনপুট সিস্টেম তারপরে অ্যান্ড্রয়েড কী কোডগুলিতে অনুবাদ করে। কী লেআউট ফাইল ব্যবহার করে। ক্যাপাসিটিভ বোতাম ইনপুট ডিভাইসের জন্য কী লেআউট ফাইলটি অবশ্যই উপযুক্ত কী ম্যাপিং নির্দিষ্ট করতে হবে এবং প্রতিটি কীর জন্য VIRTUAL পতাকা অন্তর্ভুক্ত করতে হবে।

যখন ভার্চুয়াল সফ্ট কীগুলি টাচ স্ক্রিনের মধ্যে বা কাছাকাছি শারীরিক সান্নিধ্যে অবস্থিত থাকে, তখন ব্যবহারকারীদের জন্য স্ক্রিনের নীচের দিকে স্পর্শ করার সময় বা আঙুল উপরে-থেকে-নিচ বা নীচে-থেকে- স্লাইড করার সময় ভুলবশত একটি বোতাম টিপতে পারে। পর্দার উপরে। এটি প্রতিরোধ করার জন্য, ইনপুট সিস্টেমটি কিছুটা ডিবাউন্সিং প্রয়োগ করে যাতে টাচ স্ক্রিনে সাম্প্রতিকতম স্পর্শের পরে ভার্চুয়াল সফ্ট কী প্রেসগুলি অল্প সময়ের জন্য উপেক্ষা করা হয় (এই বিলম্বকে ভার্চুয়াল কী শান্ত সময় বলা হয়)।

ভার্চুয়াল সফট কী ডিবাউন্সিং সক্ষম করতে:

  1. প্রতিটি কীর জন্য VIRTUAL পতাকা সেট সহ টাচ স্ক্রীন বা ক্যাপাসিটিভ বোতাম ইনপুট ডিভাইসের জন্য একটি কী লেআউট ফাইল সরবরাহ করুন।
    key 139    MENU           VIRTUAL
key 172    HOME           VIRTUAL
key 158    BACK           VIRTUAL
key 217    SEARCH         VIRTUAL
  2. ফ্রেমওয়ার্ক config.xml রিসোর্সের জন্য একটি রিসোর্স ওভারলেতে ভার্চুয়াল কী শান্ত সময়ের মান সেট করুন।
    <!-- Specifies the amount of time to disable virtual keys after the screen
is touched to filter out accidental virtual key presses due to swiping gestures
or taps near the edge of the display. May be 0 to disable the feature.
It is recommended that this value be no more than 250 ms.
This feature should be disabled for most devices. -->

<integer name="config_virtualKeyQuietTimeMillis">250</integer>

বৈধতা

ভ্যালিডেট কীম্যাপস টুল ব্যবহার করে আপনার কী লেআউট ফাইলগুলো যাচাই করা উচিত।