Caiet OnSong^®

Formatul de fișier OnSong^® Binder este modul în care OnSong mută o melodie, un set sau o carte întreagă între biblioteci. Ca și OnSong^® Archive, conține tot ceea ce este necesar pentru a reconstrui conținutul în alt loc — textul melodiei, atașamentele, stilurile, setările, transpoziția și adnotările — dar în timp ce o arhivă este un singur blob opac, un binder este un folder cu fișiere obișnuite. Acest lucru o face lizibilă, inspectabilă și capabilă să transporte media de care depinde o melodie, alături de melodia în sine, î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. Despachetați-o și veți găsi un folder numit după identificatorul elementului, conținând:

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

Acea structură se repetă tot drumul: un set conține melodii, o melodie 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 melodii are același format ca unul care ține o singură diagramă.

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

Ce transportă

• Melodii — diagrama de acorduri și tot ceea ce i se atașează.
• 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 cu o melodie. Puteți alege să includeți doar atașamentele care sunt efectiv în uz în loc de fiecare versiune vreodată adăugată.

Binder sau Archive?

Ambele fac un ciclu complet al conținutului bibliotecii cu fidelitate, deci alegerea este despre ce aveți nevoie din fișier:

• OnSong^® Archive este formatul mai vechi și este ceea ce trebuie folosit pentru compatibilitate cu versiunile anterioare ale OnSong.
• OnSong^® Binder este versiunea actuală. Folosiți-o pentru a partaja cu versiuni mai noi ale OnSong — și atunci când doriți un fișier pe care să-l puteți deschide și inspecziona.

Importare și exportare

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

Pentru a crea unul, folosiț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 îi cere altuia o melodie sau un set, deci același format care trăiește în aplicația dvs. Files este cel care se deplasează pe rețea.

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