Método MediaCollection.add

[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 método add adiciona um novo item de mídia ou playlist à biblioteca.

Sintaxe

retVal = MediaCollection.add(
  path
)

Parâmetros

path [in]

Cadeia de caracteres que contém o caminho.

Retornar valor

Esse método retorna um objeto Media .

Comentários

Esse método carrega um item de mídia ou playlist existente na biblioteca, dado um caminho para um arquivo. Esse método não move nem altera o arquivo. Esse método falhará se receber um caminho local inválido, mas os arquivos de mídia digital não forem verificados quanto à validade antes de serem adicionados à biblioteca.

Esse método aceita arquivos de playlist estáticos e automáticos. A PlaylistCollection. O método importPlaylist também pode ser usado para adicionar uma playlist estática à biblioteca.

Para usar esse método, é necessário acesso completo à biblioteca. Para obter mais informações, consulte Acesso à biblioteca.

Exemplos

O exemplo do Microsoft JScript a seguir adiciona três objetos de mídia à coleção de mídia Reprodutor Multimídia do Windows. O objeto Player foi criado com 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");

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Gerenciando playlists

Objeto Media

Objeto MediaCollection

MediaCollection.remove

PlaylistCollection.importPlaylist

Settings.mediaAccessRights

Settings.requestMediaAccessRights