Página de configurações de câmera

Artigo
12/18/2024

Este artigo descreve os recursos e a operação da página de configurações da câmera no Windows 11 e a estrutura de valores padrão que permite a configuração da câmera aplicada quando um aplicativo inicia a câmera.

Introdução

Antes do Windows 11, a única forma de os clientes ajustarem controles de imagem, como Brilho, Contraste, Nitidez e assim por diante, era por meio de um utilitário fornecido pelo fabricante da câmera (se disponível) ou se o aplicativo da câmera tivesse interface do usuário para ajustar o controle de imagem desejado.

A persistência dos valores ajustados costumava seguir um modelo de última entrada, tornando-o dependente do comportamento dos aplicativos que usam a câmera. Por exemplo, se um cliente ajustou o nível de brilho da câmera usando o utilitário do fabricante, esse valor só será mantido até que outro aplicativo grave no controle de brilho. Isso significava que o comportamento de um aplicativo tinha o potencial de afetar a experiência da câmera com outro aplicativo.

No Windows 11, uma nova estrutura de Valor Padrão foi apresentada, permitindo aos clientes configurar como a câmera se comporta sempre que ela é iniciada por um aplicativo. Uma nova página de configurações de câmera extensível também foi apresentada para gerenciar câmeras, incluindo os valores padrão.

Terminologia e pré-requisitos

Termo	Definição
Aplicativo complementar	Um aplicativo personalizado desenvolvido pelo fabricante da câmera que permite a configuração e o gerenciamento de uma câmera, além da página de configurações da câmera.
valor atual	O valor de um controle de câmera que está ativo no momento no ISP da câmera e é mantido na memória temporária da câmera.
Valor padrão	Um valor inicial de um controle de câmera que é armazenado em disco e salvo para uma câmera específica, para uma conta de usuário específica, em um PC específico.
ISP	Image Signal Processor, o microchip dentro da câmera responsável por controlar e ler o sensor, processar os dados da imagem e transferir os dados da imagem para o PC host.
NPU	Unidade de Processamento Neural, hardware dedicado criado para processar cargas de trabalho de inteligência artificial com alto rendimento e eficiência.
Sensor	O microchip dentro de uma câmera que é responsável por capturar imagens e convertê-las em sinais digitais.
Efeitos do Windows Studio	Uma coleção de efeitos de vídeo disponíveis em PCs Windows selecionados com NPUs.
UVC	Classe de vídeo USB, a interface padronizada para controle e streaming de câmeras conectadas por USB.

Exibição e gerenciamento de câmeras

Para iniciar a página de configurações da câmera, navegue até Configurações > Bluetooth e dispositivos > Câmeras. Esta página foi apresentada no Windows 11 e não está disponível em versões anteriores do Windows.

Câmeras de rede

A página de configurações da câmera permite que os clientes iniciem uma pesquisa na rede local por câmeras de rede/IP compatíveis com ONVIF e as conectem ao sistema. Após conectada, a câmera de rede aparece e funciona como uma câmera tradicional (por exemplo, USB).

É possível remover as câmeras de rede conectadas a um sistema selecionando a lista Câmeras conectadas na página de configurações da câmera e, depois, selecionando o botão Remover.

Para saber mais, consulte Câmeras de rede.

Câmeras conectadas

A página de configurações da câmera exibe as câmeras conectadas ao sistema no momento e permite aos clientes acessar uma subpágina com configurações adicionais relacionadas a cada câmera. Essas configurações incluem configurações de imagem padrão, a capacidade de desativar a câmera e, no caso de câmeras de rede, a capacidade de remover/desconectar a câmera.

As câmeras coloridas habilitadas são mostradas na lista e as câmeras especiais (como câmeras IR) não são mostradas.

Câmeras desativadas

Quando uma câmera é desativada por meio da página de configurações da câmera, uma seção separada aparece com uma lista de câmeras desativadas. Ao clicar em Ativar, você reativará a câmera selecionada.

Observação

Algumas câmeras talvez não apareçam na página de configurações da câmera se não tiverem um driver, estiverem em estado não funcional ou forem desabilitadas por meio de utilitários alternativos, como o Gerenciador de Dispositivos.

Configurar câmeras individuais

Ao selecionar uma câmera individual na lista Câmeras conectadas na página de configurações da câmera, uma subpágina é iniciada que exibe uma versão prévia da câmera, permite o gerenciamento da câmera e permite definir as configurações de imagem padrão.

As configurações padrão exibidas nesta página são salvas por câmera e por conta de usuário. Além disso, as configurações de imagem padrão não são salvas em backup e restauradas durante uma reinstalação do sistema operacional ou na instalação de um novo dispositivo Windows.

Desativar uma câmera

Para desativar uma câmera, selecione-a na lista Câmeras conectadas na página de configurações da câmera para abrir a subpágina e selecione o botão Desativar. Selecionar esse botão dispara um prompt para confirmar antes de desativar a câmera.

