OnSong^® Binder

Az OnSong^® Binder fájlformátum az, ahogyan az OnSong egy dalt, egy szettet vagy egy teljes könyvet mozgat a könyvtárak között. Mint az OnSong^® Archive, tartalmazza az összes szükséges információt a tartalom máshol történő visszaépítéséhez — a dalszöveget, a mellékleteket, a stílusokat, a beállításokat, a transzponálást és a megjegyzéseket —, de míg az archív egy egyetlen átlátszatlan blob, a binder egy mappája az közönséges fájloknak. Ez teszi azt olvashatóvá, ellenőrizhetővé és képessé arra, hogy az adott dalhoz szükséges médiát platformfüggetlen módon magában hordozza magával.

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

Mi van benne

A binder egy ZIP-archívum. Ha kicsomagol egyet, találni fog egy mappát az elem azonosítójának megfelelően, amely a következőket tartalmazza:

• manifest.json — maga az elem, szerializálva. Minden tulajdonság, amelyről az OnSong tud róla, ugyanabban a formában, amelyet az OnSong web API használ.
• Saját fájlja, ha van. Egy melléklet megtartja az eredeti fájlnevét, így a binder belsejében lévő PDF vagy MP3 csak az a PDF vagy MP3.
• Mappák az alemeire, az azok nevei szerint elnevezve — songs, attachments — mindegyik ugyanolyan alakú több mappát tartalmaz.

Ez a struktúra egészen lefelé ismétlődik: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest mellett a saját fájljaival. Egy kétszáz dalt tartalmazó könyvet tartalmazó binder ugyanaz a formátum, mint egy egyetlen chart-ot tartalmazó.

Egy manifest belsejében az alemeire vonatkozó hivatkozások $binder. előtaggal vannak megjelölve, így az olvasó meg tudja különböztetni az elem tulajdonait tartalmazó értéket attól, amely egy mellette lévő mappára mutat.

Mit hordoz

• Dalok — az akkorábrázolás és minden, ami hozzá van csatolva.
• Szettек — a dalok sorrendben, a szett saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, audio és bármilyen más fájl, amely egy dalhoz társított. Dönthet úgy, hogy csak a ténylegesen használt mellékleteket tartalmazza, nem pedig az összes valaha hozzáadott verziót.

Binder vagy Archive?

Mindkettő hűen megfordítja a könyvtár tartalmát, így a választás arról szól, hogy mire van szüksége a fájlból:

• OnSong^® Archive az idősebb formátum, és ezt kell használni az OnSong korábbi verzióival való kompatibilitás érdekében.
• OnSong^® Binder a jelenlegi. Használja az újabb OnSong-verziókkal való megosztáshoz — és amikor olyan fájlra van szüksége, amelyet meg tud nyitni és meg tud nézni belülről.

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

A binderek úgy kerülnek importálásra, mint bármely más fájl: nyissa meg az egyiket a Fájlokból, Mailből, AirDropből vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. Egy szettettartalmú binder importálása újra létrehozza a szettet és minden dalát; egy egyetlen dalt tartalmazó importálása azt a dalt adja hozzá.

Egy létrehozásához használja a Megosztás lehetőséget, és válassza az OnSong Binder lehetőséget formátumként.

A binde rek az OnSong Connect által is küldöttek az eszközök között, amikor az egyik eszköz megkéri a másikat egy dalra vagy szettre, így ugyanaz a formátum, amely a Fájlok alkalmazásban található, az a hálózaton keresztül utazik.

Mivel a binder egy ZIP fájl, amely JSON-t és közönséges médiafájlokat tartalmaz, ez a megfelelő formátum, ha azt kell megtudnia, hogy az OnSong valójában mi tárolt — vagy amikor valaminek olvasnia kell a tartalmat, és az nem OnSong.