En esta página

Personalizador de juguetes

Un ejemplo de personalización en 3D que muestra la selección interactiva de juguetes y los ajustes de apariencia en tiempo real mediante Qt Quick 3D.

Vista en 3D de un osito de peluche personalizable con accesorios en la fase de personalización del juguete

El personalizador de juguetes es una aplicación 3D interactiva creada con QML que permite a los usuarios personalizar personajes de juguete añadiéndoles accesorios 3D y rasgos faciales que se colocan sobre el juguete en tiempo real. Muestra cómo combinar escenas 3D deQt Quick con los controles estándar deQt Quick para crear una interfaz de usuario intuitiva.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Descripción general

El ejemplo presenta un modelo de juguete en 3D renderizado en tiempo real mediante Qt Quick 3D. La interfaz de usuario permite a los usuarios elegir entre diferentes juguetes, añadir diversos accesorios 3D y elementos faciales, y ajustar los colores de dichos accesorios mientras ven el resultado en la vista 3D.

El diseño se adapta tanto a la orientación vertical como a la horizontal, y el ejemplo también se puede ejecutar en la plataforma WebAssembly (WASM); para obtener más información, consulta Qt para WebAssembly.

Aspectos destacados del ejemplo:

  • El uso de « PrincipledMaterial » para definir materiales basados en la física para los modelos de los juguetes.
  • Combinación de controles QML en 2D con una escena 3D.
  • Organización de los componentes mediante archivos QML reutilizables para lograr una mejor estructura.
  • Permitir a los usuarios girar el juguete en la vista previa 3D arrastrando sobre la escena 3D.
  • Añadir breves animaciones de entrada y de baile para los juguetes en la primera página utilizando Timeline y TimelineAnimation.

Estructura de la aplicación

El archivo QML principal, Main.qml, define la ventana principal de la aplicación y gestiona la navegación entre seis páginas.

  • Primera página: los juguetes entran en escena y realizan breves animaciones de baile de forma secuencial.
  • Página de galería: se muestra una cuadrícula de juguetes y el usuario puede seleccionar uno.
  • Página de confirmación: muestra más detalles sobre el juguete seleccionado y solicita confirmación.
  • Página de personalización: el usuario selecciona accesorios y un nombre para el juguete.
  • Página de resumen del pedido: resume el pedido actual antes de completarlo.
  • Página final: confirma que el pedido se ha completado y permite al usuario iniciar un nuevo pedido.

Recursos

Los recursos se descargan en el momento de la compilación si aún no están presentes. Una vez finalizada la descarga, se extrae el archivo comprimido. En compilaciones posteriores, si alguno de los archivos de recursos extraídos ha cambiado, el archivo comprimido se vuelve a extraer para garantizar que todos los recursos necesarios estén disponibles y evitar fallos en tiempo de ejecución. Si una compilación falla debido a problemas con los recursos o a un paquete de recursos actualizado, al realizar una compilación limpia se eliminan tanto el archivo comprimido descargado como los archivos extraídos, de modo que la siguiente compilación pueda comenzar desde cero.

Nota: En este ejemplo se descargan algunos recursos de un servidor de Internet durante la fase de configuración de CMake.

Animaciones

La primera página cuenta con un « View3D ». Se utiliza un « Texture » como « light probe » HDR que proporciona iluminación basada en imágenes para los juguetes en 3D. Se han añadido nodos « PerspectiveCamera » y « SpotLight » para enmarcar los juguetes animados y resaltar sus movimientos al caminar y bailar en la escena.

Página de bienvenida con un peluche de oveja animado y el botón «Toca para empezar»

Hay un componente « Skin » que controla la malla con skin del personaje, mientras que un « Node » padre actúa como envoltorio para posicionar y transformar al personaje del juguete en la escena. El movimiento al caminar y bailar se controla mediante un « Timeline » que se reproduce con un « TimelineAnimation ». Los datos de animación se definen utilizando los elementos « KeyframeGroup » y « Keyframe », o se cargan a partir de datos binarios mediante « keyframeSource », que proporciona los fotogramas clave para el movimiento del personaje.

El ejemplo también utiliza un ` PrincipledMaterial ` compartido para definir el aspecto basado en la física de los personajes animados, incluyendo ` base color`, ` roughness`, ` culling mode` y ` opacity`. El material utiliza texture maps para el color base y normal data, que se proporcionan como URL desde el modelo y se vinculan a objetos Texture para su carga. AnimationModel.qml actúa como modelo de datos para los juguetes animados, almacenando las fuentes de texturas y mallas, así como metadatos adicionales, como las posiciones y rotaciones de los ojos de cada juguete.

Interfaz de usuario adaptativa

La interfaz de usuario está diseñada para adaptarse a diferentes tamaños de ventana y orientations. En la página de la galería de juguetes (ToyGalleryPage.qml), la galería de juguetes grid ajusta automáticamente el número de columnas en función del ancho disponible, de modo que las fichas de los juguetes permanezcan claramente visibles y mantengan una apariencia coherente tanto en el modo portrait como en el modo landscape.

En otras páginas, se utilizan diseños diferentes para las vistas portrait y landscape: los elementos se disponen uno al lado del otro en landscape, mientras que en portrait se utiliza un diseño de una sola columna para que el contenido se apile verticalmente. LayoutItemProxy se utiliza para posicionar los elementos dentro de estos diseños sin duplicar las definiciones de la interfaz de usuario.

Personalizar la página en modo horizontal con un oso en 3D a la izquierda y un panel de accesorios a la derecha

Personalizar la página en orientación vertical con un oso en 3D encima del panel de accesorios

Dado que algunos valores de diseño, como los tamaños de los elementos, los márgenes y las fuentes, se especifican para una resolución base diferente, el ejemplo utiliza ApplicationConfig.qml para escalar estos valores según la resolución real de la pantalla. Este archivo también centraliza los ajustes tipográficos, las familias de fuentes y las constantes de geometría de ventana derivadas de las especificaciones de diseño originales.

Vista 3D interactiva

En la página de personalización (ToyCustomizePage.qml), un 3D view muestra el juguete junto con los accesorios seleccionados. El juguete está representado por un Node raíz con partes del cuerpo separadas, cada una modelada como su propio Node. La vista 3D es interactiva a través de OrbitCameraController.qml, lo que permite al usuario girar el juguete e inspeccionar el accesorio adjunto 3D models desde diferentes ángulos, mientras que un DragHandler gestiona los gestos de rotación.

Osito de juguete en una vista previa interactiva en 3D, que gira para mostrar el modelo desde todos los ángulos

Archivos fuente

Proyecto de ejemplo en code.qt.io

Véase también Todos los ejemplos de Qt, Qt Quick Ejemplos de controles y Qt Quick Ejemplos y tutoriales en 3D.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.