Аудиоустройства

Google Cast для аудиоустройств поддерживает только воспроизведение звука. В этом руководстве описывается, как оптимизировать приложения Cast для устройств, поддерживающих только звук, и воспользоваться преимуществами снижения требований к памяти, процессору и использованию полосы пропускания сети.

Приложение, поддерживающее Google Cast для аудио, должно учитывать следующее:

  • Google Cast для аудиоустройств не отображает видео или графику. Однако многие аудиоустройства имеют дисплей для отображения метаданных, таких как состояние воспроизведения (воспроизведение или пауза) и прогресс. Ваше приложение не должно отображать такую ​​важную пользовательскую информацию только на приемнике; критическая информация и большая часть пользовательского интерфейса должны отображаться на отправителе.
  • Для правильной работы приложений веб-приемника Google Cast для аудиоустройств по-прежнему должен отображать графику, даже если она не отображается. Поскольку устройства могут не поддерживать графические операции с аппаратным ускорением, приложениям-получателям следует избегать использования операций с интенсивным использованием графики, таких как цветовые градиенты, вращение, альфа-смешение и повторное рисование больших объектов, таких как индикаторы выполнения, чаще, чем один раз в секунду.
  • Google Cast для аудиоустройств поддерживает только контент, защищенный Widevine for Digital Rights Management (DRM).
  • Для большинства Google Cast для аудиоустройств приложение-отправитель контролирует весь диапазон громкости устройства (например, динамика), а не только громкость источника звука, поступающего на телевизор, как в случае с устройством Chromecast.
  • Помимо управления воспроизведением с помощью устройства-отправителя (например, телефона), приложению может потребоваться обеспечить управление воспроизведением с помощью собственных контроллеров устройства, таких как пульт дистанционного управления, кнопки на устройстве или внешнее удаленное приложение.
  • Google Cast для аудиоустройства может поддерживать отображение метаданных контента с помощью небольшого ЖК-экрана, выхода HDMI (для звуковых панелей или аудио-видеоресиверов) или внешнего удаленного приложения, в зависимости от пользовательского интерфейса конкретного устройства.

Разработка

Первым шагом в разработке приложения Cast для поддержки Google Cast для аудио является разработка приложения Cast для аудио и видео и обеспечение его работы на Chromecast. В этом документе предполагается, что вы разработали и протестировали такое приложение.

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

Например, приложения с двумя видео и аудио (например, приложения для воспроизведения локальных файлов или файлов NAS) должны включать трансляцию на устройства только со звуком, чтобы поддерживать воспроизведение аудиофайлов, но приложение не должно позволять пользователю отправлять видеофайлы на устройство только со звуком. Приложение может использовать API-интерфейсы возможностей устройства для отправителей, описанные ниже, чтобы определить контент, подходящий для устройства.

Чтобы поддерживать Google Cast для аудио, ваше приложение должно выполнять следующие действия:

  • Поддержка только аудио: потоковая передача музыки и аудиофайлов, радио и т. д. Мультимедиа, передаваемое в приложение Web Receiver, не должно быть видеопотоком. Кроме того, избегайте потоковой передачи графики и изображений, чтобы сократить время запуска приложений и использование памяти. См. рекомендации по использованию памяти ниже.

  • Запустите, как ожидалось, на аудиоустройстве Cast для аудио, а также на обычном Chromecast.

Возможности устройства

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

HTTP-заголовок устройства

HTTP-заголовок CAST-DEVICE-CAPABILITIES предоставляемый устройством Cast во время запуска приложения, описывает возможности устройства. Устройство отправляет запрос с этим заголовком на сервер, на котором размещено приложение веб-приемника. Заголовок устройства только для звука описывает возможности устройства с помощью CAST-DEVICE-CAPABILITIES: {"display_supported":false} .

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

API веб-приемника

Вы можете получить тот же объект возможностей устройства, вызвав CastReceiverManager.getDeviceCapabilities() при загрузке приложения веб-приемника.

Дополнительные сведения см. в разделе Возможности устройства .

API-интерфейсы отправителя

Каждый из API-интерфейсов Cast-отправителя также содержит информацию о возможностях устройства. Это позволяет вашему приложению-отправителю определить, какой тип мультимедиа отправлять получателю. Если ваше приложение поддерживает как аудио, так и видео, оно может избежать отправки видеоконтента на устройства, поддерживающие только аудио. Кроме того, ваше приложение может управлять громкостью наиболее подходящим для устройства способом, как описано в Контрольном списке проектирования . См. следующие API-интерфейсы возможностей устройства для отправителей:

Рекомендации по использованию памяти

Приложения веб-приемника, работающие на аудиоустройствах, должны управлять использованием памяти следующим образом:

  • Не загружайте и не используйте какие-либо изображения или графические ресурсы, чтобы уменьшить объем памяти и сократить время до начала воспроизведения.
  • При использовании Media Source Extensions (MSE) приложения должны ограничивать размер буфера потока до 2 МБ. При использовании библиотеки медиаплеера (MPL) размер буфера потока приложения уже определен MPL.
  • При использовании HTMLMediaElement размер буфера потока приложения определяется Chrome на основе скорости потока. Ограничьте битрейт звука до 2 мегабит в секунду, что поддерживает все кодеки, описанные в разделе «Поддерживаемые носители» (до 48 кГц/16 бит).

Регулятор громкости

Для большинства Google Cast для аудиоустройств приложение-отправитель контролирует весь диапазон громкости устройства, а не только входную громкость источника звука, как в случае с устройством Chromecast. Это означает, что шаг изменения громкости должен быть меньшим для приложений, предназначенных только для аудио. Инструкции по обеспечению регулировки громкости в вашем приложении см. в следующих документах:

Элементы управления устройством

