<media>¶

O elemento <media> define um objeto de mídia contendo: mídia perceptual conteúdo; conteúdo de código imperativo; conteúdo de código declarativo; Conteúdo UTC; ou variáveis globais para o aplicativo. O tipo de objeto é definido pelo type ou é inferido pela extensão de arquivo usada no src atributo.

Quatro tipos especiais são definidos:

O tipo "application/x-ncl-NCL" (ou "application/x-ginga-NCL") é aplicado a elementos <media> com conteúdo de código NCL (observe assim que uma aplicação NCL pode incorporar outra aplicação NCL).
O tipo "application/x-ncl-NCLua" (ou "application/x-ginga-NCLua") é aplicado a elementos <media> com conteúdo de código imperativo Lua.
O "application/x-ncl-settings" (ou "application/x-ginga-settings") é aplicado a um elemento <media> especial (pode haver apenas um em um documento NCL, mas pode ser reutilizado como elemento filho de outro <context> elementos) cujas propriedades são variáveis globais (propriedades definidas pelo autor do documento ou ambiente reservado propriedades gerenciadas pelo sistema) que podem ser manipuladas pelo NCL processador de documentos. O objeto de mídia do tipo "application/x-ncl-settings" não possui conteúdo para ser exibido. Uma vez que uma aplicação NCL é iniciado, as propriedades deste objeto de mídia estão disponíveis para regra avaliações definidas por elementos <rule>. Para usar estes propriedades nas definições de elemento <link>, elas devem ser explicitamente declarado.
O tipo application/x-ncl-time (ou application/x-ginga-time) deve ser aplicado a um elemento <media> especial (pode haver apenas um em um documento NCL, mas pode ser reutilizado como elemento filho de outro <context> elementos), cujo conteúdo é o UTC. Quando for iniciado, o conteúdo UTC não é exibido; no entanto, pode ser usado para definir âncoras de conteúdo usando elementos <area>. Observe que qualquer contínuo O elemento <media> sem fonte especificada pode ser usado para definir um relógio relativo à hora de início do elemento <media>.

Reutilização de objetos de mídia¶

Exceto os elementos <media> de "application/x-ncl-NCL" e tipos "application/x-ncl-NCLua", um elemento <media> pode se referir a outro <media> elemento do mesmo documento ou para um <media> importado elemento. Todos os atributos e elementos filhos definidos pelo elemento referido são herdados pelo elemento de referência, exceto o focusIndex atributo. Todos os atributos e elementos filhos definidos pelo referente elemento deve ser ignorado pelo player NCL, exceto os seguintes atributos e elementos filhos:

id atributo, que deve ser definido.
instance atributo, que pode ser definido, caso contrário tem "new" como seu valor de string padrão;
Elementos filhos <area> podem ser adicionados. Se o novo adicionado <area> elemento tem o mesmo atributo id de um já existente Elemento <area> (definido no elemento <media> reutilizado), o novo adicionado <area> é ignorado pelo player NCL.
Elementos filhos <property> podem ser adicionados. Se o novo adicionado O elemento <property> tem o mesmo atributo de nome de um elemento já elemento <property> existente (definido no <media> reutilizado elemento), o novo <property> adicionado é ignorado pelo player NCL.

O referido elemento e o elemento a ele referente serão considerados o mesmo, quanto à especificação dos dados. Também serão considerados o mesmo em relação à sua apresentação, se o atributo da instância receber os valores "instSame" ou "gradSame".

A semântica a seguir deve ser respeitada ao reutilizar um <media> elemento. Suponha que o conjunto de <media> elementos composto pelos referidos Elemento <media> e todos os elementos <media> referentes.

Se algum elemento do subconjunto formado pelo referido elemento <media> e todos os outros elementos <media> tendo o atributo de instância igual para "instSame" ou "gradSame" está programado para ser apresentado, todos os outros elementos neste subconjunto, que não são descendentes de um <switch> elemento, também são assumidos como programados para apresentação, e mais de que, quando apresentados, sejam representados pelo mesmo instância de apresentação. Elementos descendentes de um elemento <switch> têm o mesmo comportamento se as regras necessárias para apresentá-los forem satisfeitos, caso contrário não serão agendados para apresentação.
Se o atributo da instância for igual a "instSame", todos os nós agendados do subconjunto são imediatamente apresentados através de uma instância única (instrução de início aplicada a todos eles) se uma instrução de início for aplicado em qualquer um deles.
Se o atributo da instância for igual a "gradSame", todos os nós agendados do subconjunto são apresentados através de uma instância única, mas agora gradativamente, assim que as instruções de início forem aplicadas a eles, chegando de um link, etc.
À medida que cada elemento <media> inicia sua apresentação, o comum instância na apresentação deve notificar os eventos associados seus elementos <area> e <property>.
Os elementos <media> no conjunto que possuem valores de atributos de instância iguais a "novo" não estão programados para apresentação caso algum outro elemento o conjunto está programado para ser apresentado. Quando eles são individualmente programado para apresentação, nenhum outro elemento do conjunto é afetado. Além disso, novas instâncias de apresentação independentes serão criado no início de cada apresentação individual.

