# 使用手册

## 打开控制页面

安装后完整退出并重开 Harness，在“设置 → 启动动画”中配置。不同 DSH 版本的入口可能位于插件配置页。

| 选项 | 默认值 | 用途 |
|---|---|---|
| 开启启动动画 | 开 | 关闭后使用 DSH 原生启动页 |
| 播放影片声音 | 开 | 保留现有声音策略；关闭后整体静音 |
| 播放欢迎语 | 开 | 控制额外添加的“欢迎回来”，不改影片原声 |
| 显示底部提示文字 | 开 | 只控制提示行，保留标题和进度条 |
| 淡入时长 | 2 秒 | 控制既有淡入时长 |
| 进入方式 | 片尾交叉溶解 | 也可选择播完再淡、点击才进 |
| 播放方式 | 随机 | 可固定到指定片段 |

设置保存后通常在下一次加载页面时生效。更新插件或 Host 代码后，请完整退出并重新打开应用。

## 欢迎语与原声

额外欢迎语默认开启。它遵循现有片尾与提前进入兜底逻辑；没有新增时间偏移。`1.mp4` 自带欢迎语，不叠加额外语音。

取消“播放欢迎语”后，独立欢迎音不再启动。只要影片声音开启，视频自身的音乐或人声仍然存在，这是刻意保留的原声行为。

音频启动中的重复请求会被合并；创建新预览时会清理旧预览的欢迎音与重试监听。浏览器拒绝自动播放时仍可能需要一次用户操作，插件不保证绕过平台策略。

## 添加或替换影片

支持 mp4、webm、m4v、mov，单个文件最大 512 MB。可在控制页上传，或打开素材目录后复制文件；无需修改源码。

推荐 H.264 + AAC、16:9、适合短时播放的本地片段。MP4 索引前置可改善起播；控制页面提供素材状态与优化入口。

`1.mp4` 的欢迎音例外按当前文件名保留。如果换成不同内容，或把自带欢迎语的视频改名，应同步检查该特殊规则。

## 常见问题

| 现象 | 检查方法 |
|---|---|
| 设置入口没出现 | 确认插件已登记、已完整重启，并检查宿主与 schemastery 设置接口版本 |
| 没有声音 | 检查影片声音与欢迎语开关；自动播放受限时点击一次 |
| 某几段轻顿 | 素材规格并不一致；先确认发生在起播、播放中还是转场，避免盲目改欢迎语时机 |
| 修改源码没生效 | 设置界面需构建；Host 代码需重启；启动页脚本需重新加载 |
| 安装后素材又消失 | 通过 `dsh plugin` 安装并登记依赖，不使用临时复制到 node_modules 的方式 |

源码与素材升级前建议备份。不要把整份个人 profile 配置、凭据或聊天记录上传到本仓库。