Em alguns sistemas, mais de uma câmera compartilha um ISP comum; portanto, ao desabilitar uma câmera, você pode desativar várias câmeras. Isso é comum em dispositivos de fator forma de tablet com uma câmera voltada para frente integrada (videoconferência) e voltada para o mundo. Nesse cenário, o prompt de confirmação inclui uma mensagem indicando que desabilitar uma câmera leva à desativação de outras câmeras no sistema como um grupo.

Em certos casos, a desativação das câmeras exige que o sistema seja reinicializado. Nesse cenário, a câmera continua a ser exibida na lista Câmeras conectadas da página de configurações da câmera, mas permanecerá esmaecida com uma mensagem que indica a necessidade de reiniciar o PC.

Solução de problemas de uma câmera

Para solucionar problemas de uma câmera, selecione-a na lista Câmeras conectadas na página de configurações da câmera para abrir a subpágina e selecione o botão Solucionar problemas. Selecionar esse botão inicia o utilitário Obter Ajuda que executa uma experiência interativa de solução de problemas da câmera.

Ajustar configurações básicas de imagem

Quando uma câmera é selecionada na lista Câmeras conectadas na página de configurações da câmera, uma seleção de controles deslizantes e/ou alternâncias para configurações básicas de imagem pode estar disponível na seção Configurações Básicas, conforme suporte da câmera.

A tabela a seguir lista configurações básicas disponíveis e a propriedade KS correspondente (ou Controle UVC, para câmeras USB) que a câmera deve implementar para que cada configuração fique visível. Se não houver configuração disponível na câmera, a seção Configurações Básicas não ficará visível.

Configuração básica	Propriedade KS	Controle de UVC
Brilho	Ver comentários após esta tabela	Ver comentários após esta tabela
Contraste	KSPROPERTY_VIDEOPROCAMP_CONTRAST	PU_CONTRAST_CONTROL
Nitidez	KSPROPERTY_VIDEOPROCAMP_SHARPNESS	PU_SHARPNESS_CONTROL
Saturação	KSPROPERTY_VIDEOPROCAMP_SATURATION	PU_SATURATION_CONTROL
HDR do Vídeo	KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR	MSXU_CONTROL_VIDEO_HDR

O controle de brilho é exclusivo porque, dependendo dos controles com suporte da câmera, ele mapeia para o controle KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION (MSXU_CONTROL_EVCOMPENSATION para câmeras UVC), ou para o controle herdado KSPROPERTY_VIDEOPROCAMP_BRIGHTNESS (PU_BRIGHTNESS_CONTROL para câmeras UVC).

O comportamento ideal de um controle deslizante para o brilho padrão da imagem é atuar como um deslocamento/desvio relativo ao algoritmo de Exposição Automática (AE) da câmera. Isso garante que os ajustes sejam independentes de cena e a câmera possa ser configurada para ser sempre um pouco mais clara ou um pouco mais escura para um ambiente de iluminação específico.

O controle de compensação EV é projetado de forma explícita para atuar como um desvio para o algoritmo AE de uma câmera. Quando uma câmera dá suporte ao controle de compensação EV, o controle deslizante de Brilho nas configurações da câmera é mapeado para esse controle. Quando a câmera não dá suporte ao controle de compensação EV, mas apoia o controle de Brilho herdado, o controle deslizante de Brilho é mapeado para o controle de Brilho herdado. Quando a câmera não dá suporte a controles, o controle deslizante de Brilho não fica visível na página de configurações da câmera.

Da mesma forma, os aplicativos que oferecem controles deslizantes de brilho no aplicativo são incentivados a usar a mesma lógica para mapear o controle de brilho no aplicativo para o controle de compensação de EV ou Brilho herdado. Essa lógica é implementada no aplicativo Câmera do Windows.

Ajustar efeitos do Windows Studio (ou efeitos da câmera)

Quando uma câmera é selecionada na lista Câmeras conectadas na página de configurações da câmera, uma seleção de alternâncias e/ou botões de opção para configurações de efeito de câmera pode estar disponível na seção Efeitos da Câmera, conforme suporte da câmera.

Os dispositivos Windows que dão suporte ao Windows Studio Effects nomearão a seção Windows Studio Effects.

A seguir está a lista de Efeitos de Câmera disponíveis e a Propriedade KS correspondente que a câmera deve implementar para visibilidade de cada configuração. Se não houver configuração disponível na câmera, a seção Efeitos da Câmera (ou Windows Studio Effects) não ficará visível.

Efeito da câmera	Propriedade KS
Desfoque padrão	KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION (com sinalizador KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR)
Desfoque de retrato	KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION (com sinalizador KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS)
Contato visual padrão	KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION (com sinalizador KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON)
Melhor contato visual	KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION (com sinalizador KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON)
Enquadramento automático	KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW (com sinalizador KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING)

