常见问题解答 (FAQ)

以下是使用 Anna 时的常见技术与体验问题解答。

📺 播放与多媒体类

Q1：为什么有些视频（如 MKV、AVI）播放时只有声音，画面是黑屏的？

解答：这通常是因为 iOS 系统默认的 AVPlayer 引擎不支持非苹果官方推荐的编码格式（例如 MKV 封装格式、部分 FLAC 音频或特殊的 H.265/VP9 编码）。
Anna 的解决机制：Anna 拥有智能双播放引擎切换系统。当 App 检测到视频文件后缀非 MP4/MOV 等原生格式时，会自动路由给基于 FFmpeg + Metal 硬件加速解码的 KSPlayer 引擎进行播放。如果您使用原生路径播放时遇到致命解析错误（例如 Code -17913 或其他黑屏），App 也会自动触发热切换容灾降级，无缝使用 KSPlayer 重建画面并重新播放，无需手动设置。

Q2：如何进行视频倍速或双指捏合画面？

解答：
- 视频倍速：在播放控制面板中长按屏幕任意位置即可触发“2倍速极速快进”，或点击设置调整常规倍速。
- 双指捏合（Pinch-to-zoom）：在播放 Telegram 等短视频时，你可以直接使用双指在屏幕上进行张合捏合以放大画面（最大支持 5.0 倍，若捏合到 1.0 倍以下松手会自动弹性回弹）。在放大状态下，单指拖拽画面可以平移查看局部细节。

📱 Telegram 与社交视频类

Q3：在 Anna 中登录 Telegram 账号安全吗？

解答：完全安全。
- Anna 采用 Telegram 官方提供的开源安全数据库 TDLib (Telegram Database Library)。
- 所有的认证过程（如验证码输入、两步验证等）均直接向 Telegram 官方网关服务器发起，App 绝不参与，也没有任何第三方中转服务器。
- 您的本地数据库（tdlib_db）存储在 iOS 设备本身受沙盒保护的 Document 目录下，即使是 Anna 官方也无法在云端调取您的会话历史。

Q4：为什么我收藏了视频，但 Telegram 的个人收藏夹里没有看到？

解答：
- 请确保您是在播放 Telegram 视频源的短视频时点击了底部的“收藏”按钮，且页面下方正常弹出了“已同步保存到 TG 收藏夹”的 Toast 提示。
- 如果您是在无网状态下收藏、或者所播放的视频是本地视频/非 Telegram 频道的常规视频，系统则只会显示“已保存到本地收藏”，这不会触发 Telegram 的云端消息转发。

🛰️ 存储、搜索与群晖 NAS

Q5：如何将搜索到的磁力链接一键推送到群晖下载？

解答：
1. 在 设置 -> 远程服务绑定 中，填写您群晖服务器的地址、端口以及 Download Station 的登录账号。
2. 在主页顶部的“全网搜索”或网盘盘搜中，找到包含磁力链接（magnet:）的搜索结果。
3. 点击结果右侧的群晖图标，Anna 将会异步调取官方 API，在后台默默将链接发送给群晖 Download Station。
4. 下载完成后，由于您绑定了 WebDAV 挂载，Anna 会自动发现新剧集并进行海报刮削，实现自动化流程。