কী লেআউট ফাইল (.kl ফাইল) Linux কী কোড ও অ্যাক্সিস কোডকে
Android কী কোড ও অ্যাক্সিস কোডে ম্যাপ করে এবং সংশ্লিষ্ট নীতি ফ্ল্যাগ নির্দিষ্ট করে।
ডিভাইস-নির্দিষ্ট কীবোর্ড লেআউট ফাইলগুলি হল:
- ভলিউম, পাওয়ার ও হেডসেট মিডিয়া কী-এর মতো বিশেষ কী সহ ইন্টার্নাল (বিল্ট-ইন) ইনপুট ডিভাইসের জন্য প্রয়োজন।
- অন্যান্য ইনপুট ডিভাইসের জন্য ঐচ্ছিক হলেও বিশেষ-উদ্দেশ্যমূলক কীবোর্ড ও জয়স্টিকের জন্য সাজেস্ট করা হয়।
ডিভাইস-নির্দিষ্ট কোনও কী লেআউট ফাইল উপলভ্য না থাকলে, সিস্টেম ডিফল্ট বেছে নেয়।
লোকেশন
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 কীওয়ার্ডের পরে Linux
কী কোড নম্বর ও Android কী কোড নাম অথবা কীওয়ার্ড ব্যবহারের পরে
HID ব্যবহার ও Android কী কোড নাম থাকে। HID ব্যবহারকে ৩২-বিট
পূর্ণসংখ্যা হিসেবে দেখানো হয়, যেখানে উপরের ১৬-বিট HID ব্যবহার সংক্রান্ত পৃষ্ঠা এবং নিচের ১৬-বিট
HID ব্যবহার সংক্রান্ত আইডি দেখায়। দুটি ঘোষণার মধ্যে যেকোনও একটির পরে ঐচ্ছিক
সাদা স্পেস-দ্বারা আলাদা করা নীতি সংক্রান্ত ফ্ল্যাগ থাকতে পারে।
key 1 ESCAPE key 114 VOLUME_DOWN key 16 Q VIRTUAL key usage 0x0c006F BRIGHTNESS_UP
নিম্নলিখিত নীতি সংক্রান্ত ফ্ল্যাগগুলি শনাক্ত করা হয়:
FUNCTION: কীটিকে এমনভাবে ব্যাখ্যা করতে হবে যেন FUNCTION কী ও প্রেস করা হয়েছে।GESTURE: ইউজার জেসচারের মাধ্যমে তৈরি করা কী, যেমন টাচস্ক্রিনে হাত রাখা।VIRTUAL: 'কী' হল একটি ভার্চুয়াল সফট কী (ক্যাপাসিটিভ বোতাম) যা মূল টাচ স্ক্রিনের পাশে থাকে। এর ফলে বিশেষ ডিবাউন্সিং লজিক চালু হয়ে যায় (নিচে দেখুন)।
অ্যাক্সিস ঘোষণা
অক্ষ ঘোষণাগুলিতে axis কীওয়ার্ডের পরে একটি
Linux অক্ষ কোড নম্বর এবং কোয়ালিফায়ার থাকে যা অন্তত একটি Android অক্ষ কোড নাম সহ অক্ষের আচরণকে
কন্ট্রোল করে।
প্রাথমিক অক্ষ
একটি সাধারণ অ্যাক্সিস, Linux অ্যাক্সিস কোডকে Android অ্যাক্সিস কোড নামের সাথে ম্যাপ করে। ABS_X (0x00 দ্বারা চিহ্নিত)
থেকে AXIS_X (X দ্বারা চিহ্নিত)
পর্যন্ত নিম্নলিখিত ঘোষণা ম্যাপ করা হয়েছে।
axis 0x00 X
উপরের উদাহরণে, ABS_X-এর ভ্যালু 5 হলে
AXIS_X-এর ভ্যালু 5 হিসেবে সেট করা হয়।
অক্ষ স্প্লিট করা
একটি স্প্লিট অ্যাক্সিস, দুটি Android অ্যাক্সিস কোড নামের সাথে একটি Linux অ্যাক্সিস কোড ম্যাপ করে, যাতে ম্যাপ করা হলে, থ্রেশহোল্ডের থেকে কম বা বেশি ভ্যালু দুটি আলাদা আলাদা অ্যাক্সিস জুড়ে স্প্লিট করা হয়। এই ম্যাপিং তখন কাজে লাগে যখন ডিভাইসের মাধ্যমে রিপোর্ট করা একটি ফিজিক্যাল অক্ষ দুটি আলাদা পারস্পরিকভাবে এক্সক্লুসিভ লজিক্যাল অক্ষ এনকোড করে।
নিম্নলিখিত ঘোষণাটি 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 হিসেবে সেট করা হয়।
সেন্টার ফ্ল্যাট বিকল্প
নয়েজের কারণে জয়স্টিক ব্যবহার না করা হলেও জয়স্টিক ডিভাইস ইনপুট ইভেন্ট সম্পর্কে রিপোর্ট করতে পারে। এই নয়েজ সাধারণত বাঁ এবং/অথবা ডানদিকের স্টিক থেকে আসে এবং এর ফলে ড্রাইভারকে ০-এর কাছাকাছি পজিশন ভ্যালু রিপোর্ট করতে হয়। "সেন্টার ফ্ল্যাট" ভ্যালু কন্ট্রোলার বিশ্রামরত অবস্থায় থাকলে তার থেকে কতখানি নয়েজ আশা করা যায় তা নির্দিষ্ট করে।
Linux ইনপুট প্রোটোকল, ইনপুট ডিভাইস ড্রাইভারদের জন্য জয়স্টিক অ্যাক্সিসের সেন্টার ফ্ল্যাট ভ্যালু নির্দিষ্ট করার
একটি উপায় প্রদান করে, কিন্তু সব ড্রাইভার এটি রিপোর্ট করে না এবং তাদের মধ্যে কিছু
ভুল ভ্যালু প্রদান করে। এই সমস্যার সমাধান করতে, অক্ষ ঘোষণার পরে
flat বিকল্প ব্যবহার করা যেতে পারে। এই বিকল্পটি অক্ষের কেন্দ্র
পজিশনের চারপাশে অঞ্চলের প্রস্থ নির্দিষ্ট করে যা কেন্দ্র হিসেবে বিবেচনা করা উচিত।
যেমন, কোনও ডিভাইস ড্রাইভার যদি AXIS_X-এর জন্য ০ থেকে ১০০-এর মধ্যে মান রিপোর্ট করে,
তাহলে Android ইনপুট সিস্টেমের মাধ্যমে ০-কে -১-এর সাথে এবং ১০০-কে ১-এর সাথে ম্যাপ করা হবে।
আনস্কেল করা কোঅর্ডিনেটে রেঞ্জের কেন্দ্র ৫০ হবে এবং স্কেল করা কোঅর্ডিনেটে ০ হবে।
ফ্ল্যাট ভ্যালু ১০ হলে,
ডেভেলপারদের ধরে নিতে হবে যে -০.১ এবং ০.১-এর মধ্যে (আনস্কেলড কোঅর্ডিনেটে ৪০ এবং ৬০-এর মধ্যে)
রিপোর্ট করা যেকোনও AXIS_X ভ্যালু হল নয়েজ এবং জয়স্টিক থেকে আসা সেইসব ভ্যালুকে
শূন্য হিসেবে বিবেচনা করতে হবে।
মনে রাখবেন: কী লেআউট ফাইল ড্রাইভার কোঅর্ডিনেট স্পেসের জন্য ভ্যালু নির্দিষ্ট করে দিলেও, 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
ভার্চুয়াল সফ্ট কী
ইনপুট সিস্টেম নিম্নলিখিত ব্যবহারের ক্ষেত্রে ভার্চুয়াল সফট কী প্রয়োগ করার জন্য বিশেষ ফিচার প্রদান করে:
- ভার্চুয়াল সফ্ট কী স্ক্রিনে গ্রাফিক্যালি দেখানো হলে (যেমন, Galaxy Nexus-এ), সেগুলি সিস্টেম UI প্যাকেজে থাকা নেভিগেশন বার কম্পোনেন্ট দ্বারা ইমপ্লিমেন্ট করা হয়। সিস্টেমের হাই লেভেলে গ্রাফিক্যাল ভার্চুয়াল সফ্ট কী প্রয়োগ করা হয় বলে কী লেআউট ফাইল এতে অন্তর্ভুক্ত থাকে না এবং নিম্নলিখিত তথ্য এতে প্রযোজ্য হয় না।
- ভার্চুয়াল সফ্ট কী যদি একটি বর্ধিত স্পর্শযোগ্য অঞ্চল হিসেবে প্রয়োগ করা হয়
যা মূল টাচ স্ক্রিনের অংশ (যেমন Nexus One-এ), তাহলে ইনপুট
সিস্টেম X/Y টাচ কোঅর্ডিনেটকে
Linux কী কোডে ট্রান্সলেট করার জন্য ভার্চুয়াল কী ম্যাপ ফাইল ব্যবহার করে, তারপর Linux কী কোডকে
Android কী কোডে ট্রান্সলেট করার জন্য কী লেআউট ফাইল ব্যবহার করে (ভার্চুয়াল কী ম্যাপ ফাইলের ব্যাপারে বিস্তারিত জানতে, টাচ ডিভাইস দেখুন)। টাচ স্ক্রিন ইনপুট ডিভাইসের জন্য
কী লেআউট ফাইলে অবশ্যই উপযুক্ত কী ম্যাপিং নির্দিষ্ট করতে হবে এবং প্রতিটি কী-এর জন্য
VIRTUALফ্ল্যাগ অন্তর্ভুক্ত করতে হবে। - ভার্চুয়াল সফ্ট কীগুলি যদি ক্যাপাসিটিভ বোতাম হিসেবে মূল টাচস্ক্রিন থেকে আলাদা করে
ইমপ্লিমেন্ট করা হয় (যেমন Nexus S-এ), তাহলে কার্নেল ডিভাইস ড্রাইভার বা
ফার্মওয়্যার টাচকে Linux কী কোডে ট্রান্সলেট করার জন্য দায়ী থাকে, যা
ইনপুট সিস্টেম তারপরে কী লেআউট ফাইল ব্যবহার করে Android কী কোডে ট্রান্সলেট করে।
ক্যাপাসিটিভ বোতাম ইনপুট ডিভাইসের জন্য কী লেআউট ফাইলে
উপযুক্ত কী ম্যাপিং নির্দিষ্ট করতে হবে এবং প্রতিটি কী-এর জন্য
VIRTUALফ্ল্যাগ যোগ করতে হবে।
ভার্চুয়াল সফ্ট কী টাচ স্ক্রিনের মধ্যে বা খুব কাছাকাছি থাকলে, স্ক্রিনের নিচের দিকে টাচ করার সময় অথবা স্ক্রিনে উপর থেকে নিচে বা নিচ থেকে উপরের দিকে আঙুল স্লাইড করার সময় ব্যবহারকারী সহজেই কোনও বোতামে অনিচ্ছাকৃতভাবে প্রেস করতে পারেন। এটি আটকাতে, ইনপুট সিস্টেম সামান্য ডিবাউন্সিং প্রয়োগ করে যাতে টাচস্ক্রিনে সবচেয়ে সাম্প্রতিক টাচ করার পরে কিছু সময়ের জন্য ভার্চুয়াল সফ্ট কী প্রেস উপেক্ষা করা হয় (এই বিলম্বকে ভার্চুয়াল কী কোয়াইট টাইম বলা হয়)।
ভার্চুয়াল সফ্ট কী ডিবাউন্সিং চালু করতে:
- টাচ স্ক্রিন বা ক্যাপাসিটিভ বোতাম
ইনপুট ডিভাইসের জন্য একটি কী লেআউট ফাইল দিন, যেখানে প্রতিটি কী-এর জন্য
VIRTUALফ্ল্যাগ সেট করা আছে।key 139 MENU VIRTUAL key 172 HOME VIRTUAL key 158 BACK VIRTUAL key 217 SEARCH VIRTUAL
-
ফ্রেমওয়ার্ক
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>
যাচাইকরণ
আপনাকে Validate Keymaps টুল ব্যবহার করে আপনার কী লেআউট ফাইল যাচাই করতে হবে।