Google Cast для аудиоустройств может иметь собственные элементы управления воспроизведением (например, кнопки, пульты дистанционного управления). Они используют сообщения воспроизведения мультимедиа, определенные для пространства имен urn:x-cast:com.google.cast.media , как описано в разделе «Сообщения воспроизведения мультимедиа» , для управления воспроизведением в приложении-приемнике. Приложение-приемник должно поддерживать эти сообщения о воспроизведении мультимедиа, чтобы поддерживать элементы управления воспроизведением устройства.

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

Дисплей устройства

Google Cast для аудиоустройства может иметь ЖК-экран на устройстве или приложение управления для конкретного устройства, которое отображает метаданные мультимедиа. Ваше приложение-приемник должно предоставить эти метаданные для всех аудиодорожек и обеспечить их синхронизацию с воспроизводимым в данный момент контентом, чтобы обеспечить правильное отображение метаданных на дисплее. Если приложение использует пользовательские метаданные, оно также должно предоставить стандартные метаданные аудио (название трека, имя исполнителя, название альбома и т. д.), как описано для каждой платформы ниже.

Получатель получает метаданные от отправителя при загрузке носителя. В приложении-отправителе с помощью команды загрузки мультимедиа в получатель необходимо указать поля, описанные ниже, чтобы метаданные отображались на Google Cast для аудиоустройства. Используйте следующие API:

Если приложение Cast управляет очередью мультимедиа на получателе или в облаке, веб-приемник должен транслировать любые обновления статуса мультимедиа, используя пространство имен urn:x-cast:com.google.cast.media чтобы все отправители были синхронизированы.

Регистрация

Вам необходимо зарегистрировать Google Cast для аудиоустройства для тестирования и зарегистрировать свое приложение для поддержки Google Cast для аудиоустройств с помощью консоли разработчика Google Cast SDK .

  • Дополнительную информацию о регистрации устройств см. в разделе «Устройства ».
  • При регистрации приложения необходимо установить флажок «Поддерживает трансляцию на устройства только с аудио», чтобы приложение могло обнаруживать Google Cast для аудиоустройств. См. Зарегистрируйте свое приложение .

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

Google Cast для аудио 2.0

Google Cast for Audio (GC4A) 2.0 — это аудиоплатформа Cast следующего поколения, предназначенная для устройств с малым объемом памяти и позволяющая расширить экосистему устройств, которые могут осуществлять потоковую передачу вашего контента. Поскольку GC4A 2.0 ориентирован на аудиоплатформы, набор веб-API сокращен для обеспечения совместимости с устройствами без дисплея. GC4A 2.0 распространяется на новые и существующие динамики, поддерживающие трансляцию.

Тестирование и отладка

Поскольку все поддерживаемые динамики перейдут на GC4A 2.0, важно, чтобы разработчики аудиоприложений тестировали свои приложения на GC4A 2.0. Вы можете протестировать свое приложение Cast для GC4A 2.0 на любом из перечисленных здесь устройств GC4A 2.0.

GC4A 2.0 не поддерживает удаленный отладчик Chrome. Если вы хотите отладить свое приложение, Google рекомендует использовать Cast Debug Logger .

Доступные устройства GC4A 2.0

Это неполный список устройств GC4A 2.0:

  • Bose: динамик Wi-Fi и умные саундбары
  • JBL: зарядка 5 Wi-Fi/Boombox 3 Wi-Fi/аутентичность 200, 300 и 500
  • Samsung: музыкальная рамка/саундбары
  • LG: Саундбары S90TY/SG10TY/SE70Q/S80Q/S90Q
  • Bang & Olufsen Beosound 2 / Beocore Connect
  • Соноро Маэстро 2 / Мейстерштрук 2
  • Кембридж Аудио MXN10
  • КЕФ LS60/LSX II
  • Тойфель Мотив Главная
  • Нордик Аргон Аудио
  • WiiM CI MOD S/Ультра

Рекомендуется протестировать все функции приложения на GC4A 2.0. Обязательно включите тестирование воспроизведения всех типов мультимедиа (подкастов, потоков и т. д.), приостановку, прокрутку, пропуск, изменение списков воспроизведения, остановку и повторное подключение Cast.

Поддерживаемые API

GC4A 2.0 поддерживает следующие API:

  • HTML
  • JavaScript ECMA 6
  • DOMParser
  • XMLСериализатор
  • Документ и подклассы
  • ДокументФрагмент
  • HTMLMediaElement и HTMLAudioElement
  • HTMLVideoElement (может воспроизводить только аудиоконтент)
  • HTMLScriptЭлемент
  • HTMLBaseElement
  • HTMLTemplateElement
  • Пользовательские элементы
  • Тень ДОМ
  • Модули сценариев / асинхронные / отложенные
  • Получить / XHR
  • Вебсокет
  • Порт сообщения
  • Файлы cookie
  • MSE (расширения источников мультимедиа)
  • EME (расширения зашифрованного мультимедиа)
  • Локальное/сессионное хранилище
  • DRM (com.widevine.alpha и org.w3.clearkey)
    • Поддерживается только программное дешифрование ( SW_SECURE_CRYPTO ).
  • Subtle Crypto поддерживает только расшифровку AES-CBC

GC4A 2.0 не поддерживает:

  • Импорт динамических модулей (добавится в 2024 г.)
  • CSS
  • IFrame
  • Текстовые дорожки

Идентификация

Хотя ожидается, что приложения Cast Receiver будут универсальными для всех устройств Cast, иногда бывает полезно определить, на каком устройстве вы работаете. Устройства GC4A 2.0 можно идентифицировать с помощью строки пользовательского агента.

  • Все устройства Cast содержат CrKey/ и версию. Пример: CrKey/1.68.000001 .
  • Устройства GC4A 2.0 содержат Castlite/ и его версию. Пример: Castlite/1.0 .

Контакт

