soundsible
EN
Explorar documentación
Documentación de v0.33.0Ver fuente original ↗

Integración del coche

Soundsible tiene tres capas orientadas al uso en el coche entre su implementación y sus planes:

La aplicación nativa de iOS nunca se ha instalado ni ejecutado en un dispositivo. Su comportamiento en el coche es teórico. Las compilaciones IPA y las pruebas de código no validan la reproducción nativa ni los controles del coche; la implementación de Media Session para la web es una vía independiente.

  1. Superficies del reproductor nativo del teléfono: Bluetooth, USB, pantalla de bloqueo y pantallas multimedia del automóvil que reflejan el estado En reproducción del teléfono.
  2. Aplicaciones complementarias nativas: iOS primero, Android después.
  3. Superficies de proyección oficiales: CarPlay y Android Auto.

El reproductor web ahora posee la ruta rápida a través de la API de sesión multimedia del navegador. Esto mejora los metadatos y los controles para las superficies multimedia nativas del teléfono, pero no convierte a la PWA en una aplicación automática CarPlay o Android.

Capa Web/Bluetooth actual

El reproductor web publica las URL absolutas del arte de la sesión multimedia, el estado de reproducción, el estado de posición y los controladores para:

  • reproducir
  • pausa
  • siguiente
  • anterior
  • buscar hacia atrás/adelante
  • buscar posicionarse

Esta es la mejor ruta disponible para las pantallas de bloqueo Safari/Chrome, controles Bluetooth, superficies de medios USB y vistas de “Reproducción en curso” nativas del automóvil que reflejan el teléfono. Todavía está mediado por el navegador, por lo que los automóviles individuales y las versiones del navegador pueden diferir.

Contrato API

Los clientes de automóviles nativos deben comenzar con:

GET /api/car/home
GET /api/car/items/<item_id>

Estos puntos finales requieren library:read o un token de propietario. En el modo de compatibilidad avanzada/sin cabeza, también se permiten clientes LAN/Tailscale de confianza.

Cada artículo devuelto utiliza esta forma estable:

{
  "id": "track-or-collection-id",
  "kind": "track",
  "track_id": "optional-library-track-id",
  "title": "Title",
  "subtitle": "Artist - Album",
  "artist": "Artist",
  "album": "Album",
  "duration_sec": 180,
  "artwork_url": "/api/static/cover/<track_id>",
  "stream_url": "/api/static/stream/<track_id>",
  "is_browsable": false,
  "is_playable": true
}

Los elementos de pódcast adquiridos también incluyen podcast_feed_id y podcast_episode_guid cuando están presentes en los metadatos de la biblioteca. Los clientes nativos usan esa identidad para el progreso del episodio; stream_url sigue apuntando al archivo adquirido. Las rutas del sistema de archivos local nunca forman parte de la respuesta para el coche.

Colecciones raíz:

  • recently-played
  • favourites
  • playlists
  • podcasts
  • radio
  • all-tracks

Los ID de las listas de reproducción están codificados como playlist:<url-encoded-name>.

Aplicación complementaria de iOS: solo código, nunca ejecutada en un dispositivo

El cliente nativo de iOS está en ios/ y se documenta en IOS.md. Su código pretende implementar lo siguiente; nada de ello se ha validado en un dispositivo:

  • Se empareja a través del flujo existente y mantiene el token del dispositivo emparejado en el llavero.
  • Explora /api/car/home y /api/car/items/<item_id>.
  • Reproduce desde stream_url hasta AVPlayer, con audio de fondo habilitado.
  • Publica MPNowPlayingInfoCenter y maneja MPRemoteCommandCenter.
  • Se registra como device_type: "ios" y publica el estado en /api/playback/state.

Dos cosas que el boceto original no decía, y ambas importan:

AVPlayer no puede transportar un encabezado Authorization a través de ninguna API pública. La aplicación enruta transmisiones autenticadas a través de un AVAssetResourceLoaderDelegate en un esquema personalizado, que reenvía rangos de bytes a URLSession donde los encabezados son normales. El AVURLAssetHTTPHeaderFieldsKey privado no se utiliza.

Reproducir en curso no es una formalidad. La barra de progreso de una unidad principal solo se mueve si MPNowPlayingInfoPropertyElapsedPlaybackTime y MPNowPlayingInfoPropertyPlaybackRate están publicados, y las unidades principales extraen sus botones desde los cuales se habilitan los MPRemoteCommand, por lo que los comandos que la cola no puede aceptar se desactivan en lugar de dejarse activados.

Objetivo CarPlay

Bloqueado, y no por nosotros. El derecho com.apple.developer.carplay-audio se otorga solo a aplicaciones publicadas en la App Store, y Soundsible no irá allí: la directriz 5.2.3 prohíbe descargar medios desde YouTube, que es lo que hace Soundsible. En su lugar, la aplicación se distribuye mediante descarga (consulte IOS.md).

Esto supone menos de lo que parece. Una aplicación de CarPlay añadiría la posibilidad de explorar tu biblioteca en la pantalla del coche. Todo lo demás que muestra un coche —título, artista, carátula, una barra que sigue el progreso, botones de reproducción en el volante y la pantalla En reproducción de Soundsible dentro del propio CarPlay— procede de MPNowPlayingInfoCenter y MPRemoteCommandCenter, está implementado sin ese permiso, pero nunca se ha probado en la aplicación nativa de Soundsible en un dispositivo.

Si Soundsible alguna vez se envía a través de AltStore PAL (mercados de la UE, 99 €/año, la certificación notarial verifica la seguridad en lugar del contenido) todavía no es la App Store, por lo que el derecho permanece fuera de su alcance. El siguiente árbol es lo que representaría un objetivo CarPlay si eso alguna vez cambia:

  • Inicio
  • Favoritos
  • Listas de reproducción
  • Jugado recientemente
  • Pódcasts
  • Semillas de radio

Evite la interfaz de usuario enriquecida o de formato libre en la pantalla del automóvil. La búsqueda y el descubrimiento complejo deben permanecer en el teléfono o en el escritorio a menos que las plantillas oficiales CarPlay permitan la interacción de forma segura.

Objetivo Android

La adaptación a Android solo tiene actualmente una estructura básica de desarrollo. Android Auto es un requisito del plan de adaptación, pero no está implementado ni validado.

La aplicación Android posterior debería exponer el mismo árbol /api/car/* a través de Media3 MediaLibraryService y MediaSession. Los sistemas operativos Android Auto y Android Automotive pueden luego representar la interfaz de usuario de navegación/reproducción desde la sesión multimedia nativa Android.

Buscar documentación