Google Cast para dispositivos de audio solo admite la reproducción de audio. En esta guía, se describe cómo optimizar las aplicaciones de Cast para dispositivos de solo audio y cómo aprovechar la reducción de la demanda en el uso de memoria, CPU y ancho de banda de red.
Una app compatible con Google Cast para audio debe tener lo siguiente en consideración:
- Google Cast para dispositivos de audio no muestra videos ni gráficos. Sin embargo, Muchos dispositivos de audio tienen una pantalla para mostrar metadatos, como la reproducción. el estado (reproduciendo o pausado) y el progreso. Tu aplicación no debe mostrar la información crítica del usuario solo en el receptor; información crítica, y la mayor parte de la interfaz de usuario, se debe mostrar en el remitente.
- Para ejecutar correctamente las aplicaciones del receptor web, Google Cast para dispositivos de audio deben renderizar gráficos, aunque no se muestran. Desde Es posible que los dispositivos no admitan operaciones gráficas aceleradas por hardware las aplicaciones receptoras deben evitar el uso de operaciones de alto contenido gráfico como gradientes de color, rotación, combinación alfa y volver a dibujar imágenes objetos, como barras de progreso, más de una vez por segundo.
- Google Cast para dispositivos de audio solo admite Widevine para derechos digitales. Administración (DRM) del contenido protegido.
- En la mayoría de los dispositivos de audio de Google Cast, la aplicación emisora controla el rango de volumen completo del dispositivo (una bocina, por ejemplo), no solo el de entrada de la fuente de audio a la TV, como con un dispositivo Chromecast.
- Además de controlar la reproducción con el dispositivo emisor (un teléfono, por ejemplo), puede que la app deba proporcionar el control de la reproducción con el controladores propios del dispositivo, como un control remoto, botones del dispositivo o una aplicación remota externa.
- Un dispositivo Google Cast para audio puede admitir la visualización de metadatos de contenido. con una pantalla LCD pequeña, salida HDMI (para barras de sonido o audio y video) de aplicaciones) o una aplicación remota externa, según la red del dispositivo de almacenamiento.
Desarrollo
El primer paso en el desarrollo de una aplicación de Cast para admitir Google Cast para audio es desarrollar una aplicación de Cast para audio y video, y garantizar que se ejecute un Chromecast. En este documento, se asume que desarrollaste y probaste esa app.
Una app puede admitir dispositivos que solo usen audio y video. Necesita saber cuando realiza una transmisión a una frente a la otra, y tomar medidas para garantizar que la experiencia del usuario en la situación.
Por ejemplo, apps duales de audio y video (como la reproducción de archivos locales o NAS) aplicaciones) deben permitir la transmisión a dispositivos de solo audio para admitir reproducir archivos de audio, pero la aplicación no debería permitir que el usuario envíe archivos de video al dispositivo de solo audio. La aplicación puede usar la APIs de funciones del dispositivo para remitentes que se describen a continuación para determinar el contenido adecuado para el dispositivo.
Para admitir Google Cast para el audio, tu app debe hacer lo siguiente:
Compatibilidad solo con audio: transmisión de música y archivos de audio, radio, etc. transmitirse a la aplicación receptora web no debe ser una transmisión de video por Internet. Además, evita transmisión de imágenes y gráficos para mejorar el tiempo de inicio de la aplicación y el uso de memoria. Consulta los lineamientos para el uso de memoria a continuación.
Se ejecutará según lo esperado en un dispositivo Cast para dispositivos de audio y en un Chromecast común.
Funciones del dispositivo
Tu app puede saber si se está ejecutando en un dispositivo de solo audio gracias al API de capacidades del dispositivo, disponibles desde el propio dispositivo o a través del emisor o APIs de receptor.
Encabezado HTTP del dispositivo
El encabezado HTTP CAST-DEVICE-CAPABILITIES proporcionado por el dispositivo de transmisión durante
el lanzamiento de una aplicación describe las capacidades del dispositivo. El dispositivo envía una solicitud
con este encabezado al servidor que aloja la app del receptor web. El encabezado de un
describe las capacidades del dispositivo con
CAST-DEVICE-CAPABILITIES: {"display_supported":false}
Cuando el servidor recibe la solicitud del dispositivo, puedes usar el información de este encabezado para redireccionar la solicitud a la app del receptor web, que está optimizado para dispositivos de audio.
API de Web Receiver
Puedes obtener el mismo objeto de capacidades del dispositivo llamando a CastReceiverManager.getDeviceCapabilities().
cuando se carga la app del receptor web.
Consulta Funciones del dispositivo para obtener más información información.
APIs de Sender
Cada una de las APIs de envío de Cast también tiene la información de las funciones del dispositivo. Estos permiten que tu app emisora determine qué tipo de contenido multimedia enviar al receptor. Si tu app admite audio y video, puede evitar que se envíe contenido de video a que solo usan audio. Además, tu app puede controlar el volumen con el método más apropiado para el dispositivo, como se describe en la lista de tareas de diseño. Consulta las siguientes APIs de capacidades del dispositivo para remitentes:
- Android: CastDevice.hasCapabilities
- iOS: deviceCapabilities
- Chrome: chrome.cast.Capability
Lineamientos de uso de la memoria
Las apps de receptor web que se ejecuten en dispositivos de audio deben administrar el uso de memoria de la siguiente manera:
- Evita descargar o usar cualquier imagen o recurso gráfico para reducir la memoria y acortar el tiempo hasta comenzar la reproducción.
- Cuando se usan extensiones de fuente de medios (MSE), las aplicaciones deben limitar la transmisión. a 2 MB. Si usas la biblioteca del reproductor multimedia (MPL), la interfaz de la aplicación MPL ya define el tamaño del búfer de transmisión.
- Cuando se usa HTMLMediaElement, se define el tamaño del búfer de transmisión de la aplicación por Chrome en función de la velocidad de transmisión. Limita la tasa de bits de audio a 2 megabits por por segundo, que admite todos los códecs descritos en Contenido multimedia compatible (hasta 48 KHz/16 bits).
Control de volumen
En la mayoría de los dispositivos de audio de Google Cast, la aplicación emisora controla el todo el rango de volumen del dispositivo, no solo el volumen de entrada de la fuente de audio, como con un dispositivo Chromecast. Esto significa que los incrementos del cambio de volumen deben ser menores para de audio. Consulta los siguientes documentos para obtener los lineamientos sobre cómo proporcionar el control de volumen en la app:
- Controles de volumen del remitente en la Lista de tareas de diseño
- Volumen del remitente de Android
- Volumen del remitente de iOS
- Volumen de remitentes web
Controles de dispositivos
Es posible que Google Cast para dispositivos de audio tenga sus propios controles de reproducción (como
botones o controles remotos). Usan los mensajes de reproducción multimedia definidos para las
urn:x-cast:com.google.cast.media, como se describe en
Mensajes de reproducción multimedia, para controlar la reproducción
en la aplicación receptora. La aplicación receptora debe admitir
estos mensajes de reproducción de contenido multimedia para admitir los controles de reproducción del dispositivo.
Además, tu app emisora debe admitir los Mensajes del receptor al remitente. para que, si el usuario cambia el estado del contenido multimedia con los controles del dispositivo, tus La app emisora puede recibir un mensaje de estado del receptor y actualizar la IU. según corresponda.
Pantalla del dispositivo
Un dispositivo Google Cast para audio puede tener una pantalla LCD en el dispositivo o aplicación de control específica del dispositivo que muestra metadatos de medios. Tu receptor La app debe proporcionar estos metadatos para todas las pistas de audio y asegurarse de que estén sincronizadas. con el contenido que se está reproduciendo para garantizar que los metadatos se muestren apropiadamente en la pantalla. Si la aplicación usa metadatos personalizados, También debe proporcionar los metadatos de audio estándar (nombre de la pista, nombre del artista, álbum). título, etc.), como se describe a continuación para cada plataforma.
La app receptora obtiene los metadatos del remitente cuando carga el contenido multimedia. En tu app emisora, con el comando para cargar contenido multimedia en la app receptora, debes especifica los campos que se describen a continuación para que los metadatos se muestren en la Google Cast para dispositivo de audio Usa las siguientes APIs:
Android
MediaMetadataconMEDIA_TYPE_MUSIC_TRACKy:iOS
GCKMediaMetadataconGCKMediaMetadataTypeGCKMediaMetadataTypeMusicTracky:Chrome
MediaInfoconMusicTrackMediaMetadatay:
Si la app de Cast administra una cola de contenido multimedia en la app receptora o en la nube, el
Web Receiver debe transmitir cualquier actualización de estado de contenido multimedia a través del
urn:x-cast:com.google.cast.media para que se puedan recuperar todos los remitentes
sincronizada.
Registro
Debes registrar tu Google Cast para un dispositivo de audio para pruebas y registros tu app para que admita Google Cast en dispositivos de audio a través del Consola para desarrolladores del SDK de Google Cast.
- Consulte Dispositivos para obtener más información. sobre el registro de dispositivos.
- Debes marcar la casilla de verificación Admite la transmisión a dispositivos de solo audio cuando registras tu aplicación para que esta descubra Google Cast para de audio. Consulta Registra tu aplicación.
En el caso de las aplicaciones no publicadas, como las que se usan para pruebas, también debes seleccionar el admitir dispositivos solo de audio para que la app descubra que solo usan audio.
Google Cast para audio 2.0
Google Cast para audio (GC4A) 2.0 es la plataforma de transmisión de audio de nueva generación diseñada para dispositivos con poca memoria, para ampliar el ecosistema de dispositivos pueden transmitir tu contenido. Debido a que GC4A 2.0 se orienta a plataformas de audio, la API web se reduce para alinearse con dispositivos sin visualización. GC4A 2.0 se lanzará en los nuevos y bocinas existentes que admiten transmisión.
Pruebas y depuración
Como todos los oradores compatibles harán la transición a GC4A 2.0, es importante que los desarrolladores de apps de audio prueban sus apps en GC4A 2.0. Puedes probar tu app de Cast para GC4A 2.0 en bocinas Wi-Fi Bose de producción, JBL Charge 5 Wi-Fi, JBL Authentics, Cambridge Audio, Teuful Motiv Home y LG 2024 Soundbars.
GC4A 2.0 no es compatible con Chrome Remote Debugger. Si quieres depurar tus , Google recomienda usar Cast Debug Logger.
Casos de prueba básicos recomendados
Se recomienda probar todas las funciones de la app en GC4A 2.0. Asegúrate de incluir pruebas de reproducción de todo tipo de contenido multimedia (podcasts, transmisiones, etc.), pausas, arrastres, omitir, cambiar listas de reproducción, detener la transmisión y volver a conectarla
API admitidas
GC4A 2.0 admite las siguientes APIs:
- HTML
- ECMA 6 para JavaScript
- DOMParser
- XMLSerializer
- Documento y subclases
- DocumentFragment
- HTMLMediaElement y HTMLAudioElement
- HTMLVideoElement (solo puede reproducir contenido de audio)
- HTMLScriptElement
- HTMLBaseElement
- HTMLTemplateElement
- Elementos personalizados
- Shadow DOM
- Módulos de secuencias de comandos / asíncrono / aplazado
- Recuperación / XHR
- WebSocket
- MessagePort
- Cookies
- ECM (extensiones de fuente de medios)
- EME (extensiones de medios encriptados)
- Almacenamiento local / de la sesión
GC4A 2.0 no admite lo siguiente:
- Importación de módulos dinámicos (se agregará en 2024)
- CSS
- IFrame
- TextTracks
Contacto
Comunícate con gc4a-support-external@google.com si si necesitas ayuda con la configuración para pruebas o no puedes usar una bocina Bose.