diff options
author | Lars Sutterud <lars.sutterud@qt.io> | 2024-03-04 12:04:55 +0100 |
---|---|---|
committer | Lars Sutterud <lars.sutterud@qt.io> | 2024-03-18 08:14:57 +0100 |
commit | 4c3ea1b6eb77a4c56707980bab79c36581925f94 (patch) | |
tree | 8633d84328223fae4818c2959aed52a731000798 | |
parent | 8bfe72e8e386a6a7541e11593a4368bef4370875 (diff) |
Lightning Viewer: Update docs to clearly state use of simulated data
Due to the lack of an agreement with the lightning strike data provider,
we will only provide simulated lightning strike data for this demo. This
change removes info in the documentation about the option to forward
real world lightning data, and makes it more clear that the data is
simulated.
Fixes: QTBUG-122907
Pick-to: 6.7
Change-Id: Ibae18922e79393564b3947d813b1285f0358aaf9
Reviewed-by: MohammadHossein Qanbari <mohammad.qanbari@qt.io>
Reviewed-by: Axel Spoerl <axel.spoerl@qt.io>
-rw-r--r-- | examples/demos/lightningviewer/doc/src/lightningviewer.qdoc | 27 |
1 files changed, 10 insertions, 17 deletions
diff --git a/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc b/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc index 718398554..643792eb5 100644 --- a/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc +++ b/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc @@ -19,10 +19,10 @@ \include examples-run.qdocinc \section1 Overview - \e{Lightning Viewer} is an application that receives lightning strike data - from a \l{WebSocket} and displays it on a map in real-time. It features a - responsive UI that adapts well to mobile, tablet and desktop-sized screens - in both landscape and portrait orientation. Lightning strikes appear as + \e{Lightning Viewer} is an application that receives simulated lightning + strike data from a \l{WebSocket} and displays it on a map in real-time. It + features a responsive UI that adapts well to mobile, tablet and desktop-sized + screens in both landscape and portrait orientation. Lightning strikes appear as icons on the map, and a separate overlay shows the distance and time of the last strike. These data layers can be hidden and revealed with toggles that are accessed by pressing the map layers button. There is also a switch for @@ -38,7 +38,7 @@ interaction. The \c Controller class manages the data flow between the \c LightningItemModel and the QML components. The \c LightningProvider class opens a \l{WebSocket} connection to an online server from which it receives - a JSON message for each occurring lightning strike. It parses the messages + a JSON message for each simulated lightning strike. It parses the messages and passes the data on to the \c LightningItemModel via a signal connected to a slot in the \c Controller: @@ -71,22 +71,15 @@ they are placed in a \l{Drawer} defined in \c MapLayersDrawer.qml. \section1 Lightning strike data source - The application receives lightning strike data from a server maintained by - Qt. The server provides a WebSocket API accepting connections on the - following URL: + The application receives simulated lightning strike data from a server + maintained by Qt. The server provides a WebSocket API accepting connections + on the following URL: \code wss://ewea0y4bn0.execute-api.eu-north-1.amazonaws.com/production/ \endcode - - When connected, the server accepts two different JSON messages, included in - \c lightningprovider.cpp as strings with backslashes to escape - double-quotes. The first message will trigger the API to forward real world - lightning strikes. The availability or accuracy of this data can not be - guaranteed, as it depends on third party data providers. As an alternative - solution, the second message will trigger the API to send simulated - lightning strike data: + After connecting to the server, the application triggers the live data feed + by sending the following JSON message to the server: \code - "{\"action\": \"forwardlightningdata\"}" "{\"action\": \"simulatelightningdata\"}" \endcode |