OnSong^® Binder

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong ein Lied, einen Song-Satz oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archiv enthält es alles, was zum Wiederherstellen des Inhalts an anderer Stelle erforderlich ist – den Liedtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen – aber während ein Archiv ein einziger undurchsichtiger Blob ist, ist ein Binder ein Ordner gewöhnlicher Dateien. Dies macht ihn lesbar, inspizierbar und in der Lage, die Medien, von denen ein Lied abhängt, neben dem Lied selbst auf plattformunabhängige Weise zu tragen.

Das OnSong^® Binder-Dateiformat hat eine Dateierweiterung von .onsongbinder oder .binder und einen MIME-Typ von application/onsong-binder.

Was ist darin enthalten

Ein Binder ist ein ZIP-Archiv. Entpacken Sie einen, und Sie werden einen Ordner finden, der nach der Kennung des Elements benannt ist und enthält:

• manifest.json – das Element selbst, serialisiert. Jede Eigenschaft, die OnSong darüber kennt, in der gleichen Form, die die OnSong-Web-API verwendet.
• Seine Datei, falls vorhanden. Ein Anhang behält seinen ursprünglichen Dateinamen, sodass eine PDF oder eine MP3 in einem Binder einfach diese PDF oder MP3 ist.
• Ordner für seine untergeordneten Elemente, benannt nach dem, was sie sind – songs, attachments – jeder enthält weitere Ordner mit genau der gleichen Struktur.

Diese Struktur wiederholt sich die ganze Zeit: ein Song-Satz enthält Lieder, ein Lied enthält Anhänge, und jedes ist ein Ordner mit seinem eigenen Manifest neben seinen eigenen Dateien. Ein Binder, der ein Buch mit zweihundert Liedern enthält, hat das gleiche Format wie einer, der nur ein einzelnes Chart enthält.

Innerhalb eines Manifests werden Verweise auf untergeordnete Elemente mit dem Präfix $binder. gekennzeichnet, damit ein Leser den Unterschied zwischen einem Wert, der zum Element gehört, und einem, der in einen Ordner daneben verweist, erkennen kann.

Was es trägt

• Lieder – das Akkord-Chart und alles, was daran angehängt ist.
• Song-Sätze – die Lieder in ihrer Reihenfolge mit der eigenen Anordnung des Song-Satzes.
• Bücher – eine ganze Sammlung.
• Anhänge – PDFs, Bilder, Audio und jede andere Datei, die mit einem Lied verknüpft ist. Sie können wählen, nur die Anhänge einzubeziehen, die tatsächlich verwendet werden, anstatt jede Version, die jemals hinzugefügt wurde.

Binder oder Archiv?

Beide geben den Inhalt einer Bibliothek getreu zurück, daher hängt die Wahl davon ab, was Sie aus der Datei benötigen:

• OnSong^® Archiv ist das ältere Format und sollte für die Kompatibilität mit früheren Versionen von OnSong verwendet werden.
• OnSong^® Binder ist das aktuelle. Verwenden Sie es, um mit neueren Versionen von OnSong zu teilen – und wenn Sie eine Datei möchten, die Sie öffnen und anschauen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie einen aus Dateien, Mail, AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der einen Song-Satz enthält, erstellt den Song-Satz und jedes Lied darin neu; das Importieren eines Binders, der ein einzelnes Lied enthält, fügt dieses Lied hinzu.

Um einen zu erstellen, verwenden Sie Teilen und wählen Sie OnSong Binder als Format.

Binder sind auch das, was OnSong Connect zwischen Geräten sendet, wenn ein Gerät ein anderes nach einem Lied oder einem Song-Satz fragt. Das gleiche Format, das in Ihrer Dateien-App vorhanden ist, ist also das, das über das Netzwerk übertragen wird.

Da ein Binder ein ZIP aus einfachem JSON und gewöhnlichen Mediendateien ist, ist es das richtige Format, wenn Sie sehen müssen, was OnSong tatsächlich gespeichert hat – oder wenn etwas Ihren Inhalt lesen muss und nicht OnSong ist.