Códigos QR en UnrealQR codes in Unreal

IntroducciónOverview

HoloLens 2 puede ver los códigos QR en el espacio del mundo real a través de la cámara web, que los representa como hologramas empleando un sistema de coordenadas en la posición del mundo real de cada código.The HoloLens 2 can see QR codes in world space using the webcam, which renders them as holograms using a coordinate system at each code's real-world position. Además de los códigos QR únicos, HoloLens 2 también puede representar hologramas en la misma ubicación en varios dispositivos para crear una experiencia compartida.In addition to single QR codes, HoloLens 2 can also render holograms in the same location on multiple devices to create a shared experience. Asegúrese de seguir estos procedimientos recomendados para agregar códigos QR a las aplicaciones:Make sure you're following the best practices for adding QR codes to your applications:

  • Zonas tranquilasQuiet zones
  • Iluminación y fondoLighting and backdrop
  • Tamaño, distancia y posición angularSize, distance, and angular position

Preste especial atención a las consideraciones del ambiente al colocar códigos QR en la aplicación.Pay special attention to the environment considerations when QR codes are being placed in your app. Puede encontrar más información sobre cada uno de estos temas e instrucciones sobre cómo descargar el paquete de NuGet necesario en el documento principal de seguimiento de código QR.You can find more information on each of these topics and instructions on how to download the required NuGet package in the main QR code tracking document.

Habilitación de la detección de QREnabling QR detection

Como HoloLens 2 necesita usar la cámara web para ver los códigos QR, deberá habilitarla en la configuración del proyecto:Since the HoloLens 2 needs to use the webcam to see QR codes, you'll need to enable it in the project settings:

  • Abra Editar > Configuración del proyecto, desplácese hasta la sección Plataformas y pulse en HoloLens.Open Edit > Project Settings, scroll to the Platforms section and click HoloLens.
    • Expanda la sección Funcionalidades y marque Cámara web.Expand the Capabilities section and check Webcam.  

También deberá participar en el seguimiento del código QR mediante la adición de un activo ARSessionConfig.You'll also need to opt into QR code tracking by adding an ARSessionConfig asset.

Justo antes del uso, debe habilitar manualmente el seguimiento llamando a UHoloLensARFunctionLibrary::StartCameraCapture().Right before the usage, you should manually enable the tracking by calling UHoloLensARFunctionLibrary::StartCameraCapture(). Después de terminar el seguimiento del código QR, debe deshabilitarlo mediante UHoloLensARFunctionLibrary::StopCameraCapture() para guardar los recursos del dispositivo.After ending the QR code tracking, you should disable it by UHoloLensARFunctionLibrary::StopCameraCapture() to save the device resources.

Configuración de una imagen con seguimientoSetting up a tracked image

Los códigos QR aparecen en el sistema de geometría con seguimiento de AR de Unreal como una imagen con seguimiento.QR codes are surfaced through Unreal’s AR tracked geometry system as a tracked image. Para que esto funcione, deberá hacer lo siguiente:To get this working, you'll need to:

  1. Cree un plano técnico y agregue un componente ARTrackableNotify.Create a Blueprint and add an ARTrackableNotify component.

Notificación de seguimiento de AR de QR

  1. Seleccione ARTrackableNotify y expanda la sección Eventos en el panel Detalles.Select ARTrackableNotify and expand the Events section in the Details panel.

Eventos con QR

  1. Haga clic en + junto a On Add Tracked Geometry (Al agregar geometría con seguimiento) para agregar el nodo al gráfico de eventos.Click + next to On Add Tracked Geometry to add the node to the Event Graph.

Adición de un nodo al evento On Add Tracked Geometry (Al agregar geometría con seguimiento)

Uso de una imagen con seguimientoUsing a tracked image

El gráfico de eventos de la siguiente imagen muestra el evento OnUpdateTrackedImage que se usa para representar un punto en el centro de un código QR e imprimir sus datos.The Event Graph in the following image shows the OnUpdateTrackedImage event being used to render a point in the center of a QR code and print out its data.

Ejemplo de representación de QR

Esto es lo que sucede:Here's what's going on:

  1. En primer lugar, convierte la imagen con seguimiento en un elemento ARTrackedQRCode para comprobar que la imagen actualizada actual es un código QR.First, the tracked image is cast to an ARTrackedQRCode to check that the current updated image is a QR code.
  2. Los datos codificados se recuperan de la variable QRCode.The encoded data is retrieved from the QRCode variable. Puede obtener la parte superior izquierda del código QR en la ubicación de GetLocalToWorldTransform y las dimensiones con GetEstimateSize.You can get the top-left of the QR code from the location of GetLocalToWorldTransform and the dimensions with GetEstimateSize.

También puede obtener el sistema de coordenadas para un código QR en el código.You can also get the coordinate system for a QR code in code.

Búsqueda del identificador únicoFinding the unique ID

Cada código QR tiene un id. de GUID único, que puede buscar:Every QR code has a unique guid ID, which you can find by:

  • Arrastrando y colocando el marcador As ARTracked QRCode (Como QRCode ARTracked) y buscando Get Unique ID (Obtener id. único).Dragging and dropping the As ARTracked QRCode pin and searching for Get Unique ID.

GUID de QR

Ocurren muchas cosas en segundo plano con los códigos QR, por lo que esto no es todo.There's a lot going on behind the scenes with QR codes, so this isn't the end of the road. Asegúrese de consultar los siguientes vínculos para obtener más detalles sobre ellos.Be sure to check out the following links for more details on what's under the hood.

Siguiente punto de control de desarrolloNext Development Checkpoint

Si sigue el recorrido de puntos de control de desarrollo de Unreal que hemos diseñado, significa que ya se encuentra en proceso de explorar las API y funcionalidades de la plataforma de realidad mixta.If you're following the Unreal development checkpoint journey we've laid out, you're in the midst of exploring the Mixed Reality platform capabilities and APIs. Desde aquí, puede continuar con el tema siguiente:From here, you can proceed to the next topic:

O bien puede ir directamente a la implementación de la aplicación en un dispositivo o emulador:Or jump directly to deploying your app on a device or emulator:

Puede volver a los puntos de control de desarrollo de Unreal en cualquier momento.You can always go back to the Unreal development checkpoints at any time.

Consulta tambiénSee also