با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
CameraX یک کتابخانه Jetpack است که برای کمک به توسعه برنامه دوربین آسانتر ساخته شده است. برای برنامه‌های جدید، توصیه می‌کنیم با CameraX شروع کنید. این یک API سازگار و با استفاده آسان را ارائه می‌کند که در اکثر دستگاه‌های اندرویدی کار می‌کند و با Android 5.0 (سطح API 21) سازگاری دارد. اگر برنامه‌ای را از Camera1 منتقل می‌کنید، به راهنمای انتقال Camera1 به CameraX ما مراجعه کنید.
مزایای اولیه
CameraX تجربه توسعه دهندگان را از چندین راه کلیدی بهبود می بخشد.
سازگاری گسترده دستگاه
CameraX از دستگاه‌های دارای Android نسخه 5.0 (سطح API 21) و بالاتر پشتیبانی می‌کند که بیش از 98 درصد از دستگاه‌های Android موجود را نشان می‌دهد.
سهولت استفاده
CameraX بر موارد استفاده تأکید دارد، که به شما امکان می دهد به جای مدیریت جزئیات خاص دستگاه، بر روی کاری که باید انجام دهید تمرکز کنید. رایج ترین موارد استفاده از دوربین پشتیبانی می شوند:
- پیش نمایش : یک تصویر را روی صفحه نمایش مشاهده کنید.
- تجزیه و تحلیل تصویر : برای استفاده در الگوریتم های خود، مانند انتقال به کیت ML، به یک بافر یکپارچه دسترسی پیدا کنید.
- ضبط تصویر : ذخیره تصاویر.
- ضبط ویدیو : ویدیو و صدا را ذخیره کنید.
سازگاری بین دستگاه ها
شکل 2. آزمایشگاه تست خودکار CameraX یک تجربه API سازگار را در بسیاری از انواع دستگاه ها و سازندگان تضمین می کند.
حفظ رفتار ثابت دوربین سخت است. شما باید نسبت ابعاد، جهت گیری، چرخش، اندازه پیش نمایش و اندازه تصویر را در نظر بگیرید. با CameraX، این رفتارهای اساسی فقط کار می کنند.
ما یک آزمایشگاه تست خودکار CameraX داریم که انواع رفتارهای دوربین را در طیف وسیعی از دستگاه‌ها و تمامی نسخه‌های سیستم عامل از Android نسخه 5.0 آزمایش می‌کند. این تست ها به طور مداوم برای شناسایی و رفع طیف گسترده ای از مشکلات اجرا می شوند.
پسوند دوربین
شکل 3. تصویری که با افکت بوکه (پرتره) با استفاده از CameraX گرفته شده است.
CameraX دارای یک Extensions API اختیاری است که به شما امکان می دهد با کمتر از دو خط کد به همان ویژگی ها و قابلیت های برنامه دوربین اصلی دستگاه دسترسی داشته باشید.
برنامه‌های افزودنی شامل بوکه (پرتره)، محدوده دینامیکی بالا (HDR)، حالت شب و روتوش چهره هستند که همگی به پشتیبانی دستگاه نیاز دارند.
مطالعه موردی
برای اینکه ببینید CameraX چگونه توسعه Monzo را ساده کرده است، به مطالعه موردی آنها مراجعه کنید.
مستندات
منابع اضافی
برای کسب اطلاعات بیشتر در مورد CameraX، به منابع اضافی زیر مراجعه کنید.
Codelab
شروع کار با CameraX نمونه کد
برنامه های نمونه CameraX
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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/)"]]
