NeoN VJ 用户指南

新手指南 - 首次使用用户指南

购买前请阅读

1. 简介

什么是 NeoN VJ

NeoN VJ 是一款 iOS/iPadOS 应用，能够自动识别 DJ 活动中播放的音乐，并实时显示歌曲名称、艺术家名称和专辑封面。

支持外部显示器和投影仪输出，适用于 VJ 表演和直播。

运行环境

• 支持系统: iOS 15.6 及以上
• 支持设备: iPhone / iPad
• 网络连接: 必需
• 麦克风权限: 必需（用于音乐识别）

功能特性

• ✅ 自动识别并显示播放的音乐
• ✅ 输出到外部显示器/投影仪
• ✅ 自定义活动标志和背景
• ✅ 显示 DJ 名称
• ✅ 布局自定义（7 种预设）
• ✅ 8 种语言支持（日语、英语、西班牙语、法语、韩语、泰语、简体中文、繁体中文）

限制

• ❌ 无法离线识别歌曲
• ❌ 无法识别 Shazam 数据库中不存在的歌曲
• ❌ 无法分析录制的音频文件（仅限实时识别）

2. 快速入门

首次设置

首次启动应用时的重要步骤。

1. 启动应用

启动应用后，首次启动时会在3秒后自动显示欢迎教程。

• 教程分为 3 个步骤介绍基本使用方法
• 可以点击"跳过"按钮跳过教程
• 之后可以在设置界面重新查看教程

2. 允许麦克风访问

首次启动时，或首次点击"开始识别"按钮时，会请求麦克风访问权限。

3. 功能测试（推荐）

建议使用"麦克风测试"按钮确认音频输入是否正常工作。

开始歌曲识别

1. 点击"开始识别"按钮
2. 在有音乐播放的环境中等待
3. 识别成功后，会显示歌曲名称、艺术家名称和专辑封面

停止歌曲识别

点击"停止"按钮停止识别，返回"Searching..."界面

3. 基本操作

界面说明

控制按钮（屏幕左侧）

• 麦克风测试: 确认音频输入是否正常
• 开始/停止识别: 开始/停止歌曲识别
• 重新识别: 重新进行歌曲识别（仅在开始识别后显示）
• 设置: 打开详细设置界面
• 位置调整: 仅在连接外部显示器时显示
• 隐藏菜单: 隐藏控制按钮和日志显示，最大化显示区域

控制按钮（屏幕右侧）

• 全屏显示: 切换到全屏显示模式

状态显示（屏幕底部）

• 🟢 绿点: 正在识别歌曲，歌曲已显示
• 🟠 橙点: 正在识别歌曲，但未能识别
• ⚫ 灰点: 歌曲识别已停止

重新识别功能使用方法

重新识别功能在歌曲识别困难时，或前一首歌未切换时使用。

使用场景

• 歌曲切换未被识别时
• 在返回"Searching..."界面前希望继续识别时

使用方法

1. 点击屏幕左侧的橙色"重新识别"按钮
2. 超时时间将重置，进入 5 秒快速识别模式

4. 新手推荐设置

点击屏幕左侧的"设置"按钮打开设置界面。

更改布局

可以从7种预设中选择歌曲信息的显示位置。

1. 在设置界面找到"布局"部分
2. 点击"预设选择"
3. 选择您喜欢的布局

布局预设列表

• 居中: 专辑封面和歌曲信息居中显示（默认）
• 简约: 简洁小巧的显示
• 左对齐: 歌曲信息左侧显示
• 右对齐: 歌曲信息右侧显示
• 居中·封面底部: 专辑封面位于底部（居中）
• 左侧·封面底部: 专辑封面位于底部（左对齐）
• 右侧·封面底部: 专辑封面位于底部（右对齐）

设置活动标志

可以在屏幕右上角显示活动标志。

1. 在设置界面找到"活动标志设置"部分
2. 点击"选择标志图片"
3. 从相册中选择标志图片
4. 根据需要调整"标志大小"

显示 DJ 名称

可以在"Powered by NeoN"位置显示任意 DJ 名称。

