OnSong^® Binder

Das OnSong^® Binder-Dateiformat ist die Art und Weise, wie OnSong ein Lied, einen Song-Satz oder ein ganzes Buch zwischen Bibliotheken bewegt. Wie das OnSong^® Archive enthält es alles, was notwendig 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 gewöhnlicher Dateien. Dies macht ihn lesbar, überprüfbar und in der Lage, die Medien, auf die ein Lied angewiesen ist, neben dem Lied selbst auf plattformunabhängige Weise zu transportieren.

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

Was ist drin?

Ein Binder ist ein ZIP-Archiv. Entpacken Sie eines und Sie finden 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, die 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 hält weitere Ordner mit genau der gleichen Struktur.

Diese Struktur wiederholt sich den ganzen Weg hinunter: Ein Satz enthält Songs, ein Song enthält Anhänge, und jeder ist ein Ordner mit seinem eigenen Manifest neben seinen eigenen Dateien. Ein Binder mit einem Buch von zweihundert Songs hat das gleiche Format wie einer mit einem einzelnen Chart.

Innerhalb eines Manifests werden Verweise auf untergeordnete Elemente mit einem $binder.-Präfix gekennzeichnet, sodass ein Leser unterscheiden kann, ob ein Wert zum Element gehört oder auf einen Ordner daneben verweist.

Was er trägt

• Songs – das Akkorddiagramm und alles, das damit verbunden ist.
• Sätze – die Songs in ihrer Reihenfolge, mit der eigenen Anordnung des Satzes.
• Bücher – eine ganze Sammlung.
• Anhänge – PDFs, Bilder, Audio und jede andere Datei, die einem Song zugeordnet 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 transportieren den Inhalt einer Bibliothek treu hin und zurück, daher ist die Wahl davon abhängig, was Sie aus der Datei benötigen:

• OnSong^® Archive 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 zum Teilen mit neueren Versionen von OnSong – und wenn Sie eine Datei möchten, die Sie öffnen und inspizieren 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 Satz enthält, erstellt den Satz und jeden Song darin neu; das Importieren eines mit einem einzelnen Song fügt diesen Song 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 um einen Song oder einen Satz bittet, daher ist das gleiche Format, das in Ihrer Dateien-App vorhanden ist, auch das, das über das Netzwerk reist.

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.