Definición y uso¶
El elemento <property> define una propiedad o un grupo de propiedades para su padre <media>, <context>, <body> o <switch> elementos. Estas propiedades se pueden utilizar en relaciones con otros objetos. de una aplicación NCL, si el atributo externo de <property> El elemento tiene "verdadero" como valor.
El elemento <property> define el atributo de nombre, que indica el nombre de la propiedad o grupo de propiedades y el atributo de valor. el padre El elemento no puede tener más de un elemento <property> con el mismo valor del atributo de nombre.
El atributo valor es opcional y define un valor inicial para el propiedad declarada en el atributo nombre. Cuando el valor no es especificada, la propiedad se inicializa con el valor definido en el homónimo atributos de los elementos <descriptor> o <region> asociados con el elemento padre que define el <property>, o bien con un valor predeterminado (que depende del valor del atributo de nombre). cuando el El valor se especifica en el elemento <property>, tiene prioridad sobre el valor definido en los atributos homónimos de <descriptor> o <region> elementos asociados con el elemento principal que define el <property>.
Sintaxis¶
| Elemento | Atributos | Contenido | Padre |
|---|---|---|---|
| <property> | nombre, valor, externable | -- | <media> o <context> o <body> |
Atributos¶
| Nombre | Valor | Descripción |
|---|---|---|
| nombre | Puede recibir cualquier valor de cadena que comience con una letra o un guión bajo y que solo contenga letras, dígitos, "." y "_". | El atributo nombre identifica de forma única la propiedad dentro de su elemento principal. |
| valor | Depende del valor del nombre. | El atributo valor define un valor inicial para el atributo nombre. |
| externable | "falso" o "verdadero". El valor predeterminado es: "verdadero" si la propiedad está definida en un elemento <property>, o "falso" si la propiedad está definida en un elemento <descriptor>. | El atributo externable determina si una propiedad puede (externable="true") o no (externable="false") usarse en relaciones. |
Propiedades predefinidas¶
Se utilizan varias palabras reservadas para especificar propiedades con valores predefinidos. semántica conocida por los jugadores de la NCL. Estas propiedades, su semántica, su Los valores posibles y sus valores predeterminados se presentan a continuación.
Propiedades predefinidas para todos los <media> elementos¶
| Name | Value | Description |
|---|---|---|
| style | URI. | The locator of a stylesheet file that specifies other properties for the object. |
| player | String. | Identifies the presentation tool to be used. If not specified, the player is determined by the object type, defined by the type attribute of the <media> element, or inferred by the file extension of the src attribute value of the <media> element. |
| reusePlayer | "true" or "false". The default value is "false". |
Specifies if a new player must be instantiated ("false") or if a player already instantiated must be used ("true"). |
| playerLife | "close" or "keep". The default value is "close. |
Specifies what will happen to the player instance at the end of the object presentation. |
| deviceClass | "systemScreen(i)" or "systemAudio(i)", where i is a non-negative integer. The default value is the same device class that runs the NCL player. |
Specifies the device class where the media object will be presented. There are two different types of device classes: active and passive. In an active class, a device is able to run some media players for <media> element presentations. In a passive class, a device is not required to run media players, only to exhibit a bit map or a sequence of audio samples received from another device. The "systemScreen(1)" and "systemAudio(1)" are reserved to passive classes, and "systemScreen(2)" and "systemAudio(2)" are reserved to active classes. |
| explicitDur | The "explicitDur" property is specified according with one of the following syntax:
For continuous media, the default value is set to the duration of the content, otherwise, it must be set to nil. |
Gives the duration of an object. |
| focusIndex | Positive integer. When this property is not defined, the object is considered as if no focus could be set to it. |
Specifies an index for the <media> element to which the focus may be applied. Note: When an element on focus is selected by pressing the "activate (select or enter) key", the focus control shall be passed to the <media> element renderer (player). The player may then follow its own rules for navigation. The focus control shall be passed back to the NCL Player when the "back key" is pressed. In this case, the focus goes to the element identified by the the "service.currentFocus" property of the settings node (<media> element of "application/x-ncl-settings" type). |
| moveLeft | Positive integer. | Specifies a value equal to the focusIndex value associated to the element to which the focus should be applied when the "left arrow key" is pressed. When the focus is applied to an element with the visible property set to false, or to an element that it is not being presented, the current focus does not move. |
| moveRight | Positive integer. | Specifies a value equal to the focusIndex value associated to the element to which the focus should be applied when the "right arrow key" is pressed. When the focus is applied to an element with the visible property set to false, or to an element that it is not being presented, the current focus does not move. |
| moveUp | Positive integer. | Specifies a value equal to the focusIndex value associated to the element to which the focus should be applied when the "up arrow key" is pressed. When the focus is applied to an element with the visible property set to false, or to an element that it is not being presented, the current focus does not move. |
| moveDown | Positive integer. | Specifies a value equal to the focusIndex value associated to an element to which the focus should be applied when the "down arrow key" is pressed. When the focus is applied to an element with the visible property set to false, or to an element that it is not being presented, the current focus does not move. |
Propiedades predefinidas para <media> elementos con contenido visual¶
| Name | Value | Description |
|---|---|---|
| top | A real number in the range [0,100] ending with the character <"%"> (e.g. 30%), or an integer non-negative value specifying the attribute in pixels. For pixel values, the "px" unit qualifier may be omitted. The default value is "0%", if the bottom value is not specified. |
Top position of the content, expressed as a percentage of the exhibition device height dimension, or as an absolute value. It places the top position of the content to be exhibited in the specified distance away from the top edge of the exhibition device. |
| bottom | If the "top" and "height" values are specified, it must be computed based on these values. Otherwise, it must be a real number in the range [0,100] ending with the character <"%"> (e.g. 30%), or an integer non-negative value specifying the attribute in pixels. For pixel values, the "px" unit qualifier may be omitted. The default value is "0%", if the attribute value cannot be computed from the height and top attributes. |
Bottom position of the content, expressed as a percentage of the exhibition device height dimension, or as an absolute value. It places the bottom position of the content to be exhibited in the specified distance away from the bottom edge of the exhibition device. |
| left | A real number in the range [0,100] ending with the character <"%"> (e.g. 30%), or an integer non-negative value specifying the attribute in pixels. For pixel values, the "px" unit qualifier may be omitted. The default value is "0%", if the right value is not specified. |
Left position of the content, expressed as a percentage of the exhibition device width dimension, or as an absolute value. It places the left position of the content to be exhibited in the specified distance away from the left edge of the exhibition device. |
| right | If the left and width values are specified, it must be computed based on these values. Otherwise, it must be a real number in the range [0,100] ending with the character <"%"> (e.g. 30%), or an integer non-negative value specifying the attribute in pixels. For pixel values, the "px" unit qualifier may be omitted. The default value is "0%", if the attribute value cannot be computed from the width and left attributes. |
Right position of the content, expressed as a percentage of the exhibition device width dimension, or as an absolute value. It places the right position of the content to be exhibited in the specified distance away from the right edge of the exhibition device. |
| width | A real number in the range [0,100] ending with the character <"%"> (e.g. 30%), or an integer non-negative value specifying the attribute in pixels. For pixel values, the "px" unit qualifier may be omitted. The default value is "0%". |
Width of the content to be exhibited, expressed as a percentage of the exhibition device width dimension, or as an absolute value. |
| height | A real number in the range [0,100] ending with the character <"%"> (e.g. 30%), or an integer non-negative value specifying the attribute in pixels. For pixel values, the "px" unit qualifier may be omitted. The default value is "0%". |
Height of the content to be exhibited, expressed as a percentage of the exhibition device height dimension, or as an absolute value. |
| location | See "left" and "top" properties. | Two numbers separated by comma, each one following the rule specified for "left" and "top" properties, respectively. |
| size | See "width" and "height" properties. | Two numbers separated by comma, each one following the rule specified for "width" and "height" properties, respectively. |
| bounds | See "left", "top", "width", and "height" properties. | Four numbers separated by comma, each one following the rule specified for "left", "top", "width", and "height" properties, respectively. |
| background | "white", "black", "silver", "gray", "red", "maroon", fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal". It may also be the reserved value "transparent". The default value is "transparent". |
The background color used to fill the area of a region for displaying the media content that is not filled by the content itself. |
| rgbChromakey | RGB color defined using a hexadecimal (hex) notation for the combination of Red, Green, and Blue color values (RGB). The lowest value that can be given to one of the light sources is 0 (hex 00). The highest value is 255 (hex FF). It may also be defined by the reserved words: "white", "black", "silver", "gray", "red", "maroon", fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal". |
The RGB color to be set as transparent. |
| visible | "true" or "false". The default value is "false". |
Allows the object presentation to be seen or hidden. When the visible property associated with a <context> or <body> element is equal to "true", the visible property of each child element of the composition is taken into account to define how each of these child element will be exhibited. When the visible property associated with a <context> or <body> element is equal to "false", all child elements of the composition are exhibited as hidden. It should be remarked that an object with a visible property equal to "false", that is, an object exhibited as hidden, may not have any of its content anchors selected while the visible property value persists as "false". When a document has its <body> element with its visible property set to "false" and its presentation event is in the paused state, the document is said to be in stand-by. In ISDB-T standard, when there is only one application in execution and this application is in stand-by, the service's main video is dimensioned to 100% of the screen, and the main audio is set to 100% of its volume. |
| transparency | A real number in the range [0,1] or a real number in the range [0,100] ending with the character <"%"> (e.g. "30%"). The default value is "0%". |
Indicates the degree of transparency of an object presentation: "1" or "100%" means full transparency and "0" or "0%" means opaque. |
| fit | "fill", "hidden", "meet", "meetBest", or "slice". The default value is "fill". |
Indicates how an object will be presented. "fill": scale the object's media content so that it touches all edges of the box defined by the object's "width" and "height" properties. "hidden": if the intrinsic "height" ("width") of the media content is smaller than the "height" ("width") property, the object must be rendered starting from the "top" ("left") edge and have the remaining "height" ("width") filled up with the background color; if the intrinsic "height" ("width") of the media content is greater than the "height" ("width") property, the object must be rendered starting from the top (left) edge until the height (width) defined in the property is reached; the part of the media content below (to right of) the height (width) is clipped. "meet": scale the visual media object while preserving its aspect ratio until its height or width is equal to the value specified by the "height" or "width" properties. The media content left-top corner is positioned at the top-left coordinates of the box; the empty space at the right or the bottom must be filled up with the background color. "meetBest": the semantic is identical to "meet", except that the image is not scaled greater than 100% in either dimension. "slice": scale the visual media content while preserving its aspect ratio until its height or width are equal to the value specified in the "height" and "width" properties and the defined presentation box is completely filled. Some parts of the content may get clipped. Overflow width is clipped from the right of the media object. Overflow height is clipped from the bottom of the media object. |
| scroll | "none", "horizontal", "vertical", "both", or "automatic". The default value is 0. |
Allows for the specification of how the scroll is configured in an exhibition region. |
| zIndex | An integer number in the range [0,255]. The default value is 0. |
The zIndex attribute specifies the superposition precedence, where objects with greater zIndex values are stacked on top of objects with smaller zIndex values. |
| plan | "video", "graphic", or "background". The default is "video" for media with src attribute referring to a PES of a transport stream, or "graphic" for all other cases. |
Defines in which plan of a structured screen an object will be placed. |
| focusBorderColor | "white", "black", "silver", "gray", "red", "maroon", fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal". The default value is defined by the "default.focusBorderColor" property of the settings object. |
Defines the color to decorate the screen region where the object on focus is being presented, before it is selected. |
| selBorderColor | "white", "black", "silver", "gray",""red", "maroon", fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal". The default value is defined by the "default.selBorderColor" property of the settings object. |
Defines the color to decorate the screen region where the object on focus is being presented, after it is selected. |
| focusBorderWidth | Integer. The default value is defined by the "default.focusBorderWidth" property of the settings object. |
Width (in pixels) applied to the border of an element in focus (0 means that no border will appear, positive values means that the border is outside the object content, and negative values means that the border is drawn over the object content). |
| focusBorderTransparency | A real value between 0 and 1, or a real value in the range [0,100] ending with the character <"%"> (e.g. "30%"). The default value is defined by the "default.focusBorderTransparency" property of the settings object. |
Transparency applied to the border of an element in focus, with "1" or "100%" meaning full transparency and "0" or "0%" meaning no transparency. |
| focusSrc | The following are valid values:
For focusSrc attribute whose value identifies the <"sbtvd-ts">, <"isdb-ts">, or <"ts"> scheme, the "program_number.component_tag", can be substituted by the following reserved words:
|
Specifies an alternative media source to be presented, instead of the current presentation, if an element receives the focus. This attribute follows the same rules of the src attribute of the <media> element. |
| focusSelSrc | Same as for focusSrc. | Specifies an alternative media source to be presented, instead of the current presentation, when an element on focus is selected by pressing the activation (select or enter) key. This attribute follows the same rules of the src attribute of the <media> element. |
| freeze | "true" or "false". The default value is "false". | Defines what will happen with an object at the end of its presentation, if the end content is frozen ("true") or not ("false"). Defaults to "false" |
| transIn, transOut | List of (type, subtype, dur, startProgress, endProgress, direction, fadeColor, horzRepeat, vertRepeat, borderWidth, borderColor) separated by semicolons where:
The default value for the property is the empty string. If a transition type is specified then:
|
The value of the transIn and transOut is a semicolon-separated list of transitions. The purpose of the semicolon-separated list is to allow authors to specify a set of fallback transitions if the preferred transition is not available. The first transition in the list should be performed if the user-agent has implemented this transition. If this transition is not available, then the second transition in the list should be performed, and so on. The type and subtype define the transition. The dur attribute specifies the duration of the transition. The startProgress attribute specifies the amount of progress through the transition at which to begin execution. For instance, we can want to begin a crossfade with the destination image being already 30% faded in. For this case, startProgress would be 0.3. The endProgress attribute specifies the amount of progress through the transition at which to end execution. The value of this attribute must be greater than or equal to the value of the startProgress attribute. If endProgress is equal to startProgress, then the transition remains at a fixed progress for the duration of the transition. The direction attribute specifies the direction the transition will run. Note that not all transitions will have meaningful reverse interpretations. For instance, a crossfade is not a geometric transition, and therefore has no interpretation of reverse direction. Transitions that do not have a reverse interpretation should have the direction attribute ignored and the default value of "forward" assumed. If the value of the type attribute is "fade" and the value of the subtype attribute is "fadeToColor" or "fadeFromColor", then the fadeColor attribute specifies the ending or starting color of the fade. If the value of the type attribute is not "fade", or the value of the subtype attribute is not "fadeToColor" or "fadeFromColor", then the fadeColor attribute is ignored. If the value of the type attribute is not "fade", then the following attributes can be specified: The horzRepeat attribute specifies how many times to perform the transition pattern along the horizontal axis. The vertRepeat attribute specifies how many times to perform the transition pattern along the vertical axis. The borderWidth attribute specifies the width of a generated border along a wipe edge. The borderColor attribute specifies the content of the generated border along a wipe edge. If the value of this attribute is a color, then the generated border along the wipe or warp edge is filled with this color. If the value of this attribute is "blend", then the generated border along the wipe blend is an additive blend (or blur) of the media sources. |
Propiedades predefinidas para <media> elementos con contenido multimedia continuo (solo lectura)¶
| Nombre | Valor | Descripción |
|---|---|---|
| ID de contenido | String. (Establecido solo por el reproductor NCL.) El valor predeterminado es nulo. |
La propiedad "contentId" está asociada a objetos de medios continuos cuyo contenido se define haciendo referencia a un flujo elemental. Tiene null como valor inicial y se establece en el valor del identificador transportado en el descriptor de referencia NPT (en un campo del mismo nombre: contentId), tan pronto como se inicia el objeto de medios continuos asociado. |
| en espera | "true" o "false". (Establecido solo por el reproductor NCL). El valor predeterminado es "falso". |
La propiedad "en espera" se establece en "verdadero" mientras que un contenido de objeto de medios continuos ya iniciado que hace referencia a una secuencia elemental es interrumpido temporalmente por otro contenido entrelazado, en la misma secuencia elemental. |
Propiedades predefinidas para <media> elementos con contenido audible¶
| Nombre | Valor | Descripción |
|---|---|---|
| nivel de sonido | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter <"%"> (por ejemplo, "30%"). El valor predeterminado es 1. |
Volumen de audio relativo al audio grabado. |
| nivel de equilibrio | Un número real en el rango [-1,1] o un número real en el rango [-100,100] que termina con el carácter <"%"> (por ejemplo, "30%"). El valor predeterminado es 0. |
Nivel de balance del audio (-1 a la izquierda y +1 a la derecha). |
| nivel de agudos | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter <"%"> (por ejemplo, "30%"). El valor predeterminado es 1. |
Configuración de agudos, relativa al audio grabado. |
| nivel de bajo | Un número real en el rango [0,1] o un número real en el rango [0,100] que termina con el carácter <"%"> (por ejemplo, "30%"). El valor predeterminado es 1. |
Configuración de graves, relativa al audio grabado. |
| congelar | "verdadero" o "falso". El valor predeterminado es "falso". |
Esta propiedad define lo que sucederá con un objeto al final de su presentación, si el contenido final está congelado ("verdadero") o no ("falso"). |
| transIn, transOut | Una lista del formato <"(type,subtype,dur,startProgress,endProgress)"> donde:
El valor predeterminado de la propiedad es la cadena vacía. Si se especifica una transición, entonces:
|
El tipo de transIn y transOut siempre es "fundido" y el subtipo siempre es "fundido" y está definido de forma predeterminada. El atributo dur especifica la duración de la transición. El atributo startProgress especifica la cantidad de progreso a través de la transición en la que comenzar la ejecución. El atributo endProgress especifica la cantidad de progreso a través de la transición en la que finalizar la ejecución. El valor de este atributo debe ser mayor o igual al valor del atributo startProgress. Si endProgress es igual a startProgress, entonces la transición permanece en un progreso fijo mientras dure la transición. |
Propiedades predefinidas para <media> elementos con contenido textual¶
| Name | Value | Description |
|---|---|---|
| fontColor | "white", "black", "silver", "gray", red", "maroon", "fuchsia", "purple", "lime", "green", "yellow", "olive", "blue", "navy", "aqua", or "teal". The default value is "white". |
Defines the font color. |
| fontFamily | A prioritized list of font family names and/or generic family names. There are two types of font family names:
The default value of this property is system-dependent. |
The list values are separated by a comma to indicate that they are alternatives. |
| textAlign | "left", "right", "center", or "justify". The default value is "left". |
This property describes how text content is aligned. |
| fontStyle | "normal" or "italic". The default value is "normal". |
Defines the font style. |
| fontSize | Positive integer ending with the character "px" or "pt", for relative font size expressed in pixels, or absolute font size expressed in points, respectively. The default value of this property is system-dependent. |
Sets the font-size to a fixed size in pixel or in points. |
| fontVariant | "small-caps" or "normal". The default value is "normal". |
Defines a variation type within a font family. |
| fontWeight | "normal" or "bold". The default value is "normal". |
This property selects the weight of the font. |
| freeze | "true" or "false". The default value is "false". |
This property defines what will happen with an object at the end of its presentation, if the end content is frozen ("true") or not ("false"). |
| transIn, transOut | List of (type, subtype, dur, startProgress, endProgress, direction, fadeColor, horzRepeat, vertRepeat, borderWidth, borderColor) separated by semicolons where:
The default value for the property is the empty string. If a transition type is specified then:
|
The value of the transIn and transOut is a semicolon-separated list of transitions. The purpose of the semicolon-separated list is to allow authors to specify a set of fallback transitions if the preferred transition is not available. The first transition in the list should be performed if the user-agent has implemented this transition. If this transition is not available, then the second transition in the list should be performed, and so on. The type and subtype define the transition. The dur attribute specifies the duration of the transition. The startProgress attribute specifies the amount of progress through the transition at which to begin execution. For instance, we can want to begin a crossfade with the destination image being already 30% faded in. For this case, startProgress would be 0.3. The endProgress attribute specifies the amount of progress through the transition at which to end execution. The value of this attribute must be greater than or equal to the value of the startProgress attribute. If endProgress is equal to startProgress, then the transition remains at a fixed progress for the duration of the transition. The direction attribute specifies the direction the transition will run. Note that not all transitions will have meaningful reverse interpretations. For instance, a crossfade is not a geometric transition, and therefore has no interpretation of reverse direction. Transitions that do not have a reverse interpretation should have the direction attribute ignored and the default value of "forward" assumed. If the value of the type attribute is "fade" and the value of the subtype attribute is "fadeToColor" or "fadeFromColor", then the fadeColor attribute specifies the ending or starting color of the fade. If the value of the type attribute is not "fade", or the value of the subtype attribute is not "fadeToColor" or "fadeFromColor", then the fadeColor attribute is ignored. If the value of the type attribute is not "fade", then the following attributes can be specified: The horzRepeat attribute specifies how many times to perform the transition pattern along the horizontal axis. The vertRepeat attribute specifies how many times to perform the transition pattern along the vertical axis. The borderWidth attribute specifies the width of a generated border along a wipe edge. The borderColor attribute specifies the content of the generated border along a wipe edge. If the value of this attribute is a color, then the generated border along the wipe or warp edge is filled with this color. If the value of this attribute is "blend", then the generated border along the wipe blend is an additive blend (or blur) of the media sources. |
Propiedades predefinidas para <media> elementos de "aplicación/x-ncl-settings" tipo¶
El grupo sistema. Conjunto de propiedades gestionadas por el sistema receptor. Se pueden leer, pero una NCL no puede cambiar sus valores. aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Las aplicaciones nativas del receptor pueden cambiar estas propiedades. valores. Deben persistir durante todo el ciclo de vida del receptor.
| Nombre | Valor | Descripción |
|---|---|---|
| idioma.delsistema | Código ISO 639-1. | Idioma de audio. |
| sistema.caption | Código ISO 639-1. | Idioma de los subtítulos. |
| sistema.subtítulo | Código ISO 639-1. | Idioma de subtítulos. |
| sistema.returnBitRate(i) | Número real. | La velocidad de bits total del canal interactivo (i) en kilobytes por segundo. |
| sistema.tamañodepantalla | (Entero, Entero). | Tamaño de pantalla del dispositivo, en (líneas, píxeles/línea), cuando no se define una clase. |
| system.screenGraphicSize | (Entero, Entero). | Resolución establecida para el plano gráfico de la pantalla del dispositivo, en (líneas, píxeles/línea), cuando no se define una clase. |
| sistema.tipo de audio | "mono", "estéreo" o "5.1". | Tipo de dispositivo de audio, cuando no se define una clase. |
| sistema.tamañodepantalla(i) | (Entero, Entero). | Tamaño de pantalla de la clase (i) de dispositivos, en (líneas, píxeles/línea). |
| system.screenGraphicSize(i) | (Entero, Entero). | Resolución establecida para el plano gráfico de pantalla de la clase (i) de dispositivos, en (líneas, píxeles/línea). |
| sistema.audioType(i) | "mono", "estéreo" o "5.1". | Tipo de audio de la clase (i) de dispositivos. |
| sistema.devNumber(i) | Entero. | Número de dispositivos de exhibición registrados en la clase (i). |
| sistema.classType(i) | "pasivo" o "activo". | Tipo de clase (i). |
| system.parentDeviceRegion(i) | Cinco números separados por coma; cada uno siguiendo la regla de valor especificada para las propiedades "izquierda", "arriba", "ancho", "alto" y "zIndex", respectivamente. | Identifica un elemento <region> en otro <regionBase> asociado con el dispositivo principal que crea el mapa de bits enviado a los dispositivos de clase pasiva (i); en la región especificada también se debe exhibir el mapa de bits enviado. |
| sistema.info(i) | Cadena. | Lista de reproductores multimedia de clase (i). |
| sistema.númerodeclase | Entero. | Número de clases que se han definido. |
| sistema.CPU | Número real. | Rendimiento de la CPU en MIPS, respecto a su capacidad para ejecutar aplicaciones. |
| memoria.delsistema | Entero. | Espacio mínimo de memoria en megabytes proporcionado a las aplicaciones. |
| sistema.sistemaoperativo | Cadena (por definir). | Tipo de sistema operativo. |
| system.luaVersión | Cadena (por definir). | Versión del motor Lua soportada por el receptor. |
| sistema.ncl.versión | Cadena (por definir). | Versión en idioma NCL. |
| sistema.GingaNCL.versión | Cadena (por definir). | Versión del entorno Ginga-NCL. |
| sistema.xyz | Cadena. | Cualquier propiedad con el prefijo "sistema" está reservada para uso futuro. |
El grupo usuario. Conjunto de propiedades gestionadas por el sistema receptor. Se pueden leer, pero una NCL no puede cambiar sus valores. aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Las aplicaciones nativas del receptor pueden cambiar las propiedades valores. Deben persistir durante todo el ciclo de vida del receptor.
| Nombre | Valor | Descripción |
|---|---|---|
| edad.usuario | Entero. | Edad del usuario. |
| ubicación.usuario | Cadena. | Ubicación del usuario. |
| usuario.género | "m" (masculino) o "f" (femenino). | Género de usuario. |
| usuario.xyz | Cadena. | Cualquier propiedad con el prefijo "usuario" está reservada para uso futuro. |
El grupo predeterminado. Conjunto de propiedades gestionadas por el receptor. sistema. Pueden ser leídos y modificados por una NCL. aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Las aplicaciones nativas del receptor pueden cambiar las propiedades valores. Deben persistir durante todo el ciclo de vida del receptor; sin embargo, son se ajustan a sus valores iniciales cuando se sintoniza un nuevo canal.
| Nombre | Valor | Descripción |
|---|---|---|
| default.focusBorderColor | "blanco", "negro", "plateado", "gris", "rojo", "granate", "fucsia", "púrpura", "lima", "verde", "amarillo", "oliva", "azul", "azul marino", "aqua" o "verde azulado". | Color predeterminado aplicado al borde de un elemento enfocado. |
| default.selBorderColor | "blanco", "negro", "plateado", "gris", "rojo", "granate", "fucsia", "púrpura", "lima", "verde", "amarillo", "oliva", "azul", "azul marino", "aqua" o "verde azulado". | Color predeterminado aplicado al borde de un elemento enfocado cuando se activa. |
| default.focusBorderWidth | Entero. | Ancho predeterminado (en píxeles) aplicado al borde de un elemento enfocado. |
| default.focusBorderTransparency | Número en el rango [0,1] o [0,100], que termina con el carácter <"%"> (por ejemplo, "30%"), donde "1" o "100%" significa transparencia total y "0" o "0%" significa sin transparencia. | Transparencia predeterminada aplicada al borde de un elemento enfocado. |
| predeterminado.xyz | Cadena. | Cualquier propiedad con el prefijo "predeterminado" está reservada para uso futuro. |
El grupo servicio. Conjunto de propiedades gestionadas por el formateador NCL. Se pueden leer y cambiar sus valores mediante una aplicación NCL del mismo servicio. Se pueden leer pero no se pueden cambiar sus valores. mediante un procedimiento Lua o cualquier otro procedimiento de código imperativo o declarativo. Los cambios de variables deben realizarse mediante comandos NCL. Deben persistir en al menos durante el ciclo de vida del servicio.
| Nombre | Valor | Descripción |
|---|---|---|
| servicio.currentFocus | Entero. | El valor focusIndex del elemento <media> en foco. |
| servicio.currentKeyMaster | Cadena. | Identificador id del elemento <media> que controla las teclas de navegación; Si el elemento <media> no se presenta o no está en pausa, el control de la tecla de navegación pertenece al formateador NCL. |
| servicio.xyz | Cadena. | Cualquier propiedad con el prefijo "servicio" sigue las reglas especificadas para el grupo. |
El grupo si. Conjunto de propiedades gestionadas por el middleware. ellos pueden leerse, pero es posible que una NCL no cambie sus valores aplicación, un procedimiento Lua o cualquier otro código imperativo o declarativo procedimiento. Deben persistir al menos hasta la siguiente sintonización de canal.
| Nombre | Valor | Descripción |
|---|---|---|
| si.númeroDeServicios | Entero. | Número de servicios disponibles en el país para el canal sintonizado. Nota: El valor de esta variable debe obtenerse del número de tablas PMT especificadas en la tabla PAT del flujo de transporte recibido en el canal de sintonización (ver ISO/IEC 13818-1:2007). El valor de la variable debe tener en cuenta sólo las tablas PMT cuyos campos código_país, especificados en el descriptor_disponibilidad_país (ver Sección 8.3.6 de la ABNT NBR 15603-2:2007) relacionados con la tabla, son equivalentes al valor de la variable "usuario.ubicación" del nodo configuraciones. |
| si.numberOfPartialServices | Entero | Número de servicios 1-seg disponibles en el país para el canal sintonizado. Nota: El valor de esta variable debe obtenerse del número de tablas PMT especificadas en la tabla PAT del flujo de transporte recibido en el canal de sintonización (ver ISO/IEC 13818-1:2007). El valor de la variable debe tener en cuenta sólo las tablas PMT cuyos campos country_code, especificados en el country_availability_descriptor (ver Sección 8.3.6 de la ABNT NBR 15603-2:2007) relacionados con la tabla, son iguales al valor de la variable "user.location" del nodo settings, y cuyos campos program_number son equivalentes a los campos service_id del descriptor_recepción_parcial relacionado con las tablas NIT. |
| si.númerodecanal | Entero | Número del canal sintonizado. Nota: El valor de esta variable debe obtenerse del archivo remote_control_key_id del ts_information_descriptor (ver Sección 8.3.42 de la ABNT NBR 15603-2:2007) de la tabla NIT (ver Sección 7.2.4 de la ABNT NBR 15603-2:2007) que describe el servicio actual. |
| si.xyz | Cadena | Cualquier propiedad con el prefijo "si" sigue las reglas especificadas para el grupo. |
El grupo canal. Conjunto de propiedades gestionadas por el formateador NCL. Se pueden leer y cambiar sus valores mediante una aplicación NCL del mismo canal. Se pueden leer pero no se pueden cambiar sus valores. mediante un procedimiento Lua o cualquier otro procedimiento de código imperativo o declarativo de el mismo canal; Los cambios de variables deben realizarse mediante comandos NCL. ellos debe persistir al menos hasta la siguiente sintonización de canal.
| Nombre | Valor | Descripción |
|---|---|---|
| canal.keyCapture | Cadena | Solicitud de claves alfanuméricas para aplicaciones NCL. |
| canal.tecladovirtual | "verdadero" o "falso" | Solicitud de un teclado virtual para aplicaciones NCL. |
| canal.keyboardBounds | (Entero, Entero, Entero, Entero) | Región del teclado virtual (izquierda, arriba, ancho, alto). |
| canal.xyz | Cadena | Cualquier variable con el prefijo "canal" sigue las reglas especificadas para el grupo. |
El compartido. Conjunto de propiedades gestionadas por el formateador NCL. ellos se pueden leer y cambiar sus valores mediante una aplicación NCL. ellos pueden ser leídos, pero sus valores no pueden cambiarse mediante un procedimiento Lua o cualquier otro procedimiento de código imperativo o declarativo; Los cambios variables deben ser hecho usando comandos NCL. Deben persistir al menos durante el ciclo de vida. del servicio que los ha definido.
| Nombre | Valor | Descripción |
|---|---|---|
| compartido.xyz | Cadena | Cualquier propiedad con el prefijo "compartido" sigue las reglas especificadas para el grupo. |
Nombres reservados para la definición de color¶
| Color | Nombre | Hexadecimal | (R,G,B) | Tono | (Saturación, Luz) | (Saturación, Valor) |
|---|---|---|---|---|---|---|
| Blanco | #ffffff | (100%, 100%, 100%) | 0° | (0%, 100%) | (0%, 100%) | |
| Plata | #c0c0c0 | (75%, 75%, 75%) | 0° | (0%, 75%) | (0%, 75%) | |
| Gris | #808080 | (50%, 50%, 50%) | 0° | (0%, 50%) | (0%, 50%) | |
| Negro | #000000 | (0%, 0%, 0%) | 0° | (0%, 0%) | (0%, 0%) | |
| Rojo | #ff0000 | (100%, 0%, 0%) | 0° | (100%, 50%) | (100%, 100%) | |
| Granate | #800000 | (50%, 0%, 0%) | 0° | (100%, 25%) | (100%, 50%) | |
| Amarillo | #ffff00 | (100%, 100%, 0%) | 60° | (100%, 50%) | (100%, 100%) | |
| Oliva | #808000 | (50%, 50%, 0%) | 60° | (100%, 25%) | (100%, 50%) | |
| Lime | #00ff00 | (0%, 100%, 0%) | 120° | (100%, 50%) | (100%, 100%) | |
| Verde | #008000 | (0%, 50%, 0%) | 120° | (100%, 25%) | (100%, 50%) | |
| Aqua | #00ffff | (0%, 100%, 100%) | 180° | (100%, 50%) | (100%, 100%) | |
| Verde azulado | #008080 | (0%, 50%, 50%) | 180° | (100%, 25%) | (100%, 50%) | |
| Azul | #0000ff | (0%, 0%, 100%) | 240° | (100%, 50%) | (100%, 100%) | |
| Marina | #000080 | (0%, 0%, 50%) | 240° | (100%, 25%) | (100%, 50%) | |
| Fucsia | #ff00ff | (100%, 0%, 100%) | 300° | (100%, 50%) | (100%, 100%) | |
| Púrpura | #800080 | (50%, 0%, 50%) | 300° | (100%, 25%) | (100%, 50%) |