1. 在设置界面找到"DJ 名称显示设置"部分
2. 启用"DJ 名称显示模式"
3. 在 DJ 名称栏输入要显示的 DJ 名称（最多可注册 20 个）
4. 使用单选按钮选择要显示的 DJ 名称
5. "切换间隔"设置"Powered by NeoN"和 DJ 名称的切换间隔（3-60 秒）

使用示例

• "DJ クロマティーゆうや Playing"
• "DJ SMYLE Playing"

调整歌曲识别精度

可以根据现场情况调整识别精度和速度的平衡。

1. 在设置界面找到"歌曲识别设置"部分
2. 从"识别预设选择"中选择以下选项之一

识别预设

5. 外部显示器输出

NeoN VJ 会自动检测外部显示器的连接，并开始专用显示。

有线连接方法（推荐）

1. 使用 iPad HDMI 适配器连接投影仪或显示器
2. 连接电缆后自动开始外部屏幕显示
3. iPad 本体用于操作，外部屏幕用于显示，自动开始工作
4. 连接成功时屏幕底部日志会显示"已开始在外部显示器上显示"

位置调整功能使用方法

当投影仪或外部显示器的画面稍有裁剪时，可以微调整个画面的显示位置。

操作方法

1. 在连接外部显示器的状态下启动应用
2. 点击屏幕左侧控制面板的"位置调整"按钮（变为绿色）
3. 显示十字键调整面板
4. 使用各按钮微调画面位置（每次点击移动屏幕的 5%）
   • ↑（向上箭头）: 整个画面向上移动
   • ↓（向下箭头）: 整个画面向下移动
   • ←（向左箭头）: 整个画面向左移动
   • →（向右箭头）: 整个画面向右移动
   • ●（中央按钮）: 位置重置为初始状态（居中）
5. 点击绿色"完成"按钮结束调整模式

6. Source 模式（NDI / HDMI 输出）

Source 模式将歌曲信息发送到外部 VJ 软件（OBS、Resolume 等）。使用 NDI 协议，同一网络上的 PC 和 Mac 可以直接接收输出。

Display 模式与 Source 模式的区别

NeoN VJ 有两种工作模式。

• Display 模式（默认）：在 iPad 或外接显示器上显示包含背景、标志和特效的完整画面。普通使用时选择此模式
• Source 模式：通过 NDI 将歌曲信息（曲名、艺术家、专辑封面）发送到外部软件。接收端的 VJ 软件可以自由合成内容。在 Source 模式下连接 HDMI 时，外接显示器也会显示 Source 模式画面，但背景为黑色

外部输出行为比较

Display 模式和 Source 模式的外部输出行为不同。

Display 模式 + HDMI

• 通过 HDMI 连接的外接显示器直接显示包含背景、标志和特效的完整画面
• iPad 作为操控设备，外接屏幕仅用于显示
• 适合直接投影到投影仪或显示器

Source 模式 + NDI（推荐）

• 歌曲信息以透明图层（带 Alpha 通道）的形式通过网络发送
• 接收端的 VJ 软件可以将歌曲信息叠加到自己的画面上
• 由于背景透明，只显示文字和专辑封面

Source 模式 + HDMI

• 在 Source 模式激活状态下连接 HDMI，外接显示器也会显示 Source 模式画面
• 但是，HDMI 不支持透明图层，因此背景显示为黑色
• 歌曲信息显示在黑色背景上

启用 Source 模式

1. 打开设置画面
2. 在"工作模式"部分，开启"启用 Source Mode (NDI/HDMI) [Beta]"
3. 画面切换到 Source 模式专用显示，NDI 发送自动开始

Source 模式画面布局

预览区域

画面中央显示通过 NDI 发送的视频的实时预览。您可以看到歌曲信息在透明图层上的渲染效果。

状态栏

画面顶部实时显示发送状态。

• NDI（绿色圆点）：NDI 正在发送
• fps：帧率
• ms：捕获延迟
• 接收器图标 + 数字：已连接的 NDI 接收器数量
• 分辨率：输出分辨率（1920x1080）

操控按钮

• Display：返回 Display 模式
• Start / Stop：开始/停止音乐识别
• Hold Display：锁定当前显示的歌曲信息（即使歌曲切换也保持显示）
• Retry：重新尝试音乐识别
• Blackout：保持 NDI 连接的同时暂时隐藏视频输出
• Settings：打开设置画面

