使用手册

连接和入门

要求和安装

你需要支持在线来源的Windows版VirtualDJ、本插件，以及可访问的UPnP/DLNA或OpenSubsonic/Subsonic音乐服务器。音乐服务器必须已将你的文件编入目录。已验证的服务器和元数据请参阅 兼容性列表.

对于手动安装，请关闭 VirtualDJ 和文件 MusicServer Connect.dll 在文件夹中 %LOCALAPPDATA%\VirtualDJ\Plugins64\OnlineSources 在该文件夹中，然后启动 VirtualDJ。替换现有 DLL 时也必须关闭 VirtualDJ。您可以在下面检查已安装的插件版本 关于 检查。

打开并连接插件

1. 在左侧浏览器树中打开VirtualDJ 在线音乐 → MusicServer Connect.
2. 通过曲目列表中的注册通知或通过插件条目的上下文菜单打开注册。 VirtualDJ也可以执行此命令 登录 命名它。
3. 选择发现的 UPnP 服务器或输入其 URL。对于 OpenSubsonic，还需输入您的用户名和密码或所需的 API 密钥。
4. 等待协议检测，点击 连接 或 登录.
5. 展开插件条目并打开 所有歌曲。初始库构建可能需要一些时间，具体取决于服务器和库大小。

重新连接 UPnP 并搜索服务器

连接对话框列出了网络上找到的 UPnP 服务器。选择一个服务器以使用其地址。当检测到 UPnP 时，用户名和密码保持禁用状态。对于手动设置，请输入服务器的可访问网络地址和端口。

列表左侧带有圆形箭头的按钮可再次开始服务器搜索。搜索时，图标旋转以显示列表 正在搜索UPnP服务器... 呈灰色，两个控件均已禁用。当服务器可用时，文本会变成白色。如果未找到服务器，该列表将保持灰色并禁用。手动输入的连接详细信息将被保留。

此搜索会发现服务器；它不会在 NAS 上启动新的音乐扫描。如果没有发现任何问题，请检查网络和正在运行的媒体服务器。您也可以直接输入已知的服务器地址。

登录OpenSubsonic/Subsonic

输入服务器的基本 URL，包括任何配置的子路径。使用您的音乐服务器帐户，该帐户独立于您的 Windows 用户和 VirtualDJ 帐户。该插件检测服务器协议并检查凭据。

Ampache和LMS需要API密钥才能登录。相关信息如下 服务器配置：API 密钥。该栏中还说明了您的产品需要进行哪些注册 一般 兼容性列表。

为 Windows 用户保存连接。该插件将访问数据存储在 Windows 凭证管理中。

注销并切换服务器

右键单击打开菜单 MusicServer Connect 并选择退出登录命令；VirtualDJ中的显示名称例如为 退出 并连接到所需的服务器。离线副本和本地 UPnP 播放列表属于服务器连接。通过自己的连接从其他服务器或帐户打开曲目。

删除已保存的连接并停止活动的插件操作。服务器上的音乐文件不会被删除。保存适当的连接以供离线使用。

图书馆和景观

所有曲目、收藏夹和随机曲目

所有歌曲

服务器通过正在使用的接口提供的所有媒体。根据服务器的不同，这可能包括视频。如果此处缺少文件，请先检查服务器目录。

收藏歌曲

您已标记为收藏的标题。 UPnP 和 OpenSubsonic 之间的存储有所不同；看到 收藏夹和播放列表.

随机歌曲

随机曲目选择。刷新视图以生成新的选择。

播放列表：...

由服务器提供或在插件中创建的播放列表。下面详细介绍这一点 播放列表.

离线曲目

完全保存当前连接的离线副本。该条目位于树的底部；向下滚动查看许多艺术家或专辑。

显示和隐藏视图

右键单击 MusicServer Connect 打开树设置。使用 显示/隐藏艺术家, 显示/隐藏相册 和 显示/隐藏流派 选择哪些组可见。每个菜单条目都提供下一个可用的操作：如果显示“隐藏”，则该组已经可见。

曲目艺术家和专辑艺术家

当显示艺术家时，您可以在同一菜单中进行选择 切换到曲目艺术家 和 切换到专辑艺术家 。曲目艺术家按其个人表演者对曲目进行分组。专辑艺术家将整张专辑组合在一起，包括与不同曲目艺术家的合辑。为当前连接保存该选择。

艺术家视图更改树中的分组。专栏 艺术家 如果服务器提供该曲目，则继续显示该曲目的艺术家。丢失信息或服务器汇总的信息可能会限制分配。

专辑和多种流派

