MediaCollection.add 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。
add方法會將新的媒體專案或播放清單新增至文件庫。
語法
retVal = MediaCollection.add(
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 |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應