קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
CameraX היא ספריית Jetpack שנועדה לעזור בפיתוח אפליקציות מצלמה.
באפליקציות חדשות, מומלץ להתחיל עם CameraX. הוא מספק ממשק API עקבי וקל לשימוש שפועל ברוב המכשירים עם Android, עם תאימות לאחור ל-Android 5.0 (רמת API 21). אם אתם מעבירים אפליקציה מ-Camera1, כדאי לעיין במדריך להעברה מ-Camera1 ל-CameraX.
היתרונות העיקריים
CameraX משפרת את חוויית הפיתוח במספר דרכים עיקריות.
תאימות למכשירים רבים
CameraX תומכת במכשירים עם מערכת Android מגרסה 5.0 (רמת API 21) ואילך, שהם יותר מ-98% ממכשירי Android הקיימים.
קלות השימוש
ב-CameraX מושם דגש על תרחישים לדוגמה, שמאפשרים לכם להתמקד במשימה שאתם צריכים לבצע במקום לנהל את הדקויות הספציפיות למכשיר.
התרחישים הנפוצים ביותר לדוגמה לשימוש במצלמה נתמכים:
עקביות במכשירים שונים
איור 2. מעבדת הבדיקה האוטומטית של CameraX מבטיחה חוויית API עקבית במגוון סוגים של מכשירים ויצרנים.
קשה לשמור על התנהגות עקבית של המצלמה. צריך להביא בחשבון את יחס הגובה-רוחב, הכיוון, הסיבוב, גודל התצוגה המקדימה וגודל התמונה.
בעזרת CameraX, ההתנהגויות הבסיסיות האלה פשוט פועלות.
אנחנו מנהלים מעבדת בדיקות אוטומטית של CameraX שבה נבדקים מגוון התנהגויות של מצלמות במגוון מכשירים ובכל הגרסאות של מערכת ההפעלה החל מ-Android 5.0. אנחנו מריצים את הבדיקות האלה באופן שוטף כדי לזהות ולתקן מגוון רחב של בעיות.
תוספי מצלמה
איור 3. תמונה שצולמה עם אפקט בוקה (דיוקן) באמצעות CameraX.
ל-CameraX יש ממשק API אופציונלי של תוספים שמאפשר לגשת לתכונות וליכולות של אפליקציית המצלמה המובנית של המכשיר באמצעות שתי שורות קוד בלבד.
התוספים כוללים אפקטים כמו בוקה (דיוקן), טווח דינמי גבוה (HDR), מצב לילה וריטוש פנים. כל התוספים האלה דורשים תמיכה במכשיר.
מקרה לדוגמה
במקרה לדוגמה הזה תוכלו לראות איך CameraX הפשטה את הפיתוח ב-Monzo.
מסמכים
מקורות מידע נוספים
מידע נוסף על CameraX זמין במקורות המידע הבאים.
Codelab
תחילת העבודה עם CameraX
דוגמת קוד
אפליקציות לדוגמה של CameraX
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],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/)"]]