Definição e uso¶
O elemento <property> define uma propriedade ou um grupo de propriedades para seu pai <media>, <context>, <body> ou <switch> elementos. Essas propriedades podem ser usadas em relacionamentos com outros objetos de uma aplicação NCL, se o atributo externo do <property> elemento tem "true" como valor.
O elemento <property> define o atributo name, que indica o nome da propriedade ou grupo de propriedades e o atributo de valor. O pai elemento não pode ter mais de um elemento <property> com o mesmo valor do atributo nome.
O atributo value é opcional e define um valor inicial para o propriedade declarada no atributo nome. Quando o valor não é especificado, a propriedade é inicializada com o valor definido no homônimo atributos dos elementos <descriptor> ou <region> associados com o elemento pai que define <property>, ou então com um valor padrão (que depende do valor do atributo name). Quando o valor é especificado no elemento <property>, ele tem precedência sobre o valor definido nos atributos homônimos de <descriptor> ou <region> elementos associados ao elemento pai que define o <property>.
Sintaxe¶
| Elemento | Atributos | Conteúdo | Pai |
|---|---|---|---|
| <property> | nome, valor, externável | -- | <media> ou <context> ou <body> |
Atributos¶
| Nome | Valor | Descrição |
|---|---|---|
| nome | Pode receber qualquer valor de string que comece com uma letra ou sublinhado e que contenha apenas letras, dígitos, "." e "_". | O atributo name identifica exclusivamente a propriedade dentro de seu elemento pai. |
| valor | Depende do valor do nome. | O atributo value define um valor inicial para o atributo name. |
| externável | "falso" ou "verdadeiro". O valor padrão é: "true" se a propriedade estiver definida em um elemento <property> ou "false" se a propriedade estiver definida em um elemento <descriptor>. | O atributo externable determina se uma propriedade pode (externable="true") ou não (externable="false") ser usada em relacionamentos. |
Propriedades predefinidas¶
Várias palavras reservadas são usadas para especificar propriedades com valores pré-definidos semântica conhecida pelos jogadores NCL. Essas propriedades, sua semântica, sua os valores possíveis e seus valores padrão são apresentados abaixo.
Propriedades predefinidas para todas as <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. |
Propriedades predefinidas para <media> elementos com conteúdo 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. |
Propriedades predefinidas para <media> elementos com conteúdo de mídia contínua (somente leitura)¶
| Nome | Valor | Descrição |
|---|---|---|
| ID do conteúdo | String. (Definido apenas pelo player NCL.) O valor padrão é nulo. |
A propriedade "contentId" está associada a objetos de mídia contínua cujo conteúdo é definido referente a um fluxo elementar. Possui null como valor inicial e é definido como o valor do identificador transportado no descritor de referência NPT (em um campo de mesmo nome: contentId), assim que o objeto de mídia contínua associado é iniciado. |
| espera | "true" ou "false". (Definido apenas pelo player NCL.) O valor padrão é "false". |
A propriedade "standby" é definida como "true" enquanto um conteúdo de objeto de mídia contínua já iniciado referente a um fluxo elementar é temporariamente interrompido por outro conteúdo intercalado, no mesmo fluxo elementar. |
Propriedades predefinidas para <media> elementos com conteúdo audível¶
| Nome | Valor | Descrição |
|---|---|---|
| nível de som | Um número real no intervalo [0,1] ou um número real no intervalo [0,100] terminando com o caractere <"%"> (por exemplo, "30%"). O valor padrão é 1. |
Volume de áudio relativo ao áudio gravado. |
| nível de equilíbrio | Um número real no intervalo [-1,1] ou um número real no intervalo [-100,100] terminando com o caractere <"%"> (por exemplo, "30%"). O valor padrão é 0. |
Nível de equilíbrio do áudio (-1 à esquerda e +1 à direita). |
| nível agudo | Um número real no intervalo [0,1] ou um número real no intervalo [0,100] terminando com o caractere <"%"> (por exemplo, "30%"). O valor padrão é 1. |
Configuração de agudos, relativa ao áudio gravado. |
| nível de graves | Um número real no intervalo [0,1] ou um número real no intervalo [0,100] terminando com o caractere <"%"> (por exemplo, "30%"). O valor padrão é 1. |
Configuração de graves, relativa ao áudio gravado. |
| congelar | "verdadeiro" ou "falso". O valor padrão é "falso". |
Esta propriedade define o que acontecerá com um objeto ao final de sua apresentação, se o conteúdo final estiver congelado ("true") ou não ("false"). |
| transIn, transOut | Uma lista no formato <"(type,subtype,dur,startProgress,endProgress)"> onde:
O valor padrão da propriedade é a string vazia. Se uma transição for especificada, então:
|
O tipo de transIn e transOut é sempre "fade" e o subtype é sempre "fade" e é definido por padrão. O atributo dur especifica a duração da transição. O atributo startProgress especifica a quantidade de progresso durante a transição em que a execução deve ser iniciada. O atributo endProgress especifica a quantidade de progresso em que a transição deve ser finalizada. O valor deste atributo deve ser maior ou igual ao valor do atributo startProgress. Se endProgress for igual a startProgress, então a transição permanecerá em um progresso fixo durante a transição. |
Propriedades predefinidas para <media> elementos com conteúdo 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. |
Propriedades predefinidas para <media> elementos do tipo "application/x-ncl-settings"¶
O grupo sistema. Conjunto de propriedades gerenciadas pelo sistema receptor. Eles podem ser lidos, mas não podem ter seus valores alterados por uma NCL aplicação, um procedimento Lua ou qualquer outro código imperativo ou declarativo procedimento. Os aplicativos nativos do receptor podem alterar essas propriedades' valores. Eles devem persistir durante todo o ciclo de vida do receptor.
| Nome | Valor | Descrição |
|---|---|---|
| idioma do sistema | Código ISO 639-1. | Linguagem de áudio. |
| sistema.caption | Código ISO 639-1. | Idioma da legenda. |
| sistema.subtitle | Código ISO 639-1. | Idioma da legenda. |
| sistema.returnBitRate(i) | Número real. | A taxa de bits total do canal interativo (i) em quilobytes por segundo. |
| sistema.screenSize | (Inteiro, Inteiro). | Tamanho da tela do dispositivo, em (linhas, pixels/linha), quando uma classe não está definida. |
| system.screenGraphicSize | (Inteiro, Inteiro). | Resolução definida para o plano gráfico da tela do dispositivo, em (linhas, pixels/linha), quando não há classe definida. |
| sistema.audioType | "mono", "estéreo" ou "5.1". | Tipo de áudio do dispositivo, quando uma classe não está definida. |
| sistema.screenSize(i) | (Inteiro, Inteiro). | Tamanho da tela da classe (i) de dispositivos, em (linhas, pixels/linha). |
| system.screenGraphicSize(i) | (Inteiro, Inteiro). | Resolução definida para o plano gráfico da tela da classe (i) de dispositivos, em (linhas, pixels/linha). |
| sistema.audioType(i) | "mono", "estéreo" ou "5.1". | Tipo de áudio da classe (i) de dispositivos. |
| sistema.devNumber(i) | Inteiro. | Número de dispositivos de exposição cadastrados na classe (i). |
| sistema.classType(i) | "passivo" ou "ativo". | Tipo da classe (i). |
| system.parentDeviceRegion(i) | Cinco números separados por vírgula; cada um seguindo a regra de valor especificada para as propriedades "left", "top", "width", "height" e "zIndex", respectivamente. | Identifica um elemento <region> em outro <regionBase> associado ao dispositivo pai que cria o mapa de bits enviado aos dispositivos de classe passiva (i); na região especificada o mapa de bits enviado também deverá ser exibido. |
| sistema.info(i) | Corda. | Lista dos reprodutores de mídia da classe (i). |
| sistema.classNumber | Inteiro. | Número de classes que foram definidas. |
| sistema.CPU | Número real. | Desempenho da CPU no MIPS, quanto à sua capacidade de executar aplicações. |
| memória do sistema | Inteiro. | Espaço mínimo de memória em megabytes fornecido aos aplicativos. |
| sistema.sistema operacional | String (a ser definida). | Tipo do sistema operacional. |
| system.luaVersion | String (a ser definida). | Versão do mecanismo Lua suportada pelo receptor. |
| sistema.ncl.versão | String (a ser definida). | Versão da linguagem NCL. |
| sistema.GingaNCL.versão | String (a ser definida). | Versão do ambiente Ginga-NCL. |
| sistema.xyz | Corda. | Qualquer propriedade com o prefixo "sistema" é reservada para uso futuro. |
O grupo usuário. Conjunto de propriedades gerenciadas pelo sistema receptor. Eles podem ser lidos, mas não podem ter seus valores alterados por uma NCL aplicação, um procedimento Lua ou qualquer outro código imperativo ou declarativo procedimento. Os aplicativos nativos do receptor podem alterar as propriedades valores. Eles devem persistir durante todo o ciclo de vida do receptor.
| Nome | Valor | Descrição |
|---|---|---|
| usuário.idade | Inteiro. | Idade do usuário. |
| usuário.localização | Corda. | Localização do usuário. |
| usuário.gênero | "m" (masculino) ou "f" (feminino). | Gênero do usuário. |
| usuário.xyz | Corda. | Qualquer propriedade com o prefixo "usuário" é reservada para uso futuro. |
O grupo padrão. Conjunto de propriedades gerenciadas pelo receptor sistema. Eles podem ser lidos e ter seus valores alterados por um NCL aplicação, um procedimento Lua ou qualquer outro código imperativo ou declarativo procedimento. Os aplicativos nativos do receptor podem alterar as propriedades valores. Eles devem persistir durante todo o ciclo de vida do receptor, no entanto, são ajustados para seus valores iniciais quando um novo canal é sintonizado.
| Nome | Valor | Descrição |
|---|---|---|
| padrão.focusBorderColor | "branco", "preto", "prata", "cinza", "vermelho", "marrom", "fúcsia", "roxo", "limão", "verde", "amarelo", "oliva", "azul", "marinho", "água" ou "verde-azulado". | Cor padrão aplicada à borda de um elemento em foco. |
| padrão.selBorderColor | "branco", "preto", "prata", "cinza", "vermelho", "marrom", "fúcsia", "roxo", "limão", "verde", "amarelo", "oliva", "azul", "marinho", "água" ou "verde-azulado". | Cor padrão aplicada à borda de um elemento em foco quando ativado. |
| padrão.focusBorderWidth | Inteiro. | Largura padrão (em pixels) aplicada à borda de um elemento em foco. |
| default.focusBorderTransparency | Número no intervalo [0,1] ou [0,100], terminando com o caractere <"%"> (por exemplo, "30%"), com "1" ou "100%" significando transparência total e "0" ou "0%" significando nenhuma transparência. | Transparência padrão aplicada à borda de um elemento em foco. |
| padrão.xyz | Corda. | Qualquer propriedade com o prefixo "default" é reservada para uso futuro. |
O grupo serviço. Conjunto de propriedades gerenciadas pelo formatador NCL. Eles podem ser lidos e ter seus valores alterados por uma aplicação NCL do mesmo serviço. Eles podem ser lidos, mas não podem ter seus valores alterados por um procedimento Lua ou qualquer outro procedimento de código imperativo ou declarativo. As alterações de variáveis devem ser feitas usando comandos NCL. Eles devem persistir em pelo menos durante o ciclo de vida do serviço.
| Nome | Valor | Descrição |
|---|---|---|
| serviço.currentFocus | Inteiro. | O valor focusIndex do elemento <media> em foco. |
| serviço.currentKeyMaster | Corda. | Identificador id do elemento <media> que controla as chaves de navegação; se o elemento <media> não estiver sendo apresentado ou não estiver pausado, o controle da chave de navegação pertence ao formatador NCL. |
| serviço.xyz | Corda. | Qualquer propriedade com o prefixo "serviço" segue as regras especificadas para o grupo. |
O grupo si. Conjunto de propriedades gerenciadas pelo middleware. Eles podem ser lidos, mas não podem ter seus valores alterados por um NCL aplicação, um procedimento Lua ou qualquer outro código imperativo ou declarativo procedimento. Eles devem persistir pelo menos até a próxima sintonia de canal.
| Nome | Valor | Descrição |
|---|---|---|
| si.numberOfServices | Inteiro. | Número de serviços disponíveis no país para o canal sintonizado. Nota: O valor desta variável deve ser obtido a partir do número de tabelas PMT especificadas na tabela PAT do fluxo de transporte recebido no canal de sintonia (ver ISO/IEC 13818-1:2007). O valor da variável deve levar em consideração apenas as tabelas PMT cujos campos country_code, especificados no descritor country_availability_descriptor (ver Seção 8.3.6 da ABNT NBR 15603-2:2007) relacionados à tabela, são equivalentes ao valor da variável "user.location" do nó settings. |
| si.numberOfPartialServices | Inteiro | Número de serviços de 1 segmento disponíveis no país para o canal sintonizado. Nota: O valor desta variável deve ser obtido a partir do número de tabelas PMT especificadas na tabela PAT do fluxo de transporte recebido no canal de sintonia (ver ISO/IEC 13818-1:2007). O valor da variável deve levar em consideração apenas as tabelas PMT cujos campos country_code, especificados no country_availability_descriptor (ver Seção 8.3.6 da ABNT NBR 15603-2:2007) relacionado à tabela, sejam iguais ao valor da variável "user.location" do nó settings, e cujos campos program_number sejam equivalentes aos campos service_id do parcial_reception_descriptor relacionado às tabelas NIT. |
| si.canalNumber | Inteiro | Número do canal sintonizado. Nota: O valor desta variável deve ser obtido no campo remote_control_key_id do descritor ts_information_descriptor (ver Seção 8.3.42 da ABNT NBR 15603-2:2007) da tabela NIT (ver Seção 7.2.4 da ABNT NBR 15603-2:2007) que descreve o serviço atual. |
| si.xyz | Corda | Qualquer propriedade com o prefixo "si" segue as regras especificadas para o grupo. |
O grupo canal. Conjunto de propriedades gerenciadas pelo formatador NCL. Eles podem ser lidos e ter seus valores alterados por uma aplicação NCL do mesmo canal. Eles podem ser lidos, mas não podem ter seus valores alterados por um procedimento Lua ou qualquer outro procedimento de código imperativo ou declarativo de o mesmo canal; alterações de variáveis devem ser feitas usando comandos NCL. Eles deve persistir pelo menos até a próxima sintonia de canal.
| Nome | Valor | Descrição |
|---|---|---|
| canal.keyCapture | Corda | Solicitação de chaves alfanuméricas para aplicações NCL. |
| canal.virtualTeclado | "verdadeiro" ou "falso" | Solicitação de teclado virtual para aplicações NCL. |
| canal.keyboardBounds | (Inteiro, Inteiro, Inteiro, Inteiro) | Região do teclado virtual (esquerda, superior, largura, altura). |
| canal.xyz | Corda | Qualquer variável com o prefixo "canal" segue as regras especificadas para o grupo. |
O compartilhado. Conjunto de propriedades gerenciadas pelo formatador NCL. Eles podem ser lidos e ter seus valores alterados por uma aplicação NCL. Eles podem ser lidos, mas não podem ter seus valores alterados por um procedimento Lua ou qualquer outro procedimento de código imperativo ou declarativo; mudanças de variáveis devem ser feito usando comandos NCL. Eles devem persistir pelo menos durante o ciclo de vida do serviço que os definiu.
| Nome | Valor | Descrição |
|---|---|---|
| compartilhado.xyz | Corda | Qualquer propriedade com o prefixo "compartilhado" segue as regras especificadas para o grupo. |
Nomes reservados para definição de cores¶
| Cor | Nome | Hexadecimal | (R,G,B) | Matiz | (Saturação, Luz) | (Saturação, Valor) |
|---|---|---|---|---|---|---|
| Branco | #ffffff | (100%, 100%, 100%) | 0°; | (0%, 100%) | (0%, 100%) | |
| Prata | #c0c0c0 | (75%, 75%, 75%) | 0°; | (0%, 75%) | (0%, 75%) | |
| Cinza | #808080 | (50%, 50%, 50%) | 0°; | (0%, 50%) | (0%, 50%) | |
| Preto | #000000 | (0%, 0%, 0%) | 0°; | (0%, 0%) | (0%, 0%) | |
| Vermelho | #ff0000 | (100%, 0%, 0%) | 0°; | (100%, 50%) | (100%, 100%) | |
| Marrom | #800000 | (50%, 0%, 0%) | 0°; | (100%, 25%) | (100%, 50%) | |
| Amarelo | #ffff00 | (100%, 100%, 0%) | 60°; | (100%, 50%) | (100%, 100%) | |
| Olive | #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%) | |
| Teal | #008080 | (0%, 50%, 50%) | 180°; | (100%, 25%) | (100%, 50%) | |
| Azul | #0000ff | (0%, 0%, 100%) | 240°; | (100%, 50%) | (100%, 100%) | |
| Marinha | #000080 | (0%, 0%, 50%) | 240°; | (100%, 25%) | (100%, 50%) | |
| Fúcsia | #ff00ff | (100%, 0%, 100%) | 300°; | (100%, 50%) | (100%, 100%) | |
| Roxo | #800080 | (50%, 0%, 50%) | 300°; | (100%, 25%) | (100%, 50%) |