Quando uma câmera só dá suporte ao Desfoque padrão, o controle é exibido como uma alternância ativa/desativa com o rótulo Desfoque de plano de fundo.

Quando a câmera dá suporte a Desfoque padrão e Desfoque de retrato, o controle é exibido como uma alternância ativa/desativada com o rótulo Efeitos de plano de fundo, além de um botão de opção para selecionar Desfoque padrão e Desfoque de retrato que está disponível quando Efeitos de plano de fundo está ativado.

Quando uma câmera só da suporte a Contato visual padrão, o controle é exibido como uma alternância ativa/desativa com o rótulo Contato visual.

Quando uma câmera dá suporte a Contato Visual Padrão e Contato Visual Avançado, o controle é exibido como uma alternância ativa/desativa com o rótulo Contato visual, além de um botão de opção para selecionar Padrão e Avançado que está disponível quando Contato visual está ativado.

Ajustar rotação do vídeo

Quando uma câmera externa é selecionada na lista Câmeras conectadas na página de configurações da câmera, uma lista suspensa fica disponível, permitindo que o cliente selecione uma Rotação de vídeo. As opções disponíveis são Sem rotação, 90° à direita, 90° à esquerda ou 180°.

A configuração de Rotação de vídeo só está disponível para câmeras externas. Se a câmera estiver em uso por outro aplicativo quando a configuração for alterada, ela não será aplicada até a próxima vez que a câmera for usada.

Observação

Quando a Rotação de vídeo é definida como um valor distinto de "Sem rotação", o Windows remove todos os tipos de dados compactados (por exemplo, MJPEG, H.264 e assim por diante) da câmera e emite estritamente tipos de dados não compactados. Aplicativos herdados e/ou câmeras que dependem da disponibilidade de tipos de dados compactados talvez não funcionem corretamente quando a configuração de Rotação de vídeo é definida.

Redefinir configurações da câmera

Quando uma câmera é selecionada na lista Câmeras conectadas na página de configurações da câmera, o botão Redefinir configurações permite a redefinição de todas as configurações da câmera com padrões de fábrica.

Quando esse botão é usado, as alterações nos controles Configurações Básicas, Efeitos do Windows Studio (ou Efeitos da Câmera) ou Rotação de vídeo são apagadas. A câmera é reiniciada com a configuração de fábrica.

Ao usar o botão Redefinir configurações, você também redefine todas as configurações padrão que foram definidas por um aplicativo complementar.

Comportamento de valor padrão

As alterações nos controles Configurações básicas, Efeitos do Windows Studio (ou Efeitos da Câmera) ou Rotação do vídeo são logo aplicadas à transmissão ao vivo da câmera (e ficam visíveis na versão prévia) e também são salvas como o valor padrão para a próxima vez que um aplicativo abrir a câmera.

Quando a câmera não é usada por nenhum aplicativo, o comportamento da página de configurações da câmera é simples. As alterações feitas pelos clientes nos controles Configurações Básicas, Efeitos do Windows Studio (ou Efeitos da Câmera) ou Rotação de vídeo são logo aplicadas à transmissão da versão prévia ao vivo da câmera. Elas são salvas como valores padrão atualizados que serão aplicados quando aplicativos iniciarem a câmera no futuro.

Como valores padrão se aplicam a aplicativos da câmera

Quando um aplicativo abre e inicia a câmera, o Windows inicia a câmera e, depois, aplica valores padrão à câmera que foram configurados por meio da página de configurações da câmera, a menos que o aplicativo tenha escrito certo controle depois de abrir a câmera, mas antes de iniciar a transmissão.

Por exemplo, considere um cenário em que o cliente defina o contraste padrão como 55% por meio da página de configurações da câmera e, depois, inicie a câmera em um aplicativo (como o Microsoft Teams):

Se o aplicativo abrir um identificador para a câmera e, depois, solicitar que a transmissão seja iniciada: o Windows definirá o valor atual da câmera para o controle de contraste (KSPROPERTY_VIDEOPROCAMP_CONTRAST) como 55%. O controle da câmera é entregue ao aplicativo.
Se o aplicativo abrir um identificador para a câmera, gravar o valor atual do controle de contraste como 45% e solicitar que a transmissão seja iniciada: o Windows ignorará a gravação do valor atual para o controle de contraste porque o aplicativo já o pré-inicializou.

Quando a câmera estiver em execução, o aplicativo poderá fazer o seguinte com o valor atual do controle de contraste:

Não fazer nada, caso em que o contraste permanece no valor definido na inicialização durante a sessão.
Gravar com valor distinto, caso em que o contraste muda para valor definido pelo aplicativo, durante a sessão ou até que o mesmo aplicativo o grave novamente, o que ocorrer primeiro.

