Dosarul OnSong^®

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

• manifest.json — articolul însuși, serializat. Fiecare proprietate pe care OnSong o cunoaște despre el, în aceeași formă pe care o folosește OnSong web API.
• Fișierul său, dacă are unul. Un atașament își 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, numite după ce sunt — songs, attachments — fiecare conținând mai multe foldere cu exact aceeași structură.

Această structură se repetă până la capăt: un set conține cântece, o cântec conține atașamente, și fiecare este o folder cu manifestul său alături de propriile sale fișiere. Un binder care ține o carte cu două sute de cântece are același format ca unul care ține un singur cântec.

În interiorul unui manifest, referințele la copii sunt marcate cu un prefix $binder., deci un cititor poate distinge diferența dintre o valoare care aparține articolului și una care indică o folder de lângă el.

Ce transportă

• Cântece — tabla de acorduri și tot ceea ce este atașat la ea.
• Seturi — cântecele în ordinea lor, cu aranjamentul propriului set.
• 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 de fapt în uz, mai degrabă decât fiecare versiune vreodată adăugată.

Binder sau Archive?

Ambele fac o copie fidelă 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 folosit pentru compatibilitate cu versiuni anterioare ale OnSong.
• OnSong^® Binder este cel curent. Folosiți-l pentru a împărtăși cu versiuni mai noi ale OnSong — și când doriți un fișier pe care îl puteți deschide și inspecciona.

Importarea și exportarea

Binderele se importează ca orice alt fișier: deschideți una 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 el; importarea unuia care ține o singură cântec adaugă acea cântec.

Pentru a crea una, 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 cântec sau un set, deci același format care trăiește în aplicația dvs. 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 la care trebuie să vă gândiți atunci când aveți nevoie să vedeți ce a stocat de fapt OnSong — sau atunci când ceva trebuie să citească conținutul dvs. și nu este OnSong.