Класс QNearFieldShareManager

Класс QNearFieldShareManager управляет всеми взаимодействиями, связанными с совместным использованием файлов и данных через NFC. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Функции публичного доступа

• 31 функция унаследованная от QObject

Сигналы

• 2 сигнала унаследованных от QObject

Статические члены публичного доступа

• 11 статических членов публичного доступа унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство унаследованное от QObject
• 1 слот публичного доступа унаследованный от QObject
• 9 защищенных функций унаследованных от QObject

Подробное описание

Класс QNearFieldShareManager управляет всеми взаимодействиями, связанными с совместным использованием файлов и данных через NFC.

Приложения могут обмениваться данными NDEF или содержимым файлов с помощью технологии NFC, подключив два устройства NFC друг к другу. QNearFieldShareManager предоставляет точку входа высокого уровня для доступа к этой функциональности.

Класс позволяет обмениваться как данными NDEF, так и/или файлами между двумя устройствами, вызвав метод setShareModes(). Этот метод указывает, будет ли производиться обмен данными NDEF и/или файлами. Сигнал targetDetected() генерируется каждый раз, когда обнаруживается целевой объект для обмена. С сигналом передаётся указатель QNearFieldShareTarget, который можно использовать для обмена как сообщением NDEF, так и одним или несколькими файлами.

Процесс обмена файлами через NFC включает в себя другие основополагающие транспортные средства связи, такие как Bluetooth или Wi-Fi Direct. Способ и типы используемых транспортных средств для передачи файлов зависят от реализации. Общее время, необходимое для передачи содержимого, зависит от максимальной скорости используемого транспорта. Обратите внимание, что процесс обмена сообщением/данными NDEF не требует использования других транспортных средств за пределами NFC.

В случае ошибки метод shareError() возвращает тип ошибки.

Платформы, которые не поддерживают обмен как данными NDEF, так и содержимым файлов, могут возвращать поддерживаемый поднабор в методе supportedShareModes(). Приложения, которые вызывают setShareModes() с недопустимым режимом, получат сигнал об ошибке с типом UnsupportedShareModeError.

Поскольку обмен данными через NFC фактически представляет собой канал данных между двумя процессами (одним отправителем и одним получателем), разработчик приложения должен создавать только один экземпляр QNearFieldShareManager на одно приложение. Это предотвращает возможность того, что разные части одного приложения попытаются потреблять данные, переданные через NFC.

Документация по типам членов

перечисление QNearFieldShareManager::ShareError

Это перечисление определяет тип ошибки обмена.

перечисление QNearFieldShareManager::ShareMode флаги QNearFieldShareManager::ShareModes

Это перечисление определяет тип содержимого, подлежащего обмену.

Тип ShareModes является псевдонимом для QFlags<ShareMode>. Он хранит комбинацию значений ShareMode с операцией ИЛИ.

Документация по функциям членов

QNearFieldShareManager::QNearFieldShareManager(QObject *parent = Q_NULLPTR)

Создаёт новый менеджер обмена ближнего поля с parent.

QNearFieldShareManager::~QNearFieldShareManager()

Уничтожает менеджер обмена ближнего поля.

[signal] void QNearFieldShareManager::error(QNearFieldShareManager::ShareError error)

Этот сигнал генерируется всякий раз, когда происходит ошибка, связанная с запросом на обмен.

void QNearFieldShareManager::setShareModes(ShareModes mode)

Инициализирует режим обмена NFC для обнаружения QNearFieldShareTarget для обмена данными и/или файлами. Вызовы этого метода перезапишут предыдущие режимы обмена.

Сигнал shareModesChanged() будет сгенерирован, когда режимы обмена отличаются от предыдущих режимов. Сигнал targetDetected() будет сгенерирован, если будет обнаружен целевой объект для обмена.

См. также shareModes().

QNearFieldShareManager::ShareError QNearFieldShareManager::shareError() const

Возвращает код ошибки, произошедшей.

QNearFieldShareManager::ShareModes QNearFieldShareManager::shareModes() const

Возвращает установленные режимы совместного использования.

См. также setShareModes().

[signal] void QNearFieldShareManager::shareModesChanged(QNearFieldShareManager::ShareModes modes)

Этот сигнал подаётся всякий раз, когда изменяются режимы совместного использования modes.

[static] QNearFieldShareManager::ShareModes QNearFieldShareManager::supportedShareModes()

Возвращает поддерживаемые NFC режимы совместного использования.

[signal] void QNearFieldShareManager::targetDetected(QNearFieldShareTarget *shareTarget)

Этот сигнал подаётся всякий раз, когда обнаруживается shareTarget. Экземпляр shareTarget принадлежит QNearFieldShareManager и не должен удаляться приложением.