转盘上的乐谱（MusicXML 条目）

概述

使用 MusicXML 条目，你可以把真实、可读的乐谱附加到转盘的扇区上。每个扇区都会显示乐谱，当转盘停在该扇区时，获胜弹窗会显示乐谱并可播放，因此每次转动都会揭示下一首要阅读、练习或演奏的曲子。

在应用中，该设置称为 "启用 MusicXML 条目"（位于 转盘设计 中），你可以用 🎵 "插入乐谱" 按钮添加乐谱，该按钮会打开 "插入乐谱 MusicXML" 窗口。

为任何教授、学习或演奏音乐并希望加入一点随机性的人而设计，例如:

- 进行视奏、听音或热身训练的音乐教师

- 随机选择下一首曲子的钢琴和器乐课程

- 课堂音乐游戏、排练和练习轮换

- 已经使用 MusicXML 文件并希望重复利用的教育者。

请准备好以下几样东西:

- 什么是 MusicXML: 一种用于乐谱的开放文件格式，大多数记谱软件（MuseScore、Sibelius、Finale、Dorico 等）都能导出。

- 要使用的乐谱: 设备上的 .musicxml 文件，或可供粘贴的 MusicXML 文本。不接受压缩的 .mxl 文件，因此请导出为未压缩的 .musicxml。

- 已启用该功能: 在转盘设计中打开 "启用 MusicXML 条目"（见下方步骤）。

- 一个浏览器: 乐谱在浏览器中绘制和播放。

启用该功能。 打开 转盘设置（⚙️ 齿轮图标）并进入 转盘设计。勾选 "启用 MusicXML 条目"。(i) 提示对此进行了说明: "启用此功能后，您可以通过按 🎵 按钮插入可播放的乐谱条目"。
打开某个扇区的音乐窗口。 在你想要的条目旁边，按 🎵 按钮（"插入乐谱"）。这会打开 "插入乐谱 MusicXML" 窗口。
添加你的乐谱。 将 MusicXML 粘贴到 "MusicXML" 框中（占位文本为 "粘贴 MusicXML"），或使用 "选择 MusicXML 文件" 从设备中选择一个 .musicxml 文件；你也可以把文件拖到窗口上。乐谱一旦有效，就会出现乐谱的实时预览。
插入它。 按 "插入"。渲染后的乐谱会被放入该扇区，因此五线谱会显示在转盘上。
转动。 像往常一样转动转盘。停下后，获胜弹窗会显示所选乐谱。
查看并播放获胜项。 在获胜弹窗中，乐谱会被清晰地重新绘制，带有 播放 / 暂停 按钮和从头播放的重播按钮。播放会逐个音符进行，光标沿五线谱移动。

- 随机选曲: 在每个扇区填入不同的曲子，转动以选择接下来演奏什么。

- 视奏练习: 转动以揭示一段未见过的片段并当场视奏。

- 听音与热身: 转动以得到一个简短的乐句，听完播放后再模仿。

- 课程轮换: 由音阶、练习曲或曲目组成的转盘，让下一项被公平地选出。

- 使用压缩的 .mxl 文件或 PDF；只接受未压缩的 .musicxml，因此请在记谱软件中重新导出为 MusicXML。

- 粘贴并非完整乐谱的内容；文本必须以 <?xml 开头，并包含带声部列表的有效乐谱，否则无法显示。

- 一次添加多个文件；每个扇区插入一份乐谱（你会看到 "请一次只添加一个 MusicXML 文件。"）。

- 乐谱过大；存在大小限制，非常长的曲子只会从开头播放（见限制）。

- 忘记先启用该功能；只有勾选 "启用 MusicXML 条目" 后，🎵 按钮才会出现。

- "MusicXML 无效，无法显示乐谱。" 粘贴的文本不是完整、有效的 MusicXML 乐谱；请重新导出后再试。

- "请使用 .musicxml 文件。" 你选择的文件不是 .musicxml 文件。

- "MusicXML 太大。请使用较小的乐谱。" 乐谱超过大小限制；请缩短它或拆分到多个扇区。

- "无法读取 MusicXML 文件。" 无法打开文件；请检查它是否损坏后再试。

- "此乐谱可以插入并查看，但由于音乐较长，可能只能播放开头部分。" 乐谱可以显示，但播放受到限制（见限制）。

- 乐谱显示但不播放: 播放需要浏览器的音频，有些浏览器只有在你与页面交互后才开始发声，因此请再次按播放。

- 仅支持未压缩的 .musicxml 文件（或粘贴的 MusicXML 文本）；压缩的 .mxl 及其他格式不支持。

- 每份乐谱有大小限制（约 250 KB），并且每个扇区一次添加一份乐谱。

- 播放是一种跟随音符的简单合成音（并非真实乐器的录音），非常长的乐谱只会从开头播放。

- 乐谱在浏览器中渲染和播放，因此需要一个可使用音频的浏览器会话。

- 转盘上的扇区以图像形式显示乐谱；可播放的乐谱是你在获胜弹窗中看到的那一份。