El primer paso para utilizar la Video API de Vonage es llamar a la OT.initSession() método. Otros métodos del objeto OT comprueban los requisitos del sistema y configuran el registro de errores.

Métodos

(estático) addEventListener(tipo, oyente)

Este método está obsoleto. Utiliza on() o una vez() en su lugar.

Registra un método como detector de eventos para un evento concreto.

El objeto OT genera un tipo de evento: un exception evento. El siguiente código añade un detector de eventos para el exception evento:

OT.addEventListener("exception", exceptionHandler);

function exceptionHandler(event) {
   alert("exception event. \n  code == " + event.code + "\n  message == " + event.message);
}

Si no hay ningún controlador registrado para un evento, este se ignora a nivel local. Si la función de escucha del evento no existe, el evento se ignora a nivel local.

Lanza una excepción si el listener El nombre no es válido.

Parámetros:

Véase: : - on() - una vez()

(estático) checkScreenSharingCapability(callback) → {Promise.<ScreenSharingCapabilityResponse>}

Comprueba si el navegador del cliente admite la publicación de transmisiones de pantalla compartida. El objeto devuelto por la promesa indica si se admite la pantalla compartida, así como qué fuentes de pantalla compartida (aplicación, pantalla o ventana) son compatibles. También indica si se requiere una extensión, si está instalada y si está registrada (en caso necesario).

const response = await OT.checkScreenSharingCapability();
if (!response.supported || response.extensionRegistered === false) {
// This browser does not support screen sharing
} else if (response.extensionInstalled === false) {
  // Prompt to install the extension
} else {
  // Screen sharing is available.
}

Este objeto tiene las siguientes propiedades que indican que el cliente admite la publicación de transmisiones de pantalla compartida:

