NexaDeck 用户指南

入门指南

如果您尚未设置 NexaDeck，请先阅读入门指南。本节介绍安装后该做什么。

下载与安装

1. 登录客户门户并下载最新安装程序。
2. macOS：打开 .dmg 并将 NexaDeck 拖到「应用程序」。
3. Windows：运行 .msi 安装程序并按提示操作。
4. Linux：使用 .AppImage（通过 chmod +x 使其可执行）或安装 .deb 包。

首次启动

首次启动时，NexaDeck 打开到主界面。在运营演出之前，请在设置中配置音频输出和显示设置。

然后从曲库标签页导入您的卡拉OK曲库。

运营演出

NexaDeck 围绕演出这一概念构建——一个带有歌手轮转、歌曲队列和可选歌手间隙缓冲音乐的卡拉OK场次。

开始演出

在主界面点击开始演出。这将激活轮转队列并启用歌手管理。如果已连接到 NexaLive，演出将上线以接受观众点歌。

轮转队列

轮转队列是每场卡拉OK演出的核心。它决定歌手的演出顺序。

• 添加歌手——点击 + 按钮或输入名字将某人添加到队列。
• 重新排序——拖拽歌手上下移动以调整轮转顺序。
• 标记暂离——如果歌手暂时离开，将其标记为暂离，在返回前跳过。
• 歌曲队列——每位歌手有自己的队列。添加多首歌曲，NexaDeck 在轮到时自动选择下一首。

缓冲音乐

缓冲音乐在歌手间隙自动播放以保持气氛。在曲库标签页中将曲目添加到缓冲播放列表。NexaDeck 在缓冲曲目和卡拉OK表演之间淡入淡出。

处理点歌请求

连接到 NexaLive 后，观众可以从手机提交点歌请求。请求会出现在请求标签页中，并自动与您的曲库进行匹配评分。

匹配评分

每个请求都会自动与您的曲库进行比对。精确匹配会显示绿色徽章和对应曲目。部分匹配在歌名相同但歌手不同时显示橙色徽章。无匹配的请求显示红色徽章——该歌曲不在您的曲库中。

接受请求

点击接受并排队，将匹配的请求直接添加到歌手的队列中。对于部分匹配，您可以在接受前手动选择正确的曲目。在繁忙的演出中使用键盘快捷键可以提高效率。

拒绝请求

点击拒绝来拒绝请求。您可以选择性地附上说明原因的消息——例如，该歌曲在本场演出中已被演唱过。

管理曲库

曲库是 NexaDeck 中所有可用卡拉OK曲目的集合。支持 CDG+MP3 配对文件、MP4 视频文件和 ZIP 压缩包。

导入歌曲

前往曲库 > 导入并选择文件夹。NexaDeck 扫描支持的文件、读取元数据（歌名、歌手、时长）并添加到曲库中。大量导入在后台运行。

搜索与浏览

使用曲库顶部的搜索栏按歌名、歌手或文件名查找歌曲。结果在您输入时实时更新。您还可以按字母浏览或按最近添加筛选。

智能搜索

搜索栏可同时匹配歌名、歌手和品牌。输入任意关键词即可即时更新结果——无需指定搜索字段。

格式筛选

使用格式筛选下拉菜单仅显示特定格式：CDG（CD+Graphics）、MP4（视频卡拉OK）或全部。当您想查看某首歌曲有哪些可用格式时非常实用。

快速添加到轮转

将搜索结果直接拖拽到轮转中的歌手，即可立即加入队列。您还可以右键点击歌曲查看更多选项，包括添加到播放列表或查看曲目详情。

曲库侧边栏

曲库侧边栏提供对不同视图和工具的快捷访问：

• 所有歌曲——浏览您的完整曲库。
• 播放列表——创建和管理自定义播放列表，用于缓冲音乐或主题之夜。
• 导入——从电脑上的文件夹导入新歌曲。
• 歌本——生成并打印场馆用歌本。
• 下载——从连接的来源下载曲目。
• 元数据——编辑歌名、歌手和其他元数据。
• 维护——查找重复文件、缺失曲目和修复断链路径。
• 云同步——管理 NexaLive 曲库同步状态。

曲库健康与预检

健康仪表盘会扫描整个曲库，检测可能影响演出的问题。每次演出前运行审计，及早发现问题。

问题分类

审计检查以下问题：失效条目（磁盘上已不存在的文件）、损坏的 CDG 文件（受损或无法读取的图形）、截断的音频（突然中断的文件）、零字节文件、低比特率音频，以及音频和 CDG 轨道之间的时长不匹配。

演出前清单

运行完整审计，审查并解决所有高严重性问题，然后导出报告留档。干净的健康报告意味着演出不会出现意外。

歌手管理

NexaDeck 维护一个跨演出持久化的歌手目录。每个歌手档案追踪其历史、偏好和表演数据。

歌手目录

歌手目录是您所有曾在演出中演唱过的人的数据库。每个档案显示：

• 访问次数——参加了多少场演出。
• 总歌曲数——跨所有演出演唱了多少首歌。
• 偏好设置——NexaDeck 记住的每位歌手的音高和速度调整。

将歌手添加到演出

在演出期间，在轮转面板中输入名字即可添加歌手。NexaDeck 从歌手目录自动完成。新名字自动保存以供日后使用。

歌手档案

点击任何歌手的名字可打开详细档案。档案显示其完整的演出历史、最爱歌曲以及参加演出的次数。

备注与偏好

为任何歌手的档案添加个人备注——饮品偏好、生日提醒或歌曲风格偏好。备注仅在您的 NexaDeck 中可见，有助于提供个性化体验。

