OnSong^® Gyűjtő

A OnSong^® Binder fájlformátum az, amellyel az OnSong egy dalt, egy szettet vagy egy teljes könyvet mozgat könyvtárak között. Az OnSong^® Archive formátumhoz hasonlóan tartalmazza az összes szükséges információt a tartalom máshol történő újraépítéséhez — a dalszöveget, mellékleteket, stílusokat, beállításokat, transzpozíciókat és megjegyzéseket — de ahol az archívum egyetlen átlátszatlan blob, a binder egy közönséges fájlok mappája. Ez lehetővé teszi, hogy olvasható, ellenőrizhető legyen, és a platformfüggetlen módon a dal mellett a szükséges médiafájlokat is tartalmazhatja.

A OnSong^® Binder fájlformátum kiterjesztése .onsongbinder vagy .binder, a MIME típusa pedig application/onsong-binder.

Mi van benne

A binder egy ZIP-archívum. Kicsomagolva az elem azonosítójáról elnevezett mappát találsz, amely a következőket tartalmazza:

• manifest.json — az elem önmaga, szerializálva. Minden tulajdonság, amelyről az OnSong tud róla, ugyanabban a formában, amelyet az OnSong webes API használ.
• A fájlja, ha van neki. A melléklet megtartja az eredeti fájlnevet, így a bindertől belül egy PDF vagy egy MP3 csak egy PDF vagy MP3.
• Mappák annak gyermekeire, az elnevezésük szerint — songs, attachments — mindegyik pontosan ugyanolyan szerkezetű további mappákat tartalmaz.

Ez a struktúra ismétlődik végig: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik a maga manifest fájljával és saját fájljaival rendelkező mappa. A kétszáz dallal rendelkező könyvet tartalmazó binder ugyanaz a formátum, mint az egyetlen szot tartalmazó.

A manifest belsejében a gyermekekre való hivatkozások $binder. előtaggal vannak jelölve, így az olvasó meg tudja különböztetni az elemhez tartozó értéket attól, amely az mellette lévő mappára mutat.

Mit tartalmaz

• Dalok — az akkord-diagramm és az összes hozzá csatolt fájl.
• Szettek — a dalok sorrendben, a szett saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang- és bármilyen más fájl, amely egy dalhoz kapcsolódik. Választhatod, hogy csak a ténylegesen használt mellékleteket vagy az eddig hozzáadott összes verziót fogod belefoglalni.

Binder vagy Archive?

Mindkettő hűen visszajátssza a könyvtár tartalmát, ezért a választás arról szól, mire van szükséged a fájlból:

• Az OnSong^® Archive a régebbi formátum, és az OnSong korábbi verzióival való kompatibilitás miatt használandó.
• Az OnSong^® Binder a jelenlegi. Az újabb OnSong verzióval való megosztáskor használd — és amikor olyan fájlra van szükséged, amely megnyitható és megtekinthető.

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

A binderek ugyanúgy importálódnak, mint bármely más fájl: nyiss meg egy fájlt a Fájlokból, Mailből, AirDrop-ból vagy egy felhőszolgáltatásból, és válaszd az OnSong lehetőséget. Egy szettet tartalmazó binder importálása újra létrehozza a szettet és az összes dalban; egyetlen dalt tartalmazó binder importálása azt a dalt adja hozzá.

Egy létrehozásához használd a Megosztás lehetőséget, és válaszd az OnSong Binder formátumot.

A binderek az is, amit az OnSong Connect küld az eszközök között, amikor egy eszköz egy dalt vagy szettet kér egy másiktól, így ugyanez a formátum él a Fájlok alkalmazásodban és az a hálózaton keresztül utazik.

Mivel egy binder sima JSON és közönséges médiafájlok ZIP-je, ez a megfelelő formátum arra az esetre, amikor látni kell, hogy az OnSong valójában mit tárol — vagy amikor valami másnak kell olvasnia a tartalmadat, és az nem az OnSong.