Las sesiones multimedia proporcionan una forma universal de interactuar con un audio o video
de fútbol favorito. En Media3, el reproductor predeterminado es la clase ExoPlayer
, que implementa
la interfaz Player
. La conexión de la sesión multimedia con el reproductor permite que una app
para anunciar la reproducción de contenido multimedia externamente y para recibir comandos de reproducción de
fuentes externas.
Los comandos pueden provenir de botones físicos, como el botón Reproducir en una auriculares o el control remoto de la TV. También pueden provenir de apps cliente que tengan controlador multimedia, como indicar "pausar" al Asistente de Google. Los medios de comunicación del usuario, delega estos comandos al reproductor de la app de música.
Cuándo elegir una sesión multimedia
Cuando implementas MediaSession
, permites que los usuarios controlen la reproducción:
- A través de sus auriculares A menudo, hay botones o interacciones táctiles que el usuario puede reproducir o pausar contenido multimedia en sus auriculares, o ir al siguiente o una pista anterior.
- Hablar con el Asistente de Google Un patrón común es decir "OK Google, pause" para pausar cualquier contenido multimedia que se esté reproduciendo en el dispositivo.
- Por medio de su reloj Wear OS Esto facilita el acceso a la mayoría controles de reproducción comunes mientras juegan en su teléfono.
- Mediante Controles de contenido multimedia En este carrusel, se muestran controles para cada uno mientras se ejecuta una sesión multimedia.
- En la TV Permite acciones con botones de reproducción físicos, reproducción en la plataforma y administración de energía (por ejemplo, si la TV, la barra de sonido o el receptor se apaga o se cambia la entrada, la reproducción debería detenerse en la aplicación).
- Y cualquier otro proceso externo que necesite influir en la reproducción.
Esto es ideal para muchos casos de uso. En particular, debes considerar seriamente
con MediaSession
en los siguientes casos:
- Estás transmitiendo contenido de video de formato largo, como películas o TV en vivo.
- Estás transmitiendo contenido de audio de formato largo, como podcasts o música listas de reproducción.
- Estás compilando una app para TV.
Sin embargo, no todos los casos de uso se adaptan bien a MediaSession
. Es posible que quieras
usa solo Player
en los siguientes casos:
- Estás mostrando contenido de formato corto, en el que la participación y la interacción del usuario es crucial.
- No hay un solo video activo, por ejemplo, el usuario se desplaza por una lista. y se muestran varios videos en pantalla al mismo tiempo.
- Estás reproduciendo un video de introducción o explicación único, que esperan que los usuarios miren activamente.
- Tu contenido es sensible para la privacidad y no quieres que los procesos externos Acceder a los metadatos del contenido multimedia (por ejemplo, el modo Incógnito en un navegador)
Si tu caso de uso no se adapta a ninguno de los anteriores, considera si
Aceptas que la app continúe la reproducción cuando el usuario no participa activamente.
con el contenido. Si la respuesta es sí, quizás quieras elegir
MediaSession
Si la respuesta es no, te recomendamos que uses Player
.
en su lugar.
Cómo crear una sesión multimedia
Una sesión multimedia existe junto al reproductor que administra. Puedes construir un
sesión multimedia con un objeto Context
y un objeto Player
. Deberías crear y
inicializan una sesión multimedia cuando sea necesario, como onStart()
o
Método de ciclo de vida onResume()
de Activity
, Fragment
o onCreate()
de la Service
que posee la sesión multimedia y su reproductor asociado.
Para crear una sesión multimedia, inicializa un Player
y proporciónalo a
MediaSession.Builder
de la siguiente manera:
Kotlin
val player = ExoPlayer.Builder(context).build() val mediaSession = MediaSession.Builder(context, player).build()
Java
ExoPlayer player = new ExoPlayer.Builder(context).build(); MediaSession mediaSession = new MediaSession.Builder(context, player).build();
Control automático del estado
La biblioteca Media3 actualiza automáticamente la sesión multimedia con el el estado del jugador. Por eso, no necesitas manejar manualmente la asignación desde de un jugador a una sesión.
Este es un punto de quiebre del enfoque heredado, en el que debías crear y mantener
un objeto PlaybackStateCompat
independientemente del reproductor, por ejemplo, para
indicar cualquier error.
ID de sesión único
De forma predeterminada, MediaSession.Builder
crea una sesión con una cadena vacía como
el ID de sesión. Esto es suficiente si una app tiene la intención de crear solo un
de sesión abierta, que es el caso más común.
Si una aplicación quiere administrar varias instancias de sesión al mismo tiempo, la aplicación
debe asegurarse de que el ID de cada sesión sea único. El ID de sesión se puede
cuando se compila la sesión con MediaSession.Builder.setId(String id)
.
Si ves una IllegalStateException
que hace que la app falle con el error
mensaje IllegalStateException: Session ID must be unique. ID=
, entonces
probable que una sesión se haya creado inesperadamente antes de una sesión
con el mismo ID. Para evitar que un objeto de escucha filtra las sesiones
programación, estos casos se detectan y notifican arrojando una
excepción.
Otórgales control a otros clientes
La sesión multimedia es la clave para controlar la reproducción. Te permite enrutar de fuentes externas al reproductor que hace el trabajo de reproducir medios de comunicación. Estas fuentes pueden ser botones físicos, como el botón de reproducción de una auriculares o el control remoto de la TV, o bien comandos indirectos, como instrucciones para pausar la reproducción, al Asistente de Google. Asimismo, te recomendamos que otorgues acceso a la versión de Android para facilitar los controles de notificaciones y de la pantalla de bloqueo, o a un dispositivo reloj para que puedas controlar la reproducción desde la cara de reloj. Los clientes externos pueden usar un controlador multimedia para emitir comandos de reproducción a tu app de música Son recibidos por tu sesión multimedia y, en última instancia, delega comandos al reproductor multimedia.
Cuando un controlador esté a punto de conectarse a tu sesión multimedia, el
onConnect()
método. Puedes usar el ControllerInfo
proporcionado
para decidir si aceptar
o rechazar
la solicitud. Para ver un ejemplo de aceptación de una solicitud de conexión, consulta el artículo Cómo declarar
de comandos disponibles.
Después de conectarse, un control puede enviar comandos de reproducción a la sesión. El
y, luego, delega esos comandos al reproductor. Reproducción y playlist
los comandos definidos en la interfaz de Player
se controlan automáticamente
sesión.
Otros métodos de devolución de llamada permiten controlar, por ejemplo, las solicitudes de
comandos de reproducción personalizados y
modificación de la playlist).
De manera similar, estas devoluciones de llamada incluyen un objeto ControllerInfo
para que puedas modificar
y cómo responderá a cada solicitud
en función del responsable del tratamiento de datos.
Modificar la playlist
Una sesión multimedia puede modificar directamente la playlist de su reproductor como se explica en
el
Guía de ExoPlayer para playlists
Los controladores también pueden modificar la playlist si
COMMAND_SET_MEDIA_ITEM
o COMMAND_CHANGE_MEDIA_ITEMS
está disponible para el controlador.
Cuando se agregan elementos nuevos a la playlist, el reproductor suele requerir MediaItem
instancias con un
URI definido
para que se puedan jugar. De forma predeterminada, los nuevos elementos agregados se reenvían automáticamente
a los métodos del reproductor, como player.addMediaItem
, si tienen un URI definido.
Si quieres personalizar las instancias de MediaItem
que se agregaron al reproductor, puedes
anular
onAddMediaItems()
Este paso es necesario si quieres admitir controladores que solicitan contenido multimedia.
sin un URI definido. En cambio, MediaItem
suele tener
uno o más de los siguientes campos configurados para describir el contenido multimedia solicitado:
MediaItem.id
: Es un ID genérico que identifica el contenido multimedia.MediaItem.RequestMetadata.mediaUri
: Es un URI de solicitud que puede usar un valor personalizado. y no siempre el reproductor puede reproducirlo directamente.MediaItem.RequestMetadata.searchQuery
: Una búsqueda textual, por ejemplo. de Asistente de Google.MediaItem.MediaMetadata
: Metadatos estructurados, como “título” o "artist".
Para obtener más opciones de personalización para playlists completamente nuevas, puedes
anular adicionalmente
onSetMediaItems()
que te permite definir el elemento de inicio y la posición en la playlist. Por ejemplo:
puedes expandir un único elemento solicitado a toda una lista de reproducción e indicarle al
jugador desde el índice del elemento solicitado originalmente. R
implementación de muestra de onSetMediaItems()
con esta función se pueden encontrar en la app de demostración de la sesión.
Cómo administrar diseños y comandos personalizados
En las siguientes secciones, se describe cómo anunciar un diseño personalizado de de comandos a las apps cliente y autoriza a los controladores a enviar la con comandos de SQL sencillos.
Define un diseño personalizado de la sesión
Para indicar a las apps cliente qué controles de reproducción quieres mostrar al
usuario, establece el diseño personalizado de la sesión.
Cuando compiles el MediaSession
en el método onCreate()
de tu
servicio.
Kotlin
override fun onCreate() { super.onCreate() val likeButton = CommandButton.Builder() .setDisplayName("Like") .setIconResId(R.drawable.like_icon) .setSessionCommand(SessionCommand(SessionCommand.COMMAND_CODE_SESSION_SET_RATING)) .build() val favoriteButton = CommandButton.Builder() .setDisplayName("Save to favorites") .setIconResId(R.drawable.favorite_icon) .setSessionCommand(SessionCommand(SAVE_TO_FAVORITES, Bundle())) .build() session = MediaSession.Builder(this, player) .setCallback(CustomMediaSessionCallback()) .setCustomLayout(ImmutableList.of(likeButton, favoriteButton)) .build() }
Java
@Override public void onCreate() { super.onCreate(); CommandButton likeButton = new CommandButton.Builder() .setDisplayName("Like") .setIconResId(R.drawable.like_icon) .setSessionCommand(new SessionCommand(SessionCommand.COMMAND_CODE_SESSION_SET_RATING)) .build(); CommandButton favoriteButton = new CommandButton.Builder() .setDisplayName("Save to favorites") .setIconResId(R.drawable.favorite_icon) .setSessionCommand(new SessionCommand(SAVE_TO_FAVORITES, new Bundle())) .build(); Player player = new ExoPlayer.Builder(this).build(); mediaSession = new MediaSession.Builder(this, player) .setCallback(new CustomMediaSessionCallback()) .setCustomLayout(ImmutableList.of(likeButton, favoriteButton)) .build(); }
Declara el reproductor disponible y los comandos personalizados
Las aplicaciones multimedia pueden definir comandos personalizados que, por ejemplo, pueden usarse en
un diseño personalizado. Por ejemplo, es posible que desees implementar botones que permitan a los
usuario guarda un elemento multimedia en una lista de elementos favoritos. El MediaController
envía comandos personalizados, y MediaSession.Callback
los recibe.
Puedes definir qué comandos de sesión personalizados están disponibles para un
Es MediaController
cuando se conecta a tu sesión multimedia. Lo logras al
que anula MediaSession.Callback.onConnect()
. Configuración y devolución
el conjunto de comandos disponibles al aceptar una solicitud de conexión de un
MediaController
en el método de devolución de llamada onConnect
:
Kotlin
private inner class CustomMediaSessionCallback: MediaSession.Callback { // Configure commands available to the controller in onConnect() override fun onConnect( session: MediaSession, controller: MediaSession.ControllerInfo ): MediaSession.ConnectionResult { val sessionCommands = ConnectionResult.DEFAULT_SESSION_COMMANDS.buildUpon() .add(SessionCommand(SAVE_TO_FAVORITES, Bundle.EMPTY)) .build() return AcceptedResultBuilder(session) .setAvailableSessionCommands(sessionCommands) .build() } }
Java
class CustomMediaSessionCallback implements MediaSession.Callback { // Configure commands available to the controller in onConnect() @Override public ConnectionResult onConnect( MediaSession session, ControllerInfo controller) { SessionCommands sessionCommands = ConnectionResult.DEFAULT_SESSION_COMMANDS.buildUpon() .add(new SessionCommand(SAVE_TO_FAVORITES, new Bundle())) .build(); return new AcceptedResultBuilder(session) .setAvailableSessionCommands(sessionCommands) .build(); } }
Para recibir solicitudes de comando personalizadas de un MediaController
, anula el
onCustomCommand()
en Callback
Kotlin
private inner class CustomMediaSessionCallback: MediaSession.Callback { ... override fun onCustomCommand( session: MediaSession, controller: MediaSession.ControllerInfo, customCommand: SessionCommand, args: Bundle ): ListenableFuture<SessionResult> { if (customCommand.customAction == SAVE_TO_FAVORITES) { // Do custom logic here saveToFavorites(session.player.currentMediaItem) return Futures.immediateFuture( SessionResult(SessionResult.RESULT_SUCCESS) ) } ... } }
Java
class CustomMediaSessionCallback implements MediaSession.Callback { ... @Override public ListenableFuture<SessionResult> onCustomCommand( MediaSession session, ControllerInfo controller, SessionCommand customCommand, Bundle args ) { if(customCommand.customAction.equals(SAVE_TO_FAVORITES)) { // Do custom logic here saveToFavorites(session.getPlayer().getCurrentMediaItem()); return Futures.immediateFuture( new SessionResult(SessionResult.RESULT_SUCCESS) ); } ... } }
Puedes hacer un seguimiento de qué controlador multimedia envía una solicitud mediante el
la propiedad packageName
del objeto MediaSession.ControllerInfo
que se
se pasan a los métodos Callback
. Esto te permite adaptar
comportamiento en respuesta a un comando determinado si se origina en el sistema, tu
tu propia app u otras apps cliente.
Cómo actualizar el diseño personalizado después de una interacción del usuario
Luego de controlar un comando personalizado o cualquier otra interacción con el jugador, puedes
es posible que desees actualizar el diseño que se muestra en la IU del controlador. Un ejemplo típico
es un botón de activación que cambia su ícono después de activar la acción asociada
con este botón. Para actualizar el diseño, puedes usar
MediaSession.setCustomLayout
:
Kotlin
val removeFromFavoritesButton = CommandButton.Builder() .setDisplayName("Remove from favorites") .setIconResId(R.drawable.favorite_remove_icon) .setSessionCommand(SessionCommand(REMOVE_FROM_FAVORITES, Bundle())) .build() mediaSession.setCustomLayout(ImmutableList.of(likeButton, removeFromFavoritesButton))
Java
CommandButton removeFromFavoritesButton = new CommandButton.Builder() .setDisplayName("Remove from favorites") .setIconResId(R.drawable.favorite_remove_icon) .setSessionCommand(new SessionCommand(REMOVE_FROM_FAVORITES, new Bundle())) .build(); mediaSession.setCustomLayout(ImmutableList.of(likeButton, removeFromFavoritesButton));
Personaliza el comportamiento de los comandos de reproducción
Para personalizar el comportamiento de un comando definido en la interfaz Player
, como
como play()
o seekToNext()
, une tu Player
en una ForwardingPlayer
.
Kotlin
val player = ExoPlayer.Builder(context).build() val forwardingPlayer = object : ForwardingPlayer(player) { override fun play() { // Add custom logic super.play() } override fun setPlayWhenReady(playWhenReady: Boolean) { // Add custom logic super.setPlayWhenReady(playWhenReady) } } val mediaSession = MediaSession.Builder(context, forwardingPlayer).build()
Java
ExoPlayer player = new ExoPlayer.Builder(context).build(); ForwardingPlayer forwardingPlayer = new ForwardingPlayer(player) { @Override public void play() { // Add custom logic super.play(); } @Override public void setPlayWhenReady(boolean playWhenReady) { // Add custom logic super.setPlayWhenReady(playWhenReady); } }; MediaSession mediaSession = new MediaSession.Builder(context, forwardingPlayer).build();
Para obtener más información sobre ForwardingPlayer
, consulta la guía de ExoPlayer sobre lo siguiente:
Personalización.
Identifica el controlador solicitante de un comando del jugador
Cuando un MediaController
origina una llamada a un método Player
, puedes
identifica la fuente de origen con MediaSession.controllerForCurrentRequest
y adquiere el ControllerInfo
para la solicitud actual:
Kotlin
class CallerAwareForwardingPlayer(player: Player) : ForwardingPlayer(player) { override fun seekToNext() { Log.d( "caller", "seekToNext called from package ${session.controllerForCurrentRequest?.packageName}" ) super.seekToNext() } }
Java
public class CallerAwareForwardingPlayer extends ForwardingPlayer { public CallerAwareForwardingPlayer(Player player) { super(player); } @Override public void seekToNext() { Log.d( "caller", "seekToNext called from package: " + session.getControllerForCurrentRequest().getPackageName()); super.seekToNext(); } }
Cómo responder a los botones multimedia
Los botones de medios son botones de hardware que se encuentran en dispositivos Android y otros periféricos.
como el botón de reproducción/pausa en los auriculares Bluetooth. Controladores de Media3
eventos de botones multimedia cuando lleguen a la sesión y llamen a
el método Player
apropiado en el reproductor de sesión
Una app puede anular el comportamiento predeterminado anulando
MediaSession.Callback.onMediaButtonEvent(Intent)
En ese caso, la app
puede o necesita manejar todos los detalles específicos de la API por su cuenta.
Informes y manejo de errores
Hay dos tipos de errores que emite una sesión y que informa a los controladores. Los errores fatales informan una falla técnica de reproducción de la sesión reproductor que interrumpe la reproducción. Se informan los errores fatales al controlador. automáticamente cuando ocurren. Los errores recuperables no son técnicos ni de política errores que no interrumpen la reproducción y que el de forma manual.
Errores fatales de reproducción
El reproductor informa un error fatal de reproducción a la sesión y, luego,
informados a los controladores para llamar
Player.Listener.onPlayerError(PlaybackException)
y
Player.Listener.onPlayerErrorChanged(@Nullable PlaybackException)
En ese caso, el estado de reproducción pasa a STATE_IDLE
y
MediaController.getPlaybackError()
muestra el PlaybackException
que causó
la transición. Un controlador puede inspeccionar PlayerException.errorCode
para obtener
información sobre el motivo del error.
Para la interoperabilidad, un error irrecuperable se replica en el PlaybackStateCompat
de la sesión de la plataforma cambiando su estado a STATE_ERROR
y estableciendo
el código de error y el mensaje según PlaybackException
.
Personalización de un error grave
Para proporcionar información localizada y significativa al usuario, el código de error,
el mensaje de error y los extras de errores de un error de reproducción no recuperable se pueden personalizar
con un ForwardingPlayer
cuando compiles la sesión:
Kotlin
val forwardingPlayer = ErrorForwardingPlayer(player) val session = MediaSession.Builder(context, forwardingPlayer).build()
Java
Player forwardingPlayer = new ErrorForwardingPlayer(player); MediaSession session = new MediaSession.Builder(context, forwardingPlayer).build();
El reproductor de reenvío registra un Player.Listener
para el jugador.
e intercepta devoluciones de llamada que informan un error. Una
Luego, se delega PlaybackException
a los objetos de escucha que
se registran en el reproductor de reenvío. Para que funcione, el reproductor de reenvío
anula Player.addListener
y Player.removeListener
para tener acceso al
objetos de escucha con los que se pueden enviar códigos de error, mensajes o extras personalizados:
Kotlin
class ErrorForwardingPlayer(private val context: Context, player: Player) : ForwardingPlayer(player) { private val listeners: MutableList<Player.Listener> = mutableListOf() private var customizedPlaybackException: PlaybackException? = null init { player.addListener(ErrorCustomizationListener()) } override fun addListener(listener: Player.Listener) { listeners.add(listener) } override fun removeListener(listener: Player.Listener) { listeners.remove(listener) } override fun getPlayerError(): PlaybackException? { return customizedPlaybackException } private inner class ErrorCustomizationListener : Player.Listener { override fun onPlayerErrorChanged(error: PlaybackException?) { customizedPlaybackException = error?.let { customizePlaybackException(it) } listeners.forEach { it.onPlayerErrorChanged(customizedPlaybackException) } } override fun onPlayerError(error: PlaybackException) { listeners.forEach { it.onPlayerError(customizedPlaybackException!!) } } private fun customizePlaybackException( error: PlaybackException, ): PlaybackException { val buttonLabel: String val errorMessage: String when (error.errorCode) { PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW -> { buttonLabel = context.getString(R.string.err_button_label_restart_stream) errorMessage = context.getString(R.string.err_msg_behind_live_window) } // Apps can customize further error messages by adding more branches. else -> { buttonLabel = context.getString(R.string.err_button_label_ok) errorMessage = context.getString(R.string.err_message_default) } } val extras = Bundle() extras.putString("button_label", buttonLabel) return PlaybackException(errorMessage, error.cause, error.errorCode, extras) } override fun onEvents(player: Player, events: Player.Events) { listeners.forEach { it.onEvents(player, events) } } // Delegate all other callbacks to all listeners without changing arguments like onEvents. } }
Java
private static class ErrorForwardingPlayer extends ForwardingPlayer { private final Context context; private List<Player.Listener> listeners; @Nullable private PlaybackException customizedPlaybackException; public ErrorForwardingPlayer(Context context, Player player) { super(player); this.context = context; listeners = new ArrayList<>(); player.addListener(new ErrorCustomizationListener()); } @Override public void addListener(Player.Listener listener) { listeners.add(listener); } @Override public void removeListener(Player.Listener listener) { listeners.remove(listener); } @Nullable @Override public PlaybackException getPlayerError() { return customizedPlaybackException; } private class ErrorCustomizationListener implements Listener { @Override public void onPlayerErrorChanged(@Nullable PlaybackException error) { customizedPlaybackException = error != null ? customizePlaybackException(error, context) : null; for (int i = 0; i < listeners.size(); i++) { listeners.get(i).onPlayerErrorChanged(customizedPlaybackException); } } @Override public void onPlayerError(PlaybackException error) { for (int i = 0; i < listeners.size(); i++) { listeners.get(i).onPlayerError(checkNotNull(customizedPlaybackException)); } } private PlaybackException customizePlaybackException( PlaybackException error, Context context) { String buttonLabel; String errorMessage; switch (error.errorCode) { case PlaybackException.ERROR_CODE_BEHIND_LIVE_WINDOW: buttonLabel = context.getString(R.string.err_button_label_restart_stream); errorMessage = context.getString(R.string.err_msg_behind_live_window); break; // Apps can customize further error messages by adding more case statements. default: buttonLabel = context.getString(R.string.err_button_label_ok); errorMessage = context.getString(R.string.err_message_default); break; } Bundle extras = new Bundle(); extras.putString("button_label", buttonLabel); return new PlaybackException(errorMessage, error.getCause(), error.errorCode, extras); } @Override public void onEvents(Player player, Events events) { for (int i = 0; i < listeners.size(); i++) { listeners.get(i).onEvents(player, events); } } // Delegate all other callbacks to all listeners without changing arguments like onEvents. } }
Errores recuperables
Se pueden enviar errores recuperables que no se originen en una excepción técnica por una app para todos o para un controlador específico:
Kotlin
val sessionError = SessionError( SessionError.ERROR_SESSION_AUTHENTICATION_EXPIRED, context.getString(R.string.error_message_authentication_expired), ) // Sending a nonfatal error to all controllers. mediaSession.sendError(sessionError) // Interoperability: Sending a nonfatal error to the media notification controller to set the // error code and error message in the playback state of the platform media session. mediaSession.mediaNotificationControllerInfo?.let { mediaSession.sendError(it, sessionError) }
Java
SessionError sessionError = new SessionError( SessionError.ERROR_SESSION_AUTHENTICATION_EXPIRED, context.getString(R.string.error_message_authentication_expired)); // Sending a nonfatal error to all controllers. mediaSession.sendError(sessionError); // Interoperability: Sending a nonfatal error to the media notification controller to set the // error code and error message in the playback state of the platform media session. ControllerInfo mediaNotificationControllerInfo = mediaSession.getMediaNotificationControllerInfo(); if (mediaNotificationControllerInfo != null) { mediaSession.sendError(mediaNotificationControllerInfo, sessionError); }
Un error recuperable que se envía al controlador de notificaciones multimedia se replica en el
PlaybackStateCompat
de la sesión de la plataforma. Por lo tanto, solo el código de error y
el mensaje de error se establece en PlaybackStateCompat
, según corresponda, mientras que
PlaybackStateCompat.state
no se cambió a STATE_ERROR
.
Cómo recibir errores recuperables
Una MediaController
recibe un error recuperable tras implementar
MediaController.Listener.onError
Kotlin
val future = MediaController.Builder(context, sessionToken) .setListener(object : MediaController.Listener { override fun onError(controller: MediaController, sessionError: SessionError) { // Handle nonfatal error. } }) .buildAsync()
Java
MediaController.Builder future = new MediaController.Builder(context, sessionToken) .setListener( new MediaController.Listener() { @Override public void onError(MediaController controller, SessionError sessionError) { // Handle nonfatal error. } });