Video HTML
La documentación a continuación se aplica a las versiones de firmware 7.1.x y posteriores.
Puede usar elementos <video> para reproducir video en streaming (HLS, UDP, RTP, RTSP) y archivos de video locales. También puede mostrar entrada HDMI® en cualquier reproductor BrightSign que tenga entrada HDMI (consulte esta sección).
Video en streaming
La reproducción de video en streaming se logra usando el elemento estándar HTML <video> con un atributo src adecuado. Estos esquemas de URL pueden utilizarse para la reproducción:
- http/https
- udp
- rtp
- rtsp
Tenga en cuenta que los comandos de pausa/reanudación actualmente funcionan solo para streams HLS.
Control de elementos de video con JavaScript
Los eventos y controles asociados con un elemento de video HTML5 se describen aquí. Es importante tener en cuenta que el comportamiento de la API es asíncrono, por lo que los desarrolladores de aplicaciones deben configurar los controladores de eventos pertinentes y crear una máquina de estados razonable para su aplicación. En particular, tenga en cuenta lo siguiente.
- Llamar a load() restablece un elemento de video a su estado inicial y comienza el proceso de sondeo de la fuente de video. El evento loadedmetadata se generará cuando el sondeo esté lo suficientemente completo. Para los reproductores BrightSign, el comportamiento de load() es equivalente a establecer {Resume : False}, en roVideoPlayer, es decir, iniciar la reproducción en estado pausado.
- Establecer o restablecer el atributo src en un elemento de video es equivalente a llamar a load(). Sin embargo, establecer el atributo src en una etiqueta <source> incrustada no lo es, y load() debe invocarse explícitamente.
- El método play() inicia el proceso de reproducción, pero devuelve una Promesa que se resuelve una vez que la reproducción está en curso, o se rechaza si no es posible reproducir por alguna razón.
- Los desarrolladores de aplicaciones deben crear controladores para los eventos terminado y error (como mínimo).
No tener en cuenta la asincronía en la API puede generar resultados inesperados. Considere lo siguiente:
videoElement.load()
videoElement.play()Aquí, la intención presumiblemente es inicializar y reproducir el video. Sin embargo, una implementación compatible con la especificación HTML5 puede programar la llamada a load para que ocurra algún tiempo después de que el control regrese a JavaScript, y el orden de las llamadas podría invertirse a jugar seguido de cargar dando como resultado un video que se inicia en estado pausado. En su lugar, cree un controlador loadedmetadata e invoque play() allí.
El siguiente es un ejemplo muy básico para transmitir un video a través de UDP. Tenga en cuenta que el controlador de errores está capturando el código de error 4. Esto puede suceder al intentar reproducir un video en streaming mientras el stream no está disponible. El intento de reproducción expira después de seis segundos.
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Video Test</title>
</head>
<body>
<div id="video_container">
<video id="test_video"></video>
</div>
<script src="video.js"></script>
</body>
</html>var url = "udp://239.127.86.1:1234";
var video = document.getElementById('test_video');
function ReloadVideo() {
// This causes a loadedmetadata event
video.setAttribute('src', url);
}
video.addEventListener('ended', function() {
ReloadVideo();
});
video.addEventListener('error', function(e) {
if (!video.error) {
return;
}
switch (video.error.code) {
case 4: // MEDIA_ERR_SRC_NOT_SUPPORTED
ReloadVideo();
break;
default:
break;
}
});
video.addEventListener('loadedmetadata', async function() {
try {
await video.play();
} catch (err) {
// play failed
}
});
ReloadVideo();Parámetros de streaming
Puede configurar video en streaming usando varios atributos únicos de BrightSign. Estos atributos pueden ser reemplazados por parámetros incluidos en la URL de streaming.
Ejemplo (HTML)
<video src="udp://239.192.1.1:5004" x-bs-stream-timeout="0">Ejemplo (JavaScript)
videoPlayer.setAttribute("x-bs-stream-low-latency", "1"); Se admiten los siguientes parámetros de transmisión:
- [int] x-bs-stream-timeout: El tiempo (en milisegundos) que se debe esperar para que una transmisión comience antes de abandonar la reproducción. Pasar cero indica que el reproductor de video debe esperar indefinidamente. El valor de tiempo de espera predeterminado es 5000 ms para transmisiones HTTP y 3000 ms para todas las demás transmisiones.
- [int] x-bs-stream-latency: La cantidad de desviación (en milisegundos) del valor de latencia predeterminado: por ejemplo, un valor de -500 reducirá la latencia en medio segundo; un valor de 500 aumentará la latencia en medio segundo; y un valor de 0 especificará la latencia predeterminada. Especificar un valor negativo no cambiará el tamaño del búfer; en su lugar, le dará al búfer menos tiempo para llenarse antes de que comience la reproducción. Los valores utilizables se extienden aproximadamente hasta -750, aunque este valor puede diferir según el entorno de red. Reducir demasiado la latencia provocará interrupciones evidentes en la reproducción.
- [int] x-bs-stream-fade-in: La duración del fundido de entrada (en milisegundos) para transmisiones. De forma predeterminada, las transmisiones no HTTP tienen un valor de fundido de 1500 ms si contienen video y de 4000 ms si contienen solo audio. Las transmisiones HTTP tienen un valor de fundido predeterminado de 0 ms.
- [entero o booleano] x-bs-stream-low-latency: Modo de baja latencia para transmisiones RTSP. Configurar este parámetro en verdadero (1) logrará la menor latencia posible para una transmisión, pero con una tasa de bits máxima reducida, lo cual suele ser útil para transmisiones de cámaras IP. Este parámetro está configurado en falso (0) de forma predeterminada.
- [int] x-bs-intrinsic-width: El ancho intrínseco del video de origen
- [int] x-bs-intrinsic-height: La altura intrínseca del video de origen.
Lograr baja latencia
Hay tres opciones para reducir la latencia en los reproductores BrightSign Series 3 y 4:
x-bs-stream-latency
La marca x-bs-stream-latency (búfer) descrita anteriormente en "Streaming Parameters". En este ejemplo, la latencia se reduce en medio segundo (500 milisegundos):
<video src="udp://239.192.1.1:5004" x-bs-stream-latency="-500">x-bs-no-force-capture
Si la marca x-bs-no-force-capture está configurada en verdadero, la captura de video omitirá la conversión de frecuencia de cuadros e introducirá las siguientes limitaciones:
- Los valores de transformación distintos de "identity" no funcionarán.
- Es posible que las capturas de pantalla no sean correctas
- La frecuencia de cuadros del video codificado y la salida del modo de video deben coincidir
Por ejemplo:
<video src="udp://239.192.1.1:5004" x-bs-no-force-capture="1">x-bs-no-reordering
Si la marca x-bs-no-reordering está configurada, mejorará la latencia pero deshabilitará la reproducción de B-slices. Por ejemplo:
<video src="udp://239.192.1.1:5004" x-bs-no-reordering="1">Consulte esta página para obtener más información sobre cómo modificar la latencia de las transmisiones de audio o video.
Reproductor multimedia nativo de Chrome
Los reproductores Series 5 admiten seleccionar Chrome nativo para la reproducción de video con aceleración por hardware o usar el BrightSign Media Player predeterminado para la reproducción de video. Puede elegir qué opción es mejor para su caso de uso (consulte Opciones de reproducción HTML en reproductores Series 5HTML Playback Options on Series 5 Players).
WebRTC
Para WebRTC, BrightSign OS siempre usa reproducción de video nativa de Chrome.
Los reproductores Series 5 que ejecutan OS 9.0.115 y versiones posteriores usarán automáticamente decodificación acelerada por hardware en este caso.
Los reproductores Series 4 y anteriores no admiten decodificación acelerada por hardware con reproducción de video nativa de Chrome. Por lo tanto, la decodificación se realizará por software, y solo recomendamos probar este enfoque con reproductores XT4.
Tamaño intrínseco del video
El siguiente orden de precedencia se utiliza para determinar el tamaño intrínseco de un video:
- Los atributos x-bs-intrinsic-width y x-bs-intrinsic-height atributos
- El tamaño de la imagen especificado por el atributo póster
- Los atributos ancho y altura del elemento <video>
- El tamaño según lo informado por WebMediaPlayer
- El tamaño predeterminado de CSS, según lo definido por W3C: 300x150
Si solo se especifican los atributos ancho y altura de un elemento <video> , el motor de renderizado asume que el tamaño intrínseco del video de origen es el mismo que el tamaño del elemento <video>ancho y altura atributos de un <video> no se especifican y el tamaño no está disponible desde las fuentes (por ejemplo, si la transmisión aún se está cargando), el video inicialmente tendrá de forma predeterminada una resolución de 300x150.
Si conoce el tamaño o la relación de aspecto de un video de origen de antemano, puede usar los atributos x-bs-intrinsic-width/x-bs-intrinsic-height para garantizar que la relación de aspecto del video de origen se mantenga cuando se escale para ajustarse a un elemento <video>: Por ejemplo, si la ventana de video está orientada como HD vertical (width=1080, height=1920), especificar un ancho y alto intrínsecos de 1920x1080 garantiza que los videos HD horizontales se escalen para ajustarse mientras mantienen su relación de aspecto y el letterboxing de forma adecuada. Del mismo modo, los videos se escalarán al ancho/alto intrínseco inmediatamente si el elemento <video> carece de parámetros ancho y altura , en lugar de posiblemente usar 300x150 como valor predeterminado durante un breve período
YouTube
Los reproductores BrightSign admiten videos y listas de reproducción de YouTube.
Media Source Extensions
A partir de OS 8.3, Media Source Extension (MSE) se habilita automáticamente en los reproductores Series 4. Sin embargo, aún puede deshabilitarse configurando la marca mse-support en 0 en el registro.
La compatibilidad con MSE está disponible para la serie 3, pero debe habilitarse específicamente. Para hacerlo, introduzca el siguiente código en el símbolo del sistema de BrightSign:
registry write html mse-support 1Transmisión en vivo HLS
Los reproductores BrightSign admiten transmisión en vivo HLS, pero las listas de reproducción grandes (que generalmente resultan de que el servidor entregue una lista de reproducción DVR en lugar de una lista de reproducción LIVE) causarán problemas de rendimiento.
Entrada HDMI
Debe introducir la fuente de video usando el siguiente URI: “tv:brightsign.biz/hdmi”. Tenga en cuenta que no puede sustituir otra URL de host por “brightsign.biz”.
Ejemplo
<video width="320" height="240" autoplay>
<source src="tv:brightsign.biz/hdmi">
</video>Múltiples elementos de video
De forma predeterminada, los reproductores XT, 4K y XD admiten un máximo de dos elementos <video> activos en cualquier momento (los modelos HD/LS solo admiten uno). Puede tener más de esta cantidad de elementos <video> en una página siempre que los elementos <video> adicionales tengan su atributo src establecido en una cadena vacía. Al modificar la cadena src , puede habilitar y deshabilitar elementos <video> en la página.
Puede habilitar Mosaic Mode (usando el método JavaScript BSVideoMode ) para aumentar el número mínimo permitido de elementos <video> .
Videos pequeños
Los reproductores BrightSign no admiten videos con menos de 64 píxeles de ancho o alto. Sin embargo, un video puede reducirse más allá de este límite haciendo que el elemento <video> sea menor que 64x64. Para obtener el comportamiento de reducción deseado, asegúrese de que el elemento <video> no tenga el atributo viewmode="scale-to-fill-and-crop" .
Modo de visualización
En las versiones de firmware 7.0.x y posteriores, el video HWZ se escala para ajustarse a la relación de aspecto de un elemento <video> (es decir, "scale-to-fill"). En versiones anteriores del firmware, los elementos <video> mantienen la relación de aspecto del video fuente (es decir, "scale-to-fit"). Este comportamiento predeterminado se puede modificar mediante el atributo viewmode; sin embargo, ahora recomendamos usar métodos CSS estándar (por ejemplo, object-fit) para modificar el comportamiento del modo de visualización de un elemento <video>.
- viewmode="scale-to-fill": Escala el video para llenar la ventana. La relación de aspecto del video fuente se ignora, por lo que el video puede verse estirado.
- viewmode="scale-to-fit": Añade bandas negras al video.
- viewmode="scale-to-fill-and-crop": Escala el video para llenar la ventana. La relación de aspecto del video fuente se mantiene, por lo que el video puede recortarse.
Video HWZ
HTML <video> elements can have an optional “hwz” attribute, which is disabled by default. With hwz disabled, video frames are decoded by the dedicated hardware but are routed to the GPU for display. With hwz enabled, video frames are instead routed directly to the hardware compositor, bypassing the GPU. The choice of whether to enable hwz or not depends on the application and there is no single and obviously right answer. Some considerations are:
- La GPU está limitada a una profundidad de color de 8 bits. Si se utiliza video de 10 bits, debe dirigirse al plano de video de hardware para conservar la profundidad de color completa.
- En la mayoría de los casos, la GPU está limitada a resoluciones full-HD. Si se utiliza video 4K, debe dirigirse al plano de video de hardware para evitar la pérdida de resolución. (Incluso en plataformas que pueden configurarse para admitir gráficos 4K, es poco probable que la GPU alcance una velocidad de fotogramas lo suficientemente alta para la reproducción de video con movimiento completo).
- El compositor de video de hardware puede realizar escalado simple y mezcla alfa, pero no admite transformaciones CSS arbitrarias. El video con estilos CSS complejos debe dirigirse a través de la GPU para mostrarse correctamente. Del mismo modo, cualquier video que necesite capturarse como canvas para procesamiento WebGL debe dirigirse a la GPU (consulte Renderizado de video en Canvas). Si desea usar transformaciones CSS en video, el rendimiento del reproductor disminuirá, ya que se basa en el uso de HWZ en lugar de la GPU. Recomendamos probar exhaustivamente un video hwz manipulado antes de usarlo en un entorno de producción.
- Si el video se dirige a la GPU, se requiere un repintado gráfico para cada fotograma. Esto consume una gran cantidad de ancho de banda del sistema y puede provocar una reproducción entrecortada si la GPU no puede mantener la velocidad de fotogramas requerida en todo momento.
En general, recomendamos dirigir el video al compositor de hardware a menos que exista una necesidad específica de procesamiento por parte de la GPU. Para la mayoría de las aplicaciones, dirigir el video al compositor de hardware puede lograrse configurando hwz="z-index:-1" en el elemento de video en cuestión. Esto hace que el compositor apile las capas de video y gráficos según la propiedad CSS z-index.
También puede habilitar hwz para todos los videos en un widget HTML usando uno de los siguientes métodos:
- BrightSign Author: Seleccione la casilla Habilitar la reproducción nativa de video en el estado HTML5 State.
- BrightAuthor Classic: Marque la casilla Habilitar la reproducción nativa del plano de video en el estado HTML5 .
- BrightScript: Llame a SetHWZDefault("on") en la instancia de roHtmlWidget .
Renderizado de video en Canvas
A partir de BOS 10.0.23, los fotogramas de video pueden renderizarse en canvas usando un fragmento de código como el siguiente:
const canvas = document.querySelector('canvas');
const video = document.querySelector('video');
const ctx = canvas.getContext('2d');
function updateCanvasFrame() {
if (!video.paused && !video.ended) {
// Draw the current video frame onto the canvas
ctx.drawImage(video, 0, 0, canvas.width, canvas.height);
// Call the next frame recursively
requestAnimationFrame(updateCanvasFrame);
}
}
// Trigger rendering whenever the video plays
video.addEventListener('play', () => {
updateCanvasFrame();
});Orden Z del video HWZ
Si dos elementos de video deben dirigirse al compositor de hardware, uno de ellos debe recibir hwz="z-index:-2". El que tenga el z-index más bajo (más negativo) se apilará detrás del otro. (Tenga en cuenta que en esta instancia específica se reemplaza el orden de apilamiento CSS). Alternativamente, es posible pasar un valor z-index positivo en el atributo hwz. Si se hace esto, los elementos de video se apilarán delante de la capa gráfica, reemplazando nuevamente el orden de apilamiento CSS, y el que tenga el valor z-index positivo más alto estará delante.
Para dirigir la reproducción de video a la GPU, pase hwz="off" o hwz="z-index:0" (estos son equivalentes). El valor heredado hwz="on" es equivalente a hwz="z-index:1" y debe evitarse.
Puede usar la propiedad CSS z-index para superponer los elementos sin habilitar hwz. El orden de capas que se muestra a continuación es texto arriba → video en el medio → imagen al fondo:
<body style="background-color:blue">
<div style="position:absolute;color:red;font-size:100px;z-index:-1" > Hello BrightSign </div>
<img src="poster.png" style="position:absolute;left:0px;top:0px;width:800px;height:800px;z-index:-3"></img>
<video src="coffee2.mp4" style="position:absolute;left:0px;top:0px;width:480px;height:320px;z-index: -2;" autoplay loop muted></video>
</body>Si hwz está habilitado, su propiedad CSS z-index (style="z-index:-1") será sobrescrita. Agregue un valor z-index en el atributo hwz para mantener las posiciones correctas de orden z para todos los elementos:
<body style="background-color:blue">
<div style="position:absolute;z-index:-1;color: red;font-size: 100px;" hwz="z-index:-1"> Hello World </div>
<img src="poster.png" style="position:absolute;left:0px;top:0px;width:800px;height:800px;z-index:-3" hwz="z-index:-3"></img>
<video src="coffee2.mp4" style="position:absolute;left:0px;top:0px;width:480px;height:320px;z-index: -2;" hwz="z-index:-2" autoplay loop muted></video>
</body>Transformación de video HWZ
Puede agregar el parámetro opcional "transform" al atributo "hwz" para rotar o reflejar el elemento <video> . El parámetro z-index: también debe especificarse para que la transformación funcione. Al parámetro "transform" se le pueden asignar los siguientes valores:
- identidad: Sin transformación (comportamiento predeterminado)
- rot90: Rotación de 90 grados en sentido horario
- rot180: Rotación de 180 grados
- rot270: Rotación de 270 grados en sentido horario
- espejo: Transformación de espejo horizontal
- mirror_rot90: Rotación reflejada de 90 grados en sentido horario
- mirror_rot180: Rotación reflejada de 180 grados en sentido horario
- mirror_rot270: Rotación reflejada de 270 grados en sentido horario
Varias extensiones de etiquetas de video HWZ se separan con un punto y coma. También debe agregarse un punto y coma al parámetro final.
Ejemplo
// Video rotated 180 degrees and behind graphics layer.
<video src="example_movie.mp4" hwz="z-index:-1; transform:rot180;">Desvanecimiento de transmisiones de video HWZ
El parámetro "fade" le permite controlar el comportamiento de desvanecimiento entre videos en streaming en un elemento <video> (esta configuración no se aplica al video local). El parámetro "fade" le permite controlar el comportamiento de desvanecimiento entre videos decodificados en un elemento <video> (esta configuración no se aplica a HDMI in). No afecta el audio y funcionará independientemente de DesvanecimientoDeFlujoDeEntrada.
El parámetro "fade" acepta los siguientes valores:
- auto: Si el reproductor de video actualmente no muestra nada (es decir, todavía no ha reproducido nada o el video cargado anteriormente fue borrado), el siguiente video aparecerá gradualmente. Si el reproductor de video actualmente está reproduciendo video, está pausado o está detenido sin haber sido borrado, el siguiente video no aparecerá gradualmente. Este es el comportamiento predeterminado.
- siempre : Cuando un video termina, la ventana de video se volverá negra. Luego el nuevo video aparecerá gradualmente.
- nunca: Los videos realizan la transición sin efectos de desvanecimiento.
Extensiones de transparencia de video HWZ
Si hwz está habilitado para un elemento <video>, la ventana de video también puede admitir claves luma y chroma para transparencia de video. Esta es la implementación alternativa de transparencia de video de BrightSign al usar el MPV nativo de BrightSign.
Codificación de valor de clave
El parámetro z-index: también debe especificarse para que la transparencia funcione. Las claves luma y chroma se especifican de la siguiente manera:
- luma-key:[VALUE]
- cr-key:[VALUE]
- cb-key:[VALUE]
Cada VALUE es un rango empaquetado de 3 bytes detrás del #:
- # es obligatorio, y omitirlo invalida el atributo hwz.
- La máscara casi siempre es FF para habilitar la clave.
- El extremo superior/inferior del rango es el rango inclusivo de 0–255 de valores de píxeles para hacer transparentes mediante clave. Por ejemplo, para luma-key:#FF2000:
- la máscara es FF
- alto 0x20 (32), bajo 0x00 (0) significa hacer transparente la luma 0–32.
La máscara se aplica como un AND bit a bit entre el componente luma/Cb/Cr (muestra) y el valor de la máscara. En la práctica, los valores típicos utilizados serían 0x00 o 0xFF. Una máscara de 0x00, con un valor mínimo de 0x00, deshabilita completamente la contribución de ese componente en particular a la clave. Por ejemplo, si tanto la máscara Cb como los valores mínimos se establecen en 0x00, el componente Cb no participa en la incrustación. Una máscara de 0xFF significa que el valor de muestra sin máscara debe estar dentro del rango min <= sample_val <= max para que se aplique la incrustación.
En los reproductores Series 5+, el comportamiento de incrustación actualmente no está definido si se utiliza una clave luma de #000000. Como solución alternativa, especifique el valor máximo como 1 (es decir, use una clave luma de #000001), junto con los valores Cr-key/Cb-key apropiados para la incrustación cromática.
Ejemplo
Este es un ejemplo de un video en una capa de video, delante de una capa de gráficos, con video incrustado por luma:
Consulte el complemento Plugin BrightAuthor ChromaLuma-Key-Editor para ver un ejemplo de complemento.
Cómo se seleccionan los decodificadores de video para la reproducción
El software del sistema selecciona qué decodificador de video usar según la resolución detectada del archivo de video. En el modo estándar, intentará seleccionar el decodificador que tenga la resolución máxima compatible más cercana (es decir, 1920x1080 para el decodificador HD y 3840x2160 para el decodificador 4K), sin exceder esa resolución máxima. Si se ha configurado un decodificador para el modo Mosaic, hará coincidir la resolución del video con el valor especificado de timeslice_mode en su lugar. Si ambos decodificadores admiten la misma resolución máxima, puede seleccionar un decodificador haciendo coincidir el orden z de la instancia roVideoPlayer (establcido mediante los métodos ToFront() y ToBack() ) con el orden z del decodificador (establecido mediante el método roVideoMode.SetDecoderMode() ).
También puede seleccionar el decodificador manualmente. Primero, configure los decodificadores usando el método roVideoMode.SetDecoderMode() . Luego, use el valor nombre_amigable especificado al llamar al método para designar un decodificador que se utilizará para la reproducción de video.
Para seleccionar un decodificador en BrightScript, pase una matriz asociativa al método roVideoPlayer.PlayFile() que contenga el parámetro decoder:[friendly_name] :
PlayFile({filename:"text_1.mov", decoder:"main-video"})
Para seleccionar un decodificador para video HTML, incluya la propiedad decoder:[friendly_name] con el atributo hwz :
<video hwz="decoder:main-video;"> </video> <video hwz="decoder:sd-video;"> </video>
El valor max_usage de un decodificador determina cuántos reproductores de video se pueden asignar al decodificador usando el algoritmo del software del sistema descrito anteriormente; los reproductores de video más allá del límite de max_usage pueden asignarse a otro decodificador o no mostrarse en absoluto. Por otro lado, si asigna manualmente reproductores de video usando el valor nombre_amigable del decodificador, puede asignar más reproductores de video al decodificador que el límite de max_usage , pero esto puede causar un comportamiento impredecible de visualización de video.
Descifrado de video
La etiqueta HTML <video> se puede utilizar para descifrar archivos de video y flujos IP. Actualmente, el descifrado de streaming solo es compatible con el protocolo UDP y el protocolo HTTP (cuando HTTP está emparejado con un flujo de transporte MPEG2). Si utiliza un flujo de transporte MPEG2 multicast UDP, uno de los flujos elementales debe proporcionar el PCR al reproductor.
La etiqueta <video> admite los métodos EncryptionAlgorithm y Clave de cifrado :
- EncryptionAlgorithm: El algoritmo de cifrado de archivos. Las siguientes son las opciones actuales:
- "AesCtr": El algoritmo AES en modo CTR
- "AesCtrHmac": El algoritmo AES en modo CTR con HMAC
- "TsAesEcb": El algoritmo AES en modo ECB (por ejemplo, con un Harmonic Prostream) con terminación residual frontal. Este algoritmo se utiliza para cifrado/descifrado de streaming.
- "TsAesEcbRrt": El algoritmo AES en modo ECB (por ejemplo, con un Harmonic Prostream) con terminación residual trasera. Este algoritmo se utiliza para cifrado/descifrado de streaming. Disponible a partir de la versión 9.1.164 en todos los reproductores excepto LS3, HD3, HS3, HO3, XD3, XT3, LS4, HS4 y HD4.
- "TsAesCbcRbt": El algoritmo AES en modo CBC con terminación de bloque residual. Este algoritmo se utiliza para cifrado/descifrado de streaming.
- "TsAesCbcCbt": El algoritmo AES en modo CBC con terminación de bloque claro. Este algoritmo se utiliza para cifrado/descifrado de streaming.
- Clave de cifrado: Una matriz de bytes compuesta por 128 bits de clave. Si el algoritmo de cifrado es AES-CTR o AES-CTR-HMAC, esto va seguido de 128 bits de IV.
Ejemplo (HTML)
<video src="udp://239.192.1.59:5000" EncryptionAlgorithm="TsAesEcb" EncryptionKey="01030507090b0d0f00020406080a0c0e">El reproductor de video ya no acepta claves de cifrado AES "{A|A}" (es decir, donde los 64 bits superiores e inferiores de la clave son idénticos).
Ejemplo (JavaScript)
var player = document.getElementById("my_video_player");
player.setAttribute("EncryptionAlgorithm", "TsAesEcb");
player.setAttribute("EncryptionKey", "01030507090b0d0f00020406080a0c0e");Análisis de transmisiones y subtítulos ocultos
Los siguientes atributos opcionales pueden incluirse en una etiqueta HTML <video>: "preferredvideo", "preferredaudio" y "preferredcaptions". Si múltiples transmisiones de video, audio o datos están encapsuladas en la entrada de video, estos atributos le permiten determinar qué transmisión usar. Por ejemplo, si un video puede contener pistas de audio en inglés y español, puede usar el atributo "preferredaudio" para especificar que se debe reproducir la pista en español si existe, usando inglés como valor predeterminado del video en caso contrario.
Las transmisiones preferidas se eligen haciendo coincidir los patrones de texto proporcionados con la descripción textual de la transmisión:
- Cada atributo ("preferredvideo", "preferredaudio" o "preferredcaptions") es una lista de plantillas separadas por punto y coma.
- Cada plantilla es una lista de patrones separados por comas.
- Cada patrón es un par [field_name]=[field_value] que se compara directamente con la descripción de la transmisión.
Transmisiones de video
Cada plantilla en un atributo "preferredvideo" puede contener los siguientes patrones:
- pid=[integer]: El identificador de paquete (PID) de la transmisión de video que desea mostrar
- program=[integer]: El número de programa de la transmisión de video
- codec=[video_codec]: El códec de video preferido, que puede ser cualquiera de los siguientes:
- MPEG1
- MPEG2
- MPEG4Part2
- H263
- H264
- VC1
- H265
- ancho=[integer]: El ancho de video preferido
- altura=[integer]: La altura de video preferida
- aspect=[float(x.yy)]: La relación de aspecto preferida de la transmisión de video como un número de punto flotante con dos dígitos fraccionarios.
- profundidad de color=[entero]: La profundidad de color preferida del video.
Ejemplo
preferredvideo="pid=7680, codec=H264, width=1280, height=720, aspect=1.78, colordepth=8;;"Transmisiones de audio
Cada plantilla en un atributo "preferredaudio" puede contener los siguientes patrones:
- pid=[integer]: El identificador de paquete (PID) de la transmisión de audio que desea reproducir
- program=[integer]: El número de programa de la transmisión de audio
- codec=[audio_codec]: El códec de audio preferido, que puede ser cualquiera de los siguientes:
- MPEG
- MP3
- AAC
- AAC-PLUS
- AC3
- AC3-PLUS
- DTS
- PCM
- FLAC
- Vorbis
- channels=[integer]: El número preferido de canales de audio (de 1 a 8)
- freq=[frecuencia]: La frecuencia de muestreo preferida de la pista de audio, que puede ser cualquiera de las siguientes:
- 32000
- 44100
- 48000
- lang=[idioma]: Un código que determina el idioma preferido de la pista de audio (p. ej., ing, spa). Los códigos de idioma se especifican en el estándar ISO 639-2.
- type=[audio_type]: El tipo de audio preferido, que puede ser uno de los siguientes:
- Audio principal
- Efectos limpios
- Personas con discapacidad auditiva
- Comentarios para personas con discapacidad visual
Ejemplo
preferredaudio="pid=4192, codec=AC3, channels=5, freq=48000, lang=eng, type=Main audio;;"Flujos de subtítulos y captions
Los términos "caption", "closed captions" y "closed captioning" se usan indistintamente en estos documentos.
Cada plantilla en un atributo "preferredcaption" puede contener los siguientes patrones:
- pid=[integer]: El identificador de paquete (PID) del flujo de captions que desea reproducir
- type=[subtitle_type]: El estándar de codificación de los subtítulos. Este valor puede ser uno de los siguientes:
- CEA708: Si el estándar CEA-708 no está presente, subtitle_type usará de forma predeterminada CEA-608 (si está presente).
- CEA608
- DVB
- lang=[idioma]: Un código que determina el idioma preferido de los subtítulos (p. ej., ing, spa). Los códigos de idioma se especifican en el estándar ISO 639-2.
- service=[integer]: El número de servicio preferido del flujo de captions
Ejemplo
preferredcaptions="pid=0, type=Cea708, lang=eng service=1;;"Los subtítulos y captions se renderizan en la capa gráfica, y hwz debe establecerse en z-index -1 o z-index -2 para colocar el video detrás de los gráficos. De lo contrario, los subtítulos y/o captions quedarán cubiertos por el video.
Comportamiento de coincidencia de patrones
Tenga en cuenta lo siguiente al hacer coincidir plantillas con descripciones de flujo:
- Para que una plantilla coincida con una descripción de flujo, cada patrón dentro de la plantilla debe coincidir.
- Se utilizará la primera plantilla listada que coincida con la descripción del flujo (si existe).
- Una cadena de plantilla vacía coincidirá con cualquier descripción de flujo.
- Todas las comparaciones de valores distinguen mayúsculas y minúsculas.
- Los valores numéricos deben coincidir exactamente con la descripción del flujo (sin ceros a la izquierda). Por ejemplo, el patrón pid=016 nunca coincidirá con el valor PID del flujo de 16.
- Para indicar negación lógica, aplique el signo de exclamación "!" al comienzo de un patrón. Por ejemplo, especificar preferredvideo="!codec=H265" solo coincidirá con flujos que no estén codificados mediante H.265.
- Aplique el símbolo mayor que ">" antes de un entero para indicar que, para una coincidencia exitosa, el valor en la descripción del flujo debe ser mayor que el valor que sigue al símbolo. Por ejemplo, especificar preferredvideo="width=<1921,height=<1081" solo coincidirá con videos que no sean mayores que full-HD.
- Aplique el símbolo menor que "<" antes de un entero para indicar que, para una coincidencia exitosa, el valor en la descripción del flujo debe ser menor que el valor que sigue al símbolo.
Más ejemplos
La siguiente lista de plantillas contiene tres patrones: lang=eng, lang=spa, y una cadena vacía. El primer patrón especifica un canal de idioma inglés; si el canal en inglés no existe, el segundo patrón especifica un canal de idioma español. El tercer patrón especifica cualquier otro canal si los dos primeros no existen (la cadena vacía coincide con cualquier cosa).
preferredaudio="lang=eng;lang=spa;;"Dado que la siguiente lista de plantillas está vacía, no se especifican subtítulos. Esto se puede usar para deshabilitar los subtítulos por completo.
preferredcaptions=""La siguiente lista de plantillas contiene una plantilla de cadena vacía. Dado que una plantilla vacía coincide con cualquier cosa, se reproducirá el primer flujo de video encontrado. Este es el comportamiento predeterminado de todos los atributos.
preferredvideo=";"La siguiente lista de plantillas especifica un flujo de audio de 48KHz si existe uno; de lo contrario, no se reproducirá ningún flujo de audio. Observe que la lista no termina con un punto y coma; en este caso, el punto y coma se suministra implícitamente.
preferredaudio="freq=48000"La siguiente lista de plantillas contiene dos plantillas. Tenga en cuenta que todos los patrones dentro de una plantilla deben coincidir con la descripción del flujo para que toda la plantilla coincida. En este ejemplo, se prefiere una pista en inglés codificada con AAC; una pista en inglés codificada con MP3 se designa como la segunda opción; y se elegirá cualquier pista si ninguna de las plantillas coincide.
preferredaudio="codec=aac,lang=eng;codec=mp3,lang=eng;;"Cambio de pista de video
El framework de reproducción multimedia BrightSign no admite el cambio dinámico entre pistas mediante video/audio HTML5. Sin embargo, sí admite consultar información de pistas usando la Tracklist API. Los siguientes pasos describen cómo seleccionar pistas usando esta API.
- Cree un elemento de video en JavaScript que no esté adjunto al DOM (es decir, que sea invisible).
- Configure el detector de eventos onloadedmetadata .
- Configure el src de la URL multimedia.
- Llame a load() en el elemento de video HTML5. Esto activará el evento loadedmetadata .
- Lea la información de la pista desde el evento.
- Cree un nuevo reproductor de video HTML5 y use la información de la pista para configurar los parámetros preferredAudio, preferredVideo y preferredSubtitle (descritos anteriormente).
- Llame a load()/play() en el elemento de video.
- Adjunte el elemento de video al DOM.
Al cambiar de un video a otro, es importante establecer la fuente del video en blanco para liberar el elemento de video; de lo contrario, los primeros videos continuarán usando memoria mientras se reproducen los videos posteriores. Consulte la línea 12 en el siguiente ejemplo de código.
Ejemplo
<!DOCTYPE html>
<head>
<script>
var video;
function playTrackNext()
{
// Switch to audio/video 1
var pid = video.videoTracks[1].id;
var audiopid = video.audioTracks[1].id;
// release the video element
video.src = "";
// create a new video element
video = document.createElement('video');
video.src = "http://brightsign.biz/example.ts";
video.hwz = "on";
video.preferredvideo = "pid=" + pid;
// use the params we gathered from previous video load
video.preferredaudio = "pid=" + audiopid;
video.load();
video.play();
document.getElementById("videoarea").appendChild(video);
}
function runTest()
{
// Initialize testing bs/javascript bridge.
bs.start();
// Initial load of media to gather track information
video = document.createElement('video');
video.onloadedmetadata = playTrackNext; // play track 0
video.src = "http://brightsign.biz/example.ts";
video.hwz = "on";
video.load(); // will trigger loadedmetadata event once the video is loaded.
}
</script>
</head>
<html>
<body bgcolor="#E6E6FA" onload="runTest()">
<h1>Video Audio Tracks Test Page</h1>
<div id="videoarea"></div>
</html>Enrutamiento de audio en elementos <audio>/<video>
Los reproductores BrightSign tienen atributos de audio únicos para elementos <audio>/<video> . Estos le permiten controlar cómo se enruta el audio a través de las salidas del reproductor:
- Pcmaudio: Audio PCM
- Compaudio: Audio comprimido
- Multiaudio: Audio multicanal
Cada atributo puede recibir los siguientes valores, que determinan a dónde se dirigirá el audio:
- “ninguno”
- "hdmi” o "hdmi-1", "hdmi-2", "hdmi-3", o "hdmi-4" para reproductores Series 5 con múltiples salidas
- “USB”
- “spdif”
- "analógico"
- “analog:N” (N especifica la enumeración del puerto, lo que es útil para modelos con múltiples puertos de audio analógico; también puede usar "analog:1" para especificar la salida analógica en un modelo con un único puerto de audio analógico)
Si no asigna ningún atributo de audio a un elemento <audio>/<video>, entonces el audio se dirigirá a todas las salidas de audio, junto con cualquier otro audio que se esté reproduciendo actualmente.
Ejemplo 1
<video src="example_movie.mp4" width="512" height="400" pcmaudio="hdmi" autoplay>
Your browser does not support the video tag.
</video>Ejemplo 2
<video src="example_movie.mp4" width="512" height="400" compaudio="hdmi;usb" autoplay>
Your browser does not support the video tag.
</video>Reproducción de código de tiempo de video HTML
La precisión de BrightSign para la reproducción de código de tiempo de video HTML es de 200 ms.
Chroma Keying
La configuración de chroma key de BrightSign consiste en una máscara y un valor mínimo y máximo. El mínimo y el máximo son los valores más importantes, ya que la máscara realmente solo es útil para “efectos especiales”. Se verifica cada píxel de cada fotograma para ver si está entre los valores mínimo y máximo y, si lo está, el píxel se establece como completamente transparente. Si está fuera del rango, el píxel es completamente opaco. Esto significa que tendrá un borde duro, no un desvanecimiento gradual, donde el video pasa de opaco a transparente.
Consejos de Chroma Key
- Para obtener un mejor chroma keying, no aplique anti-aliasing a ningún píxel que deba ser transparente. Entonces podrá apuntar a un único color de transparencia en lugar de un rango.
- Si su video está comprimido, el chroma está submuestreado, por lo que habrá bordes donde el chroma terminará como un valor intermedio entre el verde y el color del fotograma. Las animaciones CGI con huecos verdes a menudo tienen anti-aliasing, lo que dará como resultado un desvanecimiento de verde alrededor de los bordes. Es posible que pueda eliminar con chroma key estos bordes con los valores mostrados en los ejemplos a continuación (en estos ejemplos, v es un objeto roVideoPlayer).
- El color más fácil de eliminar del contenido es el negro, que tiene un valor de luma de 0, porque el video tiene chroma submuestreado (4:2:0 en lugar de 4:4:4). El uso de luma keying significa que cada píxel puede ser procesado con precisión.
- El blanco tiene una luma de 240 (no es exactamente un valor completo de 8 bits), pero el chroma puede significar que contiene muchos otros colores brillantes, por lo que es difícil eliminar solo el blanco.
- Los colores arbitrarios son difíciles de manejar, ya que implican especificar un pequeño rango de valores de chroma que deben calcularse. El color que se eliminará debe calcularse en YCbCr, y los valores Cb y Cr se utilizan para el chroma keying. Si la fuente es CGI, entonces el rango utilizado puede ser muy estrecho, ya que un solo color se vuelve transparente. Si la fuente de video era metraje en vivo filmado contra una pantalla verde, entonces el rango debe ser mucho más amplio para adaptarse a la gama de colores verdes en el video.
Ejemplos
Valores inferiores de Chroma Key
Aquí el rango Cr es 0-32 y el rango Cb es 0-48. Esto puede dejar un halo verde alrededor de las áreas que se mezclaron para dar una apariencia más suave, ya que el chroma keying no puede hacer transiciones suaves.
v.SetKeyingValue({cr:&hff2000, cb:&hff3000})Valores superiores de Chroma Key
Este ejemplo cubre un rango mucho mayor de colores:
v.SetKeyingValue({cr:&hff7000, cb:&hff7000}) Otras configuraciones
Mostrar/Omitir fotogramas
Esta configuración le permite configurar si se muestran los fotogramas con errores o se omiten (lo que puede causar pausas). Está disponible a partir de BOS 9.1.137.
<video id="myVideo" src="stream.ts" x-bs-drop-error-frames="false" autoplay></video>