Перейти к содержанию
NFC-метка запускает инсталляцию: подключение считывателя по OSC Перейти к товару

NFC-метка запускает инсталляцию: подключение считывателя по OSC

Как передать UID с ODNFC-LAN в мультимедийное приложение по OSC: адрес сообщения, строковый аргумент, настройка UDP и обработка повторных касаний.

Перейти к товару Документация

Посетитель подносит метку, и мультимедийная программа запускает нужную сцену. Для такого сценария ODNFC-LAN может отправлять номер карты по OSC — протоколу, который используют для обмена событиями между приложениями и устройствами. Нужен получатель с поддержкой OSC-сообщений со строковыми аргументами.

Считыватель отвечает за чтение и отправку UID. Выбор ролика, воспроизведение звука, состояние сцены и обработку неизвестных карт задают в программе инсталляции.

Что потребуется

  • ODNFC-LAN с совместимым радиоинтерфейсом и OSC-шаблоном;
  • проверенные карты, метки или браслеты;
  • сеть между считывателем и компьютером;
  • питание по схеме выбранного исполнения;
  • приложение, принимающее OSC по UDP, и настройка реакции на UID.

ODNFC-LAN использует Passive PoE 7–24 В. Источник питания приобретается отдельно; перед подключением сверьте напряжение и распиновку по руководству.

Формат сообщения в стартовом шаблоне

В исходном коде OSC-шаблона заданы:

ПараметрЗначение
ПолучательАдрес и UDP-порт из настройки net_dest
OSC-адрес/odnfc/uid
Тип аргументаs, строка
Содержимое аргументаПрочитанный UID

Например, 192.168.1.10:9000 означает компьютер с этим адресом и UDP-порт 9000. Адрес нужен фактический, доступный из сети считывателя. OSC-путь /odnfc/uid — имя сообщения, а не URL веб-страницы.

Получатель должен читать именно строку. Преобразование UID в обычное число может потерять ведущие нули или не вместить длинный идентификатор.

Как связать карту со сценой

  1. Запустите в принимающем приложении OSC-вход на выбранном UDP-порту.
  2. Укажите тот же порт и адрес компьютера в net_dest считывателя.
  3. Поднесите метку и убедитесь, что приложение получает /odnfc/uid со строкой.
  4. Сохраните соответствие «UID → сцена» в приложении.
  5. Задайте реакцию на неизвестную карту и повторное касание во время показа.
  6. Проверьте весь цикл: касание, начало сцены, её завершение и готовность к следующему посетителю.

Для нескольких точек назначьте разные OSC-пути или добавьте идентификатор точки в сообщение. В исходном шаблоне путь общий, а аргумент содержит только номер карты.

Повторы и подтверждение запуска

Длительное удержание метки и несколько быстрых касаний испытайте отдельно. Приложение должно решать, перезапускать ли сцену, игнорировать повтор или переходить к следующему действию. Одно движение руки не всегда создаёт ровно одно событие.

UDP не подтверждает доставку. Свет и звук в стартовом шаблоне означают попытку отправки, а не подтверждённый запуск видео. Если посетитель должен получать сигнал именно после запуска сцены, добавьте обратное сообщение и обработку тайм-аута. После перезапуска компьютера приложение должно снова открыть OSC-вход и вернуться в известное состояние.

Что проверить до монтажа

Испытайте используемые метки в конечном корпусе и положении, разрешение входящего UDP в сети компьютера, отключение кабеля и возврат приложения после перезапуска. Сохраните адреса, порты и таблицу сцен вместе с проектом.

Для голосов, баллов и регистрации нужны также хранение и правила обработки событий. Эти задачи разобраны в сценариях RFID для мероприятий.