QNearFieldManager Class

멤버 함수 문서

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

parent 를 사용하여 새로운 근거리 필드 관리자를 생성합니다.

[virtual noexcept] QNearFieldManager::~QNearFieldManager()

근거리 필드 관리자를 파괴합니다.

[signal] void QNearFieldManager::adapterStateChanged(QNearFieldManager::AdapterState state)

이 신호는 NFC 어댑터의 state 가 변경될 때마다 전송됩니다.

[since 6.2] bool QNearFieldManager::isEnabled() const

장치에 NFC 어댑터가 있고 이 어댑터가 켜져 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

isSupported()도 참조하십시오 .

bool QNearFieldManager::isSupported(QNearFieldTarget::AccessMethod accessMethod = QNearFieldTarget::AnyAccess) const

기본 장치가 NFC 어댑터를 가지고 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다. accessMethod 가 주어지면, 이 함수는 NFC 어댑터가 주어진 accessMethod 를 지원하는 경우에만 true 를 반환합니다.

isEnabled()도 참조하십시오 .

[since 6.2] void QNearFieldManager::setUserInformation(const QString &message)

시스템이 사용자에게 표시할 메시지를 설정합니다. 대상 감지 기능이 실행 중일 경우, ` message `가 즉시 업데이트되며 진행 상황 메시지로 사용할 수 있습니다. 오류 메시지 없이 ` startTargetDetection()`를 호출하기 직전에 설정된 마지막 메시지가 성공 메시지로 사용됩니다. 대상 감지가 실행 중이 아닌 경우, 다음 감지가 시작될 때 ` message `가 초기 메시지로 사용됩니다. 기본적으로 사용자에게는 메시지가 표시되지 않습니다.

이 함수는 Qt 6.2에서 도입되었습니다.

startTargetDetection() 및 stopTargetDetection()도 참조하십시오 .

bool QNearFieldManager::startTargetDetection(QNearFieldTarget::AccessMethod accessMethod)

타겟 감지를 시작하며, 타겟 감지가 성공적으로 시작되면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다. 타겟이 근접 범위에 들어오면 ` targetDetected()` 신호가 발생합니다. 지정된 ` accessMethod `을 가진 태그만 보고됩니다. 타겟 감지는 ` stopTargetDetection()`이 호출될 때까지 계속됩니다.

다른 accessMethod 를 가진 타겟을 감지하려면, 먼저 stopTargetDetection()를 호출해야 합니다.

stopTargetDetection()도 참조하십시오 .

void QNearFieldManager::stopTargetDetection(const QString &errorMessage = QString())

타겟 감지를 중지합니다. startTargetDetection()이 다시 호출될 때까지 targetDetected() 신호는 더 이상 발신되지 않습니다. 이전에 감지된 타겟은 여전히 유효합니다.

errorMessage 가 제공된 경우, 이는 애플리케이션의 목표가 달성되지 않았음을 시스템에 알리는 신호입니다. 사용자에게 errorMessage 와 이에 해당하는 오류 아이콘이 표시됩니다. 빈 errorMessage 를 사용하여 이 함수를 호출하면 작업이 성공적으로 종료된 것으로 간주되며, 그렇지 않은 경우 errorMessage 를 이 함수에 전달해야 합니다.

setUserInformation()도 참조하십시오 .

[signal] void QNearFieldManager::targetDetected(QNearFieldTarget *target)

이 신호는 표적이 감지될 때마다 발생합니다. ‘ target ’ 매개변수는 감지된 표적을 나타냅니다.

이 신호는 감지된 모든 대상에 대해 발생합니다.

QNearFieldManager target 의 소유권은 유지되지만, 의 소멸자가 호출될 때까지는 파괴되지 않습니다. ()를 호출하여 소유권을 양도할 수 있습니다. QNearFieldManager setParent

이 신호에 연결된 슬롯에서 target 를 삭제하지 말고, 대신 deleteLater()를 호출하십시오.

targetLost()도 참조하십시오 .

[signal, since 6.2] void QNearFieldManager::targetDetectionStopped()

이 신호는 대상 감지가 중지될 때마다 발생합니다.

이 함수는 Qt 6.2에서 도입되었습니다.

[signal] void QNearFieldManager::targetLost(QNearFieldTarget *target)

이 신호는 타겟이 근접 범위 밖으로 이동할 때마다 발생합니다. ‘ target ’ 매개변수는 감지되지 않는 타겟을 나타냅니다.

이 신호에 연결된 슬롯에서 ` target `을 삭제하지 말고, 대신 ` deleteLater()`를 사용하십시오.

QNearFieldTarget::disconnected()도 참조하십시오 .