Sintaxe¶

Elemento	Atributos	Conteúdo	Pai
<media>	id, src, type, refer, instance, descriptor	(<area> \| <property>)*	<body>, <context> ou <switch>

Atributos¶

Nome	Valor	Descrição
id	Pode receber qualquer valor de string que comece com uma letra ou um sublinhado e que contenha apenas letras, dígitos, <"."> e <"_">.	O atributo id identifica exclusivamente o elemento dentro de um documento.
src	Os seguintes valores são válidos: `file:///file_path/#fragment_identifier` -- para arquivos locais, `http://server_identifier/file_path/#fragment_identifier` -- para arquivos remotos baixados usando o protocolo HTTP, `https://server_identifier/file_path/#fragment_identifier` -- para arquivos remotos baixados usando o protocolo HTTPS, `rtsp://server_identifier/file_path/#fragment_identifier` -- para fluxos baixados usando o protocolo RTSP, `rtp://server_identifier/file_path/#fragment_identifier` -- para fluxos baixados usando o protocolo RTP, `ncl-mirror://media_element_identifier` -- para um fluxo de conteúdo idêntico ao que está em apresentação por outro elemento <media>, `sbtvd-ts:` ou `isdb-ts:` ou `ts://program_number.component_tag` -- para fluxos elementares recebidos do fluxo de transporte. Para o atributo src cujo valor identifica o esquema "sbtvd-ts", "isdb-ts" ou "ts", o "program_number.component_tag" pode ser substituído pelas seguintes palavras reservadas: "video" -- correspondente ao ES de vídeo primário sendo apresentado no plano de vídeo, "audio" -- correspondente ao ES de áudio primário, "text" -- correspondente ao ES de texto primário, "video(i)" -- correspondente ao i-ésimo menor "component_tag" de ES de vídeo listado na PMT dos serviços sintonizados, "audio(i)" -- correspondente ao i-ésimo menor "component_tag" de ES de áudio listado na PMT dos serviços sintonizados, ou "text(i)" -- correspondente ao i-ésimo menor "component_tag" de ES de texto listado na PMT dos serviços sintonizados.	O atributo src é o localizador para o conteúdo do objeto de mídia.
type	String. Deve seguir o formato MIME Media Types. Quatro tipos especiais são definidos: "application/x-ncl-NCL" (ou "application/x-ginga-NCL"), "application/x-ncl-NCLua" (ou "application/x-ginga-NCLua"), "application/x-ncl-settings" (ou "application/x-ginga-settings") e "application/x-ncl-time" (ou "application/x-ginga-time").	O atributo type deve seguir o formato MIME Media Types (ou, mais simplesmente, mimetypes). Um mimetype é uma string que define a classe de mídia (áudio, vídeo, imagem, texto, aplicação) e um tipo de codificação de mídia (como jpeg, mpeg, etc.). Os mimetypes podem ser registrados ou informais. Os mimetypes registrados são controlados pela IANA. Os mimetypes informais não são registrados na IANA, mas são definidos por acordo comum; geralmente têm um "x-" antes do nome do tipo de mídia.
refer	IDREF ou a string "alias#id", onde "id" é um valor IDREF.	O atributo refer faz referência a um id de elemento <media> que será reutilizado. Um elemento que faz referência a outro elemento não pode ser reutilizado; ou seja, seu id não pode ser o valor de nenhum atributo refer. O elemento referenciado deve ser um elemento <media>. O elemento referenciado e o elemento que faz referência a ele são considerados o mesmo em relação à sua especificação de dados. Se o objeto de mídia referenciado estiver definido dentro de um documento importado D, o valor do atributo refer deverá ter o formato "alias#id", onde "alias" é o valor do atributo alias associado ao documento D importado.
instance	"new", "instSame" ou "gradSame".	Especifica o tipo de reutilização. O valor "new" define uma nova instância de apresentação, mas herdando a especificação do elemento <media> referenciado. O valor "instSame" define uma mesma instância de apresentação que é iniciada imediatamente assim que o elemento <media> referenciado ou quaisquer outros elementos <media> que façam referência a ele com o atributo instance igual a "instSame" forem iniciados, ou se uma instrução de início for aplicada a ele. O valor "gradSame" define uma mesma instância de apresentação que é iniciada assim que uma instrução de início é aplicada a ela, vinda de um elo, etc.
descriptor	IDREF.	O atributo descriptor faz referência a um elemento <descriptor>.