• extensionInstalled (Booleano) — En versiones anteriores de Chrome y Opera, este valor está establecido en true si la extensión está instalada y registrada. En Chrome 72 o superior, Firefox 52 o superior, Safari 13 o superior, Opera 59 o superior, Edge 79 o superior e Internet Explorer, esta propiedad no está definida.
• supported (Booleano) — Establecer en true si el navegador admite la función de compartir pantalla. Comprueba el extensionRequired propiedad para comprobar si el navegador necesita una extensión para compartir pantalla.
• supportedSources (Objeto) — Obsoleto. En versiones anteriores del navegador, se podía seleccionar un tipo de fuente para compartir pantalla (como "application", "browser", "screen", o "window" estableciendo el videoSource propiedad de las opciones pasadas a la OT.initPublisher() método. Sin embargo, en los navegadores actuales que admiten la función de compartir pantalla, al pasar cualquiera de estos valores se produce el mismo comportamiento: el navegador muestra un cuadro de diálogo en el que el usuario final selecciona la fuente que se va a compartir (que puede ser toda la pantalla o una ventana concreta). En Electron, la función de compartir pantalla captura toda la pantalla, sin solicitar permiso al usuario.

El parámetro «options» también incluye las siguientes propiedades, que se aplican a la función de compartir pantalla en versiones anteriores de Chrome y Opera (en el resto de navegadores, estas propiedades no están definidas):

• extensionRequired (Cadena) — Establecer en "chrome" en versiones anteriores de Chrome y Opera, que requieren la instalación de una extensión para compartir pantalla. Esta propiedad no está definida en otros navegadores.
• extensionRegistered (Booleano) — En versiones anteriores de Chrome y Opera, esta propiedad está establecida en true si hay alguna extensión de pantalla compartida registrada; en caso contrario, se establece en false. En otros navegadores (que no requieren una extensión), esta propiedad no está definida. Utiliza la OT.registerScreenSharingExtension() Método para registrar una extensión de compartición de pantalla en versiones anteriores de Chrome u Opera.

Chrome 72 o superior, Firefox 52 o superior, Safari 13 o superior, Edge 79 o superior y Opera 59 o superior incorporan de serie la función de compartir pantalla, sin necesidad de ninguna extensión. (Ten en cuenta que la compatibilidad con el complemento de la Video API de Vonage para Internet Explorer se ha eliminado en la versión 2.17 de la Video API de Vonage.) La función de compartir pantalla es no compatible con los navegadores móviles. En Electron, la función de compartir pantalla es compatible si el webPreferences.contextIsolation La opción de la ventana del navegador Electron está configurada en false o si la aplicación utiliza un script de precarga para acceder a la herramienta de captura de escritorio. (El valor por defecto de webPreferences.contextIsolation es la opción true en Electron 12 y false (en versiones anteriores). Para publicar un vídeo de pantalla compartida en versiones anteriores de Chrome u Opera, el cliente instala una extensión que permite publicar una transmisión de vídeo de pantalla compartida en tu dominio. La Video API de Vonage extensiones para compartir pantalla El ejemplo incluye código para crear una extensión que permita compartir la pantalla en versiones anteriores de Chrome y Opera.

Para más información, consulte el Video API de Vonage: uso compartido de pantalla guía del desarrollador.

Parámetros:

Véase: : - OT.initPublisher() - OT.registerScreenSharingExtension()

Devoluciones:

Una promesa con potencial

(estático) checkSystemRequirements() → {Number}

Comprueba si el sistema es compatible con la Video API de Vonage para WebRTC. Ten en cuenta que este método se invoca automáticamente al llamar a OT.initPublisher() o OT.initSession(), y si el sistema no es compatible con la Video API de Vonage, la biblioteca OpenTok.js muestra un mensaje al usuario. Llama a la OT.checkSystemRequirements() método antes de llamar a OT.initPublisher() o OT.initSession() si no quieres que la biblioteca muestre ese mensaje.

Véase: : - OT.upgradeSystemRequirements()

Devoluciones:

Si el sistema es compatible con la Video API de Vonage para WebRTC (1) o no (0).

(estático) getActiveAudioOutputDevice()

Devuelve una Promise que resuelve el dispositivo de salida de audio actual.

El método devuelve una Promise que resuelve un objeto con dos propiedades: deviceId y label, cada uno de los cuales es una cadena.

El deviceId La propiedad es un identificador único del dispositivo. Puedes pasar el deviceId como parámetro de la OT.setAudioOutputDevice() método. En deviceId La propiedad se establece en «undefined» si el usuario no ha concedido previamente acceso a una cámara y un micrófono.

El label La propiedad identifica el dispositivo. La label Esta propiedad se establece en una cadena vacía si el usuario no ha concedido previamente acceso a una cámara y un micrófono.

Nota: Actualmente, es compatible con las versiones de escritorio de Chrome 49 o superior, Edge 17 o superior, Opera 36 o superior y las versiones recientes de Samsung Internet, WebView para Android y WebView para iOS.

Véase: : - OT.getAudioOutputDevices() - OT.setAudioOutputDevice()

(estático) getAudioOutputDevices()

Enumera los dispositivos de salida de audio (como los altavoces) disponibles para el navegador.

El método devuelve una Promise que se resuelve en un array de objetos correspondientes a los dispositivos de salida de audio disponibles. Cada objeto tiene dos propiedades: deviceId y label, cada uno de los cuales es una cadena.

El deviceId La propiedad es un identificador único del dispositivo. Puedes pasar el deviceId como parámetro de la OT.setAudioOutputDevice() método. En deviceId La propiedad se establece en «undefined» si el usuario no ha concedido previamente acceso a una cámara y un micrófono. En caso de que no haya dispositivos de salida de audio disponibles, la propiedad se establece en null.

El label La propiedad identifica el dispositivo. La label Esta propiedad se establece en una cadena vacía si el usuario no ha concedido previamente acceso a una cámara y un micrófono.

Notas::

• Actualmente, es compatible con las versiones de escritorio de Chrome 49 o superior, Edge 17 o superior, Opera 36 o superior y las versiones recientes de Samsung Internet, WebView para Android y WebView para iOS.
• Es posible que el navegador limite a uno el número de dispositivos de salida de audio mostrados antes de que el usuario haya concedido acceso a una cámara o a un micrófono.

Véase: : - OT.setAudioOutputDevice() - OT.getActiveAudioOutputDevice()

(estático) getDevices(callback) → {Promise.<Array.<Device>>}

Enumera los dispositivos de entrada de audio (como micrófonos) y los dispositivos de entrada de vídeo (cámaras) disponibles para el navegador. Devuelve una promesa que contiene la matriz de dispositivos. Cada objeto tiene tres propiedades: kind, deviceIdy label, cada uno de los cuales es una cadena.

El kind se establece en "audioInput" para dispositivos de entrada de audio o "videoInput" para dispositivos de entrada de vídeo.

El deviceId La propiedad es un identificador único del dispositivo. Puedes pasar el deviceId como el audioSource o videoSource propiedad de la options del OT.initPublisher() método.

El label La propiedad identifica el dispositivo. La label Esta propiedad se establece en una cadena vacía si el usuario no ha concedido previamente acceso a una cámara y un micrófono.

Parámetros:

Véase: : - OT.initPublisher()

Devoluciones:

Una promesa que contiene la lista de dispositivos

(estático) getSupportedCodecs() → {Promise}

Obtiene la lista de códecs compatibles para la codificación y descodificación de flujos de vídeo.

El siguiente ejemplo obtiene la lista de códecs compatibles para la codificación y decodificación de flujos de vídeo:

(async () => {
  try {
    const supportedCodecs = await OT.getSupportedCodecs();
    if (supportedCodecs.videoEncoders.indexOf('H264') < 0 &&
        supportedCodecs.videoDecoders.indexOf('H264') < 0) {
      // The client does not support encoding or decoding H264.
      // Let's recommend using a different browser.
    }
  } catch(err) {
    console.log(err);
  }
})();

Puedes utilizar las listas de códecs de vídeo compatibles para determinar si el cliente admite vídeo, en función del códec de vídeo preferido y del tipo de sesión que se esté utilizando. Puedes configurar el códec de vídeo preferido en la página «Proyecto» de tu Cuenta API de Video de Vonage. En sesiones enrutadas (sesiones que utilizan el enrutador multimedia de la Video API de Vonage), se utiliza el códec de vídeo preferido para todos los clientes de la sesión. En las sesiones retransmitidas, los clientes envían flujos directamente entre sí, y cada par de «publicador-suscriptor» intenta encontrar un códec de vídeo común que ambos puedan utilizar. En este sentido, el códec de vídeo utilizado por el par en una sesión retransmitida puede ser diferente del códec de vídeo preferido establecido. Para obtener más información, consulte la Video API de Vonage Códecs de vídeo guía del desarrollador.

Devoluciones:

Una promesa que se resuelve cuando la lista de códecs compatibles está lista. La promesa se resuelve (en caso de éxito) con un objeto que tiene dos propiedades: videoDecoders, una serie de códecs de vídeo compatibles para la decodificación, y videoEncoders, una serie de códecs de vídeo compatibles para la codificación, tales como:

{
   videoDecoders: ['H264', 'VP8', 'VP9'],
   videoEncoders: ['H264', 'VP8', 'VP9']
}

La promesa se rechaza si se produce un error al obtener la lista.

(estático) getUserMedia(opciones) → {Promise}

Obtiene un objeto `MediaStream` que utiliza un micrófono y una cámara como fuentes de audio y vídeo. Este método devuelve una promesa que se resuelve cuando el usuario ha concedido permiso para utilizar la cámara o el micrófono (o ambos) y el objeto `MediaStream` está disponible. La promesa se rechaza si se produce un error al obtener los medios o si el usuario final deniega el acceso a la cámara o al micrófono.

Puedes utilizar este método para obtener objetos `MediaStreamTrack` y pasarlos a la audioSource y videoSource opciones del OT.initPublisher() método. Por ejemplo, llama a este método para obtener un MediaStream que utilice el micrófono y la cámara como fuentes de audio y vídeo. A continuación, puedes llamar a getVideoTracks()[0] en el objeto MediaStream para obtener un objeto MediaStreamTrack correspondiente al vídeo de la cámara. A continuación, puedes añadir el objeto MediaStreamTrack como fuente para un elemento Video de HTML, dibujar ese elemento Video en un elemento Canvas de HTML y aplicar filtros o efectos de vídeo al Canvas. Después, puedes llamar a la captureStream() método del objeto HTMLCanvasElement para obtener un objeto MediaStream y llamar a getVideoTracks()[0] en el objeto MediaStream para obtener un objeto MediaStreamTrack de vídeo (con los filtros o efectos de vídeo aplicados). Por último, puedes utilizar el objeto MediaStreamTrack de vídeo como el videoSource propiedad de las opciones que pasas a OT.initPublisher(). El editor de la Video API de Vonage utilizará la pista de vídeo (con los filtros y efectos aplicados) como fuente de vídeo.

Parámetros:

Véase: : - Las opciones (especialmente audioSource y videoSource) del OT.initPublisher() método

Devoluciones:

Una promesa que se resuelve cuando el usuario ha concedido permiso para utilizar la cámara o el micrófono (o ambos) y el objeto `MediaStream` está disponible. La promesa se rechaza si se produce un error al obtener los datos multimedia, si el usuario final deniega el acceso a la cámara o al micrófono, o si el método se invoca en Internet Explorer.

(estático) hasEndToEndEncryptionSupport() → {Boolean}

Si el cliente admite el cifrado de extremo a extremo.

El siguiente ejemplo habilita el cifrado de extremo a extremo, siempre que el cliente lo admita:

// Publish in a session with end-to-end encryption, if supported
if (OT.hasEndToEndEncryptionSupport()) {
  session.publish(publisher, error) = {
    ...
  });
}

Véase: : - OT.initSession() - Session.publish()

Devoluciones:

Si el cliente admite el cifrado de extremo a extremo (true), o no (false).

(estático) hasMediaProcessorSupport(mediaType) → {Boolean}

Si el cliente es compatible con procesadores multimedia, como filtros de vídeo y audio.

El siguiente ejemplo activa el filtro de desenfoque de fondo, si el cliente lo admite:

// Add background blur, if supported
if (OT.hasMediaProcessorSupport('video')) {
  publisherOptions.videoFilter = {
    type: 'backgroundBlur',
  };
}
// Add advanced noise suppression, if supported
if (OT.hasMediaProcessorSupport('audio')) {
  publisherOptions.audioFilter = {
    type: 'advancedNoiseSuppression',
  };
}

const publisher = OT.initPublisher(publisherOptions);

Parámetros:

Véase: : - OT.initPublisher() - Publisher.applyVideoFilter() - Publisher.applyAudioFilter()

Devoluciones:

Si el cliente es compatible con procesadores multimedia (true), como los filtros de vídeo y audio, o no (false).

(estático) initPublisher(elementoDestino, propiedades, controladorDeFinalización) → {Editorial}

Inicializa y devuelve un objeto Publisher. A continuación, puedes pasar este objeto Publisher a Session.publish() para publicar un flujo en una sesión.

Nota: Si tienes intención de reutilizar un objeto Publisher para publicar en diferentes sesiones (o en la misma sesión) de forma secuencial, añade un detector de eventos para el streamDestroyed evento enviado por el objeto Publisher (cuando deja de publicar). En el oyente de eventos, llama a la preventDefault() método del objeto de evento para evitar que el vídeo del editor se elimine de la página.

Parámetros:

Véase: : - Session.publish()

Devoluciones:

El objeto Publisher.

(estático) initSession(apiKey, sessionId, options) → {Sesión}

Inicializa y devuelve el objeto de sesión local correspondiente a un ID de sesión específico.

Para conectarte a una sesión de la Video API de Vonage, utiliza el connect() método del objeto Session devuelto por el OT.initSession() método. Ten en cuenta que al llamar a OT.initSession() No inicia ninguna comunicación con la nube. Simplemente inicializa el objeto «Session», que puedes utilizar para conectarte (y para realizar otras operaciones una vez conectado).

Ten en cuenta que solo se puede inicializar un objeto `Session` por cada ID de sesión. Al llamar a OT.initSession() Si se realiza por segunda vez con el mismo ID de sesión, devuelve el objeto Session creado anteriormente. Sin embargo, puedes inicializar varios objetos Session para diferentes sesiones (con diferentes ID de sesión) con el fin de conectarte a varias sesiones.

Cuando el cliente se desconecta de la sesión (y la sesión envía un sessionDisconnected evento), puedes reutilizar el objeto Session para volver a conectarte a la sesión. Sin embargo, el objeto Session conservará cualquier manejador de eventos existente que tenga asociado. Puedes eliminar todos los manejadores de eventos llamando a la función off() método del objeto Session (sin pasar ningún parámetro).

Para ver un ejemplo, consulta Session.connect().

Parámetros:

Devoluciones:

El objeto de sesión a través del cual se llevarán a cabo todas las interacciones posteriores con la sesión.

(estático) log(mensaje)

Envía una cadena a la consola del depurador. Sin embargo, la función solo registra la información en la consola si has configurado el nivel de registro en OT.LOG o OT.DEBUG, llamando al OT.setLogLevel(OT.LOG) o OT.setLogLevel(OT.DEBUG).

Parámetros:

Véase: : - OT.setLogLevel()

(estático) off(tipo, controlador, contexto)

Elimina un controlador de eventos.

Si se pasan un nombre de evento y un método de gestión, se elimina el método de gestión para ese evento:

OT.off("exceptionEvent", exceptionEventHandler);

Si pasas un nombre de evento y no método «handler»: se eliminan todos los controladores de esos eventos:

OT.off("exceptionEvent");

El método también admite una sintaxis alternativa, en la que el primer parámetro es un objeto que constituye un mapa hash de nombres de eventos y funciones de gestión, y el segundo parámetro (opcional) es el contexto para la selección de las funciones de gestión:

OT.off(
  {
    exceptionEvent: exceptionEventHandler
  },
  this
);

Parámetros:

Véase: : - on() - una vez() - Eventos

(estático) on(tipo, controlador, contexto)

Añade una función de gestión de eventos para uno o varios eventos.

El objeto OT genera un tipo de evento: un exception evento. El siguiente código añade un escuchador de eventos para el exception evento:

OT.on("exception", function (event) {
  // This is the event handler.
});

También puedes pasar un tercer context parámetro (que es opcional) para definir el valor de this en el método del controlador:

OT.on("exception",
  function (event) {
    // This is the event handler.
  }),
  session
);