相册视图使用服务器的相册分组。两个同名的相册可以是单独的服务器条目。例如，在 Navidrome 中，相册分组可以配置为 配置.

每个类型下都会出现一个多类型标题。 MusicServer Connect 使用单独的服务器值并且还拆分列表，例如 Techno/Hard Trance 或 Techno; Hard Trance 上。例如，括号中的分隔符仍然是该类型的一部分 Techno (Peak Time / Driving)。不会下载媒体文件，也不会更改其标签。标题中的流派文本仍然是服务器提供的信息。详情： 多种流派.

智能播放列表和特殊专辑列表

如果插件识别服务器的智能播放列表，根菜单还提供 显示/隐藏智能播放列表 上。服务器根据其规则计算此类列表。该插件不提供自己的智能播放列表规则编辑器。

OpenSubsonic也出现 最新专辑, 最常播放的专辑, 最近播放的专辑 和 评分最高的专辑。它们的内容取决于服务器的信息和功能。这些专辑列表与智能播放列表不同。

刷新库

打开子树节点的上下文菜单并选择 刷新。该插件重新加载库视图。如果报告音乐库已更改，请在刷新的树中再次选择所需的条目。

音乐服务器必须首先将新文件添加到其目录中。刷新插件不会取代此服务器扫描。还需要注册一条新曲目 本地VirtualDJ搜索 注册。

搜索功能

服务器在树节点中查询和搜索

选择插件根目录 MusicServer Connect 在VirtualDJ的搜索栏中输入关键词即可搜索服务器库。可用字段和结果取决于服务器。如果没有合适的 UPnP 搜索可用，则插件可以搜索其导入的目录。

在艺术家、专辑、流派或播放列表节点中，VirtualDJ 使用其本地搜索数据库。单独显示曲目并不会在那里注册它。因此，在插件 root 上进行搜索可能会找到节点搜索中仍然缺失的曲目。

将所有曲目添加到搜索数据库

1. 将插件连接到所需的服务器并打开 所有歌曲.
2. 清空搜索字段并等待完整列表。
3. 单击曲目列表并使用 Ctrl + A 所有曲目。
4. 从上下文菜单中选择 VirtualDJ 搜索数据库 → 添加到数据库.
5. 等待完成，打开所需的树节点并再次搜索。

此操作将曲目注册到 VirtualDJ 搜索数据库中。它不会复制音乐文件或分析 BPM。确切的菜单标签可能会因您的 VirtualDJ 版本和现有数据库状态而异。

添加曲目后重复

让服务器先读取新文件。然后刷新插件视图并重复录制 所有歌曲 带有一个空的搜索字段。可以再次选择已知的标题。服务器更改后，对新服务器使用相同的过程。

如果仍然缺少匹配项，请检查 VirtualDJ 的当前文件夹搜索选项和启用的搜索字段，尤其是标题和艺术家。如果缺少轨道 所有歌曲，原因先于本地节点搜索。另请参阅 故障排除.

曲目、播放和元数据

播放音频和视频

将歌曲从列表拖到转盘上或使用 加载到 在 VirtualDJ 上下文菜单中。 VirtualDJ 处理播放、预览、波形、分析和混音。 MusicServer Connect 提供适当的服务器源或现有的离线副本。

您还可以从服务器加载视频。打开VirtualDJ的视频区域进行预览和输出。服务器必须通过其接口公开视频，并且 VirtualDJ 必须支持其音频和视频编解码器。该插件不会修改该文件。看 音频和视频.

轨道菜单和多项选择

标记一个或多个标题并右键单击以打开上下文菜单。与 Ctrl 选择其他单独的曲目，以及 Shift 连续的范围和使用 Ctrl + A 完整显示的列表。

第一组命令通常用于添加或打开。抓住 Alt 打开上下文菜单以选择“删除”或“禁用”。然后您可以释放该键。所选操作适用于所有选定的轨道，即使它们之前的设置不同。

关于其他曲目菜单的提示

VirtualDJ启动后不会立即显示通知。VirtualDJ会在首次使用插件时启动插件。请在VirtualDJ的浏览器中打开MusicServer Connect。

如果尚未使用按住Alt键打开的曲目菜单，每次VirtualDJ会话都会显示一次提示。选中MusicServer Connect且VirtualDJ位于前台时，提示会在几秒后显示。

提示内容： „按住 Alt 键并右键单击曲目，即可显示另一个上下文菜单。单击此通知打开使用手册。“

单击通知或Windows通知区域中的相应图标，即可使用VirtualDJ中当前选择的语言打开手册的本节内容。

