--- title: configuracióndecodificador slug: develop/es/configuraciondecodificador docTags: createdAt: 2025-03-11T07:07:19.526Z --- El objeto *decoderconfiguration* le permite configurar decodificadores de video para Mosaic Mode. **IDL de decoderconfiguration** ```text interface DecoderConfiguration { Promise getConfig(); Promise applyConfig(DecoderConfig config); }; interface DecoderConfigWritable { attribute String name; attribute String friendlyName; attribute String configuredSize; attribute int zIndex; attribute bool mosaicDeinterlace; }; interface DecoderConfig : DecoderConfigWritable { attribute String maxSize; attribute String mode; attribute int usageCount; attribute int maxUsage; }; ``` ## Creación de objetos Para crear un objeto *decoderconfiguration* , primero cargue el módulo `brightsign/decoderconfiguration` utilizando el método `require()` . Luego cree una instancia de la clase *decoderconfiguration* . ```javascript var DecoderConfigurationClass = require("@brightsign/decoderconfiguration"); var decoderConfig = new DecoderConfigurationClass(); ``` ## DecoderConfiguration Utilice esta interfaz para recuperar y modificar datos del decodificador de video. ### getConfig() ```javascript Promise getConfig()  ``` Devuelve un arreglo de interfaces *Configuración del decodificador* . Cada interfaz describe un decodificador de video. ### applyConfig() ```javascript Promise applyConfig(DecoderConfigArray config)  ``` Configura decodificadores de video para el modo estándar o el modo Mosaic. En el modo estándar, se utiliza un único decodificador para reproducir un solo video; en el modo Mosaic, el decodificador puede utilizarse para decodificar varios videos de diferentes fuentes locales o remotas. Este método acepta un arreglo de interfaces *Configuración del decodificador* ; los atributos que son de solo lectura (por ejemplo, `maxSize`) se ignorarán. El software del sistema selecciona qué decodificador de video utilizar 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 un decodificador ha sido configurado para Mosaic mode, en su lugar hará coincidir la resolución del video con el valor especificado en `configuredSize` . Si dos decodificadores admiten la misma resolución máxima, puede seleccionar un decodificador manualmente utilizando el atributo `friendlyName` . Para seleccionar un decodificador para un video HTML, incluya la propiedad `decodificador:[Friendlyname]` con el atributo [atributo HWZ](docId\:PdYtB1wooQwKYvCD5fJmS): ```javascript   ``` El valor `maxUsage` de un decodificador determina cuántos reproductores de video pueden asignarse al decodificador utilizando el algoritmo del software del sistema descrito anteriormente; los reproductores de video que excedan el límite de `max_usage` pueden asignarse a otro decodificador o no mostrarse en absoluto. Por otro lado, si asigna manualmente reproductores de video utilizando 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 provocar un comportamiento impredecible en la visualización de video. ## DecoderConfig Esta interfaz contiene la configuración de un decodificador de video. Contiene atributos editables y de solo lectura. ### Editable - `nombre` string: El nombre del sistema del decodificador de video (la disponibilidad del decodificador difiere según el modelo): - "4K1": El decodificador 4K principal (solo modelos XTx44) - "4K2": El decodificador 4K secundario (solo modelos XTx44) - "4K": El único decodificador 4K (solo modelos HDx24, XTx43, 4Kx42, XDx34 y XDx33) - "HD1": El primer decodificador HD - "HD2": El segundo decodificador HD - `friendlyName` string: Un nombre para hacer referencia al decodificador en HTML o BrightScript - `configuredSize` string: La resolución máxima que el decodificador aceptará (a velocidades de cuadros de hasta 60p). Si esta resolución es igual al límite máximo de resolución del decodificador, el decodificador utilizará el modo estándar; de lo contrario, utilizará el modo Mosaic. - "4K": 3840x2160 - "HD": 1920x1080 - "SD": 720x576 - "CIF": 352x288 - "QCIF": 176x144 :::hint{type="danger"} Escalar videos en modo Mosaic actualmente provoca una degradación severa del rendimiento. ::: - `zIndex` int: El índice z de la ventana de video (en modo estándar) o del grupo de ventanas de video (en modo Mosaic) en relación con el plano gráfico: - 1: La ventana de video (o grupo de ventanas) está posicionada delante del plano gráfico. - -1: La ventana de video (o grupo de ventanas) está posicionada detrás del plano gráfico. - `mosaicDeinterlace` bool: Si los videos en modo Mosaic pueden estar entrelazados o no. Habilitar el desentrelazador permitirá la reproducción de videos entrelazados en modo Mosaic, pero también reducirá la cantidad de videos en modo Mosaic que pueden decodificarse simultáneamente. ### Solo lectura - `maxSize` string: La resolución máxima del decodificador, según lo establecido por el software del sistema. Este valor puede ser `"4K"` o `"HD"` - `modo` string: El modo actual del decodificador, que puede ser `"normal"` o `"mosaico"` - `usageCount` int: El número de videos que actualmente están siendo decodificados por el decodificador - `maxUsage` int: El número máximo de videos que pueden ser decodificados simultáneamente por el decodificador (este valor siempre es 1 en modo `"normal"` ). Los límites óptimos de `max_usage` se describen a continuación; el límite puede ser menor dependiendo de varios factores, incluidos el entrelazado y la velocidad de cuadros. - Decodificador 4K: - 1 video 4K - 2 videos HD - 4 videos SD - 8 videos CIF - 10 videos QCIF - Decodificador HD: - 0 videos 4K - 1 video HD - 3 videos SD - 4 videos CIF - 5 videos QCIF ## Ejemplo Este script recupera la configuración actual del decodificador de video y la modifica para que el decodificador 4K pueda utilizarse para decodificar 2 videos HD. ```javascript var DecoderConfigurationClass = require("@brightsign/decoderconfiguration"); var decoderConfig = new DecoderConfigurationClass(); function findDecoder(element) { return element.name === "4K"; }; function setDecoder(decoderList) { decoder = decoderList.find(findDecoder); decoder.friendlyName = "main-video"; decoder.configuredSize = "HD"; decoder.zIndex = 1; decoderConfig.applyConfig(decoderList).then() .catch( function(data) { console.log(JSON.stringify(data)); }); }; decoderConfig.getConfig().then( function(data) { setDecoder(data); }) .catch( function(data) { console.log(JSON.stringify(data)); }); ```