از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
سخت افزار را ارزیابی کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ارزیابی سخت‌افزاری شامل تعریف سه اثر لمسی با برچسب‌گذاری اثرات 1، 2 و 3 برای این ارزیابی خاص است.
اثر 1: ثابت های لمسی کوتاه از پیش تعریف شده
ثابت VibrationEffect.EFFECT_CLICK اثر پایه یا مخرج مشترک در نگاشت HAL-API است که در ثابت های Map بین HAL و API ارائه شده است. با پرکاربردترین جلوه، HapticFeedbackConstants.KEYBOARD_PRESS نقشه برداری شده است.KEYBOARD_PRESS. ارزیابی این اثر به تعیین آمادگی دستگاه هدف شما برای لمس شفاف کمک می کند.
جلوه 2: جلوه لمسی سفارشی کوتاه
ثابت VibrationEffect.createOneShot(20,255) برای جلوه های لمسی سفارشی است. به طور خلاصه، تکانه های سفارشی منفرد، 20 میلی ثانیه حداکثر آستانه توصیه شده برای تعریف مدت زمان است. یک تکانه بیشتر از 20 میلی ثانیه توصیه نمی شود زیرا به عنوان یک لرزش وزوز درک می شود.
شکل 19. جلوه لمسی سفارشی کوتاه
جلوه 3: جلوه لمسی سفارشی طولانی با تنوع دامنه
ثابت VibrationEffect.createWaveform(timings[], amplitudes[], int repeat) برای جلوه های سفارشی طولانی با تنوع دامنه است. توانایی تولید دامنه های مختلف برای جلوه های لمسی سفارشی یکی از شاخص های ارزیابی قابلیت های دستگاه برای لمسی غنی است. timings [] و amplitudes [] به ترتیب {500, 500} و {128, 255} هستند که روند افزایشی دامنه را از 50٪ به 100٪ با نرخ نمونه برداری 500 میلی ثانیه نشان می دهد.
شکل 20. جلوه لمسی سفارشی طولانی با تنوع دامنه
برای بررسی قابلیت های سخت افزاری کنترل دامنه برای افکت 3، از روش Vibrator.hasAmplitudeControl() استفاده کنید. برای اجرای VibrationEffect.createWaveform با دامنه متفاوت همانطور که در نظر گرفته شده است، نتیجه باید true باشد.
شکل 21. ارزیابی موضوع اثر لمسی 1، 2، و 3
یک ارزیابی ذهنی انجام دهید
برای بررسی انسجام سریع، ابتدا یک ارزیابی ذهنی انجام دهید. هدف از ارزیابی ذهنی مشاهده دامنه اثرات لمسی برای تعیین اینکه آیا دستگاه می تواند لمسی با دامنه های قابل درک انسان ایجاد کند یا خیر است.
یک سوال خاص که حول این مفهوم ساختار یافته است به این صورت است: آیا دستگاه می‌تواند اثرات لمسی قابل‌توجهی را برای کاربران ایجاد کند؟ پاسخ به این سوال به شما کمک می‌کند از لمسی ناموفق جلوگیری کنید، از جمله لمسی نامحسوسی که کاربران نمی‌توانند آن را احساس کنند، یا لمسی ناخواسته که در آن شکل‌موج‌ها الگوهای مورد نظر را تولید نمی‌کنند.
انجام ارزیابی های کیفیت پیشرفته به شدت توصیه می شود. ارزیابی‌های کیفیت پیشرفته، ویژگی‌های قابل سنجش اثرات لمسی را برای اجرای لمسی با کیفیت مشخص می‌کند. پس از پایان کار، سازندگان دستگاه باید بتوانند وضعیت لمسی فعلی را تشخیص دهند، به این معنی که می توانند اهدافی را برای بهبود کیفیت کلی تعیین کنند. ارزیابی سخت افزار را ببینید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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,["# Assess the hardware\n\nHardware assessment involves defining three haptic effects, labeled Effects 1,\n2, and 3 for this specific assessment.\n\nEffect 1: Predefined short haptic constants\n-------------------------------------------\n\nThe\n[`VibrationEffect.EFFECT_CLICK`](https://developer.android.com/reference/android/os/VibrationEffect.html#EFFECT_CLICK)\nconstant is the baseline effect or common denominator in the HAL-API mapping\nprovided in [Map constants between HAL and API](/docs/core/interaction/haptics/haptics-map-constants)\n. It's mapped with the most used effect, [`HapticFeedbackConstants.KEYBOARD_PRESS`](https://developer.android.com/reference/android/view/HapticFeedbackConstants#KEYBOARD_PRESS)\n. Assessing this effect helps determine the readiness of your target device for\n[*clear haptics*](/docs/core/interaction/haptics/haptics-ux-foundation#clear-haptics).\n\nEffect 2: Short custom haptic effect\n------------------------------------\n\nThe\n[`VibrationEffect.createOneShot(20,255)`](https://developer.android.com/reference/android/os/VibrationEffect#createOneShot(long,%20int))\nconstant is for custom haptic effects. For short, single custom impulses,\n20 ms is the recommended maximum threshold to define duration. A single\nimpulse longer than 20 ms isn't recommended because it's perceived as a\n[*buzzy\nvibration*](/docs/core/interaction/haptics/haptics-ux-foundation#buzzy-vibration).\n\n**Figure 19.** Short custom haptic effect\n\nEffect 3: Long custom haptic effect with amplitude variation\n------------------------------------------------------------\n\nThe [`VibrationEffect.createWaveform(timings[], amplitudes[], int\nrepeat)`](https://developer.android.com/reference/android/os/VibrationEffect#createWaveform(long%5B%5D,%20int%5B%5D,%20int))\nconstant is for long custom effects with amplitude variation. The ability to\nproduce varying amplitudes for custom haptic effects is one of the indicators to\nevaluate the device's capabilities for [*rich\nhaptics*](/docs/core/interaction/haptics/haptics-ux-foundation#ease-in). The\nrecommended `timings []` and `amplitudes []` are `{500, 500}` and `{128, 255}`,\nrespectively, which presents an increasing trend of amplitude from 50% to 100%,\nwith a 500 ms sampling rate.\n\n**Figure 20.** Long custom haptic effect with amplitude variation\n\nTo check the hardware capabilities of amplitude control for Effect 3, use the\n[`Vibrator.hasAmplitudeControl()`](https://developer.android.com/reference/android/os/Vibrator#hasAmplitudeControl())\nmethod. The result has to be `true` to execute\n[`VibrationEffect.createWaveform`](https://developer.android.com/reference/android/os/VibrationEffect#createWaveform(long%5B%5D,%20int%5B%5D,%20int))\nwith varying amplitude as intended.\n\n**Figure 21.** Subject assessment of haptic effect 1, 2, and 3\n\n### Perform a subjective assessment\n\nFor a quick coherence check, perform a subjective assessment first. The goal of\nthe subjective assessment is to observe the amplitude of the haptic effects to\ndetermine whether the device can generate haptics with human-perceptible\namplitudes.\n\nA specific question structured around this notion looks like this: *Can the\ndevice produce perceptible haptic effects to the users as expected?* Answering\nthis question helps you avoid *failed haptics*, including imperceptible haptics\nthat users can't feel, or unintended haptics where waveforms don't produce\npatterns as intended.\n\n### Perform an advanced assessment\n\nPerforming advanced quality assessments is highly recommended. Advanced quality\nassessments characterize quantifiable attributes of haptic effects to implement\n*quality haptics* . When finished, device manufacturers should be able to\ndiagnose the current haptic status, which means they can set goals to improve\nthe overall quality. See [Hardware\nassessment](/docs/core/interaction/haptics/hardware)."]]
