תצוגה מקדימה של המצלמה והקרנת מדיה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

רמה 3 – מוכנה למסך גדול
תצוגה מקדימה של מצלמה
אפליקציית המצלמה היא אחת מאפליקציות Android החשובות ביותר. העינית של המצלמה היא חלון לאפליקציה, עיבוד של הפלט של חיישן המצלמה (התצוגה המקדימה של המצלמה).
חיישני המצלמה ממוקמים במיקום קבוע וביחס גובה-רוחב קבוע, ובדרך כלל הם מניבים את נתוני התמונות בכיוון לרוחב. עם זאת, העינית צריכה להתאים לכיוונים האנכי והאופקי של המכשיר, למצבים המכופף והפתוח של מכשירים מתקפלים ולגדלים שונים של חלונות במצב 'מספר חלונות'.
במצב 'חלונות מרובים' ובמכשירים מתקפלים, העינית יכולה להיות בפריסה לאורך במכשירים בפריסה לרוחב או בפריסה לרוחב במכשירים בפריסה לאורך. לרוב, אפליקציות המצלמה צריכות לסובב את התצוגה המקדימה של התמונה כך שתתאים לכיוון של העינית. גם אם העינית וחיישן המצלמה באותו כיוון, יחס הגובה-רוחב שלהם עשוי להיות שונה.
האפליקציה צריכה להתאים את הכיוון והגודל של התמונה בחיישן המצלמה לכיוון וליחס הגובה-רוחב של ממשק המשתמש, כי ממשק המשתמש משתנה בכיוון ובגודל.
במדריכים הבאים למפתחים מוסבר איך לנהל את התצוגה המקדימה של המצלמה:
הקרנת מדיה מאפשרת לצלם את התוכן במסך של המכשיר או בחלון של האפליקציה ולהציג את התוכן שצולם במכשיר אחר, כמו טלוויזיה.
אפליקציות הקרנת מדיה צריכות לרשום הרשאת שירות, לנהל את הסכמת המשתמשים, לקבוע את הכיוון והגודל של התוכן שצולם כך שיתאים לכיוון וליחס הגובה-רוחב של מכשיר היעד, ולאפשר התאמה אישית של ההקרנה.
פרטים על ההטמעה זמינים במאמר הקרנת מדיה.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון 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-27 (שעון UTC)."],[],[],null,["# Camera preview and media projection\n\nTIER 3 --- Large screen ready\n| **Objective:** Make your app [large screen ready](/docs/quality-guidelines/large-screen-app-quality#large_screen_ready) by meeting the [LS-CM1](/docs/quality-guidelines/large-screen-app-quality#LS-CM1) camera preview and [LS-CM2](/docs/quality-guidelines/large-screen-app-quality#LS-CM2) media projection requirements of the [Large screen app quality](/docs/quality-guidelines/large-screen-app-quality) guidelines.\n\nCamera preview\n--------------\n\nCamera is one of the most important Android apps. The camera viewfinder is a window into the app, a rendering of the camera sensor output (the camera preview).\n\nCamera sensors have a fixed position and fixed aspect ratio and typically output their image data in landscape orientation. The viewfinder, however, must conform to portrait and landscape device orientations, folded and unfolded states of foldable devices, and different window sizes in multi‑window mode.\n\nIn multi‑window mode and on foldables, the viewfinder can be portrait on landscape devices or landscape on portrait devices. Camera apps often must rotate the image preview to match the orientation of the viewfinder. And even when the viewfinder and camera sensor are in the same orientation, their aspect ratios can differ.\n\nYour app has the challenge of orienting and scaling the camera sensor image to match the orientation and aspect ratio of the app's UI as the UI changes orientation and size.\n\nTo learn how to manage camera preview, see the following developer guides:\n\n- [Camera preview](/training/camera2/camera-preview)\n- [CameraX overview](/training/camerax)\n\nMedia projection\n----------------\n\nMedia projection captures the contents of a device screen or app window and displays the captured content on another device, such as a TV.\n\nMedia projection apps must register a service permission, manage user consent, orient and scale the captured content to match the orientation and aspect ratio of the target device, and enable customization of the projection.\n\nFor implementation details, see [Media projection](/media/grow/media-projection)."]]