影音优化
路径：播放服务 → 影音优化。
影音优化会提前读取影片的播放信息并保存结果，减少播放远程影片时的等待。它适合 Emby 或 Jellyfin 中的远程 STRM，也可以处理媒体服务器识别到的本地影片。
这项功能需要 Pro。使用前请先在“设置 → 系统设置 → 服务设置”添加 Emby 或 Jellyfin，并确保媒体服务器可以正常连接。远程 STRM 还需要先完成 STRM 生成 和媒体代理的设置。
第一次启用
第一次打开页面时，按下面顺序完成设置：
- 在“媒体服务器”中勾选要使用的 Emby 或 Jellyfin。
- 在“媒体库”中勾选要处理的媒体库。只会处理这里选中的媒体库。
- 点击“重新检测助手”，确认媒体服务器对应的 Mediora 助手状态。助手是安装在 Emby 或 Jellyfin 上的插件，负责把优化结果写回媒体服务器；还没装的话先看安装影音优化助手。
- 点击“预览处理范围”，查看媒体库数量、影片数量和远程 STRM 数量。
- 确认范围无误后，点击“保存设置”。
助手暂时不可用或还没有安装时也可以先启用，结果会先保存在 Mediora；助手就绪后，再从页面执行同步。助手的兼容范围和安装说明见安装影音优化助手。
总览
启用后，页面会显示三个页签：总览、优化任务、设置。
“总览”用于快速查看：
| 信息 | 怎么理解 |
|---|---|
| 已优化 | 已经准备好播放信息的影片数量。 |
| 服务器已使用 | 媒体服务器已经开始使用优化结果的影片数量。 |
| 正在处理、等待处理、已暂停、失败 | 当前任务进度；失败时打开“优化任务”的任务详情查看具体提示。 |
| 播放信息分析 | 当前是否可以读取影片播放信息。 |
| 播放等待时间 | 根据已经记录的播放情况统计，不代表每一部影片的固定速度。 |
如果看到“助手尚未就绪”“有备份等待补写”或“等待媒体服务器使用”，先按提示处理即可。已有影片和普通播放不会因为这些提示被删除或中断。
优化任务
批量处理已有影片
在“优化已有影片”区域点击“查看处理范围”，先查看需要处理的数量、跳过的数量、预计用时和运行时段。确认后点击“开始优化已有影片”创建任务。
新加入的影片不会混入这次已经确认的批量任务；它们是否自动加入，由“设置”里的“自动优化新视频”决定。
查看任务
“处理任务”会显示自动处理、批量处理、单部处理、恢复备份和同步到服务器等任务。运行中的任务可以：
- 点击“暂停”，暂时停止后续处理；
- 点击“继续”，恢复已暂停的任务；
- 点击“取消”，停止尚未完成的部分。
已经完成的影片不会因为暂停或取消自动恢复原状。
处理单个视频
在“处理任务”中点击“详情”，查看每个视频的处理原因以及媒体服务器已采用的数量。任务结束后可以：
- 重新同步：使用已有准备结果修复媒体服务器信息，不重新探测网盘。宿主扫描覆盖过结果时可使用这一项。
- 重新准备：再次读取这个视频的播放信息并创建单文件任务，仍遵守数量限制、播放让路和当前范围。
- 深入读取：仅在详情提供该入口时，由你确认使用更大的读取预算；不会自动从标准档位升级。
标准读取与深入读取
| 方式 | 最多读取 | 最长读取时间 | 怎样发起 |
|---|---|---|---|
| 标准读取 | 32 MiB | 90 秒 | 普通准备和“重新准备”。 |
| 深入读取 | 128 MiB | 5 分钟 | 单个远程视频详情中主动确认。 |
这是单次读取预算，不是必须读满，也不保证预算内一定获得完整资料。深入读取仍受播放让路、数量限制和当前处理范围约束；达到上限后仍失败时，先查看视频结构、来源的 Range 支持和失败原因，不要把反复重试当作无成本操作。
操作前会显示视频文件名和影响，确认后按钮立即锁定；失败保留原因，可以处理后重试。来源文件、所选范围或目标绑定变化时，旧操作会被拒绝，请刷新详情重新确认。
详情打开期间会自动更新处理进度和仍在重试的服务器采用结果，不需要关闭重开。任务结束后，相应操作会自动解锁；全部采用或自动重试结束后停止自动刷新，仍可点击“刷新详情”查看最新结果。刷新失败会保留已显示内容和确认对象，并提供重试入口。其他页面更改处理范围后，旧页面会禁用操作并提示刷新页面；核对最新设置后再操作。
一份视频关联两台服务器时会分别记录结果。“已采用 1 / 2”表示仍有一台未成功，不能视为全部完成。可恢复的同步最多尝试五次（包含首次），失败后按 5、10、20、40 分钟间隔退避；格式、来源版本或助手保护状态冲突等待处理，其他视频或目标的重试不会绕过本目标的限制。
提示助手保护状态变化时，先到“设置”重新检测，核对并保存处理范围，再重新同步。设置未确认时不会自动换用新保护状态。
设置
功能状态
“启用影音优化”关闭后，不再创建新的优化任务，已有结果会保留。
媒体范围
重新勾选媒体服务器或媒体库后，后续自动处理和批量处理都会按新的范围执行。修改后建议重新点击“预览处理范围”。
自动处理
| 字段 | 怎么设置 | 影响 |
|---|---|---|
| 自动优化新视频 | 开启或关闭。 | 开启后，新影片进入所选媒体库时自动创建优化任务。 |
| 已有视频处理时段 | 选择全天处理，或只在指定时段处理。 | 只影响手动发起的批量处理，不影响新影片自动处理。 |
| 开始时间、结束时间 | 选择允许处理的时间段。 | 可以避开家中使用高峰；支持跨午夜时段。 |
| 每小时最多处理 | 填写 1–100。 | 限制每小时处理数量，数值越小越节省资源，但完成得更慢。 |
| 每天最多处理 | 填写 1–1000。 | 限制每天处理数量，避免一次性处理整个媒体库。 |
| 视频间隔 | 填写 5–300 秒。 | 控制连续处理影片之间的等待时间，数值越大越温和。 |
备份方式
在“自动处理”中选择“备份方式”：
| 选项 | 说明 |
|---|---|
| 在 STRM 旁保存备份（推荐） | 将结果备份在 STRM 附近，便于恢复和迁移。 |
| 不额外备份 | 只保留在 Mediora 中，节省额外文件空间，但可恢复性较弱。 |
| 保存到指定目录 | 将结果写入你填写的备份目录；请确认目录可写并且长期保留。 |
选择“保存到指定目录”时，再填写“备份目录”。如果目录不可写，页面会提示备份等待补写；修复目录后会按规则自动补写。备份保存不等于媒体服务器已经采用，二者分别记录。
这些备份保存播放信息结果，不包含完整影片，也不替代 Mediora 数据目录或媒体服务器的完整备份。改位置不会自动搬迁或删除旧文件；需要清理时到原存储核对，不能仅删除页面里的任务就认为文件已清理。
范围变化与播放等待
预览会显示本次范围和估算，确认范围有有效期；超过时间或期间修改了媒体库、来源、助手绑定时，应重新预览。预计用时受小时 / 每日额度、运行时段、播放让路和实际读取耗时影响，不是完成时限。
播放优先时，后台读取可能等待；账号额度或冷却也可能让任务停在等待状态。先看具体原因，不要通过增大并发或反复重新准备绕过账号保护。
本地受管 STRM 仍依赖当前挂载和来源身份。挂载重连、替换文件或更换来源目录后，旧准备结果不能直接证明新来源有效；媒体服务器目录映射模式则需服务器本身能读到实际路径。两种情况都先确认基础播放，再考虑优化。
使用建议
- 首次启用时先只选择一个媒体库，预览范围无误后再扩大范围。
- 批量处理前先确认媒体服务器和助手状态，避免任务长时间等待。
- 通过“每小时最多处理”“每天最多处理”和“视频间隔”控制资源占用。
- 更换影片文件后，旧结果不会继续复用，页面会重新处理新的文件版本。
- Pro 权益暂时无法确认时，已有任务和结果会保留；恢复账户状态后刷新页面即可继续。