Raccoglitore OnSong^®

Il formato di file OnSong^® Binder è il modo in cui OnSong sposta una canzone, una raccolta o un intero libro tra le librerie. Come OnSong^® Archive, 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. Decomprimi uno e troverai una cartella denominata secondo l'identificativo dell'elemento, contenente:

• manifest.json — l'elemento stesso, serializzato. Ogni proprietà che OnSong conosce a riguardo, nella stessa forma che utilizza l'API web di OnSong.
• Il suo file, se ne ha uno. Un allegato mantiene il suo nome file originale, quindi un PDF o un MP3 all'interno di 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 della stessa forma esatta.

Quella struttura si ripete fino in fondo: una raccolta 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 un singolo spartito.

All'interno di un manifest, i riferimenti agli elementi secondari 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 Contiene

• Canzoni — lo spartito di accordi e tutto ciò che è collegato ad esso.
• Raccolte — le canzoni nel loro ordine, con l'arrangiamento della raccolta.
• 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 trasportano il 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 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 E Esportazione

I binder si importano come qualsiasi altro file: apri uno da File, Mail, AirDrop o un servizio cloud e scegli OnSong. L'importazione di un binder che contiene una raccolta ricrea la raccolta e ogni canzone al suo interno; l'importazione di uno che contiene una singola canzone aggiunge quella canzone.

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

I binder sono anche quello che OnSong Connect invia tra i dispositivi quando un dispositivo chiede a un altro una canzone o una raccolta, 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 multimediali ordinari, è il formato giusto quando hai bisogno di vedere cosa OnSong ha effettivamente archiviato — oppure quando qualcosa ha bisogno di leggere il tuo contenuto e non è OnSong.