Die Tools

Sieben Tools. Erst song_format, dann, was die Aufgabe braucht.

song_format

Keine Argumente. Gibt das ganze Format auf einmal zurück: die Form, die build_song nimmt, wie Takte und Akkorde geschrieben werden, jeden Stil mit seinen Grooves, Kits und seinem Drum-Genre, was ein Teil der Band sagen kann (die DRUMS-Zeile mit ihren Becken- und Fill-Worten und den sieben Presets, die JAM-Zeile), wie du die Band wie ein Drummer einsetzt, jede Energie, Farbe und Stimmung, die Griff-Notation und die Grenzen.

Auch als Ressource noise://format/guide verfügbar, damit ein Client, der Ressourcen unterstützt, es ohne Tool-Aufruf im Kontext halten kann. Die maschinenlesbare Hälfte ist noise://format/vocabulary.

capabilities

Keine Argumente. Was NØISE kann und was nicht, und welche Felder beim Laden eines Songs wirklich etwas ändern.

check_chords

{ "chords": ["Am", "F", "E7", "Bm7b5"], "key": "Am" }

Pro Akkord: ob NØISE ihn lesen kann und wo er sonst bricht, die kanonische Schreibweise, ob er diatonic, borrowed oder outside der Tonart ist, und ob ein Griff existiert.

Am -> Am (diatonic), grip xxx555
F -> F (diatonic), grip xx3211
E7 -> E7 (borrowed), grip 020100
Bm7b5 -> Bm7b5 (diatonic), no guitar grip

Die letzte Zeile lohnt genaues Lesen: der Akkord ist völlig erlaubt, er passt in die Tonart, und er wird gespielt. NØISE hat nur keinen Griff für ein m7b5 in der Bibliothek, also zeigt das Griffbrett nichts, es sei denn, du gibst selbst einen Griff an.

chord_shapes

{ "chords": ["F"], "category": "easy", "limit": 1 }

Echte Griffe aus der Bibliothek von NØISE, gezeichnet:

F - EASY - xx3211 - F easy (xx3211)
       1  2  3  4
 e  ·  1  ·  ·  ·
 B  ·  1  ·  ·  ·
 G  ·  ·  2  ·  ·
 D  ·  ·  ·  3  ·
 A  x  ·  ·  ·  ·
 E  x  ·  ·  ·  ·

Jeder kommt mit einem tag, das du direkt in build_song setzen kannst. Die Kategorien sind easy, open, barre, power und triads; gib eine tuning an, und die Griffe werden dafür abgeleitet (eine offene Stimmung hat keine, und die Antwort sagt das, statt nichts zurückzugeben).

Nimm das, statt Bundzahlen zu erfinden. Ein Modell, das Bünde rät, ist der einfachste Weg zu einem Song, der richtig aussieht und unspielbar ist.

build_song

Das wichtigste Tool. Nimmt einen Song, oder einen Teilentwurf plus einen mode, oder einen bestehenden Song, auf dem es aufbaut:

{
  "mode": "direct",
  "song": {
    "name": "What's Up",
    "author": "4 Non Blondes",
    "key": "A",
    "bpm": 132,
    "style": "rock",
    "sections": [
      { "name": "VERSE", "repeats": 2, "bars": ["A", "Bm", "D", "A"] },
      { "name": "CHORUS", "energy": "lift", "fillIn": "crash", "fillOut": "fill", "preset": "DRIVING", "bars": ["A", "Bm", "D", "A"] }
    ]
  }
}

Gibt den Link zur .noisesong-Datei, die Seite des Songs, eine Zusammenfassung, das Dokument und alle Warnungen zurück; einen noise://-Link nur mit link: true. fillGrips: true legt auf jeden Akkord ohne Griff einen aus der Bibliothek; mit gripCategory sagst du, welche Art.

Alles, was der Server nicht verwenden konnte, kommt als Warnung mit dem, was er stattdessen genommen hat, zurück: ein unbekannter Groove, ein bpm außerhalb von 20–300, ein Kit, das nicht zum Stil gehört, ein Preset-Name, den er nicht kennt, ein Becken-Wort, das die App noch nicht spielt. Er ändert deinen Song nie stillschweigend. Ein Teil, der einen eigenen band, jamKit oder ein eigenes drums-Genre nennt, wird abgelehnt, mit dem neuen Ort im Hinweis: ein Song ist eine Band mit einem Kit, und ein Teil sagt, wie diese Band spielt (feel, fillIn, fillOut, preset, die Regler, drumsOff).

validate_song

Dieselben Prüfungen, ohne Fragen und ohne Link. Zum Wiederholen, bis der Song stimmt, ohne etwas zu hinterlassen.

load_song

{ "source": "noise://song?d=…" }

Liest einen bestehenden Song – ein .noisesong-Dokument, einen noise://-Link oder eine id aus der Bibliothek – in dieselbe Form, die build_song nimmt. Das Schema übersteht den Round-Trip unverändert, du kannst also eine Sache ändern und neu bauen. Siehe Rezepte.