Skip to main content

实时 MIDI

您可以使用 MIDI 设备通过 MIDI 音符和控制器变化实时控制您的 Udon 世界。

组件​

要开始在场景中使用 MIDI，请将 VRC Midi Listener 组件添加到你的 GameObject 之一。

VRCMidiListener

此组件通知 VRChat 你想要接收 MIDI 事件，并在需要时启动 MIDI 系统。你需要选择要接收的事件，按下"Active Events"切换按钮来选择它们——默认情况下没有选择任何事件，因此在开始测试之前请打开它们。你还需要选择将接收这些事件的 UdonBehaviour，将其选为 VRC Midi Listener 上的"Behaviour"。此 UdonBehaviour 可以在与 MIDI Listener 相同的 GameObject 上，也可以在任何其他对象上。

当你启动场景时，你可能会注意到自动添加了 VRCMidiHandler GameObject。这处理 MIDI 设备驱动程序并向所有监听器发送事件。不要自己添加此组件——它设计为自动添加和删除，以便 MIDI 设备只连接一次，并在有人离开世界时断开连接。

设备选择 - 编辑器​

你可以通过 VRChat SDK 选择设备，在 Unity 编辑器中测试 MIDI 事件。它保存在编辑器首选项中，因此 Unity 会记住你的设备用于每个项目。

Midi Utility Window

Midi Utility Selector

设备选择 - 运行时​

当您访问包含 MIDI 事件的世界时，VRChat 会尝试在您的机器上找到的第一个 MIDI 设备。如果您有多个设备并希望指定使用哪一个，可以将设备名称的一部分作为命令行参数传递。例如，如果您有一个在 Windows 中显示为"SchneebleCo MidiKeySmasher 89"的设备，可以将以下内容添加到启动选项/脚本中： --midi=midikeysmasher VRChat 会匹配部分名称并忽略大小写。了解所有其他启动选项：启动选项

示例场景​

访问 Udon Midi Test 示例世界，该世界读取并显示所有三种消息类型。