Un editor captura una transmisión de audio y vídeo desde las fuentes que especifiques. Más...

Heredan de IDisposable.

Descripción detallada

Un editor captura una transmisión de audio y vídeo desde las fuentes que especifiques.

Utiliza el Publisher.Builder clase para crear un Editorial instancia. A continuación, puedes publicar el flujo de audio y vídeo en una sesión de la Video API de Vonage llamando a la función Session.Publish(Publisher) método.

El Editorial La clase implementa la interfaz System.IDisposable. Asegúrate de llamar a la Dispose() método del Editorial objeto para que libere sus recursos cuando ya no lo necesites (por ejemplo, cuando el Editorial se elimina o cuando se cierra la aplicación o la ventana).

Documentación sobre la enumeración de miembros

VideoReason

Define los valores para el VideoEventArgs.Reason y VideoEventArgs.Reason propiedades.

Documentación sobre funciones de miembro

Dispose()

Se ocupa de la Editorial los recursos del objeto.

Tenga en cuenta que el EditorialLos recursos de... son no se elimina al llamar a la función Session.Publish(Publisher) método. Cuando se llama a Session.Publish(Publisher), los recursos de la Editorial El objeto se conserva para que puedas reutilizarlo (para volver a publicarlo en la sesión).

GetRtcStatsReport()

Obtiene el informe de estadísticas de RTC del editor. Se trata de una operación asíncrona. Cuando las estadísticas estén disponibles, el RtcStatsReport se envía el mensaje.

Véase también Estadísticas de audio actualizadas, Estadísticas de vídeo: Actualizadoy Subscriber.GetRtcStatsReport().

Documentación inmobiliaria

Velocidad máxima de bits de vídeo

La tasa de bits máxima del vídeo para la transmisión de vídeo del editor (en bits por segundo).

Esta propiedad establece un límite máximo explícito para la tasa de bits del vídeo del editor. Si se establece esta propiedad en 0, se elimina cualquier límite manual y se vuelve al comportamiento predeterminado de tasa de bits adaptativa basada en preajustes, sin ningún límite explícito.

Al leer esta propiedad, se obtiene la velocidad de transmisión máxima configurada actualmente en bps. Si no se ha establecido ninguna velocidad de transmisión manualmente, o si hay un ajuste preestablecido de velocidad de transmisión activo, el valor es 0.

Un valor de 0 indica que no se aplica ningún límite explícito de velocidad de transmisión y que la transmisión funciona según reglas preestablecidas adaptativas para optimizar la calidad.

Publicar vídeo

Modo de escalabilidad objetivo

El modo de escalabilidad de destino (SVC, codificación de vídeo escalable) para este editor. El modo de escalabilidad controla el número de capas espaciales (resolución) y temporales (frecuencia de fotogramas) que codifica WebRTC. El modo se aplica a la ruta multimedia del Media Router.

Se puede llamar al «setter» en cualquier momento; no es necesario que haya finalizado la negociación de la ruta de medios. El modo se aplicará una vez que se haya establecido la ruta de medios del enrutador de medios.

Si se negocia un códec que no sea SVC (VP8, H.264) en la ruta de medios del enrutador multimedia, se utiliza el modo aplicable más cercano: las capas espaciales se fijan obligatoriamente en 1, conservando la dimensión temporal (por ejemplo, L2T2 → L1T2 cuando se negocia VP8).

El colocador lanza Excepción de OpenTok si el modo solicitado no es un modo de escalabilidad válido (es decir, no es uno de los siguientes: L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2, L3T3).

El getter devuelve el último valor pasado al setter, o null si no se ha establecido explícitamente. Esto refleja la intención del usuario, no el modo aplicado realmente (que puede diferir debido a un recurso alternativo dependiente del códec).

Esta es una función en fase beta.

Preajuste de velocidad de bits de vídeo

La estrategia de configuración preestablecida de la tasa de bits de vídeo aplicada a la transmisión de vídeo del editor.

Esta propiedad configura una estrategia de velocidad de bits predefinida para equilibrar la calidad del vídeo y el uso del ancho de banda. Las configuraciones predefinidas y los ajustes manuales de velocidad de bits son mutuamente excluyentes. Al establecer la propiedad MaxVideoBitrate, se anula cualquier configuración predefinida y esta propiedad cambia automáticamente a VideoBitratePreset.Custom.

Al leer esta propiedad se obtiene el preajuste activo en ese momento. Si se ha configurado manualmente una tasa de bits personalizada, el valor será VideoBitratePreset.Custom.

El valor por defecto es VideoBitratePreset.Default.

Nota: El VideoBitratePreset.Custom No se puede establecer el valor directamente.

Para más información, consulta Velocidad de bits máxima del editor.

Documentación del evento

Cambio en el estado de la red

Se produce cuando se detectan cambios en las condiciones de la red por parte del editor.

Este evento se activa cuando se producen cambios significativos en el estado de la red, y proporciona estadísticas sobre los enlaces de red junto con el motivo del cambio.

Vídeo desactivado

Se invoca cuando el proveedor deja de enviar el vídeo.

Compruebe el reason propiedad de los argumentos del evento que indica el motivo por el que se detuvo el vídeo.

Desactivar advertencia de vídeo

Se invoca cuando el editor determina que el nivel de congestión de la red ha empeorado y que el vídeo se desactivará si la congestión sigue empeorando.

Si la red sigue empeorando, el Editorial desactiva el vídeo y envía el mensaje «AudioFallback». Si la calidad de la transmisión mejora, el Editorial envía el evento «VideoDisableWarningLifted».

Este método se invoca principalmente cuando la calidad de la conexión se deteriora.

Se ha desactivado la advertencia sobre el vídeo

Se invoca cuando el editor determina que el nivel de congestión de la red ha mejorado hasta el punto de que la desactivación del vídeo ya no supone un riesgo inmediato.

Este método se invoca principalmente cuando mejora la calidad de la conexión.

Compatible con vídeo

Se ejecuta cuando se reanuda la transmisión de vídeo del editor (tras haber desactivado el vídeo).

Compruebe el reason propiedad de los argumentos del evento que indica el motivo por el que se activó el vídeo.

Se ha modificado la calidad del vídeo

Se produce cuando se produce un cambio en el estado de calidad de la transmisión de vídeo del emisor.

Este evento proporciona estadísticas actualizadas sobre el vídeo y un código de motivo que indica por qué se produjo el cambio de calidad.

El VideoReason Este valor especifica la causa del evento y sigue este orden de prioridad: deterioro del ancho de banda, deterioro de la CPU, otras causas de deterioro de la calidad, cambios en el códec y cambios en la resolución o la capa.

Este evento se diferencia del Vídeo desactivado y Compatible con vídeo eventos, en el sentido de que informa de cambios relacionados con la calidad, en lugar de simples cambios de estado (activado/desactivado). El Vídeo desactivado y Compatible con vídeo Los eventos indican cuándo se desactiva o se activa la pista de vídeo del editor (por ejemplo, debido a un cambio a audio alternativo o a actualizaciones de las propiedades de la transmisión). Por el contrario, Se ha modificado la calidad del vídeo ofrece información de diagnóstico sobre las causas de la pérdida de calidad —como las limitaciones de la CPU o del ancho de banda— y puede activarse incluso cuando el vídeo sigue activado.

Las aplicaciones pueden utilizar este evento para supervisar la calidad del vídeo y actuar en consecuencia, por ejemplo, actualizando los indicadores de la interfaz de usuario o notificando a los usuarios los problemas de rendimiento.