En esta página

Qt Quick Controles - Demostración de dispositivos wearables

Muestra un lanzador de aplicaciones diseñado para dispositivos wearables.

Interfaz de un dispositivo portátil que muestra iconos circulares para iniciar aplicaciones

La demostración para dispositivos wearables consta de un lanzador de aplicaciones y una colección de aplicaciones de ejemplo pequeñas y sencillas destinadas a dispositivos wearables.

Estructura

El archivo .qml principal, wearable.qml, consta de un elemento ` ApplicationWindow`, un elemento ` StackView ` para un modelo de navegación basado en pila y botones para la navegación interactiva.

QQC2.ApplicationWindow {
    id: window
    ...
    QQC2.StackView {
        id: stackView
        ...
        initialItem: LauncherPage {
            onLaunched: (title, page, fallback) => {
                            var createdPage = Qt.createComponent(page)
                            if (createdPage.status !== Component.Ready)
                                createdPage = Qt.createComponent(fallback)
                            stackView.push(createdPage)
                            header.title = title
                        }
        }
        ...
    }

    DemoMode {
        stackView: stackView
    }

    DemoModeIndicator {
        id: demoModeIndicator
        visible: WearableSettings.demoMode
        y: WearableSettings.demoMode ? header.height + 3 : -height - header.height - 3
        anchors.horizontalCenter: parent.horizontalCenter
        z: header.z + 1
    }

    MouseArea {
        enabled: WearableSettings.demoMode
        anchors.fill: parent
        onClicked: {
            // Stop demo mode and return to the launcher page.
            WearableSettings.demoMode = false
            stackView.pop(null)
        }
    }
}

Estilo

La demostración utiliza un estilo personalizado «Qt Quick Controls 2» integrado en los recursos de la demostración. El estilo personalizado se ha implementado solo para unos pocos controles, ya que es específico de esta demostración en particular. Utiliza un tipo singleton para diversos atributos de estilo, como las fuentes y los colores.

  • WearableStyle/PageIndicator.qml
  • WearableStyle/Slider.qml
  • WearableStyle/Switch.qml
  • WearableStyle/UIStyle.qml

El estilo se aplica en « main() » en « wearable.cpp »:

QQuickStyle::setStyle(QStringLiteral("WearableStyle"));

La principal ventaja de utilizar el sistema de estilos integrado es que la selección de estilos es totalmente transparente para el código de la aplicación. No es necesario importar una carpeta específica que contenga los controles con estilo. De este modo, la aplicación también puede ejecutarse con otros estilos.

Página de inicio

El lanzador de aplicaciones se implementa utilizando un « PathView » circular en LauncherPage.qml. Cada aplicación se encuentra en un archivo .qml independiente, que se añade a la ListModel de la página del lanzador. Para algunas aplicaciones se proporciona una opción alternativa para gestionar dependencias opcionales como QtLocation.

PathView {
    id: circularView

    signal launched(string title, string page, string fallbackpage)
    ...
    model: ListModel {
        ListElement {
            title: qsTr("Navigation")
            pageIcon: "maps"
            page: "NavigationPage.qml"
            fallback: "NavigationFallbackPage.qml"
        }
        ...
        ListElement {
            title: qsTr("Settings")
            pageIcon: "settings"
            page: "SettingsPage.qml"
            fallback: ""
        }
    }
    delegate: QQC2.RoundButton {
        ...
        icon.width: 36
        icon.height: 36
        icon.source: UIStyle.iconPath(pageIcon)
        icon.color: UIStyle.textColor
        ...
        onClicked: {
            if (PathView.isCurrentItem)
                circularView.launched(title, Qt.resolvedUrl(page), Qt.resolvedUrl(fallback))
            else
                circularView.currentIndex = index
        }
    }
    ...
}

Aplicaciones

Las aplicaciones están diseñadas para la entrada táctil, basándose en los métodos de entrada o medios de comunicación que suelen ofrecer los dispositivos wearables.

La mayoría de las aplicaciones cuentan con sus propios archivos JavaScript que actúan como backends ficticios de la aplicación. Estos muestran cómo recuperar, manipular o convertir datos externos. Por ejemplo, la aplicación Weather lee datos de archivos locales mediante XMLHttpRequest. Estos archivos se generaron almacenando respuestas de servidores remotos en formato JSON. Este código se puede modificar fácilmente para obtener datos de servidores remotos.

Esta aplicación utiliza el módulo QtLocation para mostrar una ruta dentro de Oslo. Si QtLocation no está instalado, muestra una imagen estática a modo de mapa y la información de la ruta basada en un archivo JSON. Actualmente, no es posible especificar el origen y el destino desde la propia aplicación, pero se puede añadir en función de las capacidades del dispositivo. Por ejemplo, puedes recopilar la información necesaria utilizando uno de los siguientes métodos:

  • Implementar pantallas adicionales para recabar datos del usuario
  • Comunicarse con otro dispositivo (teléfono inteligente u ordenador) a través de Bluetooth o WiFi.
El tiempo

Esta aplicación muestra información meteorológica, como la temperatura, las horas de salida y puesta del sol, la presión atmosférica, etc. Esta información se obtiene de https://openweathermap.org/ mediante su API REST. La respuesta de la API está en formato JSON, que la aplicación analiza mediante JavaScript. Esta aplicación también se puede modificar añadiendo pantallas para obtener datos meteorológicos de una ubicación determinada.

Reloj mundial

Esta aplicación muestra un reloj mundial para diferentes ciudades. Por el momento, la lista de ciudades está codificada de forma fija en la aplicación, pero puede modificarse en función de las capacidades de entrada del dispositivo.

Otras

El resto de aplicaciones devuelven datos estáticos por el momento, pero pueden modificarse para procesar los datos de respuesta obtenidos de los respectivos servicios.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Proyecto de ejemplo en code.qt.io

© 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.