기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

디바이스에서 섀도우 사용

이 섹션에서는 디바이스가 Device Shadow 서비스와 통신하는 데 선호되는 방법인 MQTT 메시지를 사용하여 AWS IoT 섀도우와 디바이스 통신을 설명합니다.

섀도우 통신은의 request/response model using the publish/subscribe 통신 모델을 에뮬레이션합니다MQTT. 모든 섀도우 작업은 요청 주제, 성공한 응답 주제(accepted) 및 오류 응답 주제(rejected)로 구성됩니다.

앱 및 서비스에서 디바이스가 연결되어 있는지 여부를 확인할 수 있도록 하려면 디바이스 연결 상태 감지 단원을 참조하세요.

이 섹션의 예제에서는이 표에 설명된 대로가 명명된 또는 명명되지 않은 섀도우를 참조할 ShadowTopicPrefix 수 있는 약식 형태의 주제를 사용합니다.

섀도우는 명명되거나 명명되지 않을(클래식) 수 있습니다. 각 섀도우에 사용되는 주제는 주제 접두사만 다릅니다. 이 표에서는 각 섀도우 유형에서 사용하는 주제 접두사를 보여줍니다.

전체 주제를 생성하려면 참조할 섀도우 유형에 대해 ShadowTopicPrefix를 선택하고 thingName 및 shadowName(해당하는 경우)을 해당 값으로 바꾸고 다음 표에 표시된 대로 주제 스텁을 추가합니다. 주제는 대/소문자를 구분합니다.

섀도우에 대해 예약된 주제에 대한 자세한 내용은 섀도우 주제 단원을 참조하세요.

에 처음 연결할 때 디바이스 초기화 AWS IoT

디바이스가에 등록한 후에는 지원하는 섀도우에 대해 이러한 MQTT 메시지를 구독 AWS IoT해야 합니다.

각 섀도우에 대해 위 표의 메시지를 구독한 후 디바이스는 각 섀도우에 /get 주제를 게시하여 지원하는 섀도우가 이미 생성되었는지 테스트해야 합니다. /get/accepted 메시지가 수신되면 메시지 본문에 섀도우 문서가 포함되며, 디바이스에서 이 문서를 사용하여 해당 상태를 초기화할 수 있습니다. /get/rejected 메시지가 수신되면 현재 디바이스 상태와 함께 /update 메시지를 게시하여 섀도우를 생성해야 합니다.

예를 들어, 클래식 섀도우나 명명된 섀도우가 없는 사물 My_IoT_Thing이 있다고 가정합니다. 이제 예약된 주제 $aws/things/My_IoT_Thing/shadow/get에 대한 /get 요청을 게시하면 사물에 섀도우가 없기 때문에 $aws/things/My_IoT_Thing/shadow/get/rejected 주제에 대한 오류가 반환됩니다. 이 오류를 해결하려면 먼저 다음 페이로드와 같은 현재 디바이스 상태를 포함하는 $aws/things/My_IoT_Thing/shadow/update 주제를 사용하여 /update 메시지를 게시합니다.

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

이제 사물에 대한 클래식 섀도우가 생성되고 메시지가 $aws/things/My_IoT_Thing/shadow/update/accepted 주제에 게시됩니다. 주제 $aws/things/My_IoT_Thing/shadow/get에 게시하는 경우 디바이스 상태와 함께 $aws/things/My_IoT_Thing/shadow/get/accepted 주제에 대한 응답이 반환됩니다.

명명된 섀도우의 경우 get 요청을 사용하기 전에 먼저 명명된 섀도우를 생성하거나 섀도우 이름이 포함된 업데이트를 게시해야 합니다. 예를 들어 명명된 섀도우 namedShadow1을 생성하려면 먼저 디바이스 상태 정보를 주제 $aws/things/My_IoT_Thing/shadow/name/namedShadow1/update에 게시합니다. 상태 정보를 검색하려면 명명된 섀도우 $aws/things/My_IoT_Thing/shadow/name/namedShadow1/get에 대한 /get 요청을 사용합니다.

디바이스가 연결된 동안 메시지 처리 AWS IoT

디바이스가 연결되어 있는 동안 /update/delta 메시지를 수신할 AWS IoT수 있으며 다음을 통해 디바이스 상태를 섀도우의 변경 사항과 일치해야 합니다.

디바이스가 연결되어 있는 동안 표시된 경우 이러한 메시지를 게시해야 합니다.

디바이스가에 다시 연결될 때 메시지 처리 AWS IoT

하나 이상의 섀도우가 있는 디바이스가 연결되면 다음을 통해 지원하는 모든 섀도우의 상태와 동기화 AWS IoT해야 합니다.