QMqttClient Class

멤버 함수 문서

[explicit] QMqttClient::QMqttClient(QObject *parent = nullptr)

지정된 parent 으로 새 MQTT 클라이언트 인스턴스를 생성합니다.

[override virtual noexcept] QMqttClient::~QMqttClient()

MQTT 클라이언트를 삭제합니다. MQTT 클라이언트가 MQTT 브로커에서 아직 연결 해제되지 않은 경우 자동으로 연결이 해제됩니다.

void QMqttClient::authenticate(const QMqttAuthenticationProperties &prop)

인증 요청을 브로커에 전송합니다. prop 인증 요청을 이행하는 데 필요한 정보를 지정합니다.

이 함수는 QMqttClient::authenticationRequested 신호가 전송된 후에만 호출해야 합니다.

authenticationRequested() 및 authenticationFinished()도 참조하세요 .

[signal] void QMqttClient::authenticationFinished(const QMqttAuthenticationProperties &p)

이 신호는 확장 인증이 완료된 후 전송됩니다. p 인증 프로세스에 대한 사용 가능한 세부 정보를 지정합니다.

인증 성공 후 QMqttClient::connected 이 전송됩니다.

authenticationRequested() 및 authenticate()도 참조하세요 .

[signal] void QMqttClient::authenticationRequested(const QMqttAuthenticationProperties &p)

이 신호는 클라이언트가 QMqttClient::connectToHost 또는 QMqttClient::connectToHostEncrypted 을 호출한 후 연결이 설정되기 전에 전송됩니다. 확장 인증에서 브로커는 QMqttClient::authenticate 을 호출하여 제공해야 하는 추가 세부 정보를 요청할 수 있습니다. p 은 브로커가 제공하는 속성을 지정합니다.

authenticationFinished() 및 authenticate()도 참조하세요 .

[signal] void QMqttClient::brokerSessionRestored()

이 신호는 클라이언트가 cleanSession 속성을 false 으로 설정한 브로커에 성공적으로 연결하고 브로커가 세션을 복원했을 때 발생합니다.

클라이언트가 이전에 동일한 clientId 을 사용하여 연결한 적이 있는 경우 세션을 복원할 수 있습니다.

[invokable] void QMqttClient::connectToHost()

MQTT 브로커에 대한 연결을 시작합니다.

void QMqttClient::connectToHostEncrypted(const QSslConfiguration &conf)

MQTT 브로커에 대한 암호화된 연결을 시작합니다.

conf 연결에 사용할 SSL 구성을 지정합니다.

[signal] void QMqttClient::connected()

이 신호는 연결이 설정되면 발신됩니다.

QMqttConnectionProperties QMqttClient::connectionProperties() const

클라이언트가 브로커에 요청한 연결 속성을 반환합니다.

setConnectionProperties()도 참조하세요 .

[invokable] void QMqttClient::disconnectFromHost()

MQTT 브로커와의 연결을 끊습니다.

[signal] void QMqttClient::disconnected()

이 신호는 연결이 닫혔을 때 발생합니다. disconnectFromHost ()가 호출되거나 브로커가 연결을 끊을 때 연결이 닫힐 수 있습니다.

QMqttLastWillProperties QMqttClient::lastWillProperties() const

마지막 유언장 속성을 반환합니다.

setLastWillProperties()도 참조하세요 .

[signal] void QMqttClient::messageReceived(const QByteArray &message, const QMqttTopicName &topic = QMqttTopicName())

이 신호는 새 메시지가 수신되면 발신됩니다. 메시지 카테고리는 topic 으로 지정되며 내용은 message 입니다.

[signal] void QMqttClient::messageSent(qint32 id)

publish() 함수를 통해 전송된 메시지가 브로커에 수신되었음을 나타냅니다. id 는 publish() 에서 반환하는 것과 동일하여 메시지 상태를 추적하는 데 도움이 됩니다.

[signal] void QMqttClient::messageStatusChanged(qint32 id, QMqtt::MessageStatus s, const QMqttMessageStatusProperties &properties)

id s 은 메시지의 새 상태를 지정하고 은 서버에서 제공하는 추가 속성을 지정합니다. properties

[signal] void QMqttClient::pingResponseReceived()

이 신호는 브로커가 requestPing() 호출 또는 keepAlive() 핑 메시지에 응답하고 연결이 여전히 유효할 때 전송됩니다.

[invokable] qint32 QMqttClient::publish(const QMqttTopicName &topic, const QByteArray &message = QByteArray(), quint8 qos = 0, bool retain = false)

지정된 topic 으로 브로커에 message 을 게시합니다. qos 은 메시지 전송에 필요한 QoS 수준을 지정합니다.

retain 을 true 으로 설정하면 다른 클라이언트가 연결하여 메시지를 수신할 수 있도록 메시지가 브로커에 유지됩니다.

내부적으로 메시지를 식별하는 데 사용되는 ID를 반환합니다.

