Evento VideoEnabledChangedEvent
Define el objeto de evento para el videoDisabled y videoEnabled
eventos enviados por el suscriptor.
Propiedades
cancelable
Tipo: Booleano
Si el evento tiene un comportamiento predeterminado que se puede cancelar
(true) o no (false). Puedes anular el comportamiento predeterminado
llamando a la función preventDefault() método del objeto de evento en la función de llamada de retorno.
(Véase preventDefault().)
reason
Tipo: Cadena
El motivo por el que se ha desactivado o activado el vídeo. Se puede establecer en uno de los siguientes valores:
-
"publishVideo"— El editor ha iniciado o detenido la publicación de un vídeo llamando alpublishVideo(true)opublishVideo(false). -
"quality"— El envío de vídeo puede iniciarse o detenerse en función de los cambios en la calidad de la transmisión. Cuando está activada la función de recambio de audio del suscriptor, el enrutador multimedia de la Video API inicia o detiene el envío de vídeo al suscriptor en función de los cambios en la calidad de la transmisión. Esta función del enrutador multimedia de la Video API hace que el suscriptor interrumpa la transmisión de vídeo cuando la conectividad se deteriora. (El suscriptor sigue recibiendo la transmisión de audio, si la hay.) Si la conectividad mejora hasta permitir de nuevo la transmisión de vídeo, el objeto «Subscriber» envía unvideoEnabledevento, y el suscriptor vuelve a recibir el vídeo. Por defecto, el suscriptor muestra un indicador de vídeo desactivado cuando unvideoDisabledEl evento con este motivo se envía y elimina el indicador cuando elvideoEnabledSe envía un evento con este motivo. Puedes controlar la visualización de este icono llamando a la funciónsetStyle()método del suscriptor, estableciendo elvideoDisabledDisplayModepropiedad (o puedes establecer el estilo al llamar a laSession.subscribe()método, configurando elstylepropiedad delpropertiesparámetro). Esta función solo está disponible en las sesiones que utilizan el enrutador multimedia de la Video API de Vonage (sesiones con el modo multimedia (configurado en «enrutado»), no en sesiones en las que el modo multimedia esté configurado en «retransmitido». -
Cuando la función de recambio de audio del editor está activada, el editor inicia o detiene el envío de vídeo en función de los cambios en la calidad de la transmisión. (El suscriptor sigue recibiendo la transmisión de audio, si la hay.) Si la conectividad mejora hasta el punto de permitir de nuevo la transmisión de vídeo, el objeto editor envía un
videoEnabledevento, y el suscriptor vuelve a recibir el vídeo. Por defecto, el editor muestra un indicador de vídeo desactivado cuando unvideoDisabledEl evento con este motivo se envía y elimina el indicador cuando elvideoEnabledSe envía un evento con este motivo. Puedes controlar la visualización de este icono llamando a la funciónsetStyle()método del Publisher y configurando elvideoDisabledDisplayModepropiedad, o bien puedes configurar lavideoDisabledDisplayModecuando se llama a la propiedadOT.initPublisher()método y configurando elstylepropiedad delpropertiesparámetro. -
"subscribeToVideo"— El suscriptor ha activado o cancelado su suscripción al servicio de vídeo llamando alsubscribeToVideo(true)osubscribeToVideo(false). -
"codecNotSupported"— El suscriptor ha dejado de suscribirse al vídeo debido a un códec incompatible. -
"codecChanged"— El vídeo para suscriptores se ha activado tras cambiar un códec que resultaba incompatible. -
"serverRotation"— El cliente de publicación se ha desconectado de la sesión debido a Rotación de servidores de la Video API.
target
Tipo: Objeto
El objeto que ha activado el evento.
type
Tipo: Cadena
El tipo de evento: "videoDisabled" o
"videoEnabled".
Métodos
| Nombre | Descripción |
|---|---|
isDefaultPrevented() → {Boolean} |
Si se ha impedido el comportamiento predeterminado del evento mediante una llamada a preventDefault() (true) o no (false). |
preventDefault() |
Evita que se produzca el comportamiento predeterminado asociado al evento. |
isDefaultPrevented() → {Boolean}
Si se ha impedido el comportamiento predeterminado del evento mediante una llamada a
preventDefault() (true) o no (false).
Véase preventDefault().
Devoluciones:
preventDefault()
Evita que se produzca el comportamiento predeterminado asociado al evento.
Para comprobar si un evento tiene un comportamiento predeterminado, consulta el cancelable propiedad
del objeto de evento.
Llame al preventDefault() método en la función de devolución de llamada del evento.
Los siguientes eventos tienen comportamientos predeterminados:
sessionDisconnect— Véase SessionDisconnectEvent.preventDefault().streamDestroyed— Véase StreamEvent.preventDefault().accessDialogOpened— Consulta el Evento «accessDialogOpened».accessDenied— Consulta el Evento «accessDenied».