Элемент REF

Статья
06/21/2023

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Элемент REF задает URL-адрес для цифрового мультимедийного содержимого.

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

Атрибуты

HREF (обязательно)

URL-адрес любого мультимедийного содержимого, поддерживаемого Медиаплеер Windows.

Родительские и дочерние элементы

Иерархия	Элементы
Родительские элементы	ЗАПИСЬ
Дочерние элементы	DURATION, ENDMARKER, PREVIEWDURATION, STARTMARKER, STARTTIME

Этот элемент задает URL-адрес для части мультимедийного содержимого. URL-адрес может указывать на любой поддерживаемый тип мультимедиа, используя любой протокол, поддерживаемый Медиаплеер Windows.

Поддерживаемые типы мультимедиа включают неподвижные образы, такие как .gif и .jpg изображения, а также flash-файлы с расширением SWF-файла. Эти типы мультимедиа полезны для включения рекламного контента в список воспроизведения. В файлах изображений и Flash-файлах, воспроизводимых в цикле, необходимо также указать количество времени для отображения элемента мультимедиа, включив элемент DURATION в элемент REF . Если вы хотите, чтобы изображение продолжало отображаться во время буферизации следующей записи в списке воспроизведения, включите элемент PARAM в элемент ENTRY , задайте для его атрибута name значение ShowWhileBuffering и задайте для его атрибута value значение true.

Для ссылки на содержимое на компакт-диске или DVD-диске, который это позволяет, предоставляются протоколы wmpcd и wmpdvd. Например, если задать для атрибута HREF значение "wmpdvd://f/5/3", на DVD-диске будет воспроизводиться глава 3 заголовка 5, но только в том случае, если DVD-диск был создан для его разрешения.

Приложения, которые открывают цифровые носители из-за брандмауэра, будут иметь более высокую производительность при открытии элементов мультимедиа, если адрес указан с использованием имени сервера доменных имен (DNS) вместо IP-адреса.

Чаще всего этот элемент используется для смены URL-адресов. Если Медиаплеер Windows не удается открыть элемент мультимедиа, определенный в элементе REF, он пытается получить URL-адрес в следующем элементе REF. После того как Медиаплеер Windows открывает содержимое мультимедиа из URL-адреса, определенного в область одного элемента ENTRY, последующие теги REF в этом элементе ENTRY игнорируют. После завершения воспроизведения фрагмента содержимого Медиаплеер Windows переходит к следующему элементу ENTRY, если таковой имеется.

Важно После того как Медиаплеер Windows устанавливает соединение с элементом содержимого, на который указывает ссылка, он игнорирует все остальные элементы REF в этом элементе ENTRY, независимо от того, завершается ли соединение нормально или ненормально.

Если элемент мультимедиа, на который ссылается ссылка, является файлом изображения, необходимо использовать элемент DURATION , чтобы указать время отображения изображения.

Примечание

Попытка воспроизвести флэш-носитель, включающий звук с первым кадром, может привести к непредвиденным результатам. Вы должны создавать содержимое Flash для воспроизведения звука, начиная не ранее второго кадра.

Примеры

<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>

Требования

Требование	Значение
Версия	Медиаплеер Windows версии 7.0 или более поздней

См. также раздел

Поддерживаемые протоколы и типы файлов
Справочник по элементам метафайлов Windows Media
Справочник по метафайлам Windows Media