This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | Last revision Both sides next revision | ||
|
api:note:zh [2023/10/16 11:35] hfsr [Available notes] |
api:note:zh [2023/11/29 14:23] hfsr [Note(音符) API] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| Note(音符) API | Note(音符) API | ||
| ======= | ======= | ||
| - | Note(音符) API提供了将音符转换为它们各自的MIDI编码和/或频率(单位为赫兹)的功能，以及一些其他东西。此API常与computer.beep和音符方块（来自OpenComponents模组）配合使用。 | + | Note(音符) API提供了将音符转换为它们各自的MIDI编码和/或频率（单位为赫兹）的功能，以及一些其他功能。此API常与`computer.beep`以及原版的音符盒（需安装OpenComponents模组）配合使用。 |
| - `note.midi(n: number or string): number` | - `note.midi(n: number or string): number` | ||
| - | 将字符串格式的音符（如 A#4 或 Gb3，查看下表）或给出的频率转换为MIDI编码。 | + | 将字符串格式的音符（如 A#4 或 Gb3，查看下表）或给出的频率转换为MIDI编码。 |
| + | \\ | ||
| - `note.freq(n: number or string): number` | - `note.freq(n: number or string): number` | ||
| - | 将字符串格式的音符（如 A#4)或给出的MIDI编码转换为频率。 | + | 将字符串格式的音符（如 A#4）或给出的MIDI编码转换为频率。 |
| + | \\ | ||
| - `note.name(n: number): string` | - `note.name(n: number): string` | ||
| - | 将MIDI编码转换回字符串。如果你需要转换频率，请用`note.name(note.midi(frequency))`。 | + | 将MIDI编码转换回字符串。如果你需要转换频率，请用`note.name(note.midi(frequency))`。 |
| + | \\ | ||
| - `note.ticks(n: number): number` | - `note.ticks(n: number): number` | ||
| - | 将音符方块的记号(0-24)转换为MIDI编码(分别对应34-58)，或者反过来。在与音符方块和OpenComponents配合使用时很有帮助。 | + | 将音符方块的记号（0-24）转换为MIDI编码（分别对应34-58），或者反过来。在与音符盒以及OpenComponents配合使用时很有帮助。 |
| + | \\ | ||
| - `note.play(tone: string or number,duration: number)` | - `note.play(tone: string or number,duration: number)` | ||
| - | 通过computer.beep演奏字符串或MIDI编码对应的音符，时长为duration参数。 | + | 通过`computer.beep`演奏字符串或MIDI编码对应的音符，时长为`duration`参数。 |
| ###可用音符 | ###可用音符 | ||