useVideoPlayerPrefs()

useVideoPlayerPrefs 讀寫 SwVideoPlayer 的兩個使用者偏好(framework#427):

偏好預設作用
skipIntroOutrotrue跳過片頭片尾:傳了 skip 時片頭自動跳過、進入片尾即開始「下一集」倒數
autoPlayNexttrue自動播放下一集:開著 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 期回傳預設值,水合後才是使用者實際選擇;只在用戶端互動裡讀它。