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