Если вам нужна помощь в настройке для тестирования или вы не можете использовать динамик Bose, свяжитесь с нами по адресу gc4a-support-external@google.com.

,

Google Cast для аудиоустройств поддерживает только воспроизведение звука. В этом руководстве описывается, как оптимизировать приложения Cast для устройств, поддерживающих только звук, и воспользоваться преимуществами снижения требований к памяти, процессору и использованию полосы пропускания сети.

Приложение, поддерживающее Google Cast для аудио, должно учитывать следующее:

  • Google Cast для аудиоустройств не отображает видео или графику. Однако многие аудиоустройства имеют дисплей для отображения метаданных, таких как состояние воспроизведения (воспроизведение или пауза) и прогресс. Ваше приложение не должно отображать такую ​​важную пользовательскую информацию только на приемнике; критическая информация и большая часть пользовательского интерфейса должны отображаться на отправителе.
  • Для правильной работы приложений веб-приемника Google Cast для аудиоустройств по-прежнему должен отображать графику, даже если она не отображается. Поскольку устройства могут не поддерживать графические операции с аппаратным ускорением, приложениям-получателям следует избегать использования операций с интенсивным использованием графики, таких как цветовые градиенты, вращение, альфа-смешение и повторное рисование больших объектов, таких как индикаторы выполнения, чаще, чем один раз в секунду.
  • Google Cast для аудиоустройств поддерживает только контент, защищенный Widevine for Digital Rights Management (DRM).
  • Для большинства Google Cast для аудиоустройств приложение-отправитель контролирует весь диапазон громкости устройства (например, динамика), а не только громкость источника звука, поступающего на телевизор, как в случае с устройством Chromecast.
  • Помимо управления воспроизведением с помощью устройства-отправителя (например, телефона), приложению может потребоваться обеспечить управление воспроизведением с помощью собственных контроллеров устройства, таких как пульт дистанционного управления, кнопки на устройстве или внешнее удаленное приложение.
  • Google Cast для аудиоустройства может поддерживать отображение метаданных контента с помощью небольшого ЖК-экрана, выхода HDMI (для звуковых панелей или аудио-видеоресиверов) или внешнего удаленного приложения, в зависимости от пользовательского интерфейса конкретного устройства.

Разработка

Первым шагом в разработке приложения Cast для поддержки Google Cast для аудио является разработка приложения Cast для аудио и видео и обеспечение его работы на Chromecast. В этом документе предполагается, что вы разработали и протестировали такое приложение.

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

Например, приложения с двумя видео и аудио (например, приложения для воспроизведения локальных файлов или файлов NAS) должны включать трансляцию на устройства только со звуком, чтобы поддерживать воспроизведение аудиофайлов, но приложение не должно позволять пользователю отправлять видеофайлы на устройство только со звуком. Приложение может использовать API-интерфейсы возможностей устройства для отправителей, описанные ниже, чтобы определить контент, подходящий для устройства.

Чтобы поддерживать Google Cast для аудио, ваше приложение должно выполнять следующие действия:

  • Поддержка только аудио: потоковая передача музыки и аудиофайлов, радио и т. д. Мультимедиа, передаваемое в приложение Web Receiver, не должно быть видеопотоком. Кроме того, избегайте потоковой передачи графики и изображений, чтобы сократить время запуска приложений и использование памяти. См. рекомендации по использованию памяти ниже.

  • Запустите, как ожидалось, на аудиоустройстве Cast для аудио, а также на обычном Chromecast.

Возможности устройства

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

HTTP-заголовок устройства

HTTP-заголовок CAST-DEVICE-CAPABILITIES предоставляемый устройством Cast во время запуска приложения, описывает возможности устройства. Устройство отправляет запрос с этим заголовком на сервер, на котором размещено приложение веб-приемника. Заголовок устройства только для звука описывает возможности устройства с помощью CAST-DEVICE-CAPABILITIES: {"display_supported":false} .

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

API веб-приемника

Вы можете получить тот же объект возможностей устройства, вызвав CastReceiverManager.getDeviceCapabilities() при загрузке приложения веб-приемника.

Дополнительные сведения см. в разделе Возможности устройства .

API-интерфейсы отправителя

Каждый из API-интерфейсов Cast-отправителя также содержит информацию о возможностях устройства. Это позволяет вашему приложению-отправителю определить, какой тип мультимедиа отправлять получателю. Если ваше приложение поддерживает как аудио, так и видео, оно может избежать отправки видеоконтента на устройства, поддерживающие только аудио. Кроме того, ваше приложение может управлять громкостью наиболее подходящим для устройства способом, как описано в Контрольном списке проектирования . См. следующие API-интерфейсы возможностей устройства для отправителей:

Рекомендации по использованию памяти

Приложения веб-приемника, работающие на аудиоустройствах, должны управлять использованием памяти следующим образом:

  • Не загружайте и не используйте какие-либо изображения или графические ресурсы, чтобы уменьшить объем памяти и сократить время до начала воспроизведения.
  • При использовании Media Source Extensions (MSE) приложения должны ограничивать размер буфера потока до 2 МБ. При использовании библиотеки медиаплеера (MPL) размер буфера потока приложения уже определен MPL.
  • При использовании HTMLMediaElement размер буфера потока приложения определяется Chrome на основе скорости потока. Ограничьте битрейт звука до 2 мегабит в секунду, что поддерживает все кодеки, описанные в разделе «Поддерживаемые носители» (до 48 кГц/16 бит).

Регулятор громкости

Для большинства Google Cast для аудиоустройств приложение-отправитель контролирует весь диапазон громкости устройства, а не только входную громкость источника звука, как в случае с устройством Chromecast. Это означает, что шаг изменения громкости должен быть меньшим для приложений, предназначенных только для аудио. Инструкции по обеспечению регулировки громкости в вашем приложении см. в следующих документах:

