Visão geral de rastreio de código QR

HoloLens 2 pode detetar códigos QR no ambiente em torno dos auscultadores, estabelecendo um sistema de coordenadas na localização real de cada código. HoloLens 2 também podem renderizar hologramas no mesmo local em vários dispositivos para criar uma experiência partilhada. Assim que ativar a webcam do seu dispositivo, poderá reconhecer códigos QR nas versões mais recentes dos seus projetos. Antes de ir para a produção, recomendamos que siga as melhores práticas que incluímos no final do artigo.

Suporte de dispositivos

Funcionalidade HoloLens 1ª Gen HoloLens 2 Auscultadores imersivos
Deteção de código QR ✔️ ✔️

Nota

O rastreio de código QR com auscultadores Windows Mixed Reality imersivos em computadores de secretária é suportado na versão Windows 10 2004 e superior. Utilize a API Microsoft.MixedReality.QRCodeWatcher.IsSupported() API para determinar se a funcionalidade é suportada no dispositivo atual.

Melhores práticas para deteção de código QR

Zonas tranquilas em torno dos códigos QR

Para serem lidos corretamente, os códigos QR requerem uma margem em torno de todos os lados do código. Esta margem não deve conter qualquer conteúdo impresso e deve ter quatro módulos (um único quadrado preto no código) de largura.

A especificação QR contém mais informações sobre zonas tranquilas.

Iluminação e pano de fundo

A qualidade de deteção de código QR é suscetível a iluminação e pano de fundo variados.

Numa cena com iluminação brilhante, imprima um código preto num fundo cinzento. Caso contrário, imprima um código QR preto num fundo branco.

Se o pano de fundo do código estiver escuro, experimente um código cinzento preto se a sua taxa de deteção for baixa. Se o pano de fundo for relativamente leve, um código regular deve funcionar bem.

Tamanho dos códigos QR

Windows Mixed Reality dispositivos não funcionam com códigos QR com lados inferiores a 5 cm cada.

Para os códigos QR entre os lados de 5 cm e 10 cm de comprimento, deve estar bastante perto de detetar o código. Também levará mais tempo para detetar códigos deste tamanho.

A hora exata para detetar códigos não depende apenas do tamanho dos códigos QR, mas também do quão longe está do código. Aproximar-se do código ajudará a compensar problemas com o tamanho.

Distância e posição angular do código QR

As câmaras de localização só conseguem detetar um certo nível de detalhe. Para pequenos códigos - < 10 cm ao longo dos lados - deve estar bastante perto. Para um código QR versão 1 que varia entre 10 cm e 25 cm de largura, a distância mínima de deteção varia entre 0,15 metros e 0,5 metros.

A distância de deteção para o tamanho aumenta linearmente, mas também depende da versão QR ou do tamanho do módulo. Quanto maior for a versão, menores os módulos, que só podem ser detetados de uma posição mais próxima. Também pode experimentar os códigos micro QR se quiser que a distância de deteção seja maior. A deteção de QR funciona com uma gama de ângulos += 45 deg para garantir que temos uma resolução adequada para detetar o código.

Importante

Certifique-se sempre de que tem contraste suficiente e uma fronteira adequada.

Códigos QR com logotipos

Os códigos QR com logotipos não foram testados e não são atualmente suportados.

Gestão de dados de código QR

Windows Mixed Reality dispositivos detetam códigos QR ao nível do sistema no controlador. Quando o dispositivo for reiniciado, os códigos QR detetados desapareceram e serão redetectados como novos objetos da próxima vez.

Recomendamos configurar a sua aplicação para ignorar códigos QR mais antigos do que uma etiqueta de tempo específica. Atualmente, a API não suporta limpar o histórico de código qR.

Colocação de código QR em um espaço

Para obter recomendações sobre onde e como colocar códigos QR, consulte considerações ambientais para HoloLens.

Ver também