OpenTok.Publisher

public class Publisher : IDisposable

Utiliza el Publisher.Builder clase para crear un Editorial instancia. A continuación, puedes publicar la transmisión de audio y vídeo en un OpenTok sesión llamando al método Session.Publish(Publisher).

El Editorial La clase implementa la interfaz System.IDisposable. Asegúrate de llamar al método Dispose() de la 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).

Tipos anidados: OpenTok.Publisher.VideoEventArgs, OpenTok.Publisher.Builder, OpenTok.Publisher.StreamEventArgs, OpenTok.Publisher.ErrorEventArgs, OpenTok.Publisher.AudioLevelArgs, OpenTok.Publisher.AudioNetworkStats, OpenTok.Publisher.AudioNetworkStatsEventArgs, OpenTok.Publisher.VideoNetworkStats, OpenTok.Publisher.VideoLayerStats, OpenTok.Publisher.VideoNetworkStatsEventArgs, OpenTok.Publisher.VideoQualityChangedEventArgs, OpenTok.Publisher.PublisherMediaLinkStats, OpenTok.Publisher.PublisherMediaLinkStatsEventArgs, OpenTok.Publisher.NetworkConditionChangedEventArgs, OpenTok.Publisher.PublisherRtcStats, OpenTok.Publisher.RtcStatsReportArgs

Propiedades

Nombre Tipo Descripción
VideoTransformers Lista<VideoTransformer> { get; set; } Lista de VideoTransformer en el orden en que se aplicarán a la secuencia. Consulta la documentación sobre Uso de la biblioteca Vonage Media Processor y aplicar transformaciones multimedia. El getter devuelve una copia de la lista. Añadir o eliminar transformadores de esta copia no afectará a las capas internas.
AudioTransformers Lista<AudioTransformer> { get; set; } Lista de AudioTransformer en el orden en que se aplicarán a la secuencia. Consulta la documentación sobre Uso de la biblioteca Vonage Media Processor y aplicar transformaciones multimedia. El getter devuelve una copia de la lista. Añadir o eliminar transformadores de esta copia no afectará a las capas internas.
VideoRenderer IVideoRenderer { get; } El motor de reproducción de vídeo para la editorial.
VideoCapturer IVideoCapturer { get; } El programa de captura de vídeo para el editor.
Stream Transmisión { get; } El flujo de este editor. Las propiedades del Transmisión Los objetos son una instantánea del estado del flujo en el momento en que se accede a esta propiedad y no se actualizarán a medida que cambie el estado del flujo.
PublishCaptions bool { get; set; } Si la editorial publica subtítulos.
CaptionsInputLanguage cadena { get; set; } El idioma de entrada preferido para los subtítulos de este editor. Establece un código de idioma BCP-47 compatible o un valor nulo para restablecer el valor por defecto.
PublishAudio bool { get; set; } Si la editorial publica contenido de audio.
PublishVideo bool { get; set; }
VideoSourceType Tipo de fuente de vídeo { get; set; } El tipo de transmisión (ya sea de cámara o de pantalla compartida), tal y como se define en el OpenTok.VideoSourceType enum.
MaxVideoBitrate int { get; set; } Esta propiedad establece un límite máximo explícito para la tasa de bits del vídeo del editor. Al establecer 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 tasa de bits máxima configurada actualmente en bps. Si no se ha establecido ninguna tasa de bits manual, o si hay un preajuste de tasa de bits activo, el valor es 0. Un valor de 0 indica que no se aplica ningún límite explícito de tasa de bits y que la transmisión funciona según las reglas de los preajustes adaptativos para optimizar la calidad.
VideoBitratePreset Preajuste de velocidad de bits de vídeo { get; set; } 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 El valor no se puede establecer directamente. Para más información, consulta Velocidad de bits máxima del editor.
DegradationPreference Preferencia de degradación { get; set; } La política preferida que seguirá el motor de vídeo a la hora de ajustar la frecuencia de fotogramas y la resolución en función de las limitaciones de ancho de banda y de la CPU. Consulta la enumeración `DegradationPreference` para obtener una descripción de los valores posibles.
TargetScalabilityMode cadena { get; set; } La función «setter» puede invocarse en cualquier momento; no es necesario que haya finalizado la negociación de la ruta multimedia. El modo se aplicará una vez que se haya establecido la ruta multimedia del enrutador multimedia. Si se negocia un códec que no sea SVC (VP8, H.264) en la ruta multimedia del enrutador multimedia, se utiliza el modo aplicable más cercano: las capas espaciales se fijan obligatoriamente en 1, conservando la dimensión temporal (p. ej., L2T2 → L1T2 cuando se negocia VP8). El setter lanza una excepción 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 realmente aplicado (que puede diferir debido a un recurso alternativo dependiente del códec). Se trata de una función en fase beta.

enum VideoReason

Define los valores de las propiedades VideoEventArgs.Reason y VideoEventArgs.Reason.

