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 期返回默认值,水合后才是用户实际选择;只在客户端交互里读它。