Uso de sombras en dispositivos

En esta sección se describen las comunicaciones de dispositivos con sombras mediante mensajes MQTT, el método preferido para que los dispositivos se comuniquen con el servicio Device Shadow de AWS IoT.

Las comunicaciones de sombra emulan un modelo de solicitud/respuesta utilizando el modelo de comunicación de publicación/suscripción de MQTT. Cada acción de sombra consta de un tema de solicitud, un tema de respuesta correcta (accepted) y un tema de respuesta de error (rejected).

Si desea que las aplicaciones y servicios puedan determinar si un dispositivo está conectado, consulte Detección de un dispositivo conectado.

Los ejemplos de esta sección utilizan una forma abreviada del tema, de modo que ShadowTopicPrefix puede hacer referencia a una sombra con nombre o sin nombre, como se describe en esta tabla.

Las sombras pueden ser con nombre o sin nombre (clásico). Los temas utilizados por cada uno solo difieren en el prefijo del tema. Esta tabla muestra el prefijo de tema utilizado por cada tipo de sombra.

Para crear un tema completo, seleccione el ShadowTopicPrefix para el tipo de sombra al que desea hacer referencia, reemplace thingName y shadowName si procede, con sus valores correspondientes y, a continuación, anexe el código auxiliar del tema como se muestra en la tabla siguiente. Recuerde que los temas distinguen entre mayúsculas y minúsculas.

Consulte Temas de sombra para obtener más información acerca de los temas reservados para las sombras.

Inicialización del dispositivo en la primera conexión a AWS IoT

Después de que un dispositivo se registre con AWS IoT, debe suscribirse a estos mensajes MQTT para las sombras que admite.

Después de suscribirse a los mensajes de la tabla anterior para cada sombra, el dispositivo debe probar si las sombras que admite ya se han creado publicando un tema /get en cada sombra. Si se recibe un mensaje /get/accepted, el cuerpo del mensaje contiene el documento de sombra, que el dispositivo puede utilizar para inicializar su estado. Si se recibe un mensaje /get/rejected, la sombra debe crearse publicando un mensaje /update con el estado actual del dispositivo.

Por ejemplo, supongamos que tiene un objeto My_IoT_Thing sin sombras, ni clásicas ni con nombre. Si ahora publica una solicitud /get en el tema reservado $aws/things/My_IoT_Thing/shadow/get, se devolverá un error sobre el tema $aws/things/My_IoT_Thing/shadow/get/rejected, ya que el objeto no tiene sombras. Para resolver este error, publique primero un mensaje /update utilizando el tema $aws/things/My_IoT_Thing/shadow/update con el estado actual del dispositivo, como la siguiente carga.

{
	"state": {
		"reported": {
			"welcome": "aws-iot",
			"color": "yellow"
		}
	}
}

Ahora se creará una sombra clásica para el objeto y el mensaje se publicará en el tema $aws/things/My_IoT_Thing/shadow/update/accepted. Si publica en el tema $aws/things/My_IoT_Thing/shadow/get, se devuelve una respuesta al tema $aws/things/My_IoT_Thing/shadow/get/accepted con el estado del dispositivo.

En el caso de las sombras con nombre, debe crear primero la sombra con nombre o publicar una actualización con el nombre de la sombra antes de utilizar la solicitud get. Por ejemplo, para crear una sombra con nombre namedShadow1, publique primero la información del estado del dispositivo en el tema $aws/things/My_IoT_Thing/shadow/name/namedShadow1/update. Para recuperar la información de estado, use la solicitud /get para la sombra con nombre ($aws/things/My_IoT_Thing/shadow/name/namedShadow1/get).

Procesamiento de mensajes mientras el dispositivo está conectado a AWS IoT

Mientras un dispositivo está conectado a AWS IoT, puede recibir mensajes /update/delta, y el estado del dispositivo debe coincidir siempre con los cambios en sus sombras; para ello debe hacer lo siguiente:

Mientras un dispositivo está conectado, debe publicar estos mensajes cuando se indique.

Procesamiento de mensajes cuando el dispositivo se vuelve a conectar a AWS IoT

Cuando un dispositivo con una o más sombras se conecta a AWS IoT, debe sincronizar su estado con el de todas las sombras que admite del siguiente modo: