Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mídia SDV: gerenciar telas

A SDV Media expõe telas disponíveis para apps OEM com a API Linux DRM.

Interação entre componentes de DRM

Figura 1. Interação entre componentes de DRM.

Um framebuffer é uma fonte de dados de pixel, com suporte de um buffer de memória alocado externamente.
Um plano é uma origem de imagem usada pelo CRTC. Ele está associado a um framebuffer e pode representar uma visualização cortada dele.
CRTC representa um pipeline de exibição geral. Ele pode combinar vários planos para criar o vídeo final e enviar a saída para vários codificadores.
Um codificador converte a saída de vídeo do CRTC em um formato adequado para um conector específico.
Um conector representa um conector de tela disponível. Por exemplo, uma porta HDMI.

Para uma descrição mais detalhada, consulte:

Superfície da API

A SDV Media fornece as interfaces DRM do Linux. Embora possam ser usadas diretamente com a chamada de sistema ioctl, para o desenvolvimento de aplicativos, recomendamos usar uma biblioteca auxiliar do espaço do usuário. Exemplo:

Crate drm-rs para Rust (recomendado)
libdrm para C/C++. A página de manual drm-kms oferece uma visão geral extensa das APIs e do uso delas.

Configurar a renderização para uma única tela

Abra um dispositivo DRM (/dev/dri/card*) e use APIs DRM do Linux, por exemplo, por libdrm, no descritor do arquivo para selecionar a tela e o modo dela.

Normalmente, o sistema host expõe apenas um único dispositivo de GPU virtual, que aparece como /dev/dri/card0.
Alocar buffers frontais e traseiros com a API DRM do Linux.

Recomendamos usar gbm_bo_create() do minigbm e receber o descritor do arquivo DMA-BUF com gbm_bo_get_fd().
Crie framebuffers GL com suporte dos buffers alocados.
1. Crie um EGLImage do buffer de DRM com eglCreateImageKHR e EGL_LINUX_DMA_BUF_EXT (da extensão EGL_EXT_image_dma_buf_import ).
2. Crie uma textura GL e use glEGLImageTargetTexture2DOES (da extensão GL_OES_EGL_image) para definir o armazenamento da textura como o EGLImage da etapa anterior.
3. Crie um framebuffer do GL e use glFramebufferTexture2D para definir a textura de apoio como a criada na etapa anterior.
Para renderizar um frame:
1. Vincule um dos framebuffers GL criados.
2. Desenhe um frame com as APIs GLES comuns.
3. Mostre o frame em uma tela: use a API DRM do Linux (drmModeAtomicCommit()) para enviar um DRM_MODE_PAGE_FLIP_EVENT com o descritor de arquivo DMA-BUF usado pelo framebuffer GL vinculado.

Compor a saída de vídeo de várias camadas

Para composição multicamada (multiplano) acelerada por hardware, dependemos do sistema host que expõe cada camada como um conector DRM separado (display virtual) e as mapeia para o local / pipeline de hardware correto.

Consulte Configurar a renderização em várias telas para mais detalhes.

Configurar a renderização em várias telas

Abra o dispositivo DRM /dev/dri/card* como no fluxo de tela única.
Listar os conectores de exibição disponíveis.

Cada tela é exposta como um conector separado do dispositivo DRM.

Observação: como a SDV Media é executada em uma VM, dependendo do hipervisor, as telas disponíveis nem sempre correspondem a uma tela física, mas, por exemplo, a uma janela gerenciada por um processo de compositor em execução no sistema host.

Para cada conector de tela:

Selecione um CRTC compatível com o conector. Cada conector tem uma lista de codificadores disponíveis, e cada codificador indica com quais CRTCs ele pode ser usado. Sempre há pelo menos um CRTC compatível.
1. Selecione um avião compatível com o CRTC.
2. Cria framebuffers DRM com suporte de buffers de GPU. Esse processo é igual ao da variante de tela única.
3. Conecte o plano, o CRTC e o conector e defina o modo de vídeo no CRTC.
  
  É possível definir o modo de várias telas ao mesmo tempo usando a API atômica para definir as seguintes propriedades de DRM para cada conector, CRTC e conjunto de planos.

A lista completa de propriedades necessárias:

Destino	Propriedade	Tipo	Descrição
Conector	`CRTC_ID`	ID da CRTC	ID do CRTC a ser atribuído ao conector
CRTC	`MODE_ID`	ID do blob	ID de um blob de propriedade criado usando `drmModeCreatePropertyBlob`, que contém a struct `drmModeModeInfo` do modo de vídeo selecionado.
CRTC	`ACTIVE`	Booleano	`true` para marcar o CRTC como ativo
Avião	`FB_ID`	ID do framebuffer	ID do framebuffer DRM a ser mostrado na tela.
Avião	`SRC_X`	Pixels	Coordenada X do retângulo da imagem de origem do framebuffer.
Avião	`SRC_Y`	Pixels	Coordenada Y do retângulo da imagem de origem do framebuffer.
Avião	`SRC_W`	16.16 ponto fixo	Largura do retângulo da imagem de origem do framebuffer (pixels deslocados para a esquerda em 16 bits)
Avião	`SRC_H`	16.16 ponto fixo	Altura do retângulo da imagem de origem do framebuffer (pixels deslocados para a esquerda em 16 bits)
Avião	`CRTC_X`	Pixels	Coordenada X do retângulo da imagem de destino do CRTC
Avião	`CRTC_Y`	Pixels	Coordenada Y do retângulo da imagem de destino do CRTC
Avião	`CRTC_W`	Pixels	Largura do retângulo da imagem de destino do CRTC
Avião	`CRTC_H`	Pixels	Altura do retângulo da imagem de destino do CRTC

Insira o loop de renderização:
1. Aguarde o evento de troca de página em um CRTC antes de renderizar o próximo frame.
2. Renderize um frame e mostre-o na tela programando uma troca de página para determinado CRTC + framebuffer.