Referensi format partitur · Jianpu 简谱 → JSON
Format JSON partitur guzheng
Online Guzheng memainkan notasi angka yang disimpan sebagai file JSON kecil. Seluruh formatnya adalah satu object dengan array measures — di sini ada semua field, contoh lengkap, dan prompt yang bisa kamu berikan ke AI bersama foto partiturmu.
Tiga langkah membuat partitur yang bisa dimainkan
- Berikan [prompt di bawah](#ai-prompt) ke AI apa pun bersama foto atau PDF partitur jianpu-mu.
- Simpan JSON yang dikembalikan sebagai file .json.
- Buka guzheng, pindah ke 🎼 Main Partitur, lalu klik 📂 Unggah partitur JSON.
Tidak ada yang diunggah ke server. File diproses di browser dan disimpan di local storage agar masih ada saat kamu kembali. Kamu juga bisa membuat partitur manual di ✏️ Editor Partitur lalu mengekspornya sebagai JSON.
Contoh lengkap
Dua birama — satu birama pentatonik naik, lalu tremolo, satu istirahat, dan satu nada satu oktaf lebih tinggi.
{
"version": 1,
"title": "Pentatonic Warm-Up",
"artist": "Your name (optional)",
"key": "D",
"tempo": 88,
"timeSignature": "4/4",
"measures": [
{ "notes": [
{ "degree": 1, "beats": 1 },
{ "degree": 2, "beats": 1 },
{ "degree": 3, "beats": 1 },
{ "degree": 5, "beats": 1 }
] },
{ "notes": [
{ "degree": 6, "beats": 2, "technique": "tremolo" },
{ "degree": 0, "beats": 1 },
{ "degree": 1, "octave": 1, "beats": 1 }
] }
]
}Field tingkat atas
| Field | Tipe | Deskripsi |
|---|---|---|
version | number | Selalu 1. Dicadangkan untuk perubahan format di masa depan. |
title | string | Ditampilkan di atas partitur. Jika kosong, memakai “Partitur Tanpa Judul”. |
artist | string, optional | Komposer, arranger, atau sumber. Ditampilkan di samping judul. |
key | string, optional | Huruf dari penanda 1=D — “D”, “G”, “Bb”, “F#”. Aplikasi mentranspos seluruh instrumen agar cocok, maksimal 7 semitone ke kedua arah. |
tempo | number | Ketukan per menit, 20–300. Nilai yang hilang atau tidak valid menjadi 80 dengan peringatan. |
timeSignature | string, optional | Tulis seperti yang tercetak, mis. “4/4” atau “2/4”. Menentukan jumlah ketukan per birama; default 4/4. |
youtube | object, optional | ID 11 karakter atau URL YouTube lengkap. Memuat panel beat karaoke. |
measures | array, required | Satu entry untuk setiap birama yang tercetak. Tidak boleh kosong. |
Field nada
Setiap entry dalam measures[n].notes adalah satu nada atau istirahat yang tercetak, sesuai urutan baca.
| Field | Tipe | Deskripsi |
|---|---|---|
degree | integer 0–7 | Angka jianpu yang tercetak. 0 adalah istirahat. 4 dan 7 dimainkan dengan press bend pada senar 3 dan 6 — tulis persis seperti yang tercetak. |
octave | integer −2…2, optional | Titik di atas angka → 1 (dua titik → 2). Titik di bawah → −1 (dua titik → −2). Hilangkan untuk oktaf tengah. |
beats | number 0–16, optional | Panjang dalam ketukan quarter-note. Default 1. Nilai buruk menjadi 1 dengan peringatan. |
technique | string, optional | Saat ini hanya tremolo (摇指). Yang lain diabaikan. |
Degree dan senar
Instrumen dituning pentatonik D — D, E, F♯, A, B berulang di 21 senar. Jianpu 4 dan 7 tidak punya senar sendiri; aplikasi memainkannya dengan press bend pada senar 3 dan 6 hijau, sama seperti pemain asli. Tulis 4 dan 7 seperti biasa, lalu aplikasi yang menangani sisanya.
| Degree | Pitch (nada dasar D) | Cara dimainkan | Warna senar |
|---|---|---|---|
| 1 | D | senar 1 di setiap kelompok | — |
| 2 | E | senar 2 di setiap kelompok | — |
| 3 | F♯ | senar 3 di setiap kelompok | hijau |
| 4 | G | press bend dari 3 (+1 semitone) | hijau |
| 5 | A | senar 4 di setiap kelompok | — |
| 6 | B | senar 5 di setiap kelompok | hijau |
| 7 | C♯ | press bend dari 6 (+2 semitone) | hijau |
Degree yang jatuh di luar rentang 21 senar ditampilkan merah di partitur dan dilewati saat playback, dengan peringatan di atas panel. Turunkan nilai octave atau transpos dengan Tuning.
Membaca ritme menjadi ketukan
beats menghitung ketukan quarter-note, jadi langsung cocok dengan garis bawah, tanda panjang, dan titik pada jianpu cetak. Gabungkan nada yang diikat menjadi satu nada dengan nilai totalnya.
| Tercetak | Nama | beats |
|---|---|---|
| 5 | angka biasa | 1 |
| 5 — | satu garis | 2 |
| 5 — — | dua garis | 3 |
| 5· | bertitik | 1.5 |
| 5 (satu garis bawah) | eighth | 0.5 |
| 5 (satu garis bawah, bertitik) | eighth bertitik | 0.75 |
| 5 (dua garis bawah) | sixteenth | 0.25 |
Prompt untuk mengubah partitur dengan AI
Salin ini, tempel ke ChatGPT, Claude, Gemini, atau asisten lain, lalu lampirkan foto atau PDF halaman jianpu yang jelas. Spesifikasinya sama seperti di atas, hanya ditulis untuk model.
Convert the attached jianpu (简谱, numbered musical notation) sheet music for guzheng into JSON.
Output ONLY a single JSON object — no commentary, no markdown code fence — with exactly this shape:
{
"version": 1,
"title": "song title as printed",
"artist": "composer / source (optional)",
"key": "D",
"tempo": 88,
"timeSignature": "4/4",
"measures": [
{ "notes": [
{ "degree": 3, "octave": 0, "beats": 1 },
{ "degree": 5, "beats": 0.5 },
{ "degree": 6, "beats": 0.5, "technique": "tremolo" },
{ "degree": 1, "octave": 1, "beats": 2 }
] },
{ "notes": [
{ "degree": 0, "beats": 1 },
{ "degree": 6, "octave": -1, "beats": 3 }
] }
]
}
Rules:
- One entry in "measures" per printed measure. Split at every barline, reading left to right, top row to bottom row.
- "degree": the printed digit 1–7. Use 0 for a rest.
- "octave": dots above the digit → 1 (two dots → 2). Dots below → -1 (two dots → -2). No dots → 0 (or omit).
- "beats": length in quarter-note beats. Bare digit = 1. One underline = 0.5, two underlines = 0.25. A small dot after the digit makes it 1.5× (dotted note, e.g. 1.5). Each dash "—" after a digit adds 1 beat (so "5 — —" = beats 3). Merge tied notes into one note with the summed beats.
- "key": from the "1=D" marking — the letter only, e.g. "D", "G", "Bb", "F#". The app auto-tunes to it.
- "tempo": the metronome marking (♩=88). If missing, estimate from the tempo word.
- "timeSignature": as printed, e.g. "4/4" or "2/4".
- "technique": optional. Use "tremolo" on notes marked 摇指 / tremolo. Omit otherwise.
- Optionally add "youtube": { "videoId": "11-char id" } if a backing/karaoke video is known.
- Grace notes and ornaments: skip them, keep only the main melody notes. For chords, keep the top (melody) note.
- Do not transpose anything — copy the digits exactly as printed. Degrees 4 and 7 are fine: the app plays them by press-bending strings 3 and 6.Model sering salah membaca scan yang padat. Muat hasilnya, dengarkan sekali dengan 👂 Dengarkan, lalu perbaiki apa pun yang salah di ✏️ Editor Partitur sebelum latihan.
Harap hanya ubah partitur yang secara legal boleh kamu gunakan
Partitur musik dilindungi hak cipta seperti karya lain. Ubah musik yang kamu tulis sendiri, musik yang kamu punya lisensinya, atau karya tradisional dan domain publik — dan simpan untuk diri sendiri kecuali haknya mengizinkan hal lain. Situs ini tidak menyimpan partitur pihak ketiga dan tidak pernah mengunggah milikmu: file tetap di browser-mu sendiri.
Demo bawaan dan semua latihan di Pelajaran adalah materi orisinal yang dibuat untuk situs ini, bebas kamu gunakan.