[invokable] qint32 QMqttClient::publish(const QMqttTopicName &topic, const QMqttPublishProperties &properties, const QByteArray &message = QByteArray(), quint8 qos = 0, bool retain = false)

지정된 properties 및 topic 와 함께 message 를 브로커에 게시합니다. qos 는 메시지 전송에 필요한 QoS 수준을 지정합니다.

retain 을 true 으로 설정하면 다른 클라이언트가 연결하여 메시지를 수신할 수 있도록 메시지가 브로커에 유지됩니다.

내부적으로 메시지를 식별하는 데 사용되는 ID를 반환합니다.

bool QMqttClient::requestPing()

브로커에 핑 메시지를 보내고 응답을 기대합니다.

연결이 활성화되어 있고 autoKeepAlive 이 true 인 경우 클라이언트가 이 프로세스를 관리해야 하므로 이 함수를 호출하면 실패합니다.

requestPing() 을 수동으로 사용하려면 연결이 활성화되어 있는 동안 keepAlive 간격 내에 매번 호출해야 합니다.

핑이 성공했는지 확인하려면 pingResponseReceived() 신호에 연결합니다.

핑 요청을 보낼 수 있으면 true 을 반환합니다.

pingResponseReceived(), autoKeepAlive() 및 keepAlive()도 참조하세요 .

QMqttServerConnectionProperties QMqttClient::serverConnectionProperties() const

연결 시도 후 브로커가 반환한 QMqttServerConnectionProperties 을 반환합니다.

이는 QMqttClient::setConnectionProperties 에서 설정한 클라이언트 측 연결 속성이 브로커에 의해 수락되었는지 확인하는 데 사용할 수 있습니다. 또한 연결 시도가 실패한 경우 연결 진단에 사용할 수 있습니다.

connectionProperties()도 참조하세요 .

void QMqttClient::setConnectionProperties(const QMqttConnectionProperties &prop)

연결 속성을 prop 로 설정합니다. QMqttConnectionProperties 을 사용하여 서버에 특정 기능 집합을 사용하도록 요청할 수 있습니다. 연결 요청 후 QMqttClient::serverConnectionProperties 을 호출하여 서버 응답을 얻을 수 있습니다.

connectionProperties()도 참조하세요 .

void QMqttClient::setLastWillProperties(const QMqttLastWillProperties &prop)

마지막 유언장 속성을 prop 로 설정합니다. QMqttLastWillProperties 을 사용하면 브로커에 저장된 마지막 유언장 메시지에 대한 추가 기능을 설정할 수 있습니다.

lastWillProperties()도 참조하세요 .

void QMqttClient::setTransport(QIODevice *device, QMqttClient::TransportType transport)

전송을 device 로 설정합니다. 전송은 소켓 유형이거나 QIODevice 에서 파생될 수 있으며 transport 으로 지정됩니다.

transport()도 참조하세요 .

QMqttSubscription *QMqttClient::subscribe(const QMqttTopicFilter &topic, quint8 qos = 0)

topic 에서 알림을 받도록 새 구독을 추가합니다. qos 매개변수는 보안 메시지가 수신되는 수준을 지정합니다. 사용 가능한 QoS 수준에 대한 자세한 내용은 서비스 품질을 참조하세요.

이 함수는 QMqttSubscription 에 대한 포인터를 반환합니다. 동일한 주제를 두 번 구독하는 경우 반환 값은 동일한 구독 인스턴스를 가리킵니다. MQTT 클라이언트가 구독의 소유자입니다.

QMqttSubscription *QMqttClient::subscribe(const QMqttTopicFilter &topic, const QMqttSubscriptionProperties &properties, quint8 qos = 0)

topic 에서 알림을 수신할 새 구독을 추가합니다. properties 매개변수는 브로커에서 유효성을 검사할 추가 구독 속성을 지정합니다. qos 매개변수는 보안 메시지가 수신되는 수준을 지정합니다. 사용 가능한 QoS 수준에 대한 자세한 내용은 서비스 품질을 참조하세요.

이 함수는 QMqttSubscription 에 대한 포인터를 반환합니다. 동일한 토픽이 두 번 구독된 경우 반환 값은 동일한 구독 인스턴스를 가리킵니다. MQTT 클라이언트가 구독의 소유자입니다.

QIODevice *QMqttClient::transport() const

브로커와의 통신에 사용된 전송을 반환합니다.

setTransport()도 참조하세요 .

void QMqttClient::unsubscribe(const QMqttTopicFilter &topic)

topic 에서 구독을 취소합니다. subscribe()을 호출하여 구독한 내역에 대해서는 알림이 전송되지 않습니다.

void QMqttClient::unsubscribe(const QMqttTopicFilter &topic, const QMqttUnsubscriptionProperties &properties)

topic 에서 구독을 취소합니다. subscribe()을 호출하여 구독한 모든 알림은 전송되지 않습니다. properties 는 브로커에 전달할 추가 사용자 속성을 지정합니다.