useVideoPlayerPrefs()
useVideoPlayerPrefs 讀寫 SwVideoPlayer 的兩個使用者偏好(framework#427):
| 偏好 | 預設 | 作用 |
|---|---|---|
skipIntroOutro | true | 跳過片頭片尾:傳了 skip 時片頭自動跳過、進入片尾即開始「下一集」倒數 |
autoPlayNext | true | 自動播放下一集:開著 show-play-next 時,播完 / 片尾顯示 5 秒倒數後 emit play-next |
播放器在 show-play-next 為真時會把這兩項放進 Artplayer 設定面板,一般不用自己呼叫本 composable;需要在站點自己的設定頁裡展示這兩個開關時才用。
const { prefs, set } = useVideoPlayerPrefs()
prefs.value.autoPlayNext // 讀(computed,永遠是完整物件)
set({ skipIntroOutro: false }) // 只寫傳入的欄位
- 儲存走 framework 加密的
useLocal(鍵sw-video-player-prefs,自動帶專案前綴)——不要自己讀寫localStorage。 - 存的物件缺欄位(舊版本寫入 / 手動改過)時按預設值補齊。
- SSR 期回傳預設值,水合後才是使用者實際選擇;只在用戶端互動裡讀它。