按住Alt键打开任意MSC曲目的上下文菜单一次后，插件会为当前Windows用户记住该操作。此后即使重新启动，也不会再显示提示。仅打开手册不会关闭提示。

按住Alt键时短暂出现键盘显示

按住Alt键时，VirtualDJ可能会短暂显示键盘按键映射。MSC上下文菜单仍可正常使用。如果该显示令你感到困扰，可以选择延迟显示或将其关闭。

选项1：延迟显示

键盘映射显示仍然可用，但只有较长时间按住Alt键后才会出现。延迟时间在VirtualDJ键盘映射中设置。

1. 将keyboardShowKeymapOverlay保持为“是”（Yes）。打开设置 → 控制器，选择Keyboard，然后打开映射编辑器（Edit Mapping/Advanced Editor）。
2. 选择ALT键并记下当前命令。在现有keyboard_shortcuts调用中添加所需的延迟。例如：

   keyboard_shortcuts 1500ms

3. 使用自定义名称保存修改后的键盘映射，并保持选中该映射。

1500ms表示1.5秒。快速按住Alt并右键单击时，通常可以避免显示键盘映射。MSC仍会立即识别按住的Alt键；延迟仅作用于VDJ键盘显示。

可根据需要调整时间；500ms表示半秒。要撤销修改，请恢复之前记下的命令。如果ALT映射包含其他命令，请仅修改keyboard_shortcuts调用。

选项2：开启或关闭显示

1. 通过齿轮图标打开VirtualDJ设置，然后选择选项。
2. 搜索keyboardShowKeymapOverlay。
3. 将keyboardShowKeymapOverlay设为“否”（No）。

此设置会隐藏键盘映射显示。现有键盘快捷键以及使用Alt切换MSC菜单的功能仍然可用。选择“是”（Yes）可重新启用显示。

此选项不提供针对Alt或AltGr的单独选择。用于触发显示的按键在VirtualDJ键盘映射中设置。

下载 …, 恢复原始封面 和 从音乐文件读取BPM和调性 位于分隔组的下方。这三个命令不会随Alt键而改变。VirtualDJ还会添加自己的编辑器和数据库命令。

插件命令为 收藏歌曲, 播放列表, 下载, 离线副本, 封面 和 BPM/钥匙 解释如下。编辑器和分析命令，例如 标签编辑器, BPM编辑器 或 分析BPM和标签 属于VirtualDJ，与读取现有文件标签的插件有不同的效果。

从标题中检测混音

全局检测将最后一个匹配的括号对的内容放入混音列中，并从标题列中删除这部分。例子： Superfreak (Freak) (Blakkat Remix) 显示为标题 Superfreak (Freak) 与混音 Blakkat Remix。服务器明确提供的混音字段优先。

从1.5版本开始，可以为单个或多个标题设置识别： 开启混音识别 在普通曲目菜单中启用它；与 Alt 打开菜单时出现 关闭混音识别。促销活动适用于整个选择。根菜单中的全局设置保留标题的初始值，没有任何具体定义。

两个命令都重建 来自源数据的标题和混音 再次。 开启混音识别 生成与打开检测的第一次调用相同的值。 关闭混音识别 采用完整的源标题，不分离；保留源的独立混音标签。

如果在 VirtualDJ 中编辑了标题或混音，则在覆盖之前会出现确认信息。对于多项选择，更改一个轨道就足够了：在处理整个选择之前，对话框会出现一次。 覆盖 将所有选定标题的两个字段替换为相应的源表示形式。与 取消 所有标题和混音值以及之前的曲目特定设置都将保留。服务器上的其他元数据和音乐文件保持不变。

VirtualDJ 保存当前服务器连接和帐户的轨道特定选择。相同的选择适用于您自己的播放列表中重复出现的该曲目。 MusicServer Connect不创建单独的轨迹数据库。

从 FRITZ!Box 文件名确定标题艺术家

如果有合适的 FRITZ!Box 连接，也会出现此情况 从文件名提取曲目艺术家。此可选帮助程序尝试从服务器提供的文件名作为标题派生缺少的艺术家。现有艺术家元数据优先。结果取决于命名模式；与 关闭从文件名提取艺术家 再次关闭该功能。

该菜单项在 Gerbera 上不可用。如果 Gerbera 返回类似“艺术家 - 标题”的标题，尽管有单独的艺术家字段，请检查其 在搜索结果中配置纯标题.

读取BPM和密钥

该插件首先使用 BPM 和服务器提供的键值。缺失值并不能证明音乐文件没有标签：某些服务器仅读取某些格式的标签或根本不读取它们。兼容性列表中描述了已知的限制。

