Lightning Viewer
Una aplicación con una interfaz de usuario adaptativa que muestra los rayos en un mapa en tiempo real mediante la combinación de Qt Quick, Qt Location, Qt Positioning y Qt WebSockets.

Lightning Viewer es una aplicación que recibe datos simulados de descargas eléctricas desde WebSocket y los muestra en un mapa en tiempo real. Cuenta con una interfaz de usuario adaptativa que se ajusta perfectamente a pantallas de móviles, tabletas y ordenadores de sobremesa, tanto en orientación horizontal como vertical. Los rayos aparecen como iconos en el mapa, y una capa superpuesta independiente muestra la distancia y la hora del último rayo. Estas capas de datos se pueden ocultar y mostrar mediante botones de activación a los que se accede pulsando el botón de capas del mapa. También hay un selector para cambiar entre tipos de mapa y un botón que centra el mapa en la ubicación del usuario.
Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Estructura de la aplicación y clases relevantes
Esta aplicación sigue el patrón Modelo-Vista-Controlador (MVC). La clase ` LightningItemModel ` actúa como modelo. Almacena una lista de objetos ` LightningItemData ` y proporciona métodos para insertar nuevos datos y obtener información sobre las últimas huelgas. La vista se define en varios componentes QML que muestran los datos y la interfaz de usuario, y gestionan la interacción con el usuario. La clase ` Controller ` gestiona el flujo de datos entre ` LightningItemModel ` y los componentes QML. La clase ` LightningProvider ` abre una conexión ` WebSocket ` con un servidor en línea del que recibe un mensaje JSON por cada rayo simulado. Analiza los mensajes y transmite los datos a ` LightningItemModel ` a través de una señal conectada a una ranura en ` Controller`:
connect(m_provider.get(), &LightningProvider::dataReady, this, &Controller::onDataReceived);Cada rayo está representado por una estructura LightningItemData. Contiene la marca de tiempo, la latitud y la longitud del rayo, e incluye métodos que devuelven su distancia y dirección respecto a la ubicación del usuario, proporcionada como un QGeoCoordinate. La estructura LastStrikeInfo contiene información sobre el último rayo.
LightningView.qml Sirve como vista principal de la aplicación. Se encarga de mostrar el mapa y los datos de los rayos a través del componente ` MapView.qml`, así como los controles de usuario mediante el componente ` ActionsLayer.qml`. Al iniciarse la aplicación, el componente ` LightningSplash.qml ` se muestra sobre la vista principal. Si el Qt Lottie Animation módulo está disponible, esta pantalla de inicio mostrará una animación vectorial importada desde un archivo Lottie mediante la función CMake ` qt_target_qml_from_lottie()`. De lo contrario, mostrará una imagen estática.
MapView.qml gestiona el zoom y el desplazamiento del mapa. Utiliza un PositionSource para obtener la ubicación actual del usuario y un Map para mostrar el mapa. Además, incluye un LightningMapLayer.qml para mostrar los datos sobre rayos y un DistanceTimeLayer.qml para mostrar información sobre el último rayo.
ActionsLayer.qml Ofrece un botón para recentrar el mapa y un control de conmutación personalizado, SwitchMap.qml, para alternar entre diferentes tipos de mapa. También incluye un botón de capas del mapa que muestra los controles de activación/desactivación de las capas. Estos controles se definen en MapLayersItem.qml. En orientación horizontal, aparecen junto al botón de capas del mapa, mientras que en orientación vertical se sitúan en un Drawer definido en MapLayersDrawer.qml.
Fuente de datos de descargas atmosféricas
La aplicación recibe datos simulados de descargas atmosféricas desde un servidor gestionado por Qt. El servidor proporciona una API WebSocket que acepta conexiones en la siguiente URL:
wss://ewea0y4bn0.execute-api.eu-north-1.amazonaws.com/production/Tras conectarse al servidor, la aplicación activa la transmisión de datos en tiempo real enviando el siguiente mensaje JSON al servidor:
"{\"action\": \"simulatelightningdata\"}"Archivos fuente
Véase también Todos los ejemplos de Qt, Ejemplos y tutoriales deQt Quick , Ejemplos deQt Location , Ejemplos deQt Positioning y Ejemplos deQt WebSockets .
© 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.