Visualização da câmera e projeção de mídia
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.

NÍVEL 3: preparado para telas grandes
Visualização da câmera
A câmera é um dos apps mais importantes do Android. O visor da câmera é uma janela para o app, uma renderização da saída do sensor da câmera (a visualização da câmera).
Os sensores da câmera têm uma posição e uma proporção fixas e geralmente geram dados de imagem na orientação paisagem. No entanto, o visor precisa estar em conformidade com as orientações de retrato e paisagem do dispositivo, os estados dobrado e aberto de dispositivos dobráveis e diferentes tamanhos de janela no modo de várias janelas.
No modo de várias janelas e em dispositivos dobráveis, o visor pode ser retrato em dispositivos no modo paisagem ou paisagem em dispositivos no modo retrato. Os apps de câmera geralmente precisam girar a visualização da imagem para corresponder à orientação do visor. E mesmo quando o visor e o sensor da câmera estão na mesma orientação, as proporções podem ser diferentes.
O app tem o desafio de orientar e dimensionar a imagem do sensor da câmera para corresponder à orientação e proporção da interface do app à medida que a interface muda de orientação e tamanho.
Para saber como gerenciar a prévia da câmera, consulte os seguintes guias para desenvolvedores:
A projeção de mídia captura o conteúdo de uma tela do dispositivo ou janela do app e exibe o conteúdo capturado em outro dispositivo, como uma TV.
Os apps de projeção de mídia precisam registrar uma permissão de serviço, gerenciar o consentimento do usuário, orientar e dimensionar o conteúdo capturado para corresponder à orientação e à proporção do dispositivo de destino e permitir a personalização da projeção.
Para detalhes de implementação, consulte Projeção de mídia.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]