azure-iothub package

IoT Hub 서비스 클라이언트는 Azure IoT Hub를 통해 디바이스와 통신하는 데 사용됩니다. 이를 통해 SDK 사용자는 다음을 수행할 수 있습니다.

• 디바이스에 클라우드-디바이스(명령이라고도 함)를 보냅니다. 명령은 IoT Hub에서 큐에 대기되고 디바이스가 연결된 경우에만 비동기적으로 전달됩니다. 디바이스당 50개의 명령만 큐에 대기할 수 있습니다.
• 디바이스에서 직접 메서드를 호출합니다(디바이스가 현재 연결된 경우에만 작동합니다. 디바이스와 통신하는 동기 방식임).
• 이전 명령에 대해 디바이스에서 보낸 피드백 메시지를 수신 대기합니다.
• 디바이스에서 파일 업로드 알림을 수신 대기합니다.

사용자는 팩터리 메서드 중 하나를 호출하여 새 Client 인스턴스를 만들어야 합니다. FromConnectionString 또는 SharedAccessSignature IoT Hub 서비스 클라이언트를 만듭니다.

디바이스 ID 레지스트리 API와 함께 사용할 디바이스의 표현을 만듭니다.

디바이스 ID 레지스트리 디바이스에 대한 부분 설명이 포함된 JSON 개체에서 직접 작동할 수 있으므로 이 클래스는 사용되지 않습니다. 그 위에 처음에이 클래스는 symmetricKey 속성 이름에 오타와 함께 제공 되었다 (그것은 파스칼 대/소문자 대신 낙타 대/소문자). SDK는 기존 코드를 중단하지 않기 위해 이 클래스를 유지하지만 향후 주 버전 업데이트에서 제거될 예정이며 고객은 대신 일반 JSON 개체를 사용해야 합니다.

IoT Hub 인스턴스에서 장기 실행 작업을 만들고, 업데이트하고, 모니터링하고, 취소하고, 기존 작업을 쿼리하는 메서드를 제공합니다. Azure IoT Hub의 작업 API를 사용하면 여러 디바이스에서 직접 메서드 호출 및 쌍 업데이트를 예약할 수 있습니다.

SDK 사용자는 팩터리 메서드 fromConnectionString(string) 및 fromSharedAccessSignature(string)사용하여 JobClient 인스턴스를 만들어야 합니다.

레지스트리 클래스는 IoT Hub 디바이스 ID 서비스에 대한 액세스를 제공합니다. SDK 사용자는 팩터리 메서드 중 하나인 fromConnectionString 또는 SharedAccessSignature 사용하여 이 클래스를 인스턴스화해야 합니다.

디바이스 ID 레지스트리 작업에 사용되는 프로토콜은 HTTPS입니다.

서비스 클라이언트에서 사용하는 전송 클래스는 보안(TLS) 소켓을 통해 AMQP 프로토콜을 사용하여 Azure IoT Hub에 연결하는 데. 이 클래스는 직접 사용해서는 안 되며 대신 Client 팩터리 메서드 중 하나인 fromConnectionString 또는 fromSharedAccessSignature전달되어야 합니다.

서비스 클라이언트에서 사용하는 전송 클래스는 보안 websocket을 통해 AMQP 프로토콜을 사용하여 Azure IoT Hub에 연결하는 데. 이 클래스는 직접 사용해서는 안 되며 대신 Client 팩터리 메서드 중 하나인 fromConnectionString 또는 fromSharedAccessSignature전달되어야 합니다.

생성자에 전달된 연결 문자열을 기반으로 공유 액세스 서명을 만듭니다. 이 클래스는 SDK의 프로토콜 계층에서 각 요청에 인증 헤더를 추가하는 데 사용됩니다.

디바이스 쌍은 Azure IoT Hub에 의해 저장되고 디바이스가 오프라인인 경우에도 사용할 수 있는 디바이스의 상태를 설명하는 문서입니다. 다음 3개 섹션을 중심으로 빌드됩니다.

• 태그: 서비스 쪽에서만 액세스할 수 있는 키/값 쌍
• Desired 속성: 서비스에 의해 업데이트되고 디바이스에서 수신됨
• Reported 속성: 디바이스에서 업데이트되고 서비스에서 수신합니다.

가능성이 있지만 desired 및 reported 속성은 일치할 필요가 없으며 필요한 경우 이러한 두 컬렉션을 동기화하는 논리는 SDK 사용자에게 맡깁니다.

자세한 내용은 Device Twins이해하세요.

특정 디바이스에 대한 Twin 가져오는 권장 방법은 getTwin(string, HttpResponseCallback<Twin>) 방법을 사용하는 것입니다.

Configuration 개체는 단일 디바이스의 구성을 나타내거나 targetCondition을 기반으로 디바이스에 구성으로 적용할 수 있는 배포를 나타낼 수 있습니다.

직접 메서드(디바이스 메서드라고도 함)와 함께 사용할 수 있는 매개 변수에 대해 설명합니다.