Элементы управления устройством

Google Cast для аудиоустройств может иметь собственные элементы управления воспроизведением (например, кнопки, пульты дистанционного управления). Они используют сообщения воспроизведения мультимедиа, определенные для пространства имен urn:x-cast:com.google.cast.media , как описано в разделе «Сообщения воспроизведения мультимедиа» , для управления воспроизведением в приложении-приемнике. Приложение-приемник должно поддерживать эти сообщения о воспроизведении мультимедиа, чтобы поддерживать элементы управления воспроизведением устройства.

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

Дисплей устройства

Google Cast для аудиоустройства может иметь ЖК-экран на устройстве или приложение управления для конкретного устройства, которое отображает метаданные мультимедиа. Ваше приложение-приемник должно предоставить эти метаданные для всех аудиодорожек и обеспечить их синхронизацию с воспроизводимым в данный момент контентом, чтобы обеспечить правильное отображение метаданных на дисплее. Если приложение использует пользовательские метаданные, оно также должно предоставить стандартные метаданные аудио (название трека, имя исполнителя, название альбома и т. д.), как описано для каждой платформы ниже.

Получатель получает метаданные от отправителя при загрузке носителя. В приложении-отправителе с помощью команды загрузки мультимедиа в получатель необходимо указать поля, описанные ниже, чтобы метаданные отображались на Google Cast для аудиоустройства. Используйте следующие API:

Если приложение Cast управляет очередью мультимедиа на получателе или в облаке, веб-приемник должен транслировать любые обновления статуса мультимедиа, используя пространство имен urn:x-cast:com.google.cast.media чтобы все отправители были синхронизированы.

Регистрация

Вам необходимо зарегистрировать Google Cast для аудиоустройства для тестирования и зарегистрировать свое приложение для поддержки Google Cast для аудиоустройств с помощью консоли разработчика Google Cast SDK .

  • Дополнительную информацию о регистрации устройств см. в разделе «Устройства ».
  • При регистрации приложения необходимо установить флажок «Поддерживает трансляцию на устройства только с аудио», чтобы приложение могло обнаруживать Google Cast для аудиоустройств. См. Зарегистрируйте свое приложение .

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

Google Cast для аудио 2.0

Google Cast for Audio (GC4A) 2.0 — это аудиоплатформа Cast следующего поколения, предназначенная для устройств с малым объемом памяти и позволяющая расширить экосистему устройств, которые могут осуществлять потоковую передачу вашего контента. Поскольку GC4A 2.0 ориентирован на аудиоплатформы, набор веб-API сокращен для обеспечения совместимости с устройствами без дисплея. GC4A 2.0 распространяется на новые и существующие динамики, поддерживающие трансляцию.

Тестирование и отладка

Поскольку все поддерживаемые динамики перейдут на GC4A 2.0, важно, чтобы разработчики аудиоприложений тестировали свои приложения на GC4A 2.0. Вы можете протестировать свое приложение Cast для GC4A 2.0 на любом из перечисленных здесь устройств GC4A 2.0.

GC4A 2.0 не поддерживает удаленный отладчик Chrome. Если вы хотите отладить свое приложение, Google рекомендует использовать Cast Debug Logger .

Доступные устройства GC4A 2.0

Это неполный список устройств GC4A 2.0:

  • Bose: динамик Wi-Fi и умные саундбары
  • JBL: зарядка 5 Wi-Fi/Boombox 3 Wi-Fi/аутентичность 200, 300 и 500
  • Samsung: музыкальная рамка/саундбары
  • LG: Саундбары S90TY/SG10TY/SE70Q/S80Q/S90Q
  • Bang & Olufsen Beosound 2 / Beocore Connect
  • Соноро Маэстро 2 / Мейстерштрук 2
  • Кембридж Аудио MXN10
  • КЕФ LS60/LSX II
  • Тойфель Мотив Главная
  • Нордик Аргон Аудио
  • WiiM CI MOD S/Ультра

Рекомендуется протестировать все функции приложения на GC4A 2.0. Обязательно включите тестирование воспроизведения всех типов мультимедиа (подкастов, потоков и т. д.), приостановку, прокрутку, пропуск, изменение списков воспроизведения, остановку и повторное подключение Cast.

Поддерживаемые API

GC4A 2.0 поддерживает следующие API:

  • HTML
  • JavaScript ECMA 6
  • DOMParser
  • XMLСериализатор
  • Документ и подклассы
  • ДокументФрагмент
  • HTMLMediaElement и HTMLAudioElement
  • HTMLVideoElement (может воспроизводить только аудиоконтент)
  • HTMLScriptЭлемент
  • HTMLBaseElement
  • HTMLTemplateElement
  • Пользовательские элементы
  • Тень ДОМ
  • Модули сценариев / асинхронные / отложенные
  • Получить / XHR
  • Вебсокет
  • Порт сообщения
  • Файлы cookie
  • MSE (расширения источников мультимедиа)
  • EME (расширения зашифрованного мультимедиа)
  • Локальное/сессионное хранилище
  • DRM (com.widevine.alpha и org.w3.clearkey)
    • Поддерживается только программное дешифрование ( SW_SECURE_CRYPTO ).
  • Subtle Crypto поддерживает только расшифровку AES-CBC

GC4A 2.0 не поддерживает:

  • Импорт динамических модулей (добавится в 2024 г.)
  • CSS
  • IFrame
  • Текстовые дорожки

Идентификация

Хотя ожидается, что приложения Cast Receiver будут универсальными для всех устройств Cast, иногда бывает полезно определить, на каком устройстве вы работаете. Устройства GC4A 2.0 можно идентифицировать с помощью строки пользовательского агента.

  • Все устройства Cast содержат CrKey/ и версию. Пример: CrKey/1.68.000001 .
  • Устройства GC4A 2.0 содержат Castlite/ и его версию. Пример: Castlite/1.0 .

