故障排除

视觉效果不响应音频#

1. 确认已连接音频文件或实时输入，并且处于活动状态。
2. 对于文件音源，按下播放；对于实时输入，启动所选的输入。
3. 使用内置的频谱显示组件进行测试，确认 Astrofox 正在接收音频。
4. 打开反应器，确认其输出电平表在变化。
5. 如果信号太弱，扩大频谱选区或降低 Max dB。
6. 确认目标控件已绑定到预期的反应器，并且其数值范围不是平的。

如果运动有延迟，降低反应器的平滑值。如果抖动过大，提高平滑值。在频谱模式下，较高的衰减值也会让输出下降得更慢。

找不到麦克风或 MIDI 设备#

• 当浏览器请求时，授予麦克风或 MIDI 权限。
• 确认设备已连接，并且其他应用程序可以使用它。
• 连接新设备后，刷新可用输入列表。
• 如果其他应用独占了该设备，请将其关闭。
• 在 macOS 桌面应用中，请在“系统设置”中检查 Astrofox 的权限。

桌面音频是否可用，取决于所选的屏幕共享源和操作系统。有些浏览器只提供标签页音频，而不提供系统级音频。

打开项目时缺少媒体#

本地图片和视频文件并不总能自动重新打开，尤其是在项目移动到另一台电脑之后。使用 Relink Media，为每个未解析的图层选择匹配的图片或视频。

音频不会存储在项目文件中。打开项目后，使用 Load audio 重新加载音轨。

归档或传输作品时，请将媒体文件与项目文件放在一起。

插件图层无法渲染#

1. 选择操作栏中的 Manage plugins，确认所需的插件已安装。
2. 如果是开发中的插件，修改文件后请重新加载它。
3. 检查其清单文件和引用的文件是否可以访问，并且服务端已启用 CORS。
4. 已发布的插件请使用 HTTPS；HTTP 仅在 localhost 上被接受。
5. 在浏览器开发者控制台中检查着色器编译错误或 worker 错误。
6. 确保动画使用 frame.time，而不是基于实际时间的计时器。

如果 worker 渲染一个预览帧的时间超过约 3 秒，或在导出期间超过 5 秒，它会被停止并标记为无响应，以便 Astrofox 的其余部分继续运行。

Save video 无法开始#

Save video 总是会打开导出对话框。在导出满足以下条件之前，确认按钮会保持禁用：

• 一个时长至少 5 秒的音频文件
• 开始时间早于结束时间
• 所选范围至少 5 秒
• 当平台可以提前选择保存位置时，已选择保存位置

仅有实时输入无法定义离线导出的时间轴。请在 Save Video 对话框中选择一个音频文件。

导出格式与预期不符#

网页版导出使用当前浏览器的 MediaRecorder 所支持的格式。如果需要特定的 MP4 或 WebM 编码器，请使用捆绑了 ffmpeg 的桌面应用。如果桌面应用找不到 ffmpeg，它会回退到浏览器兼容的方式。

桌面应用无法捕获音频#

麦克风输入需要麦克风权限。桌面音频还可能需要屏幕录制权限，以及一个确实包含音轨的捕获源。修改操作系统权限后，请重启 Astrofox。

旧项目丢失了元素#

Astrofox 会自动迁移受支持的 1.x 项目元素。不受支持或无法转换的元素会被移除，并在项目打开时报告。请保留原始 .afx 文件的备份，并参阅从 1.x 升级了解元素的对应关系。

报告 bug#

在 Astrofox issue tracker 中搜索或新建 issue。请附上 Astrofox 版本、网页版或桌面应用平台、操作系统和浏览器、复现步骤，以及可以安全分享时的最小项目。