输出元素选择

可以单独开启/关闭通过 NDI 发送的元素。

• Album Art：专辑封面
• Song Title：曲名
• Artist：艺术家名
• Powered by / DJ：署名显示 / DJ 名
• Searching Text：识别中的"Searching..."文字

布局预设（9 种）

Source 模式有专用的布局预设，用于选择输出元素的放置位置。

• Center：居中放置（默认）
• Center Top：居中靠上
• Center Bottom：居中靠下
• Center Left：靠左居中
• Center Right：靠右居中
• Top Left：左上角
• Top Right：右上角
• Bottom Left：左下角
• Bottom Right：右下角

NDI 接收端设置

前提条件

• iPad 和接收端 PC/Mac 必须在同一网络上
• 支持 NDI 的软件（OBS + NDI 插件、Resolume、vMix 等）

OBS 设置示例

1. 安装 OBS NDI 插件
2. 在 OBS 中添加"来源" → "NDI Source"
3. 从来源名称列表中选择"NeoN VJ"
4. 视频以透明图层形式接收，可以合成到其他来源之上

Source 模式故障排除

接收端找不到 NDI 源

1. 确认 iPad 和接收设备在同一 Wi-Fi 网络上
2. 确认 Source 模式已启用（状态栏中有绿色"NDI"指示器）
3. 检查防火墙是否阻止了 NDI 通信
4. 刷新 NDI 接收软件中的来源列表

视频卡顿或延迟

• 检查 Wi-Fi 信号强度（推荐使用 5GHz 频段）
• 减少网络上的其他流量
• 检查状态栏中的"drop"（丢帧数）是否在增加

7. 实用功能

自定义背景与滤镜设置

可以设置活动用的背景图片，并使用滤镜进行调整。

设置背景图片

1. 在设置界面找到"自定义背景设置"部分
2. 在"选择背景图片"中设置活动用背景图片
3. 启用"启用自定义背景"

滤镜调整

可以调整文字的可读性。

• 亮度: 背景的明亮度
• 对比度: 背景的对比度
• 饱和度: 背景的色彩鲜艳度
• 模糊: 背景的模糊程度
• 色相: 背景的色调
• 不透明度: 背景的不透明度

视频背景（仅 iPad）

可以显示视频背景。

上传视频

1. 在设置界面找到"自定义视频设置"部分
2. 启用"视频背景"
3. 将视频文件上传到插槽 1-5（点击各插槽的"添加"按钮）
4. 支持格式: MP4、MOV、M4V
5. 各插槽的开/关切换: 上传后，可以单独设置各视频的启用/禁用

播放模式

• 单一播放: 重复播放所选的 1 个视频（使用单选按钮选择视频）
• 顺序播放: 按顺序自动切换活动视频
• 随机播放: 以随机顺序自动切换活动视频

设置切换间隔

"切换间隔"设置 5-60 秒范围内的视频自动切换时间（仅在顺序播放/随机播放时有效）

容量限制

• 单个文件最大100MB
• 所有视频总计最大400MB
• 推荐分辨率: Full HD（1920×1080）以下
• 支持格式: MP4、MOV、M4V

语言设置

可以更改应用的显示语言。

1. 在设置界面找到"语言设置"部分
2. 选择您喜欢的语言

支持的语言

日语、英语、西班牙语、法语、韩语、泰语、简体中文、繁体中文

8. 故障排除

歌曲无法识别时

检查清单

1. ✅ 设备是否已连接到互联网
2. ✅ 使用麦克风测试按钮检查音频输入
3. ✅ 音乐音量是否足够
4. ✅ 周围噪音是否过大
5. ✅ 确认麦克风访问权限（设置→隐私→麦克风）

解决方法

• 确认识别稳定设置: 使用"Shazam 原生"模式提高识别速度
• 使用"重新识别"按钮: 识别过程中手动重新识别

麦克风访问被拒绝时

屏幕上会显示"麦克风访问权限"警告。

1. 点击"打开设置"按钮
2. 在 iOS 设置界面将"NeoN VJ"的麦克风访问设为 ON
3. 返回应用并重试"开始识别"

