카메라 미리보기 및 미디어 프로젝션
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
TIER 3 — 대형 화면 지원
카메라 미리보기
카메라는 가장 중요한 Android 앱 중 하나입니다. 카메라 뷰파인더는 카메라 센서 출력 (카메라 미리보기)의 렌더링으로, 앱의 창입니다.
카메라 센서는 고정된 위치와 고정된 가로세로 비율을 가지며 일반적으로 이미지 데이터를 가로 모드 방향으로 출력합니다. 그러나 뷰파인더는 세로 모드 및 가로 모드 기기 방향, 폴더블 기기의 접힌 상태와 펼쳐진 상태, 멀티 윈도우 모드의 다양한 창 크기를 준수해야 합니다.
멀티 윈도우 모드 및 폴더블에서는 가로 모드 기기에서는 세로 모드로, 세로 모드 기기에서는 가로 모드로 뷰파인더가 표시될 수 있습니다. 카메라 앱은 뷰파인더의 방향에 맞게 이미지 미리보기를 회전해야 하는 경우가 많습니다. 뷰파인더와 카메라 센서의 방향이 동일하더라도 가로세로 비율이 다를 수 있습니다.
앱의 UI 방향과 크기가 변경될 때 앱의 UI 방향과 가로세로 비율에 맞게 카메라 센서 이미지의 방향을 지정하고 크기를 조정해야 합니다.
카메라 미리보기를 관리하는 방법은 다음 개발자 가이드를 참고하세요.
미디어 프로젝션은 기기 화면 또는 앱 창의 콘텐츠를 캡처하고 캡처된 콘텐츠를 TV와 같은 다른 기기에 표시합니다.
미디어 프로젝션 앱은 서비스 권한을 등록하고, 사용자 동의를 관리하고, 캡처된 콘텐츠의 방향과 크기를 조정하여 대상 기기의 방향과 가로세로 비율에 맞추고, 프로젝션 맞춤설정을 사용 설정해야 합니다.
구현 세부정보는 미디어 프로젝션을 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 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)."]]
