Користувач натискає «вниз» на пульті — фокус стрибає в кінець списку, пропускаючи кнопку «Улюблене». Знайома ситуація? Це класична помилка Focus Engine в Android TV додатках. Ми проєктуємо мультимедійні додатки, в яких навігація передбачувана, плеєр адаптується під екран, а контент потрапляє в рекомендації Google TV. Розробка ведеться під ключ — від прототипу до публікації в Google Play. За 5 років ми реалізували 12 OTT-проєктів, накопичений досвід гарантує якість і відповідність вимогам Google.
Як Android TV відрізняється від Google TV?
Google TV — надбудова над Android TV з іншим лаунчером і вимогами до контенту. Додаток для Android TV може некоректно відображатися на Google TV через відмінності в обробці рекомендацій та deep link. Враховуємо це на етапі проєктування, щоб уникнути проблем після релізу.
Як налаштувати D-pad навігацію в складних макетах?
Головна відмінність від мобільної розробки — користувач керує D-pad пульта. Фокус переміщується через Android Focus Engine, але вкладені горизонтальні RecyclerView всередині вертикального (Netflix-патерн) ламають логіку: при натисканні «вниз» фокус може перескочити в кінець екрана. Рішення — кастомний LinearLayoutManager з перевизначеним onInterceptFocusSearch(). Без цього користувач не добирається до потрібного ряду.
Бібліотека Leanback (androidx.leanback) надає BrowseSupportFragment та RowsSupportFragment з нативною підтримкою D-pad, але вона вважається застарілою. Jetpack Compose для TV (androidx.tv:tv-compose) пропонує TvLazyRow та TvLazyColumn з декларативним керуванням фокусом. Для нових проєктів обираємо Compose TV, для legacy — Leanback.
| Характеристика |
Leanback |
Compose TV |
| Архітектура |
Фрагменти, View |
Декларативна Compose |
| Навігація |
Автоматична, обмежена |
Кастомна через FocusRequester |
| Продуктивність |
Вища на старих пристроях |
Краще на нових (API 24+) |
| Швидкість розробки |
Нижча через шаблони |
Вища, менше коду |
| Підтримка Google TV |
Обмежена |
Повна |
Як інтегрувати ExoPlayer з адаптивною якістю?
androidx.media3:media3-exoplayer — стандарт для Android TV. Критично правильно налаштувати TrackSelector: вибір відео треку має враховувати роздільність дисплея, а не просто брати максимальне — 4K на 1080p екрані марно витрачає пропускну здатність. DRM Widevine L1 доступний на сертифікованих пристроях (SHIELD TV, Chromecast з Google TV). Перевіряємо рівень через MediaDrm.isCryptoSchemeSupported(WIDEVINE_UUID) та запит securityLevel. Media3 документація рекомендує такий підхід.
Інтеграція з рекомендаціями Google TV
Google TV відображає персоналізовані рекомендації з додатків через API WatchNextPrograms. Потрібен ContentProvider для заповнення прогресу перегляду, оновлення статусу та видалення завершених програм. Fire TV використовує інший механізм — App-to-App Communication через Intent для deep link в контент.
Як проходить розробка: покроково
- Аналіз вимог до контенту, монетизації та цільової платформи.
- Проєктування навігації та focus-менеджменту.
- Інтеграція ExoPlayer з кастомними налаштуваннями треків і DRM.
- Реалізація рекомендацій Google TV (WatchNext Programs).
- Тестування на 5+ пристроях (NVIDIA Shield, Chromecast з Google TV, Xiaomi Mi Box, TCL TV, Sony Bravia).
- Підготовка графіки для лаунчера та іконок.
- Збірка та публікація в Google Play з дотриманням Android TV developer guide.
- Технічна підтримка після релізу (1 місяць).
Сертифікація та публікація в Google Play
Додаток публікується з <uses-feature android:name="android.software.leanback"/> та <uses-feature android:name="android.hardware.touchscreen" android:required="false"/>. Останнє обов'язкове — без нього Play Store не покаже додаток на TV. Google перевіряє: навігація доступна з D-pad, немає залежностей від тача, коректно обробляються KEYCODE_BACK та KEYCODE_DPAD_*.
Що входить в роботу
- Вихідний код з коментарями та документація по збірці.
- Конфігурація CI/CD (GitHub Actions, Fastlane) для автоматичної публікації в TestFlight та Google Play.
- Доступи до консолей розробника (App Store Connect, Google Play Console).
- Тестовий звіт по 5 пристроях з різними версіями ОС.
- Навчання команди замовника по роботі з адмінкою контенту.
- Пост-релізна підтримка протягом 1 місяця (виправлення критичних багів).
Типові помилки при розробці
- Ігнорування Focus Engine — користувач не може дістатися до кнопок.
- Відсутність обробки KEYCODE_BACK — додаток не закривається.
- Неправильна конфігурація TrackSelector — буферизація 4K на 1080p екрані.
- Пропуск метаданих для Google TV — немає рекомендацій.
- Забута залежність android.hardware.touchscreen:false — додаток не видно.
Терміни та вартість
| Тип додатку |
Терміни |
| Інформаційний на Leanback |
від 5 до 9 тижнів |
| VOD з DRM, рекомендаціями, офлайном |
від 12 до 20 тижнів |
Вартість розраховується індивідуально після аналізу контенту та монетизації. Безкоштовно оцінимо ваш проєкт. Зв'яжіться з нами, щоб обговорити деталі. Отримайте консультацію по вашому проєкту.
Розробка віджетів, App Clips та Live Activities: точки входу поза додатком
Ми знаємо: користувач бачить додаток не тільки всередині. Віджет на домашньому екрані, живий рахунок матчу в Dynamic Island, міні-досвід без встановлення — це окремі точки входу. За 5 років ми розробили понад 50 розширень — від простих інформаційних віджетів до App Clips з платіжними сценаріями. Економія часу клієнта на повторних входах — до 30%. Ми — сертифіковані розробники Apple і Google, гарантуємо сумісність з останніми версіями SDK.
Розробка віджетів WidgetKit: чому не можна просто «додати віджет»
WidgetKit працює через Timeline Provider — віджет не живе в пам'яті постійно, а запитує знімки даних заздалегідь. Найчастіша помилка: розробник намагається показати дані в реальному часі через URLSession прямо з getTimeline(). Apple цього не забороняє, але при агресивному оновленні система починає троттлити запити, і віджет застигає на застарілих даних.
Правильний підхід: основний додаток оновлює дані через WidgetCenter.shared.reloadTimelines(ofKind:) після отримання push-сповіщення або при поверненні в foreground. Віджет читає дані з shared App Group контейнера через UserDefaults(suiteName:) або файлового сховища. Жодних прямих мережевих запитів у провайдері в продакшні.
У новітніх версіях iOS з'явився AppIntent-based interactive widget — кнопки та тогли прямо на віджеті без відкриття додатку. Реалізується через Button(intent:) у SwiftUI-розмітці. Працює тільки для простих дій; складна логіка повинна переходити в додаток через widgetURL.
Як Live Activities змінюють користувацький досвід?
Live Activities — механізм для відображення живих даних на Lock Screen та в Dynamic Island (iPhone 14 Pro+). Запускаються через ActivityKit, оновлюються через push-сповіщення типу liveactivity з корисним навантаженням до 4KB.
Архітектурно це окремий SwiftUI-таргет з двома представленнями: компактним (Dynamic Island) та розгорнутим (Lock Screen). Дані передаються через ActivityAttributes — строго типізовану структуру. Динамічна частина — ContentState, статична (не змінюється за час активності) — в ActivityAttributes безпосередньо.
Типова проблема: Live Activity не оновлюється, хоча push надсилається. Причина — додаток не має permission на background push або apns-push-type виставлений неправильно. У production потрібен apns-push-type: liveactivity і токен з activity.pushToken. Без коректного push-токена Activity не отримає оновлень — це підтверджено документацією Apple.
Коли використовувати App Clips, а коли Instant Apps?
App Clips (iOS) та Instant Apps (Android) вирішують схоже завдання — дати функціональність без встановлення повного додатку. Реалізація принципово різна.
App Clip — окремий таргет у Xcode, максимум 15MB, запускається через NFC-мітку, QR-код, Safari Smart App Banner або посилання в Messages. Доступ до даних обмежений: немає Keychain sharing з основним додатком без явного налаштування, немає доступу до HealthKit, немає push-сповіщень (тільки ephemeral). App Clip Card налаштовується в App Store Connect — помилки в метаданих часта причина відмови в рев'ю.
Android Instant Apps будуються на модульній архітектурі: додаток ділиться на feature-модулі, кожен може бути завантажений окремо через Play Feature Delivery. Instant App — це feature-модуль з <dist:module dist:instant="true">. Обмеження — не більше 15MB сумарно для instant delivery.
Порівняння показує: App Clips виграють у сценаріях з оплатою завдяки інтеграції з Apple Pay — конверсія вища на 20% порівняно з Instant Apps в аналогічних кейсах. Instant Apps краще підходять для ігрових демо та сервісів, де потрібен швидкий доступ через Google Search.
| Параметр |
App Clips |
Instant Apps |
| Макс. розмір |
15 MB |
15 MB |
| Тригери запуску |
NFC, QR, URL, Safari |
URL, Google Search, Play Store |
| Загальний Keychain |
Через App Group |
Через SharedPreferences/Keystore |
| Рекомендований сценарій |
Оплата, посадковий, демо |
Ігрове демо, разові сервіси |
Що входить в роботу?
-
Аудит поточної архітектури: визначаємо, які точки входу потрібні — віджет, Live Activity, App Clip, Instant App.
-
Прототипування: візуальна модель розширення з урахуванням гайдлайнів платформи (Apple HIG, Material Design).
-
Розробка: реалізація на Swift (iOS) або Kotlin (Android) з використанням WidgetKit, ActivityKit, App Clip API, Play Feature Delivery.
-
Інтеграція: налаштування App Group, Keychain sharing, push-сертифікатів, provisioning profile.
-
Тестування: на реальних пристроях (iPhone, iPad, Android) та в симуляторах. Для Live Activities — тест через
xcrun simctl push.
-
Публікація: підготовка метаданих для App Store Connect (App Clip Card) та Google Play Console (Instant App configuration).
-
Документація та навчання: опис архітектури, інструкції з оновлення віджетів, troubleshooting push-сповіщень.
Процес роботи
-
Аналітика: які функції додатку реально потрібні поза ним, і який механізм підходить. Віджет з прогнозом — WidgetKit. Трекінг доставки — Live Activity. Оплата на касі — App Clip.
-
Проектування: вибір стеку, схеми оновлення даних (Timeline, push), UI-макети для компактного та розгорнутого представлення.
-
Реалізація: написання коду на Swift/Kotlin, налаштування App Group, push-сертифікатів, тестових схем.
-
Тест: кожне розширення тестується ізольовано. WidgetKit-рендеринг перевіряється через Xcode Widget Gallery, Live Activities — через симулятор з примусовим надсиланням push.
-
Деплой: публікація в сторах, моніторинг метрик (частота оновлень, кількість запусків App Clip).
Строки орієнтовно
| Тип розширення |
Строк (робочі дні) |
| Простий інформаційний віджет |
від 5 до 10 |
| Інтерактивний віджет (AppIntent) |
від 10 до 15 |
| Live Activity з push |
від 10 до 20 |
| App Clip з оплатою |
від 20 до 30 |
| Instant App (Android) |
від 15 до 25 |
Вартість розраховується індивідуально після аудиту. Оцінка надається протягом 2 робочих днів.
Типові помилки при розробці розширень
- Занадто часте оновлення віджета — призводить до троттлінгу та порожнього стану. Рекомендуємо інтервал не менше 15 хвилин (див. Apple Human Interface Guidelines, WidgetKit documentation).
- Ігнорування shared container — віджет не бачить дані, тому що використовує свій
UserDefaults, а не App Group.
- Відсутність fallback для Live Activities — якщо push не доставлений, користувач бачить застарілі дані. Потрібен механізм періодичного опитування через
Activity.update з pushType: nil.
- Неправильні метадані App Clip Card — часта причина відхилення в App Store Review. Наприклад, некоректний URL або відсутній значок.
Зв'яжіться з нами, щоб оцінити, яке розширення підходить вашому додатку. Замовте аудит поточних точок входу — ми знайдемо неочевидні сценарії для віджетів та App Clips. Отримайте консультацію інженера з архітектури вже сьогодні. Гарантуємо проходження App Store Review з першого разу — наш досвід підтверджений десятками успішних публікацій.
