Метод MediaCollection.add

Статья
06/21/2023

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

Метод add добавляет новый элемент мультимедиа или список воспроизведения в библиотеку.

Синтаксис

retVal = MediaCollection.add(
  path
)

Параметры

path [in]: Строка , содержащая путь.

Возвращаемое значение

Этот метод возвращает объект Media .

Этот метод загружает существующий элемент мультимедиа или список воспроизведения в библиотеку с заданным путем к файлу. Этот метод не перемещает и не изменяет файл. Этот метод завершается ошибкой, если задан недопустимый локальный путь, но цифровые файлы мультимедиа не проверяются на допустимость перед их добавлением в библиотеку.

Этот метод принимает как статические, так и автоматические файлы списка воспроизведения. PlaylistCollection. Метод importPlaylist также можно использовать для добавления статического списка воспроизведения в библиотеку.

Для использования этого метода требуется полный доступ к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Примеры

Следующий пример Microsoft JScript добавляет три объекта мультимедиа в коллекцию Медиаплеер Windows мультимедиа. Объект Player был создан с идентификатором ID="Player".

// Adding a media object using a website.
Player.mediaCollection.add("https://www.proseware.com/Media/Laure.wma");

// Adding a media object from a local network.
// You must add an escape sequence of a backslash for 
// every original backslash.
Player.mediaCollection.add("\\\\yourservername\\Public\\Jeanne.wma");

// Adding a media object from a file on a local drive.
// Be sure to add appropriate escape sequences.
Player.mediaCollection.add("C:\\WMSDK\\WMPSDK\\docs\\samples\\media\\house.wma");

Требования

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

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

Управление списками воспроизведения
Объект media
Объект MediaCollection
MediaCollection.remove
PlaylistCollection.importPlaylist
Settings.mediaAccessRights
Settings.requestMediaAccessRights