MediaCollection.add 方法

add方法會將新的媒體專案或播放清單新增至文件庫。

語法

retVal = MediaCollection.add(
  path
)

參數

路徑 [in]

包含 路徑的字串。

傳回值

這個方法會傳回 Media 物件。

備註

這個方法會在檔案的路徑下,將現有的媒體專案或播放清單載入文件庫。 這個方法不會移動或變更檔案。 如果提供不正確本機路徑,但數位媒體檔案在新增至程式庫之前,不會檢查其有效性,則此方法會失敗。

此方法同時接受靜態和自動播放清單檔案。 PlaylistCollectionimportPlaylist方法也可用來將靜態播放清單新增至文件庫。

若要使用此方法,需要程式庫的完整存取權。 如需詳細資訊,請參閱 程式庫存取

範例

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

設定.mediaAccessRights

設定.requestMediaAccessRights