显示不清晰时

• 在文字颜色设置中切换白色文字/黑色文字
• 使用自定义背景时调整亮度/对比度
• 适当调整字体大小
• 调整自定义 Info 图片大小以提高可读性

外部显示器无显示时

1. 确认电缆连接
2. 确认外部显示器的输入切换
3. 确认 iPad 是否识别外部显示器
4. 在日志显示中确认"已开始在外部显示器上显示"消息

外部显示器画面被裁剪时

1. 使用位置调整功能: 点击屏幕左侧的"位置调整"按钮
2. 使用十字键微调画面位置（上下左右最多 20%）
3. 使用中央按钮重置位置
4. 调整完成后点击"完成"按钮结束

视频无法播放时（仅 iPad）

1. 确认视频文件是否为支持格式（MP4、MOV、M4V）
2. 确认文件大小是否在限制内（100MB 以下）
3. 确认视频插槽是否为"活动"状态
4. 单一播放模式时: 确认是否使用单选按钮选择了视频
5. 确认是在 iPad 上运行（iPhone 上无法使用视频功能）

应用崩溃时

1. 重启设备
2. 完全退出应用后重启
3. 在 iOS 设置中确认是否有足够的存储空间
4. 将应用更新到最新版本
5. 使用多个视频时: 减少视频数量以降低负载

9. 高级功能

运行模式设置

可以切换应用的运行模式。

iPhone 模式

• 适用于 iPhone 或 iPad mini 等小屏幕的显示尺寸
• 适合小屏幕或近距离显示

常规显示设置

可以详细调整各显示元素的大小。

可调整项目

• 专辑封面大小: 120-800 范围调整
• 歌曲名字体大小: 50-150 范围调整
• 艺术家名字体大小: 30-120 范围调整
• 标志大小: 30-200 范围调整
• 署名字体大小: 10-50 范围调整
• 自定义 Info 图片大小: 50-500 范围调整

大文字显示模式

仅文字的大型显示模式。

• 启用"大文字显示模式"后，会隐藏专辑封面，仅显示大型文字
• 更适合远距离观看
• 适合大型场地或宽广会场使用

视频背景（仅 iPad）

视频背景功能是 iPad 专用的高级功能。通过显示背景视频可以实现更豪华的演出效果。

外部显示器设置

可以访问高级外部显示器设置。

设置项目

1. 在设置界面找到"外部显示器"部分（需要启用"显示所有设置菜单"）
2. "外部显示器自动显示"的开/关切换
3. 确认连接状态（显示已连接的外部显示器信息）

详细识别参数调整

选择"自定义"预设后，可以单独调整以下项目。

• 历史保留期: 5-60 秒范围，设置参考过去识别结果的时间
• 判定阈值: 10-100% 范围，设置以何种概率确定歌曲
• 判定开始的最少识别次数: 1-10 次范围设置
• 连续识别时的即时变更次数: 2-5 次范围，设置同一首歌连续识别时的反应速度
• 静音超时: 10-120 秒范围，设置音乐未被识别时返回"Searching..."的时间

10. 退出应用

正常退出流程

1. 停止歌曲识别: 点击"停止"按钮结束识别
2. 确认设置保存: 更改设置后务必使用"保存"按钮保存
3. 主屏幕按钮/手势: 正常退出应用

长时间使用后退出时

• 使用视频背景或大量效果时，可能会给设备带来负载
• 退出应用后，建议让设备稍作休息

需要强制退出时

应用无响应时:

1. 打开应用切换器（双击主屏幕按钮，或向上滑动主屏幕栏）
2. 向上滑动 NeoN VJ 应用以强制退出
3. 建议重启 iPad

11. 支持信息

应用更新

请定期检查更新。包含新功能添加和错误修复。

• 您可以在App Store的"更新"标签中查看最新版本
• 建议开启自动更新

联系我们

如有任何疑问，请联系开发者。

邮箱: neondjcrew.contact@gmail.com

最后

感谢您使用 NeoN VJ！

应用提供了各种功能，但只使用您"想尝试"的功能也完全没问题！

请按照您的喜好自定义 NeoN VJ，尽情享受吧！