> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/pt-br/secao-02-usando-o-velogic-studio/webcams-overview.md).

# Webcams: visão geral, FAQ, solução de problemas

Guia completo para configurar, usar e solucionar problemas de webcams com o Velogic Studio, incluindo recomendações de câmeras e instruções de configuração.

O Velogic Studio pode mostrar uma visualização ao vivo e gravar vídeo de qualquer webcam que você tenha conectada ao computador.

## Como configurar webcams

A etapa 1 do Velogic Studio é a etapa de configuração. Há uma seção na etapa 1 para ajudar você a configurar suas webcams.

Se você não tiver nenhuma webcam conectada ao seu PC, verá isto:\
![Webcam configuration section showing no webcams attached message](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-e7fd70a09c7ca097083d0c1ab0cf5d88fc67c9f5%2Fwebcams-overview-1.png?alt=media)

Se você conectar uma webcam, ela será detectada automaticamente (mas não adicionada):\
![Webcam detected automatically with Add Webcam button available](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-8ac6e9ff9b51785edac674e846ef32c69be13ec2%2Fwebcams-overview-2.png?alt=media)

Quando você clicar no botão "Adicionar webcam", aparecerá um pop-up permitindo que você escolha qual webcam adicionar:\
![Add webcam popup dialog showing available webcam selection options](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5fdcbc7aeeb186fc5f811990183174cc5413471f%2Fwebcams-overview-3.png?alt=media)

Clique na webcam que você gostaria de adicionar e você verá um cartão de configuração adicionado para essa webcam:\
![Webcam configuration card showing live view and control options for renaming, rotation, resolution](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b9b2d39f0fab6673f9ee8ef9d9639e9a6effa3c3%2Fwebcams-overview-4.png?alt=media)

A configuração mostrará a visualização ao vivo da webcam, e há controles para você:

* Renomear a webcam (por exemplo, "Frontal") - o nome é usado na Etapa 2 e no relatório, então é recomendável renomeá-la para algo que faça sentido
* Girar a webcam - particularmente útil para a visão frontal, em que você pode montar a câmera de lado para obter a melhor visão do ciclista
* Definir a resolução e a taxa de quadros - uma resolução maior será mais nítida, mas também resultará em arquivos de vídeo maiores e exigirá mais recursos do computador à medida que os vídeos forem gravados.
* Capturar uma imagem (snapshot) quando o joelho estiver na extensão máxima durante o período de captura, conforme determinado pela câmera Kinect. Isso ficará disponível para revisão e aparecerá no relatório.
* Remover a webcam (desconectá-la do Velogic Studio)

## Perguntas frequentes sobre webcams

### P. Qual webcam devo comprar?

Qualquer webcam compatível com o Windows deve funcionar com o Velogic Studio. As câmeras a seguir foram testadas e sabemos que funcionam:

