# 命令列控制
您可利用命令列引數控制 Wallpaper Engine, 從捷徑、巨集繫結或任何自行撰寫的腳本或程式碼,來存取此應用程式大部分功能。 例如,您可能暫停或停止所有桌布、變更桌布,甚至使正在運作的桌布變更設定。
請確認 Wallpaper Engine 已在運作,接著使用本指南列出的任何命令引數,透過此程式的主要處理程序 wallpaper32.exe (如果使用的是 64 位元,則為 wallpaper64.exe) 向 Wallpaper Engine 傳送命令。 您可以在 wallpaper_engine
安裝目錄中找到可執行檔。
所有命令均作為 -control
參數的值發出。 例如,暫停命令可以下列方式執行:
wallpaper32.exe -control pause
對於包含空格的字串,務必使用雙引號 " 字元:
wallpaper32.exe -control openWallpaper -file "C:\Program Files (x86)\Steam\steamapps\common\wallpaper_engine\projects\myprojects\myWallpaper\project.json"
# 命令一覽
# 暫停
暫停所有桌布。
-control pause
# 停止
停止所有桌布。
-control stop
# 播放
繼續播放原本暫停或停止的桌布。
-control play
# 靜音
將所有桌布靜音。
-control mute
# 取消靜音
將所有桌布取消靜音。
-control unmute
# 開啟桌布
為特定顯示器或第一台顯示器 (如未指定任何顯示器) 載入桌布。 您可利用 location
或 monitor
參數,選擇哪一台顯示器載入桌布,或利用 playInWindow
參數在視窗中開啟桌布。
-control openWallpaper -file <string> [-location <string>] [-monitor <number>]
[-playInWindow <string>] [-width <number>] [-height <number>]
[-x <number>] [-y <number>] [-preset <string>]
- file: 欲開啟桌布 project.json 的路徑,或桌布檔案的直接路徑 (.mp4 etc)。
- location (選用): 顯示器內部識別碼。 這些由您的電腦生成,您可在 config.json 檔案中找到。
- monitor (選用): 欲載入桌布顯示器的索引,以 0 開頭。
- preset (選用): 欲載入本機的名稱;必須已事先建立本機預設並儲存。
- playInWindow (選用): 如果您想在一視窗內開啟/控制多個桌布,則為該視窗名稱。
- width (選用): 視窗寬度。
- height (選用): 視窗高度。
- x (選用): 視窗的水平位置。
- y (選用): 視窗的垂直位置。
# 下一張桌布
跳至特定顯示器或所有顯示器 (如未指定任何顯示器) 的下一張桌布。
-control nextWallpaper [-location <string>] [-monitor <number>]
# 移除桌布
從特定顯示器或視窗移除一張或多張桌布。
-control closeWallpaper [-location <string>] [-monitor <number>]
- location (選用): 顯示器內部識別碼或您指定的視窗名稱。
- monitor (選用): 欲關閉桌布的顯示器索引,以 0 開頭。
# 開啟播放清單
為特定顯示器或第一台顯示器 (如未指定任何顯示器) 載入桌布。 您可以使用 location 或 monitor 參數選擇哪一台顯示器載入桌布。
-control openPlaylist -playlist <string> [-location <string>] [-monitor <number>]
- playlist: 您已在 Wallpaper Engine 建立並儲存的播放清單名稱。
- location (選用): 顯示器內部識別碼。 這些由您的電腦生成,您可在 config.json 檔案中找到。
- monitor (選用): 欲載入播放清單的索引,以 0 開頭。
# 套用桌布設定
將桌布動態屬性套用於特定桌布或所有桌布。 如此一來,您即可在程式運作時即時變更桌布的任何設定,不需要開啟桌布瀏覽器並手動變更。 選擇瀏覽器中任何桌布時,按一下右側的分享 JSON,即可在瀏覽器中輕鬆找到可用屬性列表。
-control applyProperties -properties <JSON> [-location <string>] [-monitor <number>]
- properties: 定義為欲套用 JSON 字串的屬性。 此字串必須特別以
RAW~(
和)~END
逸出作為分隔符號,請見下方實例。 - location (選用): 顯示器內部識別碼或您指定的視窗名稱。
- monitor (選用): 欲更新屬性的顯示器索引,以 0 開頭。
將名為 rate
的桌布設定變更為 10 的實例:
-control applyProperties -properties RAW~({"rate":10})~END
將桌布配置顏色變更為紅色的實例 ("1 0 0"
代表 RGB 值):
-control applyProperties -properties RAW~({"schemecolor":"1 0 0"})~END
# 隱藏桌面圖示
隱藏桌面圖示。
-control hideIcons
# 顯示桌面圖示
顯示桌面圖示。
-control showIcons