Beta 版本

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

文档菜单

故障排查

请在下方找到与您的症状相符的章节。如果都不匹配，请查阅常见问题或联系技术支持。

诊断日志

FloSync 会为每次会话保留日志。如果您从应用内提交问题报告，最近的日志会自动附加到报告中，无需您手动查找或阅读。

如果您想自己查看，可使用帮助 > 打开日志文件夹。日志保留 7 天。

内容加载问题

图片无法加载

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

可能的原因及解决方法：

  1. 格式不受支持

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

  2. 文件权限不足

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

  3. SVG 兼容性

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

网页无法加载

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

可能的原因及解决方法：

  1. 检查网址

    • 网址栏接受 https:// 开头的地址；如果只输入不带协议的地址（例如 example.com），会默认按 https:// 处理
    • 如果粘贴的是 http:// 地址，FloSync 不会接受，请改用该网站的 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. 查看状态栏： 直播模式期间，状态栏的同步校正计数器会显示累计校正次数：
    • 长时间运行中出现少量校正属于正常
    • 如果计数反复跳动或快速攀升，可能存在配置问题
  3. 收紧同步容差： 在偏好设置中调低容差值
  4. 查看同步日志： 关注漂移警告和校正记录
  5. 重启播放： 先暂停，再重新播放

网络同步无法正常工作

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

解决方法：

  1. 确认处于同一局域网

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

  2. 确认视频文件一致

    • 客户端加载的视频必须与服务端一致。文件名不必相同，但内容必须一致
    • 如果视频时长不同，该电脑就无法跟随服务端的时间轴，而是继续播放自己的本地副本

  3. 检查防火墙设置

    • 在两台设备上都允许 FloSync 通过防火墙
    • 放行 UDP 9201 用于同步；如果还需要从服务端导入内容，请另外放行服务端的 TCP 9202

  4. 确认服务端正在运行

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

  5. 版本检查

    • 两台电脑需要使用兼容的 FloSync 版本。运行不兼容版本的服务端根本不会出现在列表中，FloSync 只会提示一次已将其跳过
    • 将两台设备升级到相同版本

  6. 等待初始稳定

    • 网络同步建立连接后，可能需要短暂时间才能稳定
    • 初期出现少量校正属于正常现象
    • 稳定后，播放应持续平稳，并保持画面对齐

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

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

原因：连续运行数天不重启的电脑会逐渐相互偏离。这是长时间运行的电脑本身的特性，并非您的部署配置存在问题，也是无人值守的部署需要按计划重启的原因。

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

同步校正导致画面卡顿

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

解决方法：

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

上线直播问题

全屏窗口未出现

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

解决方法：

  1. 检查屏幕检测

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

  2. 检查视频是否已加载

    • 上线直播前需确保至少有一块屏幕已加载内容
    • 留意是否有"找不到文件"提示

  3. 检查演示模式

    • 演示模式使用虚拟显示器进行截图和演示，不支持全屏播放
    • 如果尝试上线直播，FloSync 会显示警告。请退出演示模式，再在真实显示器上重新上线直播

  4. 检查您使用的上线直播模式

    • 控制器模式是另一回事：它驱动已连接的电脑，而在您当前操作的这台机器上不会打开任何全屏窗口，这是有意为之。状态栏会以橙色显示"直播中（控制器）"
    • 如果您想在这台电脑上打开全屏窗口，请先停止，再改选「上线直播（当前场景）」

直播模式自行停止

现象：全屏直播在没有人手动停止的情况下结束，并提示显示器配置发生了变化。

原因：当节目播放期间显示器设置发生变化时（例如某块屏幕被拔出、关闭或重新排列），FloSync 会停止全屏直播。这种干净利落的停止是有意为之：如果继续在与实际配置不匹配的布局上播放，内容会出现在错误的屏幕上。

解决方法：

  1. **检查线缆与电源：**屏幕哪怕只是短暂断开又恢复，也会被视为一次变化
  2. **重新配置后再次上线：**将显示器恢复到您想要的状态后，点击「上线直播」
  3. 对于长期部署，请让屏幕与电脑接在同一电源线路（或同一插排）上，避免在非营业时段发生断电，并彻底禁用显示器休眠（参见同步优化）

按 ESC 无法退出直播模式

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

解决方法：

  1. 点击全屏窗口：在直播窗口上单击即可退出直播模式，效果与 ESC 相同。如果 ESC 不起作用，这是最快的退出方式
  2. 尝试停止按钮：该按钮仅在控制器模式下可用（此时控制面板始终可见），点击标有「停止控制器」的按钮。在全屏直播或排程模式下，控制面板被全屏窗口遮挡，无法用这种方式点击该按钮
  3. 必要时强制退出：可使用 Cmd+Q（macOS）或 Alt+F4（Windows），作为最后手段

应用程序问题

FloSync 无法启动

macOS 解决方法：

  1. 安全性设置

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

  2. 清除偏好设置

    • 如果 FloSync 能打开到偏好设置界面，请使用下方的重置功能，不要手动删除文件
    • 否则请删除 ~/Library/Application Support/com.tentekio.flosync/ 并重新启动 FloSync

Windows 解决方法：

  1. 清除偏好设置

    • 如果 FloSync 能打开到偏好设置界面，请使用下方的重置功能，不要手动删除文件
    • 否则请删除 %APPDATA%\Tentekio LLC\FloSync\ 并重新启动 FloSync
    • 如果 FloSync 完全无法打开，请重新安装

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

    • 从 Microsoft 官网下载最新版本

重置 FloSync（两个平台通用）：

打开偏好设置，滚动到危险操作，点击重置 FloSync 旁边的重置按钮。在弹出的确认框中点击重置并退出。这会清除您的偏好设置、排程和内容分配，然后退出应用，之后请重新启动 FloSync。

重置还会删除您的日志。如果您可能需要将日志发给技术支持，请先通过帮助 > 打开日志文件夹将它们复制出来。

CPU/内存占用过高

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

解决方法：

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

视频编码问题

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

快速解决：将视频转码为 H.264 All-Intra，可在所有平台上获得最佳的同步表现。ProRes LT 和 DNxHR HQ 也是受支持的替代方案，两者在 macOS 和 Windows 上均可使用。

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

已知限制

当前限制

  • 跨屏模式下，画面在屏幕边框处可能无法完美对齐
  • Wi-Fi 下的网络同步稳定性不如有线连接
  • 受 DRM 保护的内容无法播放
  • 超高分辨率视频（8K 及以上）在部分硬件上可能表现不佳
  • 直播模式下无法切换显示模式，需先退出直播
  • 网页无法跨屏展开，在跨屏模式下会以镜像方式显示
  • 网页仅支持 HTTPS 网址，不支持 HTTP
  • 网络同步会让视频画面在各电脑间保持逐帧对齐；图片和网页没有可同步的位置，但涉及图片或网页的场景切换仍会让所有电脑同时切换
  • 全局画布无法在 Windows 电脑和 Mac 之间导入，请在每台机器上分别本地配置
  • 无缝循环适用于 MP4 和 MOV 文件，其他格式会自动使用标准循环

获得最佳效果的建议

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