Контакт

Если вам нужна помощь в настройке для тестирования или вы не можете использовать динамик Bose, свяжитесь с нами по адресу gc4a-support-external@google.com.

,

Google Cast для аудиоустройств поддерживает только воспроизведение звука. В этом руководстве описывается, как оптимизировать приложения Cast для устройств, поддерживающих только звук, и воспользоваться преимуществами снижения требований к памяти, процессору и использованию полосы пропускания сети.

Приложение, поддерживающее Google Cast для аудио, должно учитывать следующее:

  • Google Cast для аудиоустройств не отображает видео или графику. Однако многие аудиоустройства имеют дисплей для отображения метаданных, таких как состояние воспроизведения (воспроизведение или пауза) и прогресс. Ваше приложение не должно отображать такую ​​важную пользовательскую информацию только на приемнике; критическая информация и большая часть пользовательского интерфейса должны отображаться на отправителе.
  • Для правильной работы приложений веб-приемника Google Cast для аудиоустройств по-прежнему должен отображать графику, даже если она не отображается. Поскольку устройства могут не поддерживать графические операции с аппаратным ускорением, приложениям-получателям следует избегать использования операций с интенсивным использованием графики, таких как цветовые градиенты, вращение, альфа-смешение и повторное рисование больших объектов, таких как индикаторы выполнения, чаще, чем один раз в секунду.
  • Google Cast для аудиоустройств поддерживает только контент, защищенный Widevine for Digital Rights Management (DRM).
  • Для большинства Google Cast для аудиоустройств приложение-отправитель контролирует весь диапазон громкости устройства (например, динамика), а не только громкость источника звука, поступающего на телевизор, как в случае с устройством Chromecast.
  • Помимо управления воспроизведением с помощью устройства-отправителя (например, телефона), приложению может потребоваться обеспечить управление воспроизведением с помощью собственных контроллеров устройства, таких как пульт дистанционного управления, кнопки на устройстве или внешнее удаленное приложение.
  • Google Cast для аудиоустройства может поддерживать отображение метаданных контента с помощью небольшого ЖК-экрана, выхода HDMI (для звуковых панелей или аудио-видеоресиверов) или внешнего удаленного приложения, в зависимости от пользовательского интерфейса конкретного устройства.

Разработка

Первым шагом в разработке приложения Cast для поддержки Google Cast для аудио является разработка приложения Cast для аудио и видео и обеспечение его работы на Chromecast. В этом документе предполагается, что вы разработали и протестировали такое приложение.

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

Например, приложения с двумя видео и аудио (например, приложения для воспроизведения локальных файлов или файлов NAS) должны включать трансляцию на устройства только со звуком, чтобы поддерживать воспроизведение аудиофайлов, но приложение не должно позволять пользователю отправлять видеофайлы на устройство только со звуком. Приложение может использовать API-интерфейсы возможностей устройства для отправителей, описанные ниже, чтобы определить контент, подходящий для устройства.

Чтобы поддерживать Google Cast для аудио, ваше приложение должно выполнять следующие действия:

  • Поддержка только аудио: потоковая передача музыки и аудиофайлов, радио и т. д. Мультимедиа, передаваемое в приложение Web Receiver, не должно быть видеопотоком. Кроме того, избегайте потоковой передачи графики и изображений, чтобы сократить время запуска приложений и использование памяти. См. рекомендации по использованию памяти ниже.

  • Запустите, как ожидалось, на аудиоустройстве Cast для аудио, а также на обычном Chromecast.

Возможности устройства

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

HTTP-заголовок устройства

HTTP-заголовок CAST-DEVICE-CAPABILITIES предоставляемый устройством Cast во время запуска приложения, описывает возможности устройства. Устройство отправляет запрос с этим заголовком на сервер, на котором размещено приложение веб-приемника. Заголовок устройства только для звука описывает возможности устройства с помощью CAST-DEVICE-CAPABILITIES: {"display_supported":false} .

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

API веб-приемника

Вы можете получить тот же объект возможностей устройства, вызвав CastReceiverManager.getDeviceCapabilities() при загрузке приложения веб-приемника.

Дополнительные сведения см. в разделе Возможности устройства .

API-интерфейсы отправителя

Каждый из API-интерфейсов Cast-отправителя также содержит информацию о возможностях устройства. Это позволяет вашему приложению-отправителю определить, какой тип мультимедиа отправлять получателю. Если ваше приложение поддерживает как аудио, так и видео, оно может избежать отправки видеоконтента на устройства, поддерживающие только аудио. Кроме того, ваше приложение может управлять громкостью наиболее подходящим для устройства способом, как описано в Контрольном списке проектирования . См. следующие API-интерфейсы возможностей устройства для отправителей:

Рекомендации по использованию памяти

Приложения веб-приемника, работающие на аудиоустройствах, должны управлять использованием памяти следующим образом:

  • Не загружайте и не используйте какие-либо изображения или графические ресурсы, чтобы уменьшить объем памяти и сократить время до начала воспроизведения.
  • При использовании Media Source Extensions (MSE) приложения должны ограничивать размер буфера потока до 2 МБ. При использовании библиотеки медиаплеера (MPL) размер буфера потока приложения уже определен MPL.
  • При использовании HTMLMediaElement размер буфера потока приложения определяется Chrome на основе скорости потока. Ограничьте битрейт звука до 2 мегабит в секунду, что поддерживает все кодеки, описанные в разделе «Поддерживаемые носители» (до 48 кГц/16 бит).

Регулятор громкости

Для большинства Google Cast для аудиоустройств приложение-отправитель контролирует весь диапазон громкости устройства, а не только входную громкость источника звука, как в случае с устройством Chromecast. Это означает, что шаг изменения громкости должен быть меньшим для приложений, предназначенных только для аудио. Инструкции по обеспечению регулировки громкости в вашем приложении см. в следующих документах:

