از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
هاپتیک ها را پیاده سازی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سازندگان دستگاه به طور کلی مالک دارایی های خصوصی ایجاد شده برای هر دستگاه در نظر گرفته می شوند. به این ترتیب، تلاش های مهندسی آنها اغلب بر اساس هر دستگاه متمرکز است. تلاش اندکی برای سازگاری دستگاه‌های دیگر در اکوسیستم انجام می‌شود.
در مقابل، توسعه‌دهندگان تلاش می‌کنند تا برنامه‌هایی بسازند که بدون در نظر گرفتن مشخصات فنی هر دستگاه، روی همه تلفن‌های اندرویدی موجود در اکوسیستم کار کنند. این تفاوت در رویکرد می‌تواند باعث ایجاد مشکل تکه تکه شدن شود، به عنوان مثال، قابلیت‌های سخت‌افزاری برخی از تلفن‌ها با انتظارات تعیین‌شده توسط توسعه‌دهندگان برنامه مطابقت ندارد. بنابراین اگر رابط‌های برنامه‌نویسی لمسی روی برخی از تلفن‌های اندرویدی کار کنند اما در برخی دیگر نه، نتیجه یک اکوسیستم ناسازگار است. به همین دلیل است که پیکربندی سخت‌افزار نقش مهمی در حصول اطمینان از اینکه سازندگان می‌توانند APIهای لمسی اندروید را در هر دستگاهی پیاده‌سازی کنند، ایفا می‌کند.
این صفحه یک چک لیست گام به گام برای تنظیم انطباق سخت افزار برای بهترین استفاده از API های لمسی اندروید ارائه می دهد.
شکل زیر ایجاد دانش مشترک بین سازندگان دستگاه و توسعه دهندگان را نشان می دهد که گامی حیاتی در ایجاد یک اکوسیستم منسجم است:
شکل 1. ایجاد دانش بین سازندگان دستگاه و توسعه دهندگان
چک لیست پیاده سازی هاپتیک
ثابت ها را پیاده سازی کنید
- لیست ثابت ها برای پیاده سازی هاپتیک
ابتدایی ها را پیاده سازی کنید
- راهنمای پیاده سازی برای ترکیبات اولیه HAL.
ثابت های بین HAL و API را نگاشت
- توصیه‌های نگاشت بین ثابت‌های API عمومی ( قراردهنده‌های مکان نام‌گذاری شده در چارچوب) و ثابت‌های HAL، که متغیرها را پیاده‌سازی می‌کنند.
- برای اطلاعات بیشتر در مورد این فرآیند، به اصول طراحی برای راهنمایی نقشه برداری توصیه شده مراجعه کنید.
اثرات پاکت خطی تکه ای (PWLE) را پیاده سازی کنید
- راهنمای پیاده سازی برای پاکت های دامنه و فرکانس.
سخت افزار را ارزیابی کنید
- دستورالعمل در مورد اثرات لمسی هدف. از این دستورالعمل ها برای بررسی سریع سخت افزار خود استفاده کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],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)."]]