Quando os aplicativos da câmera (como o Microsoft Teams) gravam em controles da câmera (contraste, brilho, entre outros), eles gravam as propriedades KS da câmera. Isso altera o valor atual do controle na câmera e não modifica o valor padrão como a página de configurações da câmera.

Usar a página de configurações da câmera com a câmera em uso

O comportamento pode ser mais complexo quando a página de configurações da câmera é usada enquanto outro aplicativo usa a câmera. A página de configurações da câmera sempre exibe os valores padrão, mas a transmissão de versão prévia (e a transmissão de vídeo exibida no aplicativo) representa os valores atuais definidos na câmera.

Considere um cenário básico em que um aplicativo abre a câmera e o aplicativo não tem interface do usuário para ajustar o valor atual do controle de contraste. Se o cliente abrir a página de configurações da câmera para ajustar o contraste com o aplicativo em execução, não haverá problemas porque o aplicativo não alterou o valor atual do controle de contraste fora do valor padrão.

Considere um cenário mais complexo, em que o valor padrão do controle de contraste seja 55%, mas o aplicativo que usa a câmera definiu o valor atual do controle de contraste como 45%. Nesse caso, a transmissão da câmera é executada com o contraste definido como 45%. Se o cliente abrir a página de configurações da câmera com o aplicativo em execução, ele verá uma versão prévia que reflete um contraste de 45%, mas o controle deslizante de contraste a seguir mostrará o valor padrão de 55%, o que é uma incompatibilidade.

Neste ponto, o cliente pode alterar o contraste usando o aplicativo. O Valor Atual do Contraste mudaria, afetando a transmissão de vídeo na versão prévia da página de configurações da câmera e no aplicativo. Mas, o controle deslizante de contraste na página de configurações da câmera continuará a exibir 55%.

Como alternativa, o cliente pode alterar o contraste por meio da página de configurações da câmera. Por exemplo, suponha que tenham ajustado o controle deslizante para 40%. A página de configurações da câmera salva 40% como o novo Valor Padrão e define o Valor Atual da câmera como 40%. Isso faz com que a transmissão de vídeo na página de configurações da câmera e no aplicativo seja alterado e reflita um contraste de 40%.

Observação

Alguns aplicativos podem usar a API IMFCameraControlMonitor para monitorar alterações externas em controles. Considere um aplicativo que deseja manter o contraste em 45% durante o uso da câmera. Esse aplicativo pode monitorar a propriedade KS de contraste e reescrever logo a propriedade KS como 45% se ela for alterada externamente por meio da página de configurações da câmera.

Não é comum ter problemas de sincronização e eles só ocorrem no cenário específico em que um cliente faz alterações em tempo real em configurações de imagem em um aplicativo e, ao mesmo tempo, inicia a página de configurações da câmera para ajustar a mesma configuração de imagem.

Para gerenciar situações de uso simultâneo, um banner de informações é exibido na página de configurações da câmera quando a câmera está em uso por outro aplicativo, indicando que as alterações feitas na página de configurações da câmera ou no aplicativo afetarão o aplicativo e a versão prévia na página de configurações da câmera.

Aplicativos complementares da câmera

Os fabricantes de câmeras talvez desejem fornecer seus próprios aplicativos personalizados que permitem aos clientes alterar as configurações de câmera padrão.

O Windows 11 fornece uma estrutura de aplicativos complementares da câmera que permite a fabricantes desenvolver aplicativos com os seguintes recursos:

Capacidade de exibir e/ou modificar as mesmas configurações de Valor Padrão com suporte da página de configurações da câmera (por exemplo, Brilho, Contraste, Efeitos de plano de fundo e assim por diante).
Capacidade de registrar, atualizar ou excluir configurações de Valor Padrão para outros controles de câmera conhecidos pelo Windows, mas que não são expostos por meio da página de configurações da câmera (por exemplo, o controle Hue).
Capacidade de registrar, atualizar ou excluir configurações de Valor padrão para controles de câmera proprietários do fabricante (por exemplo, o controle liga/desliga para o efeito de ajuste de iluminação personalizado do fabricante de uma câmera).

Quando uma câmera associa um aplicativo complementar específico a ela, é adicionada uma entrada desse aplicativo à página de configurações da câmera. Se o aplicativo estiver instalado, ele poderá ser iniciado na página de configurações da câmera; caso contrário, um link para a Microsoft Store será exibido para baixá-lo.

Para saber mais sobre como criar um aplicativo complementar, confira Aplicativos complementares da câmera.

Iniciar de forma programática a página de configurações da câmera

A página de configurações da câmera pode ser iniciada por um aplicativo usando um URI de link direito, o que é útil para aplicativos que desejam permitir acesso rápido a controles comuns da câmera. Para obter mais informações, consulte Launch the camera settings página.