تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
CameraX هي مكتبة Jetpack مصممة للمساعدة في تسهيل تطوير تطبيقات الكاميرا.
بالنسبة إلى التطبيقات الجديدة، ننصح بالبدء باستخدام CameraX. وهو يوفّر واجهة برمجة تطبيقات متسقة وسهلة الاستخدام تعمل على معظم أجهزة Android، مع إمكانية التوافق مع الأنظمة القديمة للإصدار Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات). في حال نقل تطبيق من
الكاميرا1، يُرجى مراجعة
دليل نقل البيانات من الكاميرا1 إلى CameraX.
المزايا الأساسية
تساعد CameraX في تحسين تجربة مطوّري البرامج بعدة طرق رئيسية.
توافق واسع مع الأجهزة
يتوافق تطبيق CameraX مع الأجهزة التي تعمل بالإصدار
Android 5.0 (المستوى 21 لواجهة برمجة التطبيقات) والإصدارات الأحدث،
ويمثل أكثر من% 98 من أجهزة Android الحالية.
سهولة الاستخدام
يركّز CameraX على حالات الاستخدام التي تتيح لك التركيز على المهمة التي تريد إنجازها بدلاً من إدارة الفروقات الدقيقة الخاصة بالجهاز.
تتوفّر معظم حالات استخدام الكاميرا الشائعة:
الاتّساق على جميع الأجهزة
الشكل 2. يضمن المختبر الآلي لاختبار CameraX تقديم تجربة متّسقة لواجهة برمجة التطبيقات على العديد من أنواع الأجهزة والشركات المصنّعة.
من الصعب الحفاظ على سلوك ثابت للكاميرا. يجب مراعاة نسبة العرض إلى الارتفاع والاتجاه والتدوير وحجم المعاينة وحجم الصورة.
باستخدام تطبيق CameraX، تعمل هذه السلوكيات الأساسية فقط.
ندير مختبرًا آليًا لاختبار CameraX من أجل اختبار مجموعة متنوعة من سلوكيات الكاميرا على مجموعة من الأجهزة
وجميع إصدارات أنظمة التشغيل منذ الإصدار Android 5.0. يتم إجراء هذه الاختبارات
بشكل مستمر لتحديد مجموعة واسعة من المشاكل وإصلاحها.
إضافات الكاميرا
الشكل 3. صورة تم التقاطها بتأثير الضبابية (بورتريه) باستخدام CameraX.
يشتمل تطبيق CameraX على واجهة برمجة تطبيقات Extensions اختيارية تتيح لك الوصول إلى الميزات والإمكانات نفسها التي يوفرها تطبيق الكاميرا الأصلي للجهاز من خلال رموز برمجية لا تقل عن سطرين.
وتتضمّن الإضافات خلفية ضبابية (عمودية) ونطاق عالي الديناميكية (HDR)
و"الوضع الليلي" و"تجميل الوجه"، وتتطلّب جميعها توافقًا مع الجهاز.
دراسة حالة
لمعرفة كيف نجحت شركة CameraX في تبسيط عملية التطوير لنظام Monzo،
يمكنك الاطّلاع على دراسة الحالة التي تجريها شركة CameraX.
المستندات
مراجع إضافية
لمعرفة المزيد من المعلومات عن CameraX، يُرجى الرجوع إلى الموارد الإضافية التالية.
درس تطبيقي حول الترميز
بدء استخدام CameraX
عيّنة تعليمات برمجية
نماذج تطبيقات CameraX
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# CameraX overview\nPart of [Android Jetpack](/jetpack).\n=====================================================\n\nCameraX is a Jetpack library, built to help make camera app development easier.\nFor new apps, we recommend starting with CameraX. It provides a consistent,\neasy-to-use API that works across the vast majority of Android devices, with\nbackward-compatibility to Android 5.0 (API level 21). If you're migrating an app\nfrom Camera1, see our\n[Camera1 to CameraX migration guide](/training/camerax/camera1-to-camerax). \n[Get started with CameraX](https://codelabs.developers.google.com/codelabs/camerax-getting-started)\n\nPrimary benefits\n----------------\n\nCameraX improves the developer experience in several key ways.\n\n### Broad device compatibility\n\nCameraX supports devices running\n[Android 5.0 (API level 21)](/about/versions/lollipop) and higher,\nrepresenting over 98% of existing Android devices.\n\n### Ease of use\n\nCameraX emphasizes use cases, which allow you to focus on the task you need\nto get done instead of managing device-specific nuances.\nMost common camera use cases are supported:\n\n- [Preview](/training/camerax/preview): View an image on the display.\n- [Image analysis](/training/camerax/analyze): Access a buffer seamlessly for use in your algorithms, such as to pass to ML Kit.\n- [Image capture](/training/camerax/take-photo): Save images.\n- [Video capture](/training/camerax/video-capture): Save video and audio.\n\n### Consistency across devices\n\n**Figure 2.** Automated CameraX test lab ensures a consistent API\nexperience across many device types and manufacturers.\n\nMaintaining consistent camera behavior is hard. You have to consider\naspect ratio, orientation, rotation, preview size, and image size.\nWith CameraX, these basic behaviors just work.\n\nWe maintain an automated CameraX test lab that tests a variety of camera\nbehaviors across [a range of devices](/training/camerax/devices)\nand all operating system versions since Android 5.0. These tests\nrun on an ongoing basis to identify and fix a wide range of issues.\n\n### Camera extensions\n\n**Figure 3.** An image captured with\nthe bokeh (portrait) effect using CameraX.\n\nCameraX has an optional [Extensions](/training/camerax/extensions-api) API that\nallows you to access the same features and capabilities as a device's native\ncamera app with as few as two lines of code.\n\nExtensions include bokeh (portrait), high dynamic range (HDR),\nnight mode, and face retouching, all of which require device support.\n\n### Case study\n\nTo see how CameraX has simplified development for Monzo,\nsee [their case study](/stories/apps/monzo-camerax).\n\nDocumentation\n-------------\n\n- [CameraX architecture](/training/camerax/architecture)\n- [Configuration options](/training/camerax/configuration)\n- [Implement a preview](/training/camerax/preview)\n- [Image analysis](/training/camerax/analyze)\n- [Image capture](/training/camerax/take-photo)\n- [Video capture](/training/camerax/video-capture)\n- [Camera extensions](/training/camerax/extensions-api)\n- [Transform output](/training/camerax/transform-output)\n- [Use case rotations](/training/camerax/orientation-rotation)\n- [Lab-tested devices](/training/camerax/devices)\n\nAdditional resources\n--------------------\n\nTo learn more about CameraX, consult the following additional resources.\n\n### Codelab\n\n\n- [Getting Started with CameraX](https://codelabs.developers.google.com/codelabs/camerax-getting-started)\n\n### Code sample\n\n- \n- [CameraX sample apps](https://github.com/android/camera-samples/)"]]
