IoT Platform ofrece la función de sombra de dispositivo para almacenar en caché los datos de estado que envía cada dispositivo y los comandos que envían las aplicaciones. Los dispositivos en línea pueden recibir comandos directamente from IoT Platform. Si los dispositivos están sin conexión, puede solicitar los comandos a IoT Platform una vez que vuelvan a conectarse. Este tema describe los escenarios de uso de la sombra de dispositivo y cómo utilizar esta función.
Sombras de dispositivo
Una sombra de dispositivo es un archivo JSON que almacena los datos de estado enviados por un dispositivo y los datos de estado del dispositivo que desean las aplicaciones. Para obtener más información sobre los datos JSON, consulte JSON format of device shadows.
Cada dispositivo tiene solo una sombra. Un dispositivo puede obtener o configurar su sombra en IoT Platform mediante Message Queuing Telemetry Transport (MQTT) para sincronizar el estado.
Diferencias entre las sombras de dispositivo y los valores de propiedad deseados
Los valores de propiedad deseados y las sombras de dispositivo son datos deseados que se almacenan en IoT Platform. Cuando los dispositivos se conectan, obtienen estos datos para implementar la lógica de negocio correspondiente. A continuación se describen las diferencias entre los valores de propiedad deseados y las sombras de dispositivo según su alcance de aplicación.
|
Elemento |
Descripción |
|
Valores de propiedad deseados |
El alcance de aplicación es limitado. Solo puede especificar valores para las propiedades del Thing Specification Language (TSL) de un dispositivo. Antes de usar esta función, debe definir un modelo TSL para el dispositivo. Si desea especificar valores deseados para las propiedades TSL de un dispositivo, utilice esta función. Para ver más ejemplos, consulte Specify a desired property value to control the status of a bulb. |
|
Sombras de dispositivo |
El alcance de aplicación es amplio. Esta función es independiente de las propiedades TSL. Puede usarla para especificar datos de los dispositivos, como su estado. En la siguiente sección se describen escenarios específicos. Para obtener más información sobre cómo configurar sombras de dispositivo, consulte JSON format of device shadows. |
Escenarios
En los siguientes escenarios, puede utilizar la función de sombra de dispositivo para obtener los datos de estado enviados por los dispositivos y los datos de estado del dispositivo que desean las aplicaciones.
-
Las aplicaciones solicitan el estado del dispositivo.
Escenarios:
Un dispositivo se conecta y desconecta con frecuencia debido a inestabilidad en la red. En este caso, el dispositivo no puede procesar las solicitudes de las aplicaciones.
Varias aplicaciones podrían solicitar los datos de estado del dispositivo al mismo tiempo. El dispositivo no puede procesar las solicitudes simultáneas ni devolver respuestas a las aplicaciones.
Puede sincronizar el estado del dispositivo con la sombra en IoT Platform. Las aplicaciones pueden obtener los datos de estado más recientes from la sombra. De esta manera, las aplicaciones se desacoplan del dispositivo.
A continuación se muestra el proceso. Para obtener más información, consulte The device submits the status.
-
Las aplicaciones envían comandos para cambiar el estado del dispositivo.
Descripción: Un dispositivo está sin conexión, o se conecta y desconecta con frecuencia debido a inestabilidad en la red. En este caso, es posible que los comandos de las aplicaciones no lleguen al dispositivo.
Puede almacenar los comandos con marcas de tiempo en la sombra. Cuando el dispositivo se conecta, obtiene los comandos de la sombra y determina si debe procesarlos según las marcas de tiempo.
A continuación se muestra el proceso. Para obtener más información, consulte Applications change the device status, The device requests the shadow y The device deletes shadow properties.
Consultar y actualizar una sombra de dispositivo
Debe configurar la función de sombra de dispositivo para el dispositivo. Para obtener más información, consulte Device shadow.
Después de configurar el dispositivo y conectarlo a IoT Platform, puede consultar y actualizar el estado de la sombra del dispositivo en la consola de IoT Platform.
Inicie sesión en la consola de IoT Platform.
En la página Overview, busque la instancia que desea gestionar y haga clic en el ID o nombre de la instancia.
En el panel de navegación izquierdo, seleccione .
En la página Devices, busque el dispositivo que desea gestionar y haga clic en View en la columna Actions. Aparecerá la página Device Details.
-
Haga clic en la pestaña Device Shadow. En esta pestaña, puede consultar la sombra de dispositivo enviada por el dispositivo.
-
Haga clic en Update Shadow. Introduzca la información de estado deseado en la sección
"desired".Para obtener información sobre el formato de las sombras de dispositivo, consulte JSON format of device shadows.
El dispositivo obtiene los datos de estado deseados al suscribirse a un topic específico. Si el dispositivo está en línea, IoT Platform envía el estado deseado al dispositivo en tiempo real.
Si el dispositivo está sin conexión, la sombra almacena en caché los datos de estado deseados. Cuando el dispositivo vuelve a conectarse, extrae los datos de estado deseados más recientes from IoT Platform.
Operaciones de API relacionadas
GetDeviceShadow: consulta una sombra de dispositivo.
UpdateDeviceShadow: actualiza una sombra de dispositivo.