Primeros pasos con Qt Remote Objects
Introducción
El módulo « Qt Remote Objects » ofrece una forma sencilla de compartir las API de Qt entre procesos y dispositivos. Para que esto funcione, se necesita un canal de datos entre procesos y dispositivos. Para establecer este canal de datos, en primer lugar, necesitas un « QRemoteObjectNode ».
En QtRO, un nodo es un punto final de comunicación. En una red de objetos remotos, cada participante, ya sea un proceso o un dispositivo, necesita su propio nodo. QtRO es una red peer-to-peer, en la que los nodos conectados constituyen los enlaces de la red.
Los nodos, por sí solos, no tienen mucha utilidad. Pero su valor se pone de manifiesto cuando se añaden clases « QObject » a un nodo para compartirlas. Entonces, cualquier nodo par puede solicitar una copia o instancia del objeto compartido al nodo anfitrión, es decir, el nodo que lo comparte.
A diferencia de lo que ocurre al utilizar instancias de clase normales (con propiedades independientes y emisiones de señales), QtRO sincroniza automáticamente los cambios en el objeto compartido en todas sus copias. Salvo algunas excepciones, estas copias tienen la misma API de Qt que el objeto original y están pensadas para utilizarse exactamente como si el objeto original estuviera disponible.
En QtRO, el objeto original se denomina «Fuente» (Source). Se trata de una clase de C++ totalmente implementada, con la lógica de negocio necesaria para proporcionar la funcionalidad requerida. Las copias de este objeto se denominan «Réplicas» (Replicas). No es necesario escribir código C++ para una réplica; en su lugar, se solicita una instancia desde un nodo. Aunque sí se necesita algo de código para utilizar la réplica —por ejemplo, conectar señales a tus propias ranuras—, no es necesario implementar el comportamiento interno, ya que eso ya se ha hecho por ti en la fuente.
Dado que el código fuente puede encontrarse en un proceso diferente o incluso en un dispositivo distinto, hay factores en QtRO que debes tener en cuenta y con los que normalmente no te encontrarías al desarrollar sin comunicación entre procesos (IPC). En concreto, ¿qué ocurre si el proceso o el dispositivo no están disponibles? Aquí es donde entran en juego las novedades de la API de réplicas:
- La señal initialized() se emite una vez que la réplica ha recibido el estado de origen desde la red QtRO.
- Tanto la propiedad ` isReplicaValid ` como la señal ` stateChanged()` te avisan si se pierde la conexión.
Los objetos compartidos a través de QtRO utilizan los enlaces (conductos) entre nodos para toda la comunicación. Si quieres compartir un ` QObject`, debes crear un nodo host con una URL a la que puedan conectarse otros nodos. También puedes utilizar el Registro para facilitar las conexiones, pero los nodos que compartan fuentes deben seguir siendo nodos host. A cada objeto compartido se le asigna un nombre (un QString), que se utiliza para identificarlo en la red QtRO.
Implementación
Para ilustrar el uso de objetos remotos, en el lado de origen, debemos:
- Crear el objeto de origen que se replicará en otros nodos, con o sin el uso de repc, el compilador de « Qt Remote Objects ».
- Opcionalmente, crear el Registro. De lo contrario, utilizar conexiones directas.
- Crear un nodo host para que el objeto de origen pueda compartirse.
- Llamar a la función ` enableRemoting()` del nodo para compartir el objeto de origen.
En el lado de la réplica, debemos:
- Opcionalmente, utilizar repc para generar un encabezado de réplica para su proyecto.
- Crea el nodo que se conectará con el nodo host de origen.
- Llama a la función ` acquire()` del nodo para crear un puntero a una réplica.
Los siguientes ejemplos ilustran tanto objetos estáticos compilados con repc como objetos de origen dinámicos. Además, muestran conexiones directas, así como conexiones que utilizan un Registro entre nodos.
© 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.