OnSong^® Binder

Az OnSong^® Köteg fájlformátum az a módszer, amellyel az OnSong egyik könyvtárból a másikba mozgat egy dalt, egy szettet vagy egy teljes könyvet. A OnSong^® Archívumhoz hasonlóan magában hordozza mindazt, amely szükséges a tartalom máshol történő újraépítéséhez — a dal szövegét, mellékleteket, stílusokat, beállításokat, transzponálást és megjegyzéseket — azonban az archívum egy egyetlen, átláthatatlan blob, míg a köteg egy mappa közönséges fájlokkal. Ez teszi olvashatóvá, vizsgálhatóvá, és képessé arra, hogy az a médium, amelytől egy dal függ, platformfüggetlen módon a dal mellett járjon.

Az OnSong^® Köteg fájlformátum fájlkiterjesztése .onsongbinder vagy .binder, MIME-típusa pedig application/onsong-binder.

Mi van benne

A köteg egy ZIP-archívum. Csomagold ki, és találsz egy mappát az elem azonosítója után elnevezve, amely tartalmazza:

• manifest.json — maga az elem, szerializálva. Az OnSong minden tulajdonsága, amely rá vonatkozik, az ugyanolyan formában, mint az OnSong web API használja.
• Annak fájlja, ha van neki. A melléklet megtartja az eredeti fájlnevet, így egy PDF vagy egy MP3 a köteget egyszerűen az az PDF vagy MP3.
• Mappákat a gyermekelemeire, elnevezve azok szerint, hogy mik azok — songs, attachments — mindegyik több mappát tartalmaz pontosan ugyanolyan szerkezetben.

Ez a szerkezet egészen lefelé ismétlődik: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyiknek saját mappája van a saját manifest mellett a saját fájljaival. A köteg, amely egy kétszázdalos könyvet tartalmaz, ugyanaz a formátum, mint egy, amely egy egyedi diagramot tartalmaz.

A manifest-en belül a gyermekelemekhöz való hivatkozások $binder. előtaggal vannak jelölve, így az olvasó meg tudja különböztetni azt az értéket, amely az elemhez tartozik, attól az értéktől, amely a mellette lévő mappára mutat.

Mit hordoz

• Dalok — az akkord-diagram és minden, ami csatolt hozzá.
• Szettek — a dalok a sorrendben, a szett saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, audio és bármely más fájl, amely egy dalhoz kapcsolódik. Választhatsz úgy, hogy csak a ténylegesen használt mellékleteket foglalja bele, nem pedig az összes valaha hozzáadott verziót.

Köteg vagy archívum?

Mindkettő hűen körbe járja a könyvtár tartalmát, ezért a választás arról szól, hogy mit kell a fájlból:

• OnSong^® Archívum a régebbi formátum, és ezzel kell használni az OnSong korábbi verzióival való kompatibilitáshoz.
• OnSong^® Köteg a jelenlegi formátum. Használd az újabb OnSong-verziókkal való megosztáshoz — és amikor olyan fájlt szeretnél, amelyet meg tudsz nyitni és megnézhetsz.

Importálás és exportálás

A kötegek ugyanúgy importálódnak, mint bármely más fájl: nyiss meg egyet a Fájlokból, Levelezésből, AirDropról vagy egy felhőszolgáltatásból, és válaszd az OnSong lehetőséget. Egy szettet tartalmazó köteg importálása újra létrehozza a szettet és minden benne szereplő dalt; egy egyetlen dalt tartalmazó köteg importálása azt a dalt adja hozzá.

Egyetlen létrehozásához használd a Megosztás lehetőséget, és válaszd az OnSong Köteg formátumot.

A kötegek azok is, amiket a OnSong Connect küld az eszközök között, ha az egyik eszköz a másiktól egy dalt vagy egy szettet kér, így ugyanaz a formátum, amely a Fájlok alkalmazásban van, az, amely a hálózaton utazik.

Mivel a köteg egy ZIP-fájl, amely egyszerű JSON-ből és közönséges médiafájlokból áll, ez a helyes formátum, amelyhez akkor kell fordulni, ha látni szeretnéd, hogy az OnSong valójában mit tárolva — vagy amikor valaminek ki kell olvasnia a tartalmadat, és ez nem az OnSong.