변경 사항 Qt NFC

Qt 6의 변경 사항은 프레임워크를 더 효율적이고 사용하기 쉽게 만들기 위한 의도적인 노력의 결과입니다.

저희는 각 릴리스에서 모든 공개 API에 대해 바이너리 및 소스 호환성을 유지하기 위해 노력하고 있습니다. 하지만 Qt를 더 나은 프레임워크로 만들기 위한 노력의 일환으로 일부 변경 사항은 불가피했습니다.

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

새로운 기능 및 메서드

추가됨 QNdefRecord::clear()

이 메서드를 사용하여 NDEF 레코드를 지우십시오.

추가됨 QNdefFilter::match()

이 메서드를 사용하여 NDEF 레코드( 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 Smart Poster 사양에 따라, `type`은 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로 노출되어서는 안 됩니다. NFC 태그에서 데이터를 읽으려면 QNearFieldTarget::ndefMessageRead 또는 QNearFieldTarget::requestResponse 을 사용하십시오.

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 열거형은 getter 및 setter 메서드(QNearFieldManager::setTargetAccessModes() 및 QNearFieldManager::targetAccessModes())와 함께 제거되었습니다.

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

QNearFieldShareManager 및 QNearFieldShareTarget 제거

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

QML API 제거

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