加载、搜索与调整弹幕样式

在播放时开启或关闭弹幕

播放视频时唤出控制栏，点“弹幕”按钮（图标标有“弹”或 DM）。在 iPhone 和 iPad 上切换“弹幕开关”；在 Mac 上选择“开启弹幕”或“关闭弹幕”。

当正在播放的视频和当前数据源支持公共弹幕时，Calyx TV 会自动加载弹幕时间线，并在你暂停、拖动进度条或倍速播放时保持同步。

手动搜索并加载匹配的剧集弹幕

如果没有自动匹配到弹幕，或者你正在播放本地 MKV/MP4 视频、片名未自动识别，可以在弹幕面板中点“搜索弹幕”。

输入片名关键词，从搜索结果中选择对应的剧集或电影，再点选当前观看的分集即可立即加载新弹幕。完成后点“完成弹幕搜索”回到播放画面。

调整显示区域、不透明度、字号与速度

在播放器控制栏打开“弹幕设置”，可以根据屏幕大小调整弹幕密度，避免遮挡画面主体或底部字幕：

所有修改都会在画面上实时生效：

• 显示区域：调整弹幕占屏幕高度的比例，范围从 20%（默认，仅顶部五分之一）到 100%（全屏）。
• 不透明度：在 20% 至 100% 之间调节（默认 80%）。
• 字号大小：在 24 至 64 之间调整弹幕文字大小（默认 36），适配手机、平板或桌面显示器。
• 弹幕速度：在 0.5×（较慢）至 2.0×（较快）之间调节滚动速度（默认 1.0×）。

校准弹幕延迟与切换彩色渐变预设

如果弹幕来自片头时长不同的视频版本，可以在“弹幕设置”中调节“弹幕延迟”，在 −10 秒到 +10 秒之间平移弹幕时间轴，不会影响原本的音画和字幕同步。

你还可以在同一面板中开启视觉增强选项：

• 边缘渐隐：让滚动弹幕在画面左右边缘平滑淡入和淡出。
• 彩色渐变：为普通白色弹幕应用从左到右的彩色渐变效果，自带颜色的弹幕则保留原色。
• 8 种渐变预设：提供 bilibili、甜蜜（Sweet）、赛博（Cyber）、日落（Sunset）、海洋（Ocean）、薄荷（Mint）、彩虹（Rainbow）以及混搭（Mix，按每条弹幕文本固定分配一种配色）。

弹幕不显示时的常见提示排查

开启弹幕后如果画面没有弹幕，请对照播放器提示排查：

• 没有可显示的弹幕：当前时间段没有弹幕或尚未匹配成功，可点“搜索弹幕”换简短片名重试。
• 当前视频不支持公共弹幕：该播放条目未开放公共弹幕功能。
• 当前播放器不支持弹幕：请到播放设置中切换为支持原生弹幕层的播放器配置。
• 弹幕文件超过 16 MiB 限制或未返回有效 XML：远端弹幕服务返回的数据过大或格式异常，可在“搜索弹幕”中改选其他分集来源。