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'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 contenere 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 C'è Dentro

Un binder è un archivio ZIP. Decompattane uno 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 che utilizza l'API web OnSong.
• Il suo file, se ne ha uno. Un allegato mantiene il suo nome file originale, quindi un PDF o un MP3 dentro un binder è semplicemente quel PDF o MP3.
• Cartelle per i suoi elementi secondari, denominate in base a cosa sono — songs, attachments — ciascuna contenente più cartelle esattamente della stessa forma.

Quella 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 che contiene un libro di duecento canzoni ha lo stesso formato di uno che contiene una singola chart.

All'interno di un manifest, i riferimenti agli elementi secondari sono contrassegnati con un prefisso $binder., così un lettore può distinguere un valore che appartiene all'elemento da uno che punta a una cartella accanto ad esso.

Cosa Contiene

• Canzoni — la chart accordale 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 piuttosto che ogni versione mai aggiunta.

Binder O Archive?

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

• OnSong^® Archive è il formato più vecchio ed è quello da utilizzare per la compatibilità con le versioni precedenti di OnSong.
• OnSong^® Binder è quello attuale. Utilizzalo per condividere con le 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. Importare un binder che contiene un set ricrea il set e ogni canzone in esso; importarne uno che contiene una singola canzone aggiunge quella canzone.

Per crearne uno, utilizza 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 giusto da usare quando hai bisogno di vedere cosa OnSong ha effettivamente memorizzato — o quando qualcosa ha bisogno di leggere il tuo contenuto e non è OnSong.