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.