Elemento <media>

Definição e uso¶

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¶

Name	Value	Description
id	It may receive any string value that begins with a letter or an underscore and that only contains letters, digits, <".">, and <"_">.	The id attribute uniquely identifies the element within a document.
src	The following are valid values: <"file:/file_path/#fragment_identifier"> -- for local files, <"http:server_identifier/file_path/#fragment_identifier"> -- for remote files downloaded using the HTTP protocol, <"https://server_identifier/file_path/#fragment_identifier"> -- for remote files downloaded using the HTTPS protocol, <"rtsp://server_identifier/file_path/#fragment_identifier"> -- for streams downloaded using the RTSP protocol, <"rtp://server_identifier/file_path/#fragment_identifier"> -- for streams downloaded using the RTP protocol, <"ncl-mirror://media_element_identifier"> -- for a content flow identical to the one in presentation by another <media> element, <"sbtvd-ts:"> or <"isdb-ts:"> or <"ts://program_number.component_tag"> -- for elementary streams received from the transport stream. For src 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: "video" -- corresponding to the primary video ES being presented on the video plan, "audio" -- corresponding to the primary audio ES, "text" -- corresponding to the primary text ES, "video(i)" -- corresponding to the i-th smaller video ES "component_tag" listed in the PMT of the tuned services, "audio(i)" -- corresponding to the i-th smaller audio ES "component_tag" listed in the PMT of the tuned services, or "text(i)" -- corresponding to the i-th smaller text ES "component_tag" listed in the PMT of the tuned services.	The src attribute is the locator for the media object content.
type	String. It shall follow MIME Media Types format. Four special types are defined: "application/x-ncl-NCL" (or "application/x-ginga-NCL"), "application/x-ncl-NCLua" (or "application/x-ginga-NCLua"), "application/x-ncl-settings" (or "application/x-ginga-settings"), and "application/x-ncl-time" (or "application/x-ginga-time").	The type attribute shall follow MIME Media Types format (or, more simply, mimetypes). A mimetype is a string that defines the class of media (audio, video, image, text, application) and a media encoding type (such as jpeg, mpeg, etc.). Mimetypes may be registered or informal. Registered mimetypes are controlled by the IANA. Informal mimetypes are not registered with IANA, but are defined by common agreement; they usually have an "x-" before the media type name.
refer	IDREF or the string "alias#id" where "id" is an IDREF value.	The refer attribute refers to a <media> element id that will be reused. An element that refers to another element cannot be reused; that is, its id cannot be the value of any refer attribute. The referred element must be a <media> element. The referred element and the element that refers to it is considered the same regarding their data specification. If the referred media object is defined within an imported document D, the refer attribute value must have the format "alias#id", where "alias" is the value of the alias attribute associated with the imported D document.
instance	"new", "instSame", or "gradSame".	Specifies the reuse type. The "new" value defines a new presentation instance but inheriting the specification of the referred <media> element. The "instSame" value defines a same presentation instance that is immediately started as soon as the referred <media> element or any other <media> elements referring to it with instance attribute equal to "instSame" is started, or if a start instruction is applied on it. The "gradSame" value defines a same presentation instance that is started as soon an start instruction is applied on it, coming from a link, etc.
descriptor	IDREF.	The descriptor attribute refers to a <descriptor> element.