Приложения, которые управляют устройствами

Какими устройствами может управлять приложение KolHive

Когда вы создаете приложение в KolHive, оно может взаимодействовать с физическими устройствами вокруг вас. Приложение умеет подключаться к гаджетам по Bluetooth Low Energy, обращаться к технике в домашней или офисной сети и считывать показания датчиков движения телефона. На поддерживаемых телефонах Android оно также может отправлять сигналы инфракрасного пульта.

Например, Анна из Санкт-Петербурга может собрать трекер, который считывает пульс с нагрудного датчика Bluetooth или проверяет датчик влажности в цветочном горшке. Дмитрий в Алматы может включить умную розетку в офисной сети или разбудить рабочий компьютер с помощью Wake-on-LAN. А Ольга из Риги, у которой телефон на Android оснащен ИК-портом, может сделать пульт управления для телевизора в гостиной.

Приложения никогда не обращаются к оборудованию напрямую. Каждый запрос проходит через KolHive: система проверяет заявленные приложением права и сначала запрашивает ваше разрешение.

Bluetooth Low Energy

Созданное приложение может работать с Bluetooth Low Energy (BLE) в роли центрального устройства. Оно может искать гаджеты поблизости, подключаться к ним, читать и записывать данные объемом до 512 байт, а также подписываться на уведомления. Классический Bluetooth, аудиопрофили и последовательные соединения RFCOMM не поддерживаются.

Приложение никогда не получает скрытый список устройств вокруг. Когда оно запрашивает поиск, KolHive открывает на экране собственное окно выбора. Приложение видит только то устройство, которое вы выбрали, и только те службы Bluetooth, которые оно заранее указало.

Bluetooth работает в приложении KolHive на Mac, Windows, iPhone, iPad и Android. Устройства Apple запрашивают разрешение при первом использовании, а Android 12 и новее просит доступ к устройствам поблизости. В веб-браузере Bluetooth работает только в Chrome и Edge, но не в Safari или Firefox.

Устройства в локальной сети

Ваше приложение может находить устройства в локальной сети и общаться с ними по протоколам HTTP, WebSocket, TCP и UDP. Оно способно обнаруживать технику через SSDP или mDNS и отправлять пакеты Wake-on-LAN. Доступны только частные сетевые адреса. KolHive отклоняет подключения к публичным узлам в интернете, петлевым интерфейсам (loopback) и собственному адресу вашего устройства.

Каждое окно приложения может одновременно держать открытыми до 16 сокетов и выполнять до четырех запросов поиска устройств в минуту. Размер ответов HTTP ограничен 5 МБ. Самоподписанные сертификаты принимаются только для локальных устройств и только по явному запросу приложения.

Полное управление локальной сетью работает на Mac, Windows и Android. На Mac система покажет стандартный запрос на доступ к локальной сети. На iPhone и iPad работают HTTP, WebSocket, TCP и имена в зоне .local, но многоадресный поиск (SSDP), широковещательные запросы и Wake-on-LAN недоступны. Поэтому Илья в Новосибирске может включить телевизор по Wake-on-LAN с Mac, компьютера на Windows или телефона Android, но не с iPhone или iPad.

В веб-браузере запросы к локальной сети передаются через одно из ваших устройств, на котором выполнен вход в KolHive, по прямому зашифрованному соединению. При первом обращении на этом устройстве появится запрос на подтверждение. Трафик идет напрямую между устройствами без ретранслятора TURN, а наши серверы передают только короткие сигнальные сообщения для установки связи. Если ни одно из ваших устройств не в сети, приложение получит ответ, что доступного устройства-посредника нет.

Датчики движения, ИК-порт и геолокация

Датчики движения работают только в приложениях для телефонов и планшетов. На iPhone, iPad и Android приложение может считывать данные гироскопа, акселерометра, пользовательского акселерометра, магнитометра и барометра с частотой до 200 Гц. На компьютерах с Mac, Windows и Linux эти датчики отмечаются как неподдерживаемые.

В веб-браузере приложения используют стандартный Generic Sensor API или события движения устройства, если браузер их поддерживает. Замены для магнитометра или барометра в веб-версии нет. Браузер Safari на iPhone и iPad запрашивает разрешение перед передачей данных с датчиков.

Отправлять инфракрасные команды пульта приложение может только на телефонах Android со встроенным бытовым ИК-передатчиком (IR blaster). Каждый сигнал ограничен 1024 импульсами и длительностью в 2 секунды. На iPhone, iPad, Mac, Windows, Linux и в браузере инфракрасный порт недоступен.

Приложения также могут определять местоположение устройства с помощью GPS и геолокации на Android или службы Core Location на устройствах Apple. Это работает только в том случае, если приложение заявило использование геолокации и вы дали на это согласие.

Поддержка по платформам

Доступ к оборудованию зависит от вашего устройства и от того, используете ли вы установленное приложение KolHive или веб-браузер.

Как KolHive контролирует доступ к оборудованию

Приложения обращаются к оборудованию через интерфейсы kolhive.lan, kolhive.bluetooth, kolhive.sensors и kolhive.infrared. Каждая возможность должна быть заявлена в манифесте приложения с указанием конкретной цели и способа использования данных. Любой незаявленный вызов блокируется на трех уровнях: при проверке во время установки, внутри страницы и на уровне хоста. Подробнее о проверке разрешений читайте в статье Обзор безопасности для ИТ-специалистов.

KolHive предлагает выбрать нужное устройство в собственном окне, не позволяя приложению сканировать эфир или подключаться в фоновом режиме. Когда вы закрываете или перезагружаете окно приложения, KolHive закрывает все открытые сокеты, соединения Bluetooth и потоки данных с датчиков. Пока окно приложения скрыто, передача данных с датчиков автоматически приостанавливается, а соединения Bluetooth продолжают работать.

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