Caiet OnSong^®

Formatul de fișier OnSong^® Binder este modul în care OnSong mută o cântec, un set sau o întreagă carte între biblioteci. La fel ca OnSong^® Archive, conține tot ceea ce este necesar pentru a reconstrui conținutul în altă parte — textul cântecului, atașamentele, stilurile, setările, transpozițiile și adnotările — dar în timp ce un arhiv este un singur blob opac, un binder este un folder cu fișiere obișnuite. Aceasta îl face lizibil, inspectabil și capabil să transporte media de care depinde o cântec alături de cânteca însăși într-un mod 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 interior

Un binder este o arhivă ZIP. Dezarhivați-o și veți găsi un folder numit după identificatorul articolului, conținând:

• manifest.json — articolul în sine, serializat. Fiecare proprietate pe care OnSong o cunoaște despre acesta, în aceeași formă pe care o utilizează API-ul web OnSong.
• Fișierul acestuia, dacă are unul. Un atașament își 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 toată lungimea: un set conține cântece, o cântec conține atașamente, și fiecare este un folder cu propriul manifest alături de propriile fișiere. Un binder care ține o carte cu două sute de cântece are același format ca și unul care ț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 articolului și una care indică într-un folder de lângă acesta.

Ce transportă

• Cântece — progresiunea acordurilor și tot ceea ce este atașat acesteia.
• Seturi — cântecele în ordinea lor, cu propria aranjare a setului.
• Cărți — o colecție completă.
• Atașamente — PDF-uri, imagini, audio și orice alt fișier asociat unei cânteci. Puteți alege să includeți doar atașamentele care sunt cu adevărat în uz mai degrabă decât fiecare versiune vreodată adăugată.

Binder sau Archive?

Ambele fac o biografie corectă a conținutului unei biblioteci, deci alegerea este despre ceea ce aveți nevoie din 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. Utilizați-l pentru partajare cu versiuni mai noi ale OnSong — și atunci când doriți un fișier pe care îl puteți deschide și inspecta.

Importarea și exportarea

Binderele se importă ca orice alt fișier: deschideți-o din Files, Mail, AirDrop sau un serviciu cloud și alegeți OnSong. Importarea unui binder care ține un set recreează setul și fiecare cântec din acesta; importarea unuia care ține o singură cântec adaugă acea cântec.

Pentru a crea una, utilizați Share și alegeți OnSong Binder ca format.

Binderele sunt, de asemenea, ceea ce OnSong Connect trimite între dispozitive atunci când un dispozitiv cere altui dispozitiv o cântec sau un set, deci același format care se află în aplicația voastră Files este cel care circulă prin rețea.

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