1. 标记您想要的标题。
2. 选择 从音乐文件读取BPM和调性.
3. 等待处理。进度对话框显示已编辑的标题，可以通过以下方式打开 取消 完成。

该命令读取现有的文件标签；它不分析音频。该插件使用现有的离线副本或临时下载完整文件，然后删除临时文件。因此，大文件可能需要更长的时间。文件标签阅读器支持 MP3、FLAC、Ogg Vorbis/Opus、WAV、AIFF 和 MP4/M4A。其他格式仍然可以通过服务器提供元数据。

找到的有效值将应用于 VirtualDJ 中选定的插件轨道，并且可以替换现有的 BPM/键值。缺失值显示为 无信息 显示。文件和服务器数据库未更改。

恢复原始封面

如果封面丢失、不正确或过时，请标记受影响的标题并选择 恢复原始封面。该插件重新加载音乐服务器当前提供的封面并更新 VirtualDJ 中的显示。不需要重新启动。

服务器必须可访问并提供有效的图像。不执行互联网图像搜索。标签和音乐文件保持不变。如果保存失败，则保留之前的封面。

收藏夹和播放列表

更改保存在哪里？

添加和删除收藏夹

选择曲目并选择 添加到收藏。它们出现在下面 收藏歌曲。与 从收藏中移除 取消选择它。对于删除命令，按住 Alt 打开标题菜单时。音乐文件被保留。如果视图仍然显示旧状态，请更新它。

创建播放列表或添加标题

1. 标记您想要的标题并选择 添加到播放列表.
2. 在对话框中选择可编辑的播放列表。要创建一个，请选择 新建播放列表 … 并输入名称。
3. 确认 确定。标题将添加到所选列表中。

UPnP 服务器导入的播放列表文件无法使用此功能进行编辑，因此它们不作为可编辑目标提供。如果需要，创建您自己的包含所需曲目的 MSC 播放列表。对于 OpenSubsonic，缺少写入权限可能会阻止更改。

创建时，名称必须是唯一的。如果具有该名称的播放列表已存在，则会出现错误消息 已存在同名播放列表。请输入其他名称。 仅大小写、前导空格或尾随空格或等效 Unicode 表示形式不同的名称视为相同。这适用于本地 UPnP 播放列表和通过 OpenSubsonic/Subsonic 连接的服务器播放列表。现有的播放列表将被保留。要添加曲目，请在对话框中选择该播放列表。

删除条目并删除播放列表

打开可编辑的播放列表，标记相关条目并按住打开上下文菜单 Alt关键。选择 从播放列表中移除。该命令替换 添加到播放列表。如果某个曲目出现多次，则仅删除选定的播放列表条目。如果列表已更改，请刷新并再次选择该条目。

对于整个列表，打开播放列表节点的上下文菜单并选择 删除播放列表。确认报价 是 和 否。列表已删除；音乐文件被保留。这些命令仅适用于可编辑的播放列表。

顺序、重复的标题和格式

该插件保留服务器的播放列表顺序，包括重复的曲目。对 VirtualDJ 中的列进行排序可以更改可见顺序。如果服务器不支持视频，它们也可能不会出现在混合播放列表中。仅刷新插件无法修复服务器导入或排序错误。

服务器的软件决定服务器导入哪些播放列表文件。格式和已知偏差位于 兼容性列表。本地 MSC 播放列表与此无关；该对话框不会创建 M3U、WPL 或 XSPF 文件。

下载和离线使用

下载文件到文件夹

选择曲目并选择 下载 …。选择完整媒体文件的目标文件夹。导出使用服务器提供的下载格式。唯一的文件名可防止现有文件被覆盖。

导出的文件独立于托管脱机缓存存储在选定的文件夹中。您可以像其他本地文件一样在 VirtualDJ 中使用它们。下载失败不会作为完整文件发布。

保存供离线使用

选择突出显示的标题 保存供离线使用。该插件将完整的文件复制到本地缓存，然后在下面显示 离线曲目 。视频也保留其媒体类型。为完整文件留出足够的空间。

离线副本属于各自的服务器连接和帐户。它们不是一般的第二音乐库。托管存储如下 %LOCALAPPDATA%\MusicServerConnect\OfflineCache;使用插件中的菜单项删除副本。

进度、背景和队列

对话框 离线保存 显示曲目、项目计数和复制进度。 后台运行 在作业继续进行时关闭进度视图。通过上下文菜单 离线标题 → 查看下载队列 你再打开它。

停止

