En esta página

Qt Remote Objects

Conceptos sobre objetos remotos

Qt Remote Objects (QtRO) es un módulo de comunicación entre procesos (IPC) desarrollado para Qt. Este módulo amplía las funcionalidades existentes de Qt para permitir el intercambio de información entre procesos u ordenadores de forma sencilla.

Una de las características clave de Qt, que permite este intercambio de información, es la distinción entre la API de un objeto (definida por sus propiedades, señales y ranuras) y la implementación de dicha API. El objetivo de QtRO es cumplir con esa API esperada, incluso si el verdadero « QObject » se encuentra en un proceso diferente. Una ranura invocada en una copia de un objeto (la «Réplica» en QtRO) se reenvía al objeto real (la «Fuente» en QtRO) para su gestión. Cada «Réplica» recibe las actualizaciones de la «Fuente», ya sean cambios en las propiedades o señales emitidas.

Una «Replica» es un proxy ligero del objeto «Source», pero admite las mismas conexiones y el mismo comportamiento que los QObjects, lo que permite utilizarla de la misma forma que cualquier otro « QObject » que ofrece Qt. Entre bastidores, QtRO se encarga de todo lo necesario para que la «Replica» se comporte como su «Source».

Ten en cuenta que los objetos remotos se comportan de forma diferente a las implementaciones tradicionales de llamada a procedimiento remoto (RPC); por ejemplo:

  • En RPC, el cliente realiza una solicitud y espera la respuesta.
  • En RPC, el servidor no envía nada al cliente a menos que sea en respuesta a una solicitud.
  • A menudo, el diseño de RPC es tal que los distintos clientes son independientes entre sí: por ejemplo, dos clientes pueden solicitar indicaciones a un servicio de mapas y obtener resultados diferentes.

Aunque es posible implementar este comportamiento al estilo RPC en QtRO, mediante «Sources» sin propiedades y «slots» que tienen valores de retorno, QtRO oculta el hecho de que el procesamiento es realmente remoto. Dejas que un nodo te proporcione la réplica en lugar de crearla tú mismo, posiblemente utilizando las señales de estado (isReplicaValid()), pero luego interactúas con el objeto como lo harías con cualquier otro tipo basado en « QObject ».

Caso de uso: GPS

Consideremos un sensor como un receptor del Sistema de Posicionamiento Global (GPS). En términos de QtRO:

  • La «Fuente» sería el proceso que interactúa directamente con el hardware del GPS y determina tu ubicación actual.
  • La ubicación se expondría como propiedades de l QObject; las actualizaciones periódicas de la ubicación actualizarían estas propiedades y emitirían señales de cambio de propiedad.
  • Se crearíanréplicas en otros procesos, que siempre conocerían tu ubicación actual, pero no necesitarían ninguna lógica para calcularla a partir de los datos del sensor.
  • Conectarse a la señal de cambio de ubicación en la réplica funcionaría como se espera: la señal emitida desde la «Fuente» activaría la emisión de la señal en todas las réplicas.

Caso de uso: Acceso a la impresora

Pensemos en un servicio que proporciona acceso a una impresora. En términos de QtRO:

  • La «fuente» sería el proceso que controla directamente la impresora.
  • Los niveles de tinta y el estado de la impresora se supervisarían mediante propiedades de « QObject ». Las actualizaciones de estas propiedades emitirían señales de cambio de propiedad.
  • La característica clave —la capacidad de imprimir algo— debe transmitirse de vuelta a la impresora. Por cierto, esto se ajusta al mecanismo de «slots» de Qt, que QtRO utiliza como la forma en que las réplicas realizan llamadas a la «Fuente». En efecto, las propiedades y las señales van de la «Fuente» a las réplicas; los «slots» van de las réplicas a la «Fuente».
  • Cuando se acepta una solicitud de impresión, el estado de la impresora cambiaría, lo que provocaría un cambio en la propiedad de estado. A continuación, esto se notificaría a todas las réplicas.

Uso del módulo

Para utilizar un módulo de Qt es necesario enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar los componentes del módulo necesarios en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)

Consulta también la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añada el módulo como valor de la variable « QT » en el archivo .pro del proyecto:

QT       += remoteobjects

Artículos y guías

Referencia de la API

Licencias

Qt Remote Objects está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.

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