اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تنفيذ تقنية اللمس
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُعتبر الشركات المصنّعة للأجهزة بشكل عام مالكة مواد العرض الخاصة
التي تم إنشاؤها لكل جهاز. ولذلك، غالبًا ما تركّز جهودهم الهندسية على
كل جهاز على حدة، ولا يُبذل جهد كبير أو معدوم لضمان اتساق
الأجهزة الأخرى في المنظومة المتكاملة.
في المقابل، يسعى المطوّرون إلى إنشاء تطبيقات تعمل على جميع هواتف Android
في المنظومة المتكاملة، بغض النظر عن المواصفات الفنية لكل جهاز.
ويمكن أن يؤدي هذا الاختلاف في النهج إلى حدوث مشكلة في التجزئة، على سبيل المثال، عدم تطابق
إمكانات الأجهزة في بعض الهواتف مع التوقعات التي وضعها مطوّرو التطبيقات. وبالتالي، إذا كانت واجهات برمجة التطبيقات الخاصة باللمس تعمل على بعض هواتف Android ولكن ليس على غيرها،
يؤدي ذلك إلى منظومة متكاملة غير متّسقة. لهذا السبب، تؤدي إعدادات الأجهزة
دورًا مهمًا في ضمان تمكّن المصنّعين من تنفيذ واجهات برمجة تطبيقات ميزاتhaptics في Android على كل جهاز.
تقدّم هذه الصفحة قائمة تحقّق مفصّلة لإعداد التوافق مع الأجهزة من أجل
تحقيق أفضل استخدام لواجهات برمجة التطبيقات الخاصة باللمس في Android.
يوضّح الشكل التالي إنشاء معرفة مشتركة بين صانعي
الأجهزة والمطوّرين، وهي خطوة حاسمة في إنشاء منظومة متكاملة
متسقة:
الشكل 1: تبادل المعرفة بين المصنّعين والمطوّرين للأجهزة
قائمة التحقّق من تنفيذ تقنية اللمس
تنفيذ الثوابت
- قائمة الثوابت لتنفيذ اللمس
تنفيذ العناصر الأساسية
- إرشادات التنفيذ لعناصر تركيب HAL
ربط الثوابت بين HAL وواجهة برمجة التطبيقات
- اقتراحات الربط بين الثوابت العامة لواجهات برمجة التطبيقات (التي تُسمى
العناصر النائبة في إطار العمل) وثوابت HAL التي تنفِّذ
العناصر النائبة
- اطّلِع على مبادئ التصميم التي توجّه عملية الربط المقترَحة
للاطّلاع على مزيد من المعلومات عن هذه العملية.
تنفيذ تأثيرات المغلّفات الخطية الجزئية (PWLE)
- إرشادات تنفيذ أغلفة النطاق الزمني وسعة الموجة
تقييم الجهاز
- تعليمات حول استهداف التأثيرات اللمسية يمكنك اتّباع هذه التعليمات لإجراء فحص سريع على جهازك.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Implement haptics\n\nDevice manufacturers are generally considered the owners of the private assets\ncreated for each device. As such, their engineering efforts are often focused on\na *per-device basis*; little to no effort goes to the consistency of other\ndevices in the ecosystem.\n\nIn direct contrast, developers strive to build apps that work on *all* Android\nphones in the ecosystem, regardless of each device's technical specifications.\nThis difference in approach can cause a fragmentation problem, for example, the\nhardware capabilities of certain phones don't match expectations set by the app\ndevelopers. So if the haptics APIs work on some Android phones but not others,\nthe result is an inconsistent ecosystem. This is why hardware configuration\nplays a critical role in ensuring that manufacturers can implement Android\nhaptics APIs on *every* device.\n\nThis page provides a step-by-step checklist to set up hardware compliance for\nthe best use of the Android haptics APIs.\n\nThe following figure illustrates building common knowledge between device\nmanufacturers and developers, which is a critical step in creating a cohesive\necosystem:\n\n**Figure 1.** Building knowledge between device manufacturers and developers\n\nHaptics implementation checklist\n--------------------------------\n\n1. [Implement constants](/docs/core/interaction/haptics/haptics-constants-primitives#implement-constants)\n\n - List of constants to implement haptics.\n2. [Implement primitives](/docs/core/interaction/haptics/haptics-constants-primitives#implement-primitives)\n\n - Implementation guidance for HAL composition primitives.\n3. [Map constants between HAL and API](/docs/core/interaction/haptics/haptics-map-constants)\n\n - Mapping recommendations between public API constants (named *placeholders* in the framework) and HAL constants, which implement the placeholders.\n - See [Design principles to guide the recommended mapping](/docs/core/interaction/haptics/haptics-ux-design) to learn more about this process.\n4. [Implement piecewise linear envelope (PWLE) effects](/docs/core/interaction/haptics/haptics-pwle)\n\n - Implementation guidance for amplitude and frequency envelopes.\n5. [Assess the hardware](/docs/core/interaction/haptics/haptics-assess-hardware)\n\n - Instructions on target haptic effects. Use these instructions to perform quick checks on your hardware.\n\n| **Note:** You can learn more about building common knowledge between device manufacturers and developers in [Advanced Haptics: The When, What, and How of\n| Haptic APIs](https://www.youtube.com/watch?v=00jRoEFnpk8)."]]