Элементы управления устройством

Google Cast для аудиоустройств может иметь собственные элементы управления воспроизведением (например, кнопки, пульты дистанционного управления). Они используют сообщения воспроизведения мультимедиа, определенные для пространства имен urn:x-cast:com.google.cast.media , как описано в разделе «Сообщения воспроизведения мультимедиа» , для управления воспроизведением в приложении-приемнике. Приложение-приемник должно поддерживать эти сообщения о воспроизведении мультимедиа, чтобы поддерживать элементы управления воспроизведением устройства.

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

Дисплей устройства

Google Cast для аудиоустройства может иметь ЖК-экран на устройстве или приложение управления для конкретного устройства, которое отображает метаданные мультимедиа. Ваше приложение-приемник должно предоставить эти метаданные для всех аудиодорожек и обеспечить их синхронизацию с воспроизводимым в данный момент контентом, чтобы обеспечить правильное отображение метаданных на дисплее. Если приложение использует пользовательские метаданные, оно также должно предоставить стандартные метаданные аудио (название трека, имя исполнителя, название альбома и т. д.), как описано для каждой платформы ниже.

Получатель получает метаданные от отправителя при загрузке носителя. В приложении-отправителе с помощью команды загрузки мультимедиа в получатель необходимо указать поля, описанные ниже, чтобы метаданные отображались на Google Cast для аудиоустройства. Используйте следующие API:

Если приложение Cast управляет очередью мультимедиа на получателе или в облаке, веб-приемник должен транслировать любые обновления статуса мультимедиа, используя пространство имен urn:x-cast:com.google.cast.media чтобы все отправители были синхронизированы.

Регистрация

Вам необходимо зарегистрировать Google Cast для аудиоустройства для тестирования и зарегистрировать свое приложение для поддержки Google Cast для аудиоустройств с помощью консоли разработчика Google Cast SDK .

  • Дополнительную информацию о регистрации устройств см. в разделе «Устройства ».
  • Вы должны проверить флажок поддержанных поддержанных устройств только для аудио при регистрации вашего приложения, чтобы позволить вашему приложению обнаружить Google Capt для аудиоустройства. См. Зарегистрируйте свое заявление .

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

Google актер для Audio 2.0

Google Capt для Audio (GC4A) 2.0 - это аудио -платформа следующего поколения, предназначенная для нацеливания на устройства с низким содержанием памяти, чтобы расширить экосистему устройств, которые могут транслировать ваш контент. Поскольку GC4A 2.0 нацелен на аудио платформы, набор веб -API уменьшается до выравнивания с помощью устройств. GC4A 2.0 разрабатывает новые и существующие динамики, которые поддерживают актеры.

Тестирование и отладка

Поскольку все поддерживаемые докладчики будут переходить на GC4A 2.0, важно, чтобы разработчики Audio App проверяли свои приложения на GC4A 2.0. Вы можете проверить свое приложение для актеров на GC4A 2.0 на любом из устройств GC4A 2.0, перечисленных здесь.

GC4A 2.0 не поддерживает удаленного отладчика Chrome. Если вы хотите отлаживать свое приложение, Google рекомендует использовать журнал отладки .

Доступные устройства GC4A 2.0

Это некомпирационный список устройств GC4A 2.0:

  • Bose: динамик Wi -Fi и умные звуковые панели
  • JBL: Зарядка 5 Wi-Fi / Boombox 3 Wi-Fi / Authentics 200, 300 и 500
  • Samsung: музыкальный кадр / звуковые панели
  • LG: Soundbars S90Ty/SG10TY/SE70Q/S80Q/S90Q
  • Bang & Olufsen beosound 2 / beocore connect
  • Sonoro Maestro 2 / Meisterstruck 2
  • Cambridge Audio MXN10
  • KEF LS60 / LSX II
  • Teufel Motiv Home
  • Северный аргон аудио
  • Wiim ci mod s / ultra

Рекомендуется тестирование всех функций приложения на GC4A 2.0. Обязательно включите тестирование воспроизведения всех типов мультимедиа (подкасты, потоки и т. Д.), Пауза, очистка, пропуск, изменение списков воспроизведения, остановки и повторного подключения.

Поддерживается API

GC4A 2.0 поддерживает следующие API:

  • HTML
  • JavaScript ECMA 6
  • Domparser
  • XmlSerializer
  • Документ и подклассы
  • DocumentFragment
  • HtmlMedieElement & HtmlaudioElement
  • HTMLVideOelement (может воспроизводить только аудиоконтент)
  • Htmlscriptelement
  • Htmlbaseelement
  • Htmltemplateelement
  • Пользовательские элементы
  • Тень Дом
  • Модули сценария / асинхро
  • Fetch / xhr
  • WebSocket
  • MessagePort
  • Печенье
  • MSE (расширения источника СМИ)
  • EME (зашифрованные расширения среды)
  • Локальное / сессионное хранилище
  • DRM (com.widevine.alpha & org.w3.clearkey)
    • Поддерживается только программное расшифрование ( SW_SECURE_CRYPTO )
  • Тонкий крипто. Только поддерживает расшифрование AES-CBC

GC4A 2.0 не поддерживает:

  • Динамический импорт модуля (будет добавлен в 2024 г.)
  • CSS
  • Iframe
  • Текстовые обработки

Идентификация

В то время как приложения для применения литой приемника будут универсальными для всех литых устройств, иногда может быть полезно определить, на каком устройстве вы используете. Устройства GC4A 2.0 могут быть идентифицированы с использованием строки агента пользователя.

  • Все устройства актеров содержат CrKey/ и версию. Пример: CrKey/1.68.000001 .
  • Устройства GC4A 2.0 содержат Castlite/ и версию. Пример: Castlite/1.0 .