* [Webcam Logitech C920](https://www.amazon.com/Logitech-Widescreen-Calling-Recording-Desktop/dp/B006JH8T3S/ref=sr_1_3?crid=7HXRLXJAI63K\&keywords=c920\&qid=1646783213\&sprefix=c9%2Caps%2C247\&sr=8-3) - webcam popular no mercado. Também existe uma variante C922, que é atraente porque diz oferecer 60 FPS; na prática, muitas pessoas relatam dificuldade para obter 60 FPS da câmera e acabam usando 30 FPS.
* [Microsoft Modern Webcam](https://www.amazon.com/Microsoft-2019-Modern-Webcam/dp/B093CBVYNL/ref=sr_1_3?crid=1XW7UVQFR2UJS\&keywords=microsoft+modern+webcam\&qid=1646783294\&sprefix=microsoft+modern+webcam%2Caps%2C318\&sr=8-3) - pequena e barata
* [Dell WB7022](https://www.dell.com/en-us/shop/dell-ultrasharp-webcam/apd/319-bbhp/pc-accessories) - ótima qualidade de imagem. Às vezes, os drivers parecem ficar "travados" e é necessário desconectar e reconectar a câmera.
* [Logitech Mevo Start](https://www.amazon.com/Logitech-Wireless-Streaming-Quality-Intelligent/dp/B0866PZN76) - webcam de streaming sem fio, que pode ser configurada para funcionar via protocolo NDI (pela sua rede Wi-Fi local) - veja abaixo "Posso usar meu celular como câmera?".

Se você tiver experiência com outros modelos de webcam, bons ou ruins, por favor nos avise e os adicionaremos à lista.

### P. Minha webcam precisa ficar mais longe do meu PC - posso usar um cabo de extensão?

A maioria das webcams de consumo vem com cabos USB curtos. O cabo USB da Logitech C920 tem cerca de 1,4 m de comprimento. Se você for posicionar essa câmera mais longe do que isso da porta USB do computador, será necessário um cabo de extensão.

Tivemos uma ótima experiência com o [cabo de extensão Cable Matters USB3.0 de 10 m](https://www.amazon.com/Cable-Matters-Active-Extension-Female/dp/B00DMFFL2W/ref=sr_1_3?crid=3CJY9GF0R3NZS\&keywords=Cable+Matters+10m+USB3.0+extension+cable\&qid=1646784303\&sprefix=cable+matters+10m+usb3.0+extension+cable%2Caps%2C399\&sr=8-3). Antes havia uma versão de 5 m disponível que também funciona muito bem. Esse cabo é alimentado na extremidade remota (câmera), mas parece funcionar bem mesmo sem alimentação com a câmera Logitech C920; presumivelmente porque é apenas um cabo de altíssima qualidade. Observe que o cabo Cable Matters também estende uma câmera Kinect v2.

Ocasionalmente, vimos essa combinação de cabo de extensão + câmera entrar em um estado em que não inicia. Isso pode ser resolvido desligando e ligando novamente a fonte de alimentação do cabo (ela fica conectada na extremidade da câmera do cabo).

### P. Posso usar meu celular como câmera?

Sim! Existe um protocolo chamado [NDI](https://en.wikipedia.org/wiki/Network_Device_Interface) que permite transmitir vídeo de alta qualidade pela sua rede local. Veja como configurá-lo:

1. Instale o [aplicativo de câmera NDI HX](https://ndi.video/tools/ndi-hx-camera/) no seu celular (ele não é gratuito, mas é mais barato que uma webcam)
2. Instale o [o software](https://ndi.tv/tools/) NDI Tools

no seu PC

1. Depois, toda vez que quiser usá-lo:
2. Execute o aplicativo de câmera NDI HX no seu celular\
   ![NDI Tools software interface with Webcam Input option for phone camera integration](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a730057772254b885ff21eb1ee1b860522eb83cf%2Fwebcams-overview-5.png?alt=media)
3. Execute o software NDI Tools no seu PC e escolha a opção "Entrada de webcam":\
   ![Windows system tray NDI application with phone selection for enabling video feed](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b5448a38b0e0d131d26dc1a8775f245f096da0ab%2Fwebcams-overview-6.png?alt=media)
4. Agora você deve ter um app NDI na bandeja do sistema (canto inferior direito da área de trabalho do Windows). Clique com o botão direito nele e certifique-se de que há uma marca de seleção ao lado do nome do seu celular:

Agora você pode adicioná-lo ao Velogic Studio clicando no botão "Adicionar câmera" e usá-lo como se fosse uma webcam normal. [página de recursos do NDI](https://ndi.video/resources/) para guias de solução de problemas. Você deve usar a ferramenta NDI Studio Monitor para testar o fluxo do seu celular; se ela conseguir ver o vídeo da câmera do celular, então o Velogic Studio também deverá conseguir.

## Solução de problemas com webcams

### Se a câmera não estiver disponível para adicionar no Velogic Studio

O primeiro passo para solucionar problemas de uma webcam no Velogic Studio é garantir que ela funcione bem com o Windows em geral e com outros aplicativos.

O Windows 11 tem uma interface de gerenciamento de câmera melhor do que o Windows 10. No Windows 11, você pode usar a interface "Gerenciar câmeras":\
![Windows 11 Manage cameras interface showing connected camera devices](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a318a7442ba7cb4677413cfc2822741dbdc47a29%2Fwebcams-overview-7.png?alt=media)

(Observe que, embora a Kinect V2 possa ser usada como webcam pelo Windows, o Velogic Studio a usará para detectar articulações e para medição, portanto ela não pode ser usada como uma webcam normal).

Se você clicar em uma das câmeras, poderá ajustar as configurações dela:\
![Windows camera settings page with preview image and camera adjustment controls](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-2f632177c3970a4cb4f18187db040aa1c9d57dd9%2Fwebcams-overview-8.png?alt=media)

Se você conseguir ver a imagem de pré-visualização nesta página de configurações, então deverá conseguir adicionar a câmera no Velogic Studio.

### Se você conseguir adicionar a câmera no Velogic Studio, mas ela não iniciar

Se você vir isto:\
![Velogic Studio webcam error showing camera detected but unable to start message](https://3174144422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1dc151c85cbc13b32167e44a0fb86a447447e8fc%2Fwebcams-overview-9.png?alt=media)

... isso significa que o Velogic Studio consegue ver a câmera (ou seja, o Windows está informando que a câmera está conectada), mas não consegue iniciá-la.

A causa mais provável é que outro aplicativo (por exemplo, o Zoom) tenha controle exclusivo da câmera. O Velogic Studio também exige controle exclusivo da câmera, então você não pode usá-la com o Zoom ao mesmo tempo que com o Velogic Studio. Você pode tentar fechar o outro aplicativo ou reiniciar o computador.

Você também pode tentar desconectar e reconectar a câmera.

Observe que algumas câmeras às vezes entram em um estado em que estão ligadas, mas nenhum aplicativo está usando-as. Sabe-se que isso acontece com a câmera Dell WB7022 e pode ser corrigido desconectando e reconectando a câmera.

### Se a câmera parar no meio de uma sessão

Se uma webcam parar de enviar vídeo no meio de um ajuste enquanto suas outras câmeras continuam funcionando, o Velogic Studio exibirá um banner na visualização da webcam. Desconecte o cabo USB da webcam (ou seu cabo de extensão) e conecte-o novamente.

A câmera perdeu a conexão USB, como se tivesse sido desconectada. Se isso acontecer mais de uma vez, faça estas alterações:

1. **Desative a suspensão seletiva de USB.** No Windows, abra *Painel de Controle > Opções de Energia > Alterar configurações do plano > Alterar configurações de energia avançadas*. Expanda *Configurações USB > Configuração de suspensão seletiva de USB* e defina como *Desativado*. Se houver configurações separadas de *Na bateria* e *Conectado à tomada* , defina ambas.
2. **Impeça que o Windows desligue as portas USB para economizar energia.** No *Gerenciador de Dispositivos*, expanda *Controladores de barramento serial universal*. Para cada *Hub raiz USB* e *Hub USB genérico*, clique com o botão direito, escolha *Propriedades*, abra a guia *Gerenciamento de energia* e desmarque *Permitir que o computador desligue este dispositivo para economizar energia*.
3. **Conecte a câmera diretamente ao computador.** Não use um hub USB.
4. **Se a câmera estiver a mais de 5 m do computador, use o cabo de extensão ativo Cable Matters** recomendado acima, com a fonte de alimentação conectada.
5. **Tente outra porta USB no computador.**

Se a câmera ainda parar, envie-nos um feedback de dentro do Velogic Studio logo depois que isso acontecer. Informe a marca e o modelo da câmera, o cabo de extensão que você usa e em qual porta USB ela está conectada.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.velogicfit.com/pt-br/secao-02-usando-o-velogic-studio/webcams-overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
