QNearFieldTarget Class

멤버 함수 문서

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

parent 를 사용하여 새로운 근거리 타겟을 생성합니다.

[virtual noexcept] QNearFieldTarget::~QNearFieldTarget()

근거리 표적을 파괴합니다.

QNearFieldTarget::AccessMethods QNearFieldTarget::accessMethods() const

이 근거리 대상에서 지원하는 액세스 메서드를 반환합니다.

bool QNearFieldTarget::disconnect()

타깃과의 연결을 닫아 다른 인스턴스에서 타깃과 통신할 수 있도록 합니다. 또한 QNearFieldTarget 가 소멸되면 연결이 닫힙니다. 명령을 처리하거나 NDEF 메시지를 읽거나 쓰기 위해서는 타깃 장치와의 연결이 (재)설정됩니다.

기존 연결이 성공적으로 종료된 경우에만 ` true `를 반환하며, 그렇지 않은 경우 ` false`를 반환합니다.

[signal] void QNearFieldTarget::disconnected()

이 신호는 근거리 표적이 근접 범위 밖으로 벗어나면 발생합니다.

[signal] void QNearFieldTarget::error(QNearFieldTarget::Error error, const QNearFieldTarget::RequestId &id)

이 신호는 id 요청을 처리하는 과정에서 오류가 발생했을 때 발생합니다. error 매개변수는 해당 오류를 설명합니다.

bool QNearFieldTarget::hasNdefMessage()

근거리 통신 대상에 NDEF 메시지가 하나 이상 저장되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

int QNearFieldTarget::maxCommandLength() const

sendCommand 를 통해 전송할 수 있는 최대 바이트 수를 반환합니다. 대상이 태그 유형별 명령어 전송을 지원하지 않는 경우 0이 반환됩니다.

sendCommand()도 참조하십시오 .

[signal] void QNearFieldTarget::ndefMessageRead(const QNdefMessage &message)

이 신호는 대상에서 완전한 NDEF message 가 읽혀졌을 때 발생합니다.

readNdefMessages()도 참조하십시오 .

QNearFieldTarget::RequestId QNearFieldTarget::readNdefMessages()

근거리 통신 대상에 저장된 NDEF 메시지를 읽기 시작합니다. 요청의 완료 상태를 추적하는 데 사용할 수 있는 요청 ID를 반환합니다. 대상이 NDEF 메시지 읽기를 지원하지 않는 경우, 유효하지 않은 요청 ID가 반환됩니다.

각 NDEF 메시지마다 ` ndefMessageRead()` 신호가 발생합니다. 모든 NDEF 메시지 읽기가 완료되면 ` requestCompleted()` 신호가 발생합니다. 오류가 발생하면 ` error()` 신호가 발생합니다.

[signal] void QNearFieldTarget::requestCompleted(const QNearFieldTarget::RequestId &id)

이 신호는 id 요청이 완료되었을 때 발생합니다.

sendCommand()도 참조하십시오 .

QVariant QNearFieldTarget::requestResponse(const QNearFieldTarget::RequestId &id) const

id 요청에 대한 디코딩된 응답을 반환합니다. 요청이 알려지지 않았거나 아직 완료되지 않은 경우, 유효하지 않은 QVariant 가 반환됩니다.

QNearFieldTarget::RequestId QNearFieldTarget::sendCommand(const QByteArray &command)

근거리 대상에게 ` command `를 전송합니다. 요청의 완료 상태를 추적하는 데 사용할 수 있는 요청 ID를 반환합니다. 대상이 태그 유형별 명령어 전송을 지원하지 않는 경우, 유효하지 않은 요청 ID가 반환됩니다.

요청이 성공적으로 완료되면 ` requestCompleted()` 신호가 발신되며, 그렇지 않은 경우 ` error()` 신호가 발신됩니다.

요청이 성공적으로 완료되면 requestResponse() 함수를 통해 응답을 가져올 수 있습니다. 이 요청의 응답은 QByteArray 가 됩니다.

requestCompleted() 및 waitForRequestCompleted()도 참조하십시오 .

QNearFieldTarget::Type QNearFieldTarget::type() const

이 근거리 대상의 태그 유형을 반환합니다.

QByteArray QNearFieldTarget::uid() const

근거리 타겟의 UID를 반환합니다.

QNearFieldTarget::AccessMethod도 참조하십시오 .

bool QNearFieldTarget::waitForRequestCompleted(const QNearFieldTarget::RequestId &id, int msecs = 5000)

id 요청이 완료될 때까지 최대 msecs 밀리초 동안 대기합니다. 요청이 성공적으로 완료되고 requestCompleted() 시그널이 발생하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

QNearFieldTarget::RequestId QNearFieldTarget::writeNdefMessages(const QList<QNdefMessage> &messages)

messages 에 포함된 NDEF 메시지를 대상에 기록합니다. 요청의 완료 상태를 추적하는 데 사용할 수 있는 요청 ID를 반환합니다. 대상이 NDEF 메시지 기록을 지원하지 않는 경우 유효하지 않은 요청 ID가 반환됩니다.

쓰기 작업이 성공적으로 완료되면 requestCompleted() 신호가 발생하며, 그렇지 않은 경우 error() 신호가 발생합니다.