Si no se añade un controlador para un evento, este se ignora a nivel local.

Parámetros:

Véase: : - off() - una vez() - Eventos

(estático) once(tipo, controlador, contexto)

Añade una función de gestión de eventos para un evento. Una vez que se invoca el gestor, el método de gestión especificado se elimina como gestor de este evento. (Cuando se utiliza el OT.on() Método para añadir un controlador de eventos; el controlador es no se elimina cuando se invoca.) El OT.once() El método es equivalente a llamar a la OT.on() método y llamada OT.off() la primera vez que se invoca el controlador.

El siguiente código añade un controlador de eventos de una sola vez para el exception evento:

OT.once("exception", function (event) {
  console.log(event);
}

También puedes pasar un tercer context parámetro (que es opcional) para definir el valor de this en el método del controlador:

OT.once("exception",
  function (event) {
    // This is the event handler.
  },
  session
);

El método también admite una sintaxis alternativa, en la que el primer parámetro es un objeto que constituye un mapa hash de nombres de eventos y funciones de gestión, y el segundo parámetro (opcional) es el contexto para este objeto en cada función de gestión:

OT.once(
  {exeption: function (event) {
    // This is the event handler.
    }
  },
  session
);

Parámetros:

Véase: : - on() - una vez() - Eventos

(estática) registerScreenSharingExtension(tipo, id, versión)

Registra una extensión para que la función de compartir pantalla sea compatible con versiones anteriores de Chrome u Opera.

Nota: No es necesaria una extensión para compartir pantalla en Chrome 72 o superior ni en Opera 59 o superior. Se solicita al usuario final que conceda acceso a la pantalla, igual que se le pediría al conceder acceso a una cámara. Solo necesitas una extensión para compartir pantalla en versiones anteriores de Opera y Chrome.

Utiliza el OT.checkScreenSharingCapability() método para comprobar si una extensión es obligatoria, está registrada e instalada.

La Video API de Vonage extensiones para compartir pantalla El repositorio incluye código para crear una extensión que permita compartir la pantalla.

Parámetros:

Véase: : - OT.initPublisher() - OT.checkScreenSharingCapability()

(estático) removeEventListener(tipo, oyente)

Este método está obsoleto. Utiliza off() en su lugar.

Elimina un detector de eventos para un evento concreto.

Lanza una excepción si el listener El nombre no es válido.

Parámetros:

Véase: : - off()

(estático) reportIssue(completionHandler) → {Promise.<string>}

Informa de que tu aplicación ha tenido un problema. Puedes utilizar el ID del problema con Inspector o al tratar un asunto con el equipo de asistencia técnica de la API de Vonage.

Parámetros:

Devoluciones:

Una promesa vinculada al ID del informe

(estático) setAudioOutputDevice() → {Promise}

Establece el nuevo dispositivo de salida de audio.

El método devuelve una Promise que se resuelve cuando la operación finaliza con éxito. Si se produce un error, la Promise se rechaza.

Nota: Actualmente, es compatible con las versiones de escritorio de Chrome 49 o superior, Firefox 116 o superior, Edge 17 o superior, Opera 36 o superior, Safari 26 o superior y WebView en iOS 26 o superior.

Véase: : - OT.getAudioOutputDevices() - OT.getActiveAudioOutputDevice()

Devoluciones:

Una promesa que se resuelve cuando la operación se completa con éxito. Si se produce un error, la promesa se rechaza.

(estático) setLogLevel(logLevel)

Establece el nivel de registro de la API.

Llamando a OT.setLogLevel() establece el nivel de registro de los mensajes de registro en tiempo de ejecución que genera la biblioteca de la Video API de Vonage. El valor predeterminado del nivel de registro es OT.ERROR.

La biblioteca JavaScript de la Video API de Vonage muestra mensajes de registro en la consola del depurador (como Firebug), si hay alguna disponible.

En el siguiente ejemplo se muestra el ID de sesión en la consola, llamando a OT.log(). El código también registra un mensaje de error cuando intenta publicar un flujo antes de que te hayas conectado a la sesión (al llamar a Session.connect()).

OT.setLogLevel(OT.LOG);
session = OT.initSession(sessionId);
OT.log(sessionId);
publisher = OT.initPublisher("publishContainer");
session.publish(publisher);

Parámetros:

Véase: : - OT.log()

(estático) setProxyUrl()

Establece la URL del servidor proxy IP. Con la función de proxy IP, el cliente desvía todo el tráfico de Internet (excepto las transmisiones multimedia) a través de tu servidor proxy.

Debes llamar a este método antes de llamar a cualquier otro método de la Video API de Vonage. Esto garantiza que se utilice el servidor proxy para el tráfico de la Video API de Vonage. De lo contrario, la llamada falla y el OT El objeto envía un exception evento. En OT El objeto también envía un exception incluso si llamas a este método después de haberlo llamado anteriormente.

Esta función está disponible como complemento. Para obtener más información, consulta el Guía para desarrolladores de proxies IP.

(estático) unblockAudio()

Hace que el audio de los suscriptores se reproduzca en los navegadores en los que el audio está bloqueado. Debes llamar a este método en respuesta a un elemento HTML que envíe un click evento.

Solo tienes que llamar a este método si desactivas la visualización del icono predeterminado de reproducción de audio del suscriptor (configurando el style.audioBlockedDisplayMode propiedad del options del Session.subscribe() método). Puedes llamar a este método cuando el usuario haga clic en un elemento HTML que muestres en la página.

El suscriptor envía un audioBloqueado evento si se bloquea el audio. En respuesta a ese evento, puedes mostrar un elemento de la interfaz de usuario para notificar al usuario final que responda al audio del suscriptor de reproducción. Llama a la función OT.unblockAudio() método que se ejecuta cuando el usuario hace clic en un elemento DOM.

Nota: El audio del suscriptor también se desbloquea automáticamente si el cliente local obtiene acceso a la cámara o al micrófono (por ejemplo, en respuesta a una llamada realizada con éxito a OT.initPublisher()).

Véase: : - Subscriber.isAudioBlocked() - El audioBloqueado y audio sin restricciones Eventos para suscriptores

Devoluciones:

Promesa: La promesa se resuelve si la reproducción de audio se realiza correctamente en todos los suscriptores bloqueados. La promesa se rechaza si la reproducción falla. Véase Error Para más información.

(estática) upgradeSystemRequirements()

Muestra información sobre los requisitos del sistema para la Video API de Vonage para WebRTC. Esta información se muestra en un elemento iframe que ocupa toda la ventana del navegador.

Nota: Esta información se muestra automáticamente al llamar a la OT.initSession() o el OT.initPublisher() método si el cliente no es compatible con la Video API de Vonage para WebRTC.

Nota: Esta función quedará obsoleta en el futuro.

Véase: : - OT.checkSystemRequirements()

Eventos

excepción

Lo envía la clase OT cuando la aplicación detecta una excepción. Ten en cuenta que debes configurar un controlador de eventos para el exception evento llamando a la función OT.on() método.

Véase: : - ExceptionEvent