Nombre Valor Descripción
None 0 No se ha producido ningún incidente destacable en el vídeo ni ninguna pérdida de calidad. Motivo predeterminado o desconocido.
PublishVideo 1 El incidente se produjo porque el emisor de la retransmisión comenzó o dejó de publicar el vídeo.
Quality 3 Cuando la calidad de la transmisión de vídeo se ve afectada por las condiciones de la red, el Editorial envía el evento «VideoDisabled». Cuando las condiciones mejoran, la transmisión de vídeo se reanuda, y el Editorial envía el evento «VideoEnabled». Cuando se interrumpe la transmisión de vídeo, el Editorial sigue enviando el flujo de audio, si lo hay. Además, el capturador correspondiente a este editor no se desactivará, y los fotogramas capturados seguirán viéndose en el lado del editor.
QualityDegradationBandwidth 5 Deterioro de la calidad debido a un ancho de banda de red insuficiente.
QualityDegradationCPU 6 Deterioro de la calidad provocado por las limitaciones de la CPU del dispositivo cliente.
QualityDegradationOther 7 Deterioro de la calidad provocado por otras causas que no se pueden clasificar como limitaciones de ancho de banda o de CPU.
CodecChange 8 Ha cambiado el códec de vídeo de la transmisión.
ResolutionChange 9 Cambio en la resolución del vídeo o en el número de capas. Esto puede deberse a limitaciones en la tasa de bits, a la adaptación del codificador, a cambios en la fuente de la cámara (como cambiar de cámara o modificar la resolución de entrada) o a cambios en la configuración. No implica necesariamente una pérdida de calidad.

Métodos

Nombre Descripción
Publisher(builder)
Dispose(disposing)
Dispose() Tenga en cuenta que el EditorialLos recursos de... son no se elimina al llamar al método Session.Publish(Publisher).
GetRtcStatsReport() Consulta también AudioStatsUpdated, VideoStatsUpdated y Subscriber.GetRtcStatsReport().

Editor (creador)

Parámetros:
Nombre Tipo Descripción
builder Constructor

Eliminar (eliminando)

Parámetros:
Nombre Tipo Descripción
disposing bool

Dispose()

Tenga en cuenta que el EditorialLos recursos de... son no se eliminan al llamar al método Session.Publish(Publisher). Al llamar 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()

Consulta también AudioStatsUpdated, VideoStatsUpdated y Subscriber.GetRtcStatsReport().

Eventos

Silenciamiento forzado

event EventHandler MuteForced

Define los argumentos del evento «MuteForced».

StreamCreated

event EventHandler<StreamEventArgs> StreamCreated

Se envía cuando se crea la transmisión del emisor.

StreamDestroyed

event EventHandler<StreamEventArgs> StreamDestroyed

Se envía cuando se destruye el flujo del editor.

Error

event EventHandler<ErrorEventArgs> Error

La mayoría de los errores son graves: el editor se descarta automáticamente y ya no se puede utilizar. Algunos errores no impiden continuar y permiten seguir utilizando el editor; cuando un error no es grave, así se indica en la descripción del error.

Se ha modificado la calidad del vídeo

event EventHandler<VideoQualityChangedEventArgs> VideoQualityChanged

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 valor «VideoReason» 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 en las capas.

Este evento se diferencia de los eventos «VideoDisabled» y «VideoEnabled» en que informa de cambios relacionados con la calidad, en lugar de simples cambios de estado (activado/desactivado). Los eventos «VideoDisabled» y «VideoEnabled» indican cuándo se desactiva o se activa la pista de vídeo del editor (por ejemplo, debido a un cambio a una fuente de audio alternativa o a actualizaciones de las propiedades de la transmisión). Por el contrario, «VideoQualityChanged» proporciona información de diagnóstico sobre las causas de la degradación de la calidad —como limitaciones de CPU o de ancho de banda— y puede activarse incluso cuando el vídeo permanece 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.

Cambio en el estado de la red

event EventHandler<NetworkConditionChangedEventArgs> NetworkConditionChanged

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.

MediaLinkEstadísticasActualizado

event EventHandler<PublisherMediaLinkStatsEventArgs> MediaLinkStatsUpdated

Se ejecuta periódicamente para generar informes sobre las estadísticas de enlaces multimedia del editor.

Nivel de audio

event EventHandler<AudioLevelArgs> AudioLevel

Se envía periódicamente para informar del nivel de audio del editor.

Estadísticas de audio actualizadas

event EventHandler<AudioNetworkStatsEventArgs> AudioStatsUpdated

Se invoca cuando el editor tiene estadísticas de audio que compartir.

Estadísticas de vídeo: Actualizado

event EventHandler<VideoNetworkStatsEventArgs> VideoStatsUpdated

Se activa cuando el editor tiene estadísticas de vídeo que compartir.

RtcStatsReport

event EventHandler<RtcStatsReportArgs> RtcStatsReport

Se envía en respuesta a una llamada a GetRtcStatsReport().

Vídeo desactivado

event EventHandler<VideoEventArgs> VideoDisabled

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

Compatible con vídeo

event EventHandler<VideoEventArgs> VideoEnabled

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

Desactivar advertencia de vídeo

event EventHandler VideoDisableWarning

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

event EventHandler VideoDisableWarningLifted

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