Контакт

Пожалуйста, свяжитесь с GC4A-support-external@google.com, если вам нужна помощь для настройки для тестирования, или вы не можете использовать динамик Bose.

,

Google Capt для аудиоустройства поддерживает только воспроизведение звука. В этом руководстве описывается, как оптимизировать приложения изделия для устройств только для аудио и воспользоваться сниженными требованиями в области памяти, процессора и использования пропускной способности сети.

Приложение, которое поддерживает Google Capt для аудио, должно учитывать следующее:

  • Google Capt для аудиоустройства не отображает видео или графику. Тем не менее, многие аудиоустройства имеют дисплей для демонстрации метаданных, таких как состояние воспроизведения (игра или приостановка) и прогресс. Ваше приложение не должно отображать такую ​​критическую информацию пользователя только на приемнике; Критическая информация и большая часть пользовательского интерфейса должны быть показаны на отправителе.
  • Чтобы правильно запустить приложения для веб -приемника, Google Cast для аудиоустройства все еще должна рендерировать графику, даже если они не отображаются. Поскольку устройства могут не поддерживать аппаратные графические операции, приложения приемника должны избегать использования графических операций, таких как цветовые градиенты, вращение, альфа-смешивание и повторное демонстрацию больших объектов, таких как панели хода более одного раза в секунду.
  • Google Capt for Audio Devices поддерживает только WideVine для защищенного контента для управления цифровыми правами (DRM).
  • Для большинства Google Capt для аудиоустройства приложение отправителя управляет полным диапазоном громкости устройства (например, динамик), а не только объем ввода аудио источника для телевизора, как в случае с устройством Chromecast.
  • В дополнение к управлению воспроизведением с помощью устройства отправителя (например, телефона), приложение, возможно, придется предусматривать управление воспроизведением с помощью собственных контроллеров устройства, таких как пульт дистанционного управления, кнопки на устройстве или внешнее удаленное приложение.
  • Google Capt для аудиоустройства может поддерживать отображение метаданных контента с помощью небольшого ЖК-экрана, вывода HDMI (для звуковых панелей или аудио-видео-приемников) или внешнее удаленное приложение, в зависимости от конкретного пользовательского интерфейса устройства.

Разработка

Первым шагом в разработке актерского приложения для поддержки Google Capt для Audio является разработка приложения актеров для аудио-видео и убедиться, что оно работает на Chromecast. Этот документ предполагает, что вы разработали и проверили такое приложение.

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

Например, двойные приложения для видео и аудио (например, приложения для воспроизведения файлов Local/NAS) должны включать катирование на устройства только для аудио, чтобы поддержать воспроизведение аудиофайлов, но приложение не должно разрешать пользователю отправлять видеофайлы на устройство только для аудио. Приложение может использовать API -интерфейсы возможностей устройства для отправителей, описанных ниже, чтобы определить содержимое, подходящее для устройства.

Чтобы поддержать Google Capt для аудио, ваше приложение должно сделать следующее:

  • Поддержка только для аудио: потоковая музыка и аудиофайлы, радио и т. Д. Медиа, передаваемая в приложение веб-приемника, не должна быть видеопотоком. Кроме того, избегайте потоковой графики и изображений, чтобы улучшить время запуска приложения и использование памяти. См. Руководство по использованию памяти , ниже.

  • Запустите, как и ожидалось, на актерском составе для аудиоустройства, а также обычный хромек.

Возможности устройства

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

Устройство HTTP заголовок

Заголовок HTTP CAST-DEVICE-CAPABILITIES предоставленный лисовым устройством во время запуска приложения, описывает возможности устройства. Устройство отправляет запрос с этим заголовком на сервер, разбирающийся в приложении веб -приемника. Заголовок для устройства только для аудио описывает возможности устройства с помощью CAST-DEVICE-CAPABILITIES: {"display_supported":false} .

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

Веб -приемник API

Вы можете получить тот же объект возможностей для устройства, вызывая CastReceiverManager.getDeviceCapabilities() при загрузке приложения веб -приемника.

Смотрите возможности устройства для получения дополнительной информации.

Отправитель API

У каждого из актеров API также есть информация о возможностях устройства. Они позволяют приложению вашего отправителя определить, какой вид носителя отправлять в приемник. Если ваше приложение поддерживает как аудио, так и видео, оно может избежать отправки видеоконтента на устройства только для аудио. Кроме того, ваше приложение может управлять объемом, используя метод, наиболее подходящий для устройства, как описано в контрольном списке проектирования . Смотрите API -интерфейсы для отправителей следующие возможности устройства:

Рекомендации по использованию памяти

Приложения веб -приемника, работающие на аудиопорядках, должны управлять использованием памяти следующим образом:

  • Избегайте загрузки или использования каких -либо изображений или графических активов, чтобы уменьшить след и сократить время до начала воспроизведения.
  • При использовании расширений источника носителя (MSE) приложения должны ограничивать буфер потока 2 МБ. При использовании библиотеки медиаплееров (MPL) размер буфера потока приложения уже определяется MPL.
  • При использовании HTMLMedieElement размер буфера потока приложения определяется Chrome на основе скорости потока. Ограничьте аудио битрейт до 2 мегабит в секунду, что поддерживает все кодеки, описанные в поддерживаемой среде (до 48 кГц/16 -бит).

Объемный контроль

Для большинства Google Capt для аудиоустройства приложение отправителя управляет полным диапазоном громкости устройства, а не только в входном объеме аудио, как в случае с устройством Chromecast. Это означает, что приращения изменения объема должны быть меньше для приложений только для аудио. См. Следующие документы для руководящих принципов по предоставлению управления громкостью в вашем приложении:

Управление устройством

