播放指令

複製指令，存成播放按鈕。Exo 與 mpv 都能使用。

新增指令按鈕

mpv：進入「腳本」→「按鈕」→「新增」→「新增指令按鈕」。每個按鈕填一條指令，不需加上 mp.commandv(...)。

按「複製」，貼到指令欄位。

功能	指令
快轉 90 秒	`seek +90`
播放／暫停	`cycle pause`
切換倍速	`cycle-values speed 1 1.25 1.5 2`
切換音量	`cycle-values volume 30 60 100`
字幕提早 0.1 秒	`add sub-delay -0.1`
聲音延後 0.2 秒	`set audio-delay 0.2`
切換單片循環	`cycle-values loop-file no inf`
下一章	`add chapter 1`
切換影片高度	`cycle-values video-scale-y 1 1.15 1.3`
切換影片比例	`cycle-values video-aspect-override no 16:9 4:3 2.35:1`

set 屬性值 設定；add 屬性增量 增減；cycle-values 屬性值1 值2 輪切。名稱請用小寫。

屬性	支援寫法	數值與單位	用途與限制
`pause`	set、cycle-values、cycle	yes 暫停；no 播放	cycle pause 切換播放／暫停。
`speed`	set、add、cycle-values	0.1～5 倍；1 為原速	add 超出範圍時取上下限。
`volume`	set、add、cycle-values	0～100；0 靜音	播放器音量，系統音量不變；add 超出範圍時取上下限。
`sub-delay`	set、add、cycle-values	秒，可用小數；0 清除	主字幕：正值延後、負值提前；副字幕不變。
`audio-delay`	set、add、cycle-values	秒，可用小數；0 清除	聲音：正值延後、負值提前。
`loop-file`	set、cycle-values	inf 或 yes 開啟；no 關閉	單片無限循環，不支援指定次數或整份清單。
`chapter`	set、add、cycle-values	從 0 起算；add 僅接受 1、-1	需有章節；set chapter 2 跳第三章。
`video-scale-x`	set、cycle-values	0 < 倍率 ≤ 10000；1 取消縮放	寬度倍率；1.15 加寬 15%。
`video-scale-y`	set、cycle-values	0 < 倍率 ≤ 10000；1 取消縮放	高度倍率；1.15 增高 15%。
`video-aspect-override`	set、cycle-values	no、正數小數或寬:高，例如 16:9、4:3、2.35:1	覆寫影片比例；no 恢復來源比例，保留額外縮放與平移。填充模式仍拉伸至播放區域。不接受 0、-1 或超出 float 範圍的比例。

add chapter -1 跳上一章；本章已播放超過 5 秒時，先回到本章開頭。

縮放設為 1，取消該方向的額外縮放，保留畫面比例模式。放大可能裁切邊緣；字幕、彈幕與控制介面大小不變。

預設以秒計算；百分比以整部片長計算。超出範圍時停在起點或終點。

來源需支援跳轉；百分比與從片尾倒數都需要已知片長。

cycle-values 支援上表所有屬性，依目前值輪切，末項後回到首項。目前值不在清單時，從首項開始。

加上 !reverse 反向切換；目前值不在清單時，從末項開始。

指令反向倍速輪切

cycle-values !reverse speed 1 1.25 1.5 2

任一值無效，整條指令不執行。cycle 僅支援 pause。

功能取決於目前影片未播放或影片不支援該操作時，會提示「目前播放無法執行此指令」。

Exo 只支援本頁語法，不支援分號串接、額外前綴或 seek 旗標。

Lua 外掛與 mpv.conf 僅限 mpv，可自行匯入外掛。

本頁範圍以 Exo 為準；mpv 依原生規則，音量與循環行為可能不同。