OnSong^® Bindare

OnSong^® Binder-filformatet är hur OnSong flyttar en låt, ett set eller en hel bok mellan bibliotek. Som OnSong^® Archive innehåller den allt som krä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 ogenomskinlig blob är en binder en mapp med vanliga filer. Det gör den läsbar, inspektionsbar och kapabel att bära mediet som en låt är beroende av tillsammans med själva låten på ett plattformsagnostiskt sätt.

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

Vad som finns inuti

En binder är ett ZIP-arkiv. Packa upp en och du hittar en mapp döpt efter objektets identifierare, innehållande:

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

Den strukturen upprepas hela vägen ner: ett set innehåller låtar, en låt innehåller bilagor, och varje är en mapp med sitt eget manifest vid sidan om sina egna filer. En binder som innehåller en bok med två hundra låtar är samma format som en som innehåller ett enda sheet.

Inuti ett manifest är referenser till underordnade märkta 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 — ackordschemat och allt som är kopplat till det.
• Set — låtarna i sin ordning, med setets eget arrangemang.
• Böcker — en hel samling.
• Bilagor — PDF:er, bilder, ljud och andra filer associerade med en låt. Du kan välja att bara inkludera de bilagor som faktiskt används snarare än varje version som någonsin lagts till.

Binder eller arkiv?

Båda återger ett biblioteks innehål troget fram och tillbaka, så valet handlar om vad du behöver från filen:

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

Importera och exportera

Binders importeras på samma sätt som andra filer: öppna en från Filer, Mail, AirDrop eller en molntjänst och välj OnSong. Om du importerar en binder som innehåller ett set återskapas settet och varje låt i det; om du importerar en som innehåller en enda låt läggs den låten till.

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

Binders är också det som OnSong Connect skickar mellan enheter när en enhet ber en annan om en låt eller ett set, så samma format som finns i din Filer-app är det som färdas över nätverket.

Eftersom en binder är en ZIP av vanlig JSON och vanliga mediefiler ä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.