С выпуском Android 5.0 появляется Android TV, поддерживающий Google Cast. В этом документе описывается, что вам нужно сделать для настройки и тестирования на Android TV при разработке приложений Cast. Ваше существующее приложение Cast работает на Android TV без каких-либо дополнительных усилий. Если вы разрабатываете приложение Cast впервые, просмотрите документацию Google Cast и сначала разработайте приложение Cast для работы на устройстве Chromecast, прежде чем разрабатывать и тестировать его с Android TV.
Настройка для разработки
- Настройте свое устройство Android TV:
- Подключите устройство Android TV к локальной сети.
- Войдите в свою учетную запись Google.
- В разделе «Настройки» в строке «Устройство» выберите «О программе» .
- Прокрутите вниз и нажмите « Создать» несколько раз, пока не появится диалоговое окно с сообщением «Теперь вы разработчик».
- Если отладка по USB:
- Подключите USB-кабель, но пока не подключайте главный конец USB-кабеля к компьютеру.
- В строке «Настройки» выберите «Параметры разработчика» , выберите «Отладка по USB» и выберите « Вкл .».
- Вернитесь на главный экран. Это необходимо сделать, чтобы применить только что выбранные настройки. Настройки сохранятся, пока вы не выполните сброс настроек к заводским.
- Зарегистрируйте свое устройство Android TV в консоли разработчика Google Cast SDK , как описано в разделе «Регистрация устройства» .
Отладка
Чтобы протестировать и отладить приложение веб-ресивера на устройстве Android TV, выполните следующие действия:
- Зарегистрируйте свое устройство Android TV и свое приложение в консоли разработчика Google Cast SDK . Дополнительную информацию о регистрации устройств и приложений см. в разделе Регистрация .
- Запустите приложение-отправитель и выполните трансляцию на устройство Android TV.
- Подключитесь к устройству Android TV через ADB, как описано в разделе «Использование Android Debug Bridge» .
- На компьютере разработки откройте окно браузера Chrome и перейдите по адресу chrome://inspect .
- Щелкните ссылку проверки , чтобы перенести веб-приемник в отладчик.
В консоли удаленного отладчика Chrome включите ведение журнала отладки, введя следующее:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
См. раздел «Отладка» для получения дополнительной информации.
Рекомендации по совместимости Android TV
Чтобы сделать приложение Cast совместимым с Android TV, требуется совсем немного дополнительных усилий. Вот несколько рекомендаций и типичные ошибки, которых следует избегать, чтобы обеспечить совместимость вашего приложения с Android TV:
- Имейте в виду, что строка пользовательского агента содержит как «Android», так и «CrKey»; некоторые сайты могут перенаправляться на сайт, предназначенный только для мобильных устройств, поскольку обнаруживают метку «Android». Не думайте, что «Android» в строке пользовательского агента всегда указывает на мобильного пользователя.
- Медиа-стек Android может использовать прозрачный GZIP для извлечения данных. Убедитесь, что ваши медиаданные могут реагировать на
Accept-Encoding: gzip. - Медиа-события Android TV HTML5 могут запускаться в другое время, чем Chromecast. Это может выявить проблемы, скрытые в Chromecast.
- При обновлении мультимедиа используйте события, связанные с мультимедиа, запускаемые элементами
<audio>/<video>, напримерtimeupdate,pauseиwaiting. Избегайте использования сетевых событий, таких какprogress,suspendиstalled, поскольку они, как правило, зависят от платформы. - При настройке сертификатов HTTPS вашего сайта веб-приемника обязательно включите промежуточные сертификаты CA. Посетите тестовую страницу Qualsys SSL, чтобы убедиться: если путь доверенной сертификации для вашего сайта включает сертификат CA с пометкой «дополнительная загрузка», он может не загружаться на платформах на базе Android.
- Хотя Chromecast отображает страницу веб-приемника в графической плоскости 720p, другие платформы Cast, включая Android TV, могут отображать страницу с разрешением до 1080p. Убедитесь, что ваша страница веб-приемника корректно масштабируется при различных разрешениях.
Использование моста отладки Android
Платформа Android TV используется во многих видах бытовой электроники: телевизорах, приставках, игровых консолях и т. д. Каждый может быть настроен по-разному. Если у вас возникли трудности с доступом к ресурсам системы Android TV через пользовательский интерфейс устройства, вы можете использовать Android Debug Bridge (ADB) для получения серийного номера вашего устройства для регистрации, а также для отладки приложения. Дополнительную информацию см. в разделе Android Debug Bridge .
Использование ADB через Wi-Fi
Чтобы подключиться к вашему устройству через ADB с помощью Wi-Fi-соединения:
- На вашем устройстве Android TV включите параметры разработчика, как описано в разделе «Настройка для разработки» .
- Убедитесь, что ваш компьютер подключен к той же сети, что и ваше устройство Android TV.
Откройте терминал и введите следующее:
adb connect Android TV device IP address:4321
На своем компьютере откройте терминал и введите команды ADB. Вы можете убедиться, что соединение установлено и что устройство Android TV обменивается данными по сети с помощью следующей команды:
adb logcat
Использование ADB с USB-кабелем
Чтобы подключиться к устройству через ADB с помощью USB-кабеля:
- Настройте свое устройство Android TV для разработки, как описано в разделе Настройка для разработки .
- Подключите главный конец USB-кабеля к компьютеру.
- В разделе Разрешить отладку по USB? В диалоговом окне выберите «Всегда разрешать с этого компьютера» и нажмите «ОК» .
На своем компьютере откройте терминал и введите команды ADB. Вы можете убедиться, что соединение установлено и что устройство Android TV обменивается данными по сети с помощью следующей команды:
adb logcat
Использование ADB через TCP/IP
ADB работает без USB-кабеля через TCP/IP, но сначала необходимо получить IP-адрес устройства Android TV. Устройства, выпущенные разработчиком, автоматически прослушивают подключения порта ADB и могут быть подключены без инициализации порта. Стандартные розничные устройства Android TV не прослушивают соединения ADB автоматически; для этих устройств необходимо сначала подключиться к ADB с помощью USB-кабеля и инициализировать порт.
- Настройте свое устройство Android TV для разработки, как описано в разделе Настройка для разработки .
- На Android TV в строке «Устройство» выберите «Сеть» > «Wi-Fi» и выберите подключенную сеть.
- Выберите «Информация о состоянии» и запишите IP-адрес .
Если ваше устройство является стандартным розничным устройством Android TV, выполните следующие действия:
- Выполните действия, описанные в разделе «Использование ADB с помощью USB-кабеля» .
- Убедитесь, что ваш компьютер подключен к той же сети, что и устройство Android TV.
На вашем компьютере в терминале инициализируйте порт для TCP/IP, введя следующее:
adb tcpip 5555
Отсоедините USB-кабель и введите в терминал следующее:
adb connect Android TV device IP address:5555
Если ваше устройство Android TV выпущено разработчиком, выполните следующие действия:
- Убедитесь, что ваш компьютер подключен к той же сети, что и ваше устройство Android TV.
Откройте терминал и введите следующее:
adb connect Android TV device IP address:4321
На Android TV в разделе «Разрешить отладку по USB?» В диалоговом окне выберите «Всегда разрешать с этого компьютера» и нажмите «ОК» . Вы можете убедиться, что соединение установлено и что устройство Android TV обменивается данными по сети с помощью следующей команды:
adb logcat