Установка на Apple TV (tvOS)
Приложение Happ — Proxy Utility for TV является отдельным продуктом и отличается от версии для iOS. Это связано с особенностями и ограничениями платформы tvOS.
Импорт по локальной сети
При первом запуске автоматически откроется экран импорта (аналог нажатия «+»). Вы можете передать:
- отдельные конфигурации серверов
- одну или несколько подписок
- или всё сразу
Требования
- iPhone/Android с установленным Happ и Apple TV должны быть в одной Wi-Fi сети.
- На экране TV отсканируйте QR-код с помощью Happ на iOS/Android.
Как это работает
- Откройте Happ на iOS/Android.
- Сканируйте QR-код с экрана TV.
- Выберите, что отправлять (конфигурации/подписки) и подтвердите.
- Не закрывайте экран импорта на TV до окончания передачи — иначе соединение может оборваться и данные импортируются частично или не импортируются вовсе.
- При передаче с iOS система покажет запрос разрешения на подключения по локальной сети. Если отказать, повторный системный диалог не появится (особенность API Apple), и локальные запросы будут блокироваться. См. решение в разделе «Особенности и ограничения».
После передачи
- При успехе экран импорта скрывается, начинается обработка полученных данных (например, получение конфигураций по URL подписки).
- При ошибках (не удалось разобрать конфигурацию или получить данные по ссылке подписки) приложение покажет сообщение об ошибке.
- QR-код обновляется автоматически.
Веб-импорт через удалённый сервер
Если локальная сеть недоступна или заблокирована разрешениями, используйте Web Import.
Шаги
- На экране импорта выберите «Web Import».
- Выберите один из вариантов:
- Откройте в любом браузере сайт tv.happ.su , введите временный код с экрана TV, затем добавьте данные и нажмите «Отправить».
- Отсканируйте QR-код с экрана TV — он содержит и адрес, и временный код.
- Не закрывайте экран импортана TV до завершения операции — иначе соединение может быть закрыто, а данные не доставлены полностью.
- QR-код обновляется автоматически.
Результат
После успешной передачи приложение скроет экран импорта и выполнит те же действия, что и при импорте по локальной сети.
Подключение
После успешного импорта на домашнем экране появится список полученных подписок/серверов. Первый доступный сервер будет выбран автоматически.
Поддерживаются стандартные операции:
- выбор сервера,
- подключение/отключение,
- пинг,
- обновление подписки.
Поведение в целом соответствует версиям для iOS/Android/Desktop.
Настройки
Настройки на tvOS визуально отличаются от других платформ.
Ключевое отличие — на tvOS нет классического роутинга. Вместо него доступен упрощённый механизм правил Direct:
- Встроен дефолтный список Direct-правил.
- Вы можете их включать/выключать и редактировать под свои задачи.
Особенности и ограничения tvOS
Хранилище и очистка данных
На Apple TV (tvOS) отсутствует «гарантированно постоянное» хранилище для приложений. При нехватке памяти система может самостоятельно удалить сохранённые данные приложения (конфигурации/подписки). Рекомендуется хранить важные данные в подписке/на сервере и уметь быстро повторить импорт.
Лимит памяти на туннель
tvOS (как и iOS) жёстко ограничивает потребление памяти для сетевого туннеля — около 50 МБ. При превышении лимита система может завершить процесс туннеля (фактически «отключить» соединение). Это системное ограничение.
Разрешение «Локальная сеть» на iOS
В iOS известна особенность (баг API): если при первом запросе разрешения на локальные подключения вы выбрали «Не разрешать», повторный системный диалог не появится. Даже после включения разрешения в настройках приложения iOS может продолжать блокировать такие подключения.
Решение: переустановите приложение на iOS-устройстве (после этого система снова покажет диалог) или используйте Web Import.
Подсказки
Если импорт «по воздуху» не проходит из-за разрешений/сети, то сразу используйте Web Import - это надёжно и не зависит от локальных ограничений.
Для минимизации риска потери данных держите актуальные подписки и при необходимости повторно импортируйте их на TV всего в пару шагов.