Google Capt для аудиоустройства может иметь свои собственные элементы управления воспроизведением (например, кнопки, пульты). Они используют сообщения о воспроизведении медиа, определенные для urn:x-cast:com.google.cast.media пространство имен, как описано в сообщениях о воспроизведении медиа , для управления воспроизведением в приложении получателя. Ваше приложение для получателя должно поддерживать эти сообщения о воспроизведении медиа, чтобы поддержать элементы управления воспроизведением устройства.

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

Дисплей устройства

Google Capt для аудиоустройства может иметь ЖК-экран на устройстве или приложение управления, специфичное для устройства, которое отображает метаданные носителя. Ваше приложение для приемника должно предоставить эти метаданные для всех аудиотеров и обеспечить синхронизацию с контентом в настоящее время, чтобы гарантировать, что метаданные отображаются надлежащим образом на дисплее. Если приложение использует пользовательские метаданные, оно также должно предоставить стандартные звуковые метаданные (название трека, название артиста, название альбома и т. Д.), Как описано для каждой платформы ниже.

Приемник получает метаданные от отправителя, когда он загружает носитель. В вашем приложении отправителя, с командой для загрузки носителя на приемник, вы должны указать поля, описанные ниже, чтобы метаданные отображались в Google Capt для аудио -устройства. Используйте следующие API:

Если приложение CAST управляет медиа-очередью на приемнике или в облаке, веб-приемник должен транслировать любые обновления статуса медиа, используя urn:x-cast:com.google.cast.media пространство имен, чтобы все отправители были синхронизированы.

Регистрация

Вы должны зарегистрировать свой Google Capt для аудиоустройства для тестирования и зарегистрировать свое приложение, чтобы поддержать Google Capt для аудиоустройства, используя консоль разработчика Google Cast SDK .

  • См. Устройства для получения дополнительной информации о регистрации устройств.
  • Вы должны проверить флажок поддержанных поддержанных устройств только для аудио при регистрации вашего приложения, чтобы позволить вашему приложению обнаружить Google Capt для аудиоустройства. См. Зарегистрируйте свое заявление .

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

Google актер для Audio 2.0

Google Capt для Audio (GC4A) 2.0 - это аудио -платформа следующего поколения, предназначенная для нацеливания на устройства с низким содержанием памяти, чтобы расширить экосистему устройств, которые могут транслировать ваш контент. Поскольку GC4A 2.0 нацелен на аудио платформы, набор веб -API уменьшается до выравнивания с помощью устройств. GC4A 2.0 разрабатывает новые и существующие динамики, которые поддерживают актеры.

Тестирование и отладка

Поскольку все поддерживаемые докладчики будут переходить на GC4A 2.0, важно, чтобы разработчики Audio App проверяли свои приложения на GC4A 2.0. Вы можете проверить свое приложение для актеров на GC4A 2.0 на любом из устройств GC4A 2.0, перечисленных здесь.

GC4A 2.0 не поддерживает удаленного отладчика Chrome. Если вы хотите отлаживать свое приложение, Google рекомендует использовать журнал отладки .

Доступные устройства GC4A 2.0

Это некомпирационный список устройств GC4A 2.0:

  • Bose: динамик Wi -Fi и умные звуковые панели
  • JBL: Зарядка 5 Wi-Fi / Boombox 3 Wi-Fi / Authentics 200, 300 и 500
  • Samsung: музыкальный кадр / звуковые панели
  • LG: Soundbars S90Ty/SG10TY/SE70Q/S80Q/S90Q
  • Bang & Olufsen beosound 2 / beocore connect
  • Sonoro Maestro 2 / Meisterstruck 2
  • Cambridge Audio MXN10
  • KEF LS60 / LSX II
  • Teufel Motiv Home
  • Северный аргон аудио
  • Wiim ci mod s / ultra

Рекомендуется тестирование всех функций приложения на GC4A 2.0. Обязательно включите тестирование воспроизведения всех типов мультимедиа (подкасты, потоки и т. Д.), Пауза, очистка, пропуск, изменение списков воспроизведения, остановки и повторного подключения.

Поддерживается API

GC4A 2.0 поддерживает следующие API:

  • HTML
  • JavaScript ECMA 6
  • Domparser
  • XmlSerializer
  • Документ и подклассы
  • DocumentFragment
  • HtmlMedieElement & HtmlaudioElement
  • HTMLVideOelement (может воспроизводить только аудиоконтент)
  • Htmlscriptelement
  • Htmlbaseelement
  • Htmltemplateelement
  • Пользовательские элементы
  • Тень Дом
  • Модули сценария / асинхро
  • Fetch / xhr
  • WebSocket
  • MessagePort
  • Печенье
  • MSE (расширения источника СМИ)
  • EME (зашифрованные расширения среды)
  • Локальное / сессионное хранилище
  • DRM (com.widevine.alpha & org.w3.clearkey)
    • Поддерживается только программное расшифрование ( SW_SECURE_CRYPTO )
  • Тонкий крипто. Только поддерживает расшифрование AES-CBC

GC4A 2.0 не поддерживает:

  • Динамический импорт модуля (будет добавлен в 2024 г.)
  • CSS
  • Iframe
  • Текстовые обрывы

Идентификация

В то время как приложения для применения литой приемника будут универсальными для всех литых устройств, иногда может быть полезно определить, на каком устройстве вы используете. Устройства GC4A 2.0 могут быть идентифицированы с использованием строки агента пользователя.

  • Все устройства актеров содержат CrKey/ и версию. Пример: CrKey/1.68.000001 .
  • Устройства GC4A 2.0 содержат Castlite/ и версию. Пример: Castlite/1.0 .

Контакт

Пожалуйста, свяжитесь с GC4A-support-external@google.com, если вам нужна помощь для настройки для тестирования, или вы не можете использовать динамик Bose.