Caiet OnSong^®

Formatul de fișier OnSong^® Binder este modul în care OnSong mută o melodie, un set sau o întreagă carte între biblioteci. Ca și OnSong^® Archive, poartă totul ceea ce este necesar pentru a reconstrui conținutul în altă parte — textul melodiei, atașamentele, stilurile, setările, transpoziția și adnotările — dar unde un arhiv este un singur blob opac, un binder este un folder de fișiere obișnuite. Aceasta îl face ușor de citit, inspectabil și capabil să poarte media de care depinde o melodie alături de melodia însăși într-un mod neutru din punct de vedere al platformei.

Formatul de fișier OnSong^® Binder are o extensie de fișier de .onsongbinder sau .binder, și un tip MIME de application/onsong-binder.

Ce se află în interior

Un binder este o arhivă ZIP. Despachetează una și vei găsi un folder numit după identificatorul elementului, conținând:

• manifest.json — elementul în sine, serializat. Fiecare proprietate pe care OnSong o cunoaște despre acesta, în aceeași formă pe care o folosește API-ul web OnSong.
• Fișierul său, dacă are unul. Un atașament păstrează numele de fișier original, deci un PDF sau un MP3 din interior unui binder este doar acel PDF sau MP3.
• Foldere pentru copiii săi, numite după ceea ce sunt — songs, attachments — fiecare conținând mai multe foldere de exact aceeași formă.

Acea structură se repetă pe tot parcursul: un set conține melodii, o melodie conține atașamente, și fiecare este un folder cu manifestul propriu alături de propriile fișiere. Un binder care conține o carte cu două sute de melodii are același format ca unul care conține o singură progresie.

În interiorul unui manifest, referințele la copii sunt marcate cu un prefix $binder., deci un cititor poate face diferența între o valoare care aparține elementului și una care indică către un folder de lângă acesta.

Ce poartă

• Melodii — progresiunea acordurilor și totul atașat acesteia.
• Seturi — melodiile în ordinea lor, cu aranjamentul propriu al setului.
• Cărți — o colecție întreagă.
• Atașamente — PDF-uri, imagini, audio și orice alt fișier asociat unei melodii. Poți alege să incluzi doar atașamentele care sunt cu adevărat în uz, mai degrabă decât fiecare versiune vreodată adăugată.

Binder sau Archive?

Ambele rotunjesc conținutul unei biblioteci fidel, deci alegerea depinde de ceea ce ai nevoie din fișier:

• OnSong^® Archive este formatul mai vechi și este ceea ce trebuie să folosești pentru compatibilitate cu versiuni anterioare ale OnSong.
• OnSong^® Binder este cel actual. Folosește-l pentru a partaja cu versiuni mai noi ale OnSong — și când vrei un fișier pe care poți să îl deschizi și să privești în interior.

Import și Export

Binder-ele se importă așa cum se importă orice alt fișier: deschide unul din Files, Mail, AirDrop sau un serviciu cloud și alege OnSong. Importarea unui binder care conține un set reconstruiește setul și fiecare melodie din acesta; importarea unuia care conține o singură melodie adaugă acea melodie.

Pentru a crea unul, folosește Partajare și alege OnSong Binder ca format.

Binder-ele sunt, de asemenea, ceea ce OnSong Connect trimite între dispozitive când un dispozitiv o cere pe altul pentru o melodie sau un set, deci același format care se află în aplicația ta Files este cel care se deplasează peste rețea.

Deoarece un binder este un ZIP de JSON simplu și fișiere media obișnuite, este formatul potrivit atunci când trebuie să vezi ceea ce OnSong a stocat cu adevărat — sau când ceva trebuie să citească conținutul tău și nu este OnSong.