Raccoglitore OnSong^®

Il formato di file OnSong^® Binder è il modo in cui OnSong sposta una canzone, un set o un intero libro tra le librerie. Come l'Archivio OnSong^®, contiene tutto ciò che serve 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 da cui dipende una canzone insieme alla canzone stessa in modo indipendente dalla piattaforma.

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

Cosa Contiene

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

• manifest.json — l'elemento stesso, serializzato. Ogni proprietà che OnSong conosce su di esso, nella stessa forma utilizzata dall'API web OnSong.
• Il suo file, se ne ha uno. Un allegato mantiene 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 — contenenti ciascuna più cartelle della stessa forma esatta.

Questa struttura si ripete fino in fondo: un set contiene canzoni, una canzone contiene allegati, e ognuno è una cartella con il suo manifest accanto ai suoi file. Un binder contenente un libro di duecento canzoni è 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 in una cartella accanto ad esso.

Cosa Contiene

• Canzoni — il chord chart e tutto ciò che è allegato ad esso.
• 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 piuttosto che ogni versione mai aggiunta.

Binder O Archivio?

Entrambi trasportano fedelmente il contenuto di una libreria, quindi la scelta riguarda ciò di cui hai bisogno dal file:

• Archivio OnSong^® è il formato più vecchio ed è quello da usare per la compatibilità con versioni precedenti di OnSong.
• OnSong^® Binder è quello attuale. Usalo per la condivisione con versioni più recenti di OnSong — e quando vuoi un file che puoi aprire e ispezionare.

Importazione Ed 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 vive nella tua app File è quello che viaggia sulla rete.

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