변경 사항 Qt NFC

Qt 6는 프레임워크를 보다 효율적이고 사용하기 쉽게 만들기 위한 의식적인 노력의 결과입니다.

각 릴리스에서 모든 공개 API에 대해 바이너리 및 소스 호환성을 유지하려고 노력합니다. 하지만 Qt를 더 나은 프레임워크로 만들기 위해 몇 가지 변경이 불가피했습니다.

이 주제에서는 이러한 변경 사항을 Qt NFC 에 요약하고 이를 처리하기 위한 지침을 제공합니다.

새로운 기능 및 메서드

추가됨 QNdefRecord::clear()

이 메서드를 사용하여 NDEF 레코드를 지웁니다.

추가됨 QNdefFilter::match()

QNdefMessage 이 주어진 필터와 일치하는지 확인하려면 이 메서드를 사용합니다. 일치하면 true, 일치하지 않으면 false 을 반환합니다.

확장됨 QNearFieldTarget::Type

열거형이 두 가지 유형으로 확장되었습니다:

• QNearFieldTarget::NfcTagType4A
• QNearFieldTarget::NfcTagType4B

기능 및 메서드 변경 사항

QNearFieldManager::isAvailable() 이름 변경

QNearFieldManager::isAvailable() 이 QNearFieldManager::isEnabled()로 이름이 변경되었습니다.

에 액세스 메서드 인수가 추가되었습니다. QNearFieldManager::isSupported

accessMethod 인수를 통해 특정 기능이 지원되는지 확인할 수 있습니다. 이는 플랫폼이나 운영 체제 버전에 따라 다른 옵션을 지원할 수 있기 때문에 중요합니다.

에 액세스 메서드 인수를 추가했습니다. QNearFieldManager::startTargetDetection

accessMethod 인수를 사용하면 지정된 액세스 방법으로 NFC 태그를 검색할 수 있습니다.

QNdefNfcSmartPosterRecord::typeInfo 을 QByteArray 으로 변경했습니다. QString

NDEF 스마트 포스터 사양에 따르면 이 유형은 UTF-8 형식의 문자열입니다. 이는 QNdefNfcSmartPosterRecord::typeInfo() 및 QNdefNfcSmartPosterRecord::setTypeInfo() 메서드에 영향을 줍니다.

반환 유형 업데이트 QNdefFilter::appendRecord

QNdefFilter::appendRecord 이제 입력 매개변수의 기본 유효성 검사를 수행하고 레코드가 필터에 추가되었는지 여부를 나타내는 부울 값을 반환합니다.

제거된 기능 및 메서드

제거된 QNearFieldTarget::url

이 메서드는 QNearFieldTarget 의 기존 하위 클래스에서 구현되지 않았습니다.

QNearFieldTarget::sendCommands 제거됨

Qt 5에서는 이 메서드가 중간 명령의 결과를 추적하는 방법을 제공하지 않았기 때문에 그다지 유용하지 않았습니다. 일반적으로 추가 명령은 이전 명령이 성공적으로 실행된 경우에만 전송하면 됩니다.

올바른 접근 방식은 수동으로 명령 대기열을 생성하고 QNearFieldTarget::sendCommand 을 사용하여 명령을 보내고 QNearFieldTarget::requestCompleted 또는 QNearFieldTarget::error 을 사용하여 각 명령의 결과를 개별적으로 처리하는 것입니다.

QNearFieldTarget::keepConnection 제거됨

QNearFieldTarget::keepConnection() 및 QNearFieldTarget::setKeepConnection() 메서드가 제거되었습니다. 지금은 연결 유지가 기본 동작입니다.

QNearFieldTarget::isProcessingCommand 제거됨

이 메서드는 구현되지 않았으며 항상 false 을 반환했습니다.

QNearFieldTarget::setResponseForRequest를 비공개 API로 만들었습니다.

이 메서드는 공개 API로 노출되어서는 안 됩니다. QNearFieldTarget::ndefMessageRead 또는 QNearFieldTarget::requestResponse 을 사용하여 NFC 태그에서 데이터를 읽습니다.

제거된 QNearFieldTarget::handleResponse

이 메서드는 비공개 API가 된 QNearFieldManager::setResponseForRequest 로 호출을 전달하기 때문에 제거되었습니다.

QNearFieldTarget::reportError를 비공개 API로 만들었습니다.

QNearFieldTarget::error 신호를 대신 사용할 수 있습니다.

QNearFieldTarget::ndefMessagesWritten 신호 제거

QNearFieldTarget::requestCompleted 신호는 NDEF 메시지와 사용자 지정 명령 모두에 사용됩니다. id 매개 변수를 사용하여 어떤 요청이 실제로 완료되었는지 확인할 수 있습니다.

제거된 QNearFieldManager::(un)registerNdefMessageHandler

QNearFieldTarget::registerNdefMessageHandler 및 QNearFieldTarget::unregisterNdefMessageHandler 메서드가 제거되었습니다.

QNearFieldTarget::ndefMessageRead() 및 QNdefFilter::match()를 사용하여 NDEF 메시지를 감지하고 필요한 메시지를 필터링하세요.

QNearFieldManager::TargetAccessModes 제거됨

TargetAccessModes 열거형은 게터 및 세터 메서드(QNearFieldManager::setTargetAccessModes() 및 QNearFieldManager::targetAccessModes())와 함께 제거되었습니다.

이 기능은 Android 및 iOS 플랫폼에서 지원되지 않습니다.

QNearFieldShareManager 및 QNearFieldShareTarget이 제거되었습니다.

NFC를 통한 파일 공유는 Android에서 API 29에서 더 이상 사용되지 않습니다. 대신 다른 기술을 사용해야 합니다.

QML API 제거

QML API에 대한 지원이 중단되었습니다.