OnSong^® Ordner

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong ein Lied, einen Satz oder ein ganzes Buch zwischen Bibliotheken verschiebt. Wie das OnSong^® Archiv enthält es alles, was erforderlich ist, um den Inhalt an anderer Stelle zu rekonstruieren — den Songtext, Anhänge, Stile, Einstellungen, Transposition und Anmerkungen — aber während ein Archiv ein einzelner undurchsichtiger Blob ist, ist ein Binder ein Ordner mit gewöhnlichen Dateien. Dies macht es lesbar, inspizierbar und in der Lage, die Medien, von denen ein Lied abhängt, zusammen mit dem Lied selbst auf eine plattformunabhängige Weise zu transportieren.

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

Was sich darin befindet

Ein Binder ist ein ZIP-Archiv. Wenn Sie einen entpacken, finden Sie einen Ordner mit dem Namen des Elementbezeichners, der Folgendes enthält:

• manifest.json — das Element selbst, serialisiert. Jede Eigenschaft, die OnSong darüber kennt, in der gleichen Form wie die OnSong Web API verwendet.
• Seine Datei, falls vorhanden. Ein Anhang behält seinen ursprünglichen Dateinamen bei, 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 exakt der gleichen Struktur.

Diese Struktur wiederholt sich bis zum Ende: Ein 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 ein einzelnes Chart enthält.

Innerhalb eines Manifests sind Verweise auf untergeordnete Elemente mit einem $binder.-Präfix gekennzeichnet, sodass ein Reader den Unterschied zwischen einem Wert, der zum Element gehört, und einem Wert, der auf einen Ordner daneben verweist, erkennen kann.

Was es transportiert

• Lieder — das Akkorddiagramm und alles, das damit verbunden ist.
• Sätze — die Lieder in ihrer Reihenfolge, mit der eigenen Anordnung des Satzes.
• Bücher — eine ganze Sammlung.
• Anhänge — PDFs, Bilder, Audio und alle anderen Dateien, die mit einem Lied verknüpft sind. Sie können wählen, nur die Anhänge einzubeziehen, die tatsächlich verwendet werden, anstatt jede jemals hinzugefügte Version.

Binder oder Archiv?

Beide transportieren den Inhalt einer Bibliothek getreu hin und her, die Wahl hängt daher davon ab, was Sie von 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 Format. Verwenden Sie es, um es mit neueren Versionen von OnSong zu teilen — und wenn Sie eine Datei möchten, die Sie öffnen und ansehen können.

Importieren und Exportieren

Binder werden wie jede andere Datei importiert: Öffnen Sie eine aus Dateien, Mail, AirDrop oder einem Cloud-Dienst und wählen Sie OnSong. Das Importieren eines Binders, der einen Satz enthält, erstellt den Satz und jeden darin enthaltenen Song 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 Gerät nach einem Lied oder einem Satz fragt. Das gleiche Format, das sich in Ihrer Dateien-App befindet, ist also das, das über das Netzwerk übertragen wird.

Da ein Binder eine ZIP-Datei aus reinem 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.