OnSong^® Pärm

OnSong^®-bindningsfilformatet är hur OnSong flyttar en låt, en uppsättning eller en helt bok mellan bibliotek. Liksom OnSong^®-arkivet innehåller det 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 ogenomskinlig blob är en bindning en mapp med vanliga filer. Detta gör den läsbar, inspekterbar och kan bära de media som en låt är beroende av vid sidan av låten själv på ett plattformsagnostiskt sätt.

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

Vad som finns inuti

En bindning ä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 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 bindning är bara den PDF:en eller MP3:en.
• Mappar för dess underordnade, namngivna efter vad de är — songs, attachments — var och en innehåller fler mappar med exakt samma struktur.

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 bindning som innehåller en bok med två hundra låtar använder samma format som en som innehåller ett enskilt schema.

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 det bär

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

Bindning eller arkiv?

Båda runda-tripper ett biblioteks innehål troget, så valet handlar om vad du behöver från filen:

• OnSong^®-arkivet är det äldre formatet och är vad man ska använda för kompatibilitet med tidigare versioner av OnSong.
• OnSong^®-bindning är den nuvarande. 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.

Importering och exportering

Bindningar importeras på samma sätt som vilken annan fil som helst: öppna en från Filer, Mail, AirDrop eller en molntjänst och välj OnSong. Importering av en bindning som innehåller en uppsättning återskapar uppsättningen och varje låt i den; importering av en som innehåller en enskild låt lägger till den låten.

För att skapa en, använd Dela och välj OnSong Binder som format.

Bindningar är också vad OnSong Connect skickar mellan enheter när en enhet ber en annan om en låt eller en uppsättning, så samma format som finns i din Filer-app är det som reser över nätverket.

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