OnSong^® Binder

OnSong^® Bindar-filformatet är hur OnSong flyttar en låt, en uppsättning eller en hel bok mellan bibliotek. Som OnSong^® Arkiv innehåller den allt som behövs för att återskapa innehållet någon annanstans — låttexten, bilagor, stilar, inställningar, transponering och anteckningar — men där ett arkiv är en enda opak blob är en bindar en mapp med vanliga filer. Det gör den läsbar, inspekterbar och kan bära media som en låt är beroende av tillsammans med själva låten på ett plattformsoberoende sätt.

OnSong^® Bindar-filformatet har ett filnamnstillägg på antingen .onsongbinder eller .binder, och en MIME-typ på application/onsong-binder.

Vad som finns inuti

En bindar är ett ZIP-arkiv. Packa upp en och du hittar en mapp namngiven efter objektets identifierare, innehållande:

• manifest.json — själva objektet, serialiserat. Varje egenskap som OnSong känner till det, i samma form som OnSong-webbaserade API använder.
• Dess fil, om den har en. En bilaga behåller sitt ursprungliga filnamn, så en PDF eller en MP3 inuti en bindar är bara den PDF eller MP3.
• Mappar för dess underordnade, namngivna efter vad de är — songs, attachments — var och en innehållande fler mappar av exakt samma form.

Den strukturen upprepas hela vägen ner: en uppsättning innehåller låtar, en låt innehåller bilagor, och var och en är en mapp med sitt eget manifest bredvid sina egna filer. En bindar som innehåller en bok med två hundra låtar har samma format som en som innehåller ett enda leadark.

Inuti ett manifest markeras referenser till underordnade med ett $binder.-prefix, så en läsare kan skilja mellan ett värde som tillhör objektet och ett som pekar in i en mapp bredvid det.

Vad den bär

• Låtar — ackordtablaturen och allt som är kopplat till den.
• Uppsättningar — låtarna i deras ordning, med uppsättningens eget arrangemang.
• Böcker — en helt samling.
• Bilagor — PDF-filer, bilder, ljud och andra filer associerade med en låt. Du kan välja att endast inkludera bilagorna som faktiskt används istället för varje version som någonsin lagts till.

Bindar eller arkiv?

Båda återställer ett biblioteks innehål troget, så valet handlar om vad du behöver från filen:

• OnSong^® Arkiv är det äldre formatet och är vad du ska använda för kompatibilitet med tidigare versioner av OnSong.
• OnSong^® Bindar är den aktuella. Använd den för att dela med nyare versioner av OnSong — och när du vill ha en fil som du kan öppna och titta inuti.

Import och export

Bindrar importeras på samma sätt som alla andra filer gör: öppna en från Filer, E-post, AirDrop eller en molntjänst och välj OnSong. Att importera en bindar som innehåller en uppsättning återskapar uppsättningen och varje låt i den; att importera en som innehåller en enda låt lägger till den låten.

För att skapa en använder du Dela och väljer OnSong Bindar som format.

Bindrar är också vad OnSong Connect skickar mellan enheter när en enhet frågar en annan om en låt eller en uppsättning, så samma format som lever i din Filer-app är det som färdas över nätverket.

Eftersom en bindar är ett ZIP av vanlig JSON och vanliga mediafiler är det rätt format att gripa till när du behöver se vad OnSong faktiskt lagrat — eller när något behöver läsa ditt innehål och inte är OnSong.