Raccoglitore OnSong^®

Il formato file OnSong^® Binder è il modo in cui OnSong sposta una canzone, un set o un intero libro tra le librerie. Come OnSong^® Archive, contiene tutto il necessario per ricostruire il contenuto altrove — il testo della canzone, gli allegati, gli stili, le impostazioni, la trasposizione e le annotazioni — ma mentre un archivio è un singolo blob opaco, un binder è una cartella di file ordinari. Questo lo rende leggibile, ispezionabile e in grado di trasportare i media di cui una canzone dipende insieme alla canzone stessa in modo indipendente dalla piattaforma.

Il formato file OnSong^® Binder ha un'estensione di file di .onsongbinder o .binder e un tipo MIME di application/onsong-binder.

Cosa Contiene

Un binder è un archivio ZIP. Decomprimendone uno, troverai una cartella denominata in base all'identificatore dell'elemento, contenente:

• manifest.json — l'elemento stesso, serializzato. Ogni proprietà che OnSong conosce al riguardo, nella stessa forma che l'API web OnSong utilizza.
• Il suo file, se ne ha uno. Un allegato conserva il nome file originale, quindi un PDF o un MP3 all'interno di un binder è semplicemente quel PDF o MP3.
• Cartelle per i suoi elementi figlio, denominate in base a ciò che sono — songs, attachments — ognuna contenente più cartelle della stessa forma esatta.

Quella struttura si ripete tutto il percorso: un set contiene canzoni, una canzone contiene allegati, e ognuno è una cartella con il proprio manifest accanto ai propri file. Un binder che contiene un libro di duecento canzoni ha lo stesso formato di uno che contiene un singolo chart.

All'interno di un manifest, i riferimenti agli elementi figlio sono contrassegnati con un prefisso $binder., in modo che un lettore possa distinguere tra un valore che appartiene all'elemento e uno che punta a una cartella accanto ad esso.

Cosa Trasporta

• Canzoni — il chord chart e tutto ciò che vi è allegato.
• Set — le canzoni nel loro ordine, con l'arrangiamento del set.
• Libri — un'intera collezione.
• Allegati — PDF, immagini, audio e qualsiasi altro file associato a una canzone. Puoi scegliere di includere solo gli allegati effettivamente in uso anziché ogni versione mai aggiunta.

Binder O Archive?

Entrambi fanno un round-trip fedele del contenuto di una libreria, quindi la scelta riguarda ciò di cui hai bisogno dal file:

• OnSong^® Archive è il formato precedente, ed è quello da usare per la compatibilità con versioni precedenti di OnSong.
• OnSong^® Binder è quello attuale. Usalo per condividere con versioni più recenti di OnSong — e quando desideri un file che puoi aprire e ispezionare.

Importazione E Esportazione

I binder si importano come qualsiasi altro file: aprine uno da File, Mail, AirDrop o un servizio cloud e scegli OnSong. L'importazione di un binder che contiene un set ricrea il set e ogni canzone in esso; l'importazione di uno che contiene una singola canzone aggiunge quella canzone.

Per crearne uno, usa Condividi e seleziona OnSong Binder come formato.

I binder sono anche ciò che OnSong Connect invia tra i dispositivi quando un dispositivo chiede a un altro una canzone o un set, quindi lo stesso formato che risiede nella tua app File è quello che viaggia sulla rete.

Poiché un binder è un ZIP di JSON semplice e file media ordinari, è il formato corretto da scegliere quando hai bisogno di vedere cosa OnSong ha effettivamente memorizzato — o quando qualcos'altro ha bisogno di leggere il tuo contenuto e non è OnSong.