Caiet OnSong^®

Formatul de fișier OnSong^® Binder este modul în care OnSong transferă o melodie, un set sau o întreagă carte între biblioteci. La fel ca OnSong^® Archive, acesta conține 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 în timp ce un arhiv este o singură blob opacă, un binder este un folder cu fișiere obișnuite. Acest lucru îl face ușor de citit, inspectabil și capabil să transporte media de care depinde o melodie alături de melodia însăși într-o manieră independentă de platformă.

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ăuntru

Un binder este o arhivă ZIP. Despachetați-l și veți 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 fișierului original, deci un PDF sau un MP3 din interiorul unui binder este doar acel PDF sau MP3.
• Folder-e pentru copiii săi, numiți după ceea ce sunt — songs, attachments — fiecare conținând mai multe folder-e de exact aceeași formă.

Această structură se repetă până la capăt: un set conține melodii, o melodie conține atașamente, și fiecare este un folder cu propria lui manifestă alături de propriile fișiere. Un binder care conține o carte de două sute de melodii are același format ca și unul care conține o singură diagramă.

În interiorul unei manifeste, 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 Transportă

• Melodii — diagrama acordurilor și totul ce este atașat la aceasta.
• Seturi — melodiile în ordinea lor, cu aranjamentul propriu al setului.
• Cărți — o colecție întreagă.
• Atașamente — PDF-uri, imagini, fișiere audio și orice alt fișier asociat unei melodii. Puteți alege să includeți doar atașamentele care sunt de fapt în uz, mai degrabă decât fiecare versiune vreodată adăugată.

Binder sau Archive?

Ambele reproduc cu fidelitate conținutul unei biblioteci, deci alegerea depinde de ceea ce aveți nevoie de la fișier:

• OnSong^® Archive este formatul mai vechi și este ceea ce trebuie utilizat pentru compatibilitate cu versiunile anterioare ale OnSong.
• OnSong^® Binder este cel actual. Folosiți-l pentru a partaja cu versiuni mai noi ale OnSong — și când doriți un fișier pe care îl puteți deschide și inspectiona.

Importare și Exportare

Binder-ele se importă ca orice alt fișier: deschideți unul din Fișiere, E-mail, AirDrop sau un serviciu cloud și alegeți 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, utilizați Partajare și alegeți OnSong Binder ca format.

Binder-ele sunt, de asemenea, ceea ce OnSong Connect trimite între dispozitive atunci când un dispozitiv îi cere altuia o melodie sau un set, deci același format care trăiește în aplicația dvs. Fișiere este cel care se deplasează în rețea.

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