Partilhar via


Códigos QR em Unreal

Se não estiver familiarizado com códigos QR, poderá querer rever a nossa descrição geral do controlo de código QR.

O HoloLens 2 pode ver códigos QR no espaço mundial com a câmara Web, o que os torna hologramas na posição real de cada código. HoloLens 2 também pode compor hologramas na mesma localização em vários dispositivos para criar uma experiência partilhada. Certifique-se de que está a seguir as melhores práticas para adicionar códigos QR às suas aplicações:

  • Zonas de sossego
  • Iluminação e pano de fundo
  • Tamanho, distância e posição angular

Preste especial atenção às considerações sobre o ambiente quando os códigos QR estão a ser colocados na sua aplicação. Pode encontrar mais informações sobre cada um destes tópicos e instruções sobre como transferir o pacote NuGet necessário no nosso documento de descrição geral do controlo de código QR .

Atenção

Os códigos QR são o único tipo de imagens que podem ser monitorizados pelo HoloLens fora da caixa – o módulo UARTrackedImage da Unreal não é suportado no HoloLens. Se precisar de controlar imagens personalizadas, pode aceder à câmara Web do dispositivo e processar imagens com uma biblioteca de reconhecimento de imagens de terceiros.

Ativar a deteção de QR

Uma vez que o HoloLens 2 precisa de utilizar a câmara Web para ver os códigos QR, terá de ativá-lo nas definições do projeto:

  • Abra Editar > Definições do Projeto, desloque-se para a secção Plataformas e selecione HoloLens.
    • Expanda a secção Capacidades e selecione Câmara Web.  
  • Também terá de optar pelo controlo de código QR ao adicionar um recurso ARSessionConfig.

Se estiver a utilizar UE 4.26, recomendamos que utilize a seguinte configuração do esquema para adicionar um pequeno atraso, uma vez que o controlo de código QR tem de ser inicializado após iniciar uma Sessão de AR:

Esquema da função Alternar ARCapture com atraso

Configurar um código QR controlado

Os códigos QR são apresentados através do sistema de geometria controlado pela AR da Unreal como uma imagem controlada. Para que isto funcione, terá de:

  1. Crie um Esquema de Ator e adicione um componente ARTrackableNotify :

Notificação do Controlo de AR QR

  1. Selecione ARTrackableNotify e expanda a secção Eventos no painel Detalhes :

Eventos QR

  1. Clique + junto a Adicionar Geometria Controlada para adicionar o nó ao Gráfico de Eventos.

Adicionar nó a Adicionar Geometria Controlada

Utilizar um código QR controlado

O Gráfico de Eventos na imagem seguinte mostra o evento OnUpdateTrackedImage a ser utilizado para compor um ponto no centro de um código QR e imprimir os respetivos dados.

Eis o que se passa:

  1. Primeiro, a imagem controlada é lançada num ARTrackedQRCode para verificar se a imagem atualizada atual é um código QR.
  2. Os dados codificados são obtidos a partir da variável QRCode . Pode obter o canto superior esquerdo do código QR a partir da localização de GetLocalToWorldTransform e as dimensões com GetEstimateSize.

Também pode obter o sistema de coordenadas de um código QR no código.

Localizar o ID exclusivo

Cada código QR tem um ID de guid exclusivo, que pode encontrar ao:

  • Arrastar e largar o pin As ARTracked QRCode e procurar Obter ID Exclusivo.

QR Guid

Próximo Ponto de Verificação de Desenvolvimento

Se estiver a seguir o percurso de ponto de verificação de desenvolvimento irreal que definimos, pode avançar para o tópico seguinte:

Em alternativa, avance diretamente para a implementação da sua aplicação num dispositivo ou emulador:

Pode sempre voltar aos pontos de verificação de desenvolvimento irreais em qualquer altura.

Ver também