اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release
بدلاً من aosp-main
لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تتبُّع الحركة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في Android 9، يمكن لأجهزة الكاميرا الإعلان عن
إمكانية تتبُّع الحركة.
لا تُنشئ الكاميرات المزوّدة بهذه الميزة بيانات تتبُّع الحركة بنفسها،
ولكن يتم استخدامها بدلاً من ذلك من خلال ARCore أو خوارزمية تثبيت الصورة مع
أدوات استشعار أخرى لتحليل المشهد. لاستخدام هذه الميزة، يجب أن تكون الأجهزة متوافقة مع CONTROL_CAPTURE_INTENT_MOTION_TRACKING
.
إذا كان هذا الغرض جزءًا من طلب الالتقاط، يجب أن تحدّ الكاميرا من
وقت التعريض إلى 20 مللي ثانية كحد أقصى لتقليل التمويه الناتج عن الحركة.
الأمثلة والمصدر
يتوفّر تنفيذ مرجعي لتتبُّع الحركة من جانب HAL كجزء
من
HAL للكاميرا.
التنفيذ
لتفعيل ميزة "تتبُّع الحركة" على جهاز كاميرا، تأكَّد مما يلي:
التحقُّق
يجب أن تجتاز أجهزة الكاميرا التي تتيح ميزة "تتبُّع الحركة"
اختبارات مجموعة أدوات اختبار التوافق (CTS) للكاميرا.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Motion tracking\n\nIn Android 9, camera devices can advertise\n[motion tracking capability](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING).\nCameras that support this feature don't produce motion tracking data itself,\nbut instead are used by ARCore or an image-stabilization algorithm along with\nother sensors for scene analysis. To support this feature, devices must support\n[`CONTROL_CAPTURE_INTENT_MOTION_TRACKING`](https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#CONTROL_CAPTURE_INTENT_MOTION_TRACKING).\nIf this intent is part of the capture request, the camera must limit the\nexposure time to a maximum of 20 milliseconds to reduce motion blur.\n\nExamples and source\n-------------------\n\nA reference motion tracking implementation on the HAL side is available as part\nof the\n[Camera HAL](https://android.googlesource.com/platform/hardware/qcom/camera/+/android16-release/msm8998/QCamera2/HAL3/QCamera3HWI.cpp).\n\nImplementation\n--------------\n\nTo enable motion tracking on a camera device, make sure:\n\n- The [`ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.3/types.hal#230) capability is enabled.\n- The [`ANDROID_CONTROL_CAPTURE_INTENT_MOTION_TRACKING`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.3/types.hal#206) intent is supported and when included in a capture request limits the camera exposure time to a maximum of 20 milliseconds.\n- Lens calibration data from the following list is accurately reported in the\n static information and dynamic metadata fields:\n\n - [`ANDROID_LENS_POSE_ROTATION`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.2/types.hal#747)\n - [`ANDROID_LENS_POSE_TRANSLATION`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.2/types.hal#753)\n - [`ANDROID_LENS_INTRINSIC_CALIBRATION`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.2/types.hal#773)\n - [`ANDROID_LENS_RADIAL_DISTORTION`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.2/types.hal#780)\n - [`ANDROID_LENS_POSE_REFERENCE`](https://android.googlesource.com/platform/hardware/interfaces/+/android16-release/camera/metadata/3.3/types.hal#78)\n\nValidation\n----------\n\nCamera devices supporting the motion tracking feature must pass the\n[camera CTS tests](/docs/compatibility/cts/camera-hal#cts_tests)."]]