Elemento REF

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O elemento REF especifica uma URL para conteúdo de mídia digital.

<REF
   HREF = "URL"
>
</REF>

Atributos

HREF (obrigatório)

URL para qualquer parte do conteúdo de mídia compatível com Reprodutor Multimídia do Windows.

Elementos pai/filho

Hierarquia	Elementos
Elementos pai	ENTRADA
Elementos filho	DURATION, ENDMARKER, PREVIEWDURATION, STARTMARKER, STARTTIME

Comentários

Esse elemento especifica uma URL para um conteúdo de mídia. A URL pode apontar para qualquer tipo de mídia com suporte, usando qualquer protocolo compatível com Reprodutor Multimídia do Windows.

Os tipos de mídia com suporte incluem imagens ainda, como imagens .gif e .jpg e arquivos Flash com uma extensão de nome de arquivo .swf. Esses tipos de mídia são úteis para incluir conteúdo de publicidade em uma playlist. Com arquivos de imagem e arquivos Flash que são reproduzidos em um loop, você também deve especificar a quantidade de tempo para exibir o item de mídia, incluindo um elemento DURATION dentro do elemento REF . Se você quiser que uma imagem continue sendo exibida enquanto a próxima entrada na playlist estiver armazenada em buffer, inclua um elemento PARAM dentro do elemento ENTRY , defina seu atributo de nome como ShowWhileBuffering e defina seu atributo de valor como true.

Para fazer referência ao conteúdo em um CD ou DVD que o permita, os protocolos wmpcd e wmpdvd são fornecidos. Por exemplo, definir o atributo HREF como "wmpdvd://f/5/3" reproduzirá o capítulo 3 do título 5 em um DVD, mas somente se o DVD tiver sido criado para permitir isso.

Aplicativos que abrem mídia digital por trás de um firewall terão melhor desempenho ao abrir os itens de mídia se o endereço for especificado usando o nome DNS (servidor de nome de domínio) em vez do endereço IP.

O uso mais comum desse elemento é para substituição de URL. Se Reprodutor Multimídia do Windows não conseguir abrir uma parte da mídia definida em um elemento REF, ela tentará a URL no próximo elemento REF. Depois que Reprodutor Multimídia do Windows abre o conteúdo da mídia de uma URL definida dentro do escopo de um elemento ENTRY, ela ignora as marcas REF subsequentes dentro desse elemento ENTRY. Depois que o conteúdo terminar de ser reproduzido, Reprodutor Multimídia do Windows passará para o próximo elemento ENTRY, se houver.

• Importante Depois que Reprodutor Multimídia do Windows estabelece uma conexão com um conteúdo referenciado, ele ignora todos os outros elementos REF nesse ENTRY, se a conexão termina normalmente ou anormalmente.

Se o item de mídia referenciado for um arquivo de imagem, o elemento DURATION deverá ser usado para especificar o tempo de exibição da imagem.

Observação

A tentativa de reproduzir a mídia Flash que inclui som com o primeiro quadro pode gerar resultados inesperados. Você deve criar conteúdo flash para reproduzir o som começando não antes do segundo quadro.

Exemplos

<ASX VERSION="3.0">
   <ENTRY>
   <TITLE>Example Clip</TITLE>
      <REF HREF="mms://example.microsoft.com/selection1.asf" />
      <REF HREF="mms://sample.microsoft.com/mirror/selection1.asf" />
   </ENTRY>
</ASX>

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior

Confira também

Protocolos e tipos de arquivo com suporte

Referência de elementos de metarquivo do Windows Media

Referência de metarquivo do Windows Media