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())

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

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()도 참조하세요 .