PlaylistCollection.newPlaylist 方法
[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]
newPlaylist方法會在文件庫中建立新的播放清單。
語法
retVal = PlaylistCollection.newPlaylist(
name
)
參數
-
name [in]
-
包含 要建立之播放清單名稱的字串。
傳回值
這個方法會傳回 Playlist 物件。
備註
此方法會在文件庫中建立空的播放清單。 若要使用媒體專案填入播放清單,請使用 播放清單。appendItem 或 Playlist。insertItem。
文件庫中允許多個具有相同名稱的播放清單。 若要避免使用此方法建立重複的播放清單名稱,請使用 getByName 和 PlaylistArray。count ,以判斷具有特定名稱的播放清單是否已經存在。
播放清單名稱中不允許開頭和尾端空格,而且會自動從 為 name 參數指定的值中移除。
若要使用這個方法,需要程式庫的完整存取權。 如需詳細資訊,請參閱 程式庫存取。
範例
下列 JScript 範例會建立名為 「ThreeList」 的新空白播放清單。 Player物件是使用 ID=「Player」 建立的。
//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");
規格需求
需求 | 值 |
---|---|
版本 |
Windows 媒體播放機 7.0 版或更新版本。 |
DLL |
|
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應