Beta 版本

FloSync 目前处于 Beta 阶段,功能可能会随反馈而快速调整。

文档菜单

故障排查

本指南汇总了 FloSync 常见问题的排查与解决方法。如果在这里找不到答案,请参阅常见问题或联系技术支持。

诊断日志

FloSync 会持续记录详细的运行日志,方便排查各类问题。无论是分析同步异常、还原某次会话的运行状况,还是向技术支持提交工单,这些日志都能提供关键线索。

查看日志

通过菜单:

  • macOS:帮助 > 打开日志文件夹
  • Windows:帮助 > 打开日志文件夹

手动定位:

  • macOS:~/Library/Application Support/FloSync/logs/
  • Windows:%APPDATA%/FloSync/logs/

日志结构

日志按日期和小时分文件存储:

logs/
├── 2026-01-19/
│   ├── 00.log    (午夜至凌晨 1 点)
│   ├── 01.log    (凌晨 1 点至 2 点)
│   ├── ...
│   └── 23.log    (晚上 11 点至午夜)
├── 2026-01-18/
│   └── ...

日志保留策略

日志保留 7 天，FloSync 每次启动时会自动清理过期文件。这一策略在保证排查所需历史数据的同时，避免占用过多磁盘空间。

日志记录内容

日志中的每条记录都带有时间戳，涵盖以下事件:

  • 应用启动与退出
  • 视频加载与播放事件
  • 同步事件与校正操作
  • 网络同步的连接与断开
  • 排程播放中的场景切换
  • 错误与警告信息

利用日志排查问题

  1. 复现问题 — 记下问题大致发生的时间
  2. 打开日志文件夹 — 通过「帮助 > 打开日志文件夹」
  3. 定位对应文件 — 进入日期文件夹，打开对应小时的日志文件
  4. 搜索错误信息 — 查找标记为 "ERROR" 或 "WARN" 的条目
  5. 结合上下文分析 — 阅读错误前后的条目，了解完整背景

联系技术支持时，请随信附上相关日志文件，有助于更快定位问题。

内容加载问题

图片无法加载

现象：将图片拖入 FloSync 后无响应，或弹出错误提示。

可能的原因及解决方法：

  1. 格式不受支持

    • 支持的格式：PNG、JPG/JPEG、GIF、BMP、TIFF、WebP、SVG
    • 尝试用其他图片查看器打开，确认文件未损坏

  2. 文件权限不足

    • 确认您对该图片拥有读取权限
    • 如果文件存放在网络共享位置，请先复制到本地磁盘

  3. SVG 兼容性

    • 部分复杂 SVG 特性可能无法正确渲染
    • 如果 SVG 显示异常，建议转换为 PNG 格式

网页无法加载

现象：屏幕上的网页显示空白或报错。

可能的原因及解决方法：

  1. HTTP 与 HTTPS

    • 仅支持 HTTPS 网址，不支持 HTTP
    • 请确认网址以 https:// 开头

  2. 网络连接异常

    • 确认设备能正常访问互联网
    • 在常规浏览器中打开该网址，验证网站本身是否可用

  3. 网站禁止嵌入

    • 部分网站会拒绝在 WebView 中加载
    • 可换用其他网站，或改用本地 HTML 文件

视频播放问题

视频无法加载

现象：将视频拖入 FloSync 后无响应，或弹出错误提示。

可能的原因及解决方法：

  1. 格式不受支持

    • 请转换为 MP4（H.264）—— 详见下方的视频编码建议
    • 尝试用其他播放器打开，确认文件未损坏

  2. 缺少解码器

    • FloSync 已内置绝大多数常用解码器，但某些专有格式可能不被支持
    • 请转换为 MP4 等通用格式

  3. 文件权限不足

    • 确认您对视频文件拥有读取权限
    • 如果文件存放在网络共享位置，请先复制到本地磁盘

视频卡顿或掉帧

现象：播放画面不流畅，出现跳帧或抖动。

解决方法：

  1. 检查 CPU/GPU 使用率 — 如果已接近满载，说明硬件可能无法应对当前分辨率
  2. 使用 SSD 存储 — 机械硬盘的读取速度可能跟不上高码率视频
  3. 降低视频分辨率 — 如果硬件吃力，可用较低分辨率重新编码
  4. 关闭其他应用 — 释放系统资源
  5. 放宽同步容差 — 如果启用了同步功能，适当放宽容差可减少校正频率

屏幕问题

第二块屏幕未被检测到

现象：已连接多块屏幕，但 FloSync 只识别到一块。

解决方法：

  1. 检查系统显示设置

    • macOS：系统设置 > 显示器
    • Windows：设置 > 系统 > 显示
    • 确认操作系统已识别到所有屏幕

  2. 检查线缆连接

    • 换一根线缆试试
    • 尝试使用电脑上的其他接口

  3. 连接新屏幕后重启 FloSync

    • FloSync 在启动时检测屏幕

屏幕排列不正确

现象：跨屏模式下，视频画面出现在了错误的屏幕上。

解决方法：

  1. 在系统中调整屏幕排列

    • macOS：系统设置 > 显示器 > 排列
    • Windows：设置 > 系统 > 显示（拖动调整位置）
    • 确保虚拟排列与屏幕的物理位置一致

  2. 调整排列后重启 FloSync

同步问题

本地屏幕不同步

现象：镜像或跨屏模式下，各屏幕显示的画面不一致。

解决方法：

  1. 等待自动校正 — FloSync 会自动纠正持续性漂移
  2. 查看状态栏 — Live 模式期间，状态栏的同步校正计数器会显示累计校正次数：
    • 长时间运行中出现少量校正属于正常
    • 如果计数反复跳动或快速攀升，可能存在配置问题
  3. 收紧同步容差 — 在偏好设置中调低容差值
  4. 查看同步日志 — 关注漂移警告和校正记录
  5. 重启播放 — 先暂停，再重新播放

网络同步无法正常工作

现象：客户端找不到服务端，或者连接后同步不生效。

解决方法：

  1. 确认处于同一局域网

    • 两台电脑必须在同一本地网络内
    • 可互相 ping 对方 IP 来验证连通性

  2. 确认视频文件一致

    • 客户端必须加载与服务端相同的视频文件
    • 如果视频时长不同，同步将失败

  3. 检查防火墙设置

    • 在两台设备上都允许 FloSync 通过防火墙
    • 需放行 UDP 端口 9201

  4. 确认服务端正在运行

    • 顶部栏中的服务端图标（塔形）应为绿色
    • 状态栏应显示 "Server"
    • 可尝试点击该图标停止后重新启动服务端

  5. 等待初始稳定

    • 网络同步建立连接后，可能需要短暂时间才能稳定
    • 初期出现少量校正属于正常现象
    • 稳定后，播放应保持视觉上的一致

连续运行数天后出现渐进漂移

现象：网络同步原本运行正常，但连续运行数天后，客户端持续偏差 50–100 毫秒，且无法完全自行纠正。

原因：每台电脑的系统时钟都会因硬件振荡器差异和温度变化而产生不同速率的漂移。连续运行数天后，累积的漂移量可能超出实时校正所能补偿的范围。这是所有基于时钟同步的系统的共性问题，并非 FloSync 独有。

解决方法：重启两台电脑即可解决。对于无人值守的部署场景，建议在非工作时段安排每日定时重启——详见同步优化指南中的安排定期重启。

同步校正导致画面卡顿

现象：播放过程中视频频繁出现跳跃或卡顿。

解决方法：

  1. 在偏好设置中放宽同步容差
  2. 检查网络质量（针对网络同步场景）
  3. 降低系统负载 — 关闭不必要的应用程序
  4. 查看同步日志 — 分析是否存在规律性模式

上线直播问题

全屏窗口未出现

现象：点击「上线直播」后，屏幕上没有出现全屏窗口。

解决方法：

  1. 检查屏幕检测

    • 确认屏幕已被识别（应在屏幕排列区域中可见）
    • 尝试断开屏幕后重新连接
    • 连接新屏幕后重启 FloSync

  2. 检查视频是否已加载

    • 上线直播前需确保至少加载了一个视频
    • 留意是否有 "missing video" 提示

  3. 检查权限

    • macOS：确认 FloSync 拥有辅助功能权限（系统设置 > 隐私与安全性 > 辅助功能）
    • Windows：尝试以管理员身份运行 FloSync

按 ESC 无法退出 Live 模式

现象：在全屏窗口中按 ESC 键没有退出 Live 模式。

解决方法：

  1. 确认窗口已获得焦点 — 先点击一下全屏窗口
  2. 使用「停止直播」按钮 — 回到控制面板，点击「停止直播」
  3. 必要时强制退出 — 可使用 Cmd+Q（macOS）或 Alt+F4（Windows）

应用程序问题

FloSync 无法启动

macOS 解决方法：

  1. 安全性设置

    • 右键点击 FloSync 并选择"打开"
    • 或前往：系统设置 > 隐私与安全性 > 允许 FloSync

  2. 清除偏好设置

    • 删除：~/Library/Application Support/com.tentekio.flosync/
    • 重新启动 FloSync

Windows 解决方法：

  1. 以管理员身份运行

    • 右键点击 FloSync > 以管理员身份运行

  2. 清除偏好设置

    • 删除：%APPDATA%\Tentekio\FloSync\
    • 重新启动 FloSync

  3. 重新安装 Visual C++ 运行库

    • 从 Microsoft 官网下载最新版本

CPU/内存占用过高

现象：FloSync 消耗大量系统资源。

解决方法：

  1. 属于正常现象 — 视频播放本身就需要较多计算资源
  2. 降低视频分辨率 — 如果硬件吃力，可改用 1080p 代替 4K
  3. 减少同时播放的视频数量 — 适用于独立模式
  4. 关闭同步日志面板 — 日志记录会占用一定资源
  5. 检查是否有异常进程 — 如果停止视频后资源占用仍居高不下，请重启 FloSync

视频编码问题

如果在网络同步时遇到漂移或播放不一致的情况，视频编码格式可能是主要原因。

快速解决：将视频转码为 H.264 All-Intra，可获得可靠的同步表现，且适用于所有平台。如果不在乎文件体积，macOS 上可选 ProRes LT，Windows 上可选 DNxHD。

有关视频格式选择、推荐编码、测试素材和 FFmpeg 转码命令的详细说明，请参阅视频准备指南。

已知限制

当前限制

  • 跨屏模式下，画面在屏幕边框处可能无法完美对齐
  • Wi-Fi 下的网络同步稳定性不如有线连接
  • 受 DRM 保护的内容无法播放
  • 超高分辨率视频（8K 及以上）在部分硬件上可能表现不佳
  • Live 模式下无法切换屏幕模式，需先退出 Live
  • 网页无法跨屏展开，在跨屏模式下会以镜像方式显示
  • 网页仅支持 HTTPS 网址，不支持 HTTP
  • 网络同步仅适用于视频内容，图片和网页不会在设备之间同步

获得最佳效果的建议

  • 网络同步请务必使用有线连接
  • 将内容文件保存在本地存储上，不要放在网络驱动器中
  • 每次使用时保持一致的屏幕配置
  • 正式演示前请完整测试一遍部署方案
  • 使用排程功能时，先用短时间场景测试切换效果