Класс QNearFieldShareManager

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

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

Типы public

Функции public

• 32 функции public, унаследованные от QObject

Сигналы

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

Статические члены public

• 11 статических public членов, унаследованных от QObject

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

• 1 свойство, унаследованное от QObject
• 1 public слот, унаследованный от 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 и не должен удаляться приложением.