演出历史

历史标签页显示歌手演唱过的每首歌曲，按演出日期排列。可用于避免重复近期曲目，或推荐其许久未唱的最爱歌曲。

音频控制

NexaDeck 提供专业级音频处理，基于 Rust 引擎实现低延迟实时性能。

音高变调

以半音为单位上下调整任何曲目的音高。音高设置可按歌手保存，这样 NexaDeck 自动应用其偏好调性。

速度控制

在不影响音高的情况下加速或减速曲目。适用于需要稍微不同节奏的歌手或调整能量水平。

每首歌设置

每首歌可以有自己默认的音高、速度和音量设置。播放时自动应用这些设置。

音量与路由

独立控制主输出音量、麦克风混合和缓冲音乐音量。将音频路由到不同的输出设备——例如，将卡拉OK发送到场馆扬声器，将缓冲音乐发送到独立区域。在设置 > 音频中配置路由。

设置与配置

从右上角的齿轮图标访问设置。可用部分：

• 演出控制——默认演出选项、自动推进计时、缓冲音乐行为。
• 通用——应用语言、主题、启动行为。
• 音频——输出设备选择、采样率、缓冲区大小、路由。
• 外观——UI 主题、字体大小、显示输出配置。
• NexaLive——云连接设置。参见连接到 NexaLive。

演出控制

配置演出名称、设置轮转规则（每轮曲数、歌手限制）并管理会话计时。演出控制面板是决定当晚流程的指挥中心。

备份与恢复

通过定期备份保护您的曲库数据库、歌手记录和演出历史。

本地数据库备份

NexaDeck 在导入等重大操作前会自动备份数据库。您也可以在设置 > 维护中手动触发备份。备份存储在曲库旁边。

通过 NexaLive 云备份

连接到 NexaLive 后，曲库目录和歌手数据会自动同步到云端。这相当于异地备份——如果本地驱动器故障，可以从 NexaLive 账户恢复。

从备份恢复

恢复时，前往设置 > 维护 > 恢复并选择备份文件。NexaDeck 将用备份内容替换当前数据库。音频和 CDG 文件不受影响——仅恢复数据库（曲目元数据、歌手、演出历史）。

统计与分析

NexaDeck 追踪所有演出的详细表演数据。

仪表盘

统计仪表盘一览关键指标：总演出场次、总播放歌曲数、独立歌手数、每场平均歌曲数等。

排行榜

查看您演出中最受欢迎的内容：

• 热门歌曲——跨所有演出最常被点播和播放的曲目。
• 热门歌手——您最频繁和最活跃的表演者。
• 热门歌手（原唱）——轮转中最受欢迎的歌手。

演出历史

浏览您主持过的每场演出的时间线。每条记录显示日期、时长、歌手数量、播放歌曲和会话备注。

连接到 NexaLive

NexaLive 是 NexaDeck 的云端伙伴。它支持观众点歌、从手机远程 DJ 控制和为观众提供实时演出状态。

设置连接

1. 在 NexaDeck 中打开设置 > NexaLive。
2. 使用您的 Abydonian 账号凭据登录。
3. NexaDeck 将建立到 NexaLive 服务器的安全连接。绿色指示器确认连接已激活。

同步曲库

连接后，NexaDeck 将歌曲库同步到 NexaLive。观众即可浏览您的曲目并提交点歌请求。同步在后台运行——当您添加或删除歌曲时曲库保持最新。使用曲库 > 云同步检查同步状态。

接收请求

观众的点歌请求出现在主界面的请求标签页。每个请求显示歌名、请求者名字和提交时间。接受请求将其添加到歌手队列，或拒绝它。

连接状态

NexaLive 连接指示器出现在 NexaDeck 右上角。绿色表示已连接，黄色表示正在重连，红色表示已断开。如果连接中断，NexaDeck 会自动重连。

自助终端设置

每个场馆有一个唯一的自助终端码，观众在手机上输入该码来提交点歌请求。在设置 > NexaLive中配置自助终端码，并在场馆醒目位置展示。

连接故障排除

如果连接反复断开，请检查防火墙设置——NexaDeck 需要出站 HTTPS 访问。您也可以在高级连接设置中尝试切换 WebSocket 和轮询模式。

键盘快捷键

NexaDeck 支持键盘快捷键以快速控制演出。以下是默认绑定：

在设置 > 通用 > 键盘快捷键中自定义快捷键。

故障排除

您可能遇到的常见问题的解决方案。

音频问题

如果音频不播放，请在设置 > 音频中检查输出设备。确保选择了正确的设备且音量已调高。如果曲目能播放但声音异常，请尝试调整音高和速度控制——部分 CDG 曲目使用非标准编码。

CDG 显示问题

如果歌词显示乱码或颜色异常，CDG 文件可能已损坏。运行曲库健康审计以识别损坏的文件。从原始光盘重新提取通常可以解决问题。

NexaLive 连接

如果 NexaDeck 无法连接到 NexaLive，请检查网络连接并在设置 > NexaLive中确认凭据正确。底部栏的状态指示器显示当前连接状态。如果状态卡住，请尝试断开并重新连接。

导入错误

如果歌曲导入失败，请检查文件格式是否受支持（CDG+MP3、CDG+WAV 或 MP4）。文件必须可读且未被其他应用程序锁定。导入日志会显示每个失败文件的详细信息。

需要帮助？

如果您有疑问或遇到问题，请访问我们的联系页面或联系我们的支持团队。我们随时为您提供帮助。