终止仍在运行或等待的离线作业。已完全保存的副本将被保留。

删除排队的作业

从队列中删除选定的作业。要删除已完成的副本，请改用 删除离线副本 在曲目菜单中。

无可用内存或复制错误

该插件报告了该问题。已完整保存的文件将被保留；在重试之前请检查存储空间和连接。

更喜欢缓存或在线流

在上下文菜单中 离线曲目 你选择 优先使用缓存 或 优先在线播放。该菜单提供了您可以切换的替代方案。当首选缓存时，插件使用有效的现有本地副本。如果没有，则需要在线资源。

当首选在线流式传输并且存在本地副本时，插件会检查服务器可用性，并在服务器无法访问时可能使用该副本。对于计划的离线使用，请选择 优先使用缓存，保存适当的连接并检查所有必需的轨道是否已完全复制。这不会使播放期间的网络故障触发无缝切换。

删除离线副本

标记相关标题并按住打开上下文菜单 Alt关键。选择 删除离线副本。这仅删除由插件管理的本地副本。服务器的原始文件和之前导出到您自己的文件夹的文件将被保留。如果没有本地副本，该曲目再次需要可访问的在线资源。

许可证、语言和帮助

打开在线手册

右键打开 MusicServer Connect 上下文菜单并选择 帮助。在线手册在标准浏览器中打开。无需在音乐服务器上注册。按照菜单操作 帮助 条目 关于 和 购买许可证;的 注册曲目 显示顺序。

查看版本和许可证状态

打开上下文菜单 MusicServer Connect → 关于。该对话框显示插件版本和许可证状态 演示 或 有效。经由 确定 关闭它。

加载许可证文件并使用演示

使用 MusicServer Connect → 购买许可证 打开您当前 VirtualDJ 帐户的购买页面。尚未启用销售。一旦可用，将自动激活；还将提供许可证文件和 PDF 发票供下载。请保留这两个文件。

1. 使用已发放License的账号登录VirtualDJ。
2. 打开 关于 → 加载许可证文件....
3. 选择正确的一个 .lic文件并确认选择。
4. 成功激活后，将显示“关于”对话框 许可证：有效.

用于许可的 VirtualDJ 帐户与您的音乐服务器帐户是分开的。如果许可证被拒绝，请检查其帐户分配和文件。如果未检测到您的 VirtualDJ 帐户，请先登录该帐户。

常规演示最多允许 20 流请求 和总体 十个离线副本。流请求与不同的轨道分开计数。删除脱机副本不会恢复已用的演示限额。购买的有效许可证可以消除这些演示限制。

语言和保存的设置

插件菜单和对话框遵循VirtualDJ的语言设置；没有单独的插件语言切换。未翻译的文本可能会以英文显示。视图和混音设置存储在本地。每个连接都会保存曲目与专辑艺术家选择和可选的 FRITZ!Box 检测。

故障排除

找不到服务器或登录失败

检查服务器地址、端口和网络连接。如有必要，重复 UPnP 发现。对于 OpenSubsonic，请根据需要使用正确的服务器帐户和 API 密钥。

到处都不见踪影

直接在音乐服务器中检查目录。服务器必须通过其使用的接口提供文件和格式。然后在插件中更新。

标题可见，但在树节点中不可搜索

的 将曲目添加到 VirtualDJ 搜索数据库 并检查当前文件夹的搜索选项。

艺术家出现在标题之前

检查服务器提供的标题。在 Gerbera 处 在搜索结果中配置纯标题 使用。这与可选的 FRITZ!Box 确定无关。

专辑多次出现或显示为未知

检查专辑和专辑艺术家标签以及服务器的专辑分组。没有可用标签的文件可能会出现在原始文件名下。该插件无法发明丢失的专辑信息。

播放列表包含的歌曲较少或顺序不同

检查服务器导入、支持的格式和视频支持。对 VirtualDJ 中的列进行排序可以更改可见顺序。兼容性列表中列出了已知的服务器限制。

播放失败

检查连接和权限。直接在 VirtualDJ 中打开同一文件以隔离编解码器问题。如果它属于其他服务器或帐户，请使用适当的连接。

播放列表或收藏夹操作失败

更新列表并检查服务器帐户权限。 UPnP 服务器播放列表是只读的；您自己的 MSC 列表可以在本地进行管理。

BPM，钥匙或盖子丢失

首先检查有效的服务器和标签映射。如果需要的话 读出现有的BPM/密钥文件标签 或者那个 重新加载服务器盖.

更多详情： 兼容性列表 · 服务器配置 · 音频和视频