OnSong^® Füzet

Az OnSong^® Binder fájlformátum az a módja, ahogy az OnSong egy dalt, egy készletet vagy egy teljes könyvet helyez át a könyvtárak között. Mint az OnSong^® Archive, tartalmazza az összes olyan információt, amely szükséges a tartalom máshol történő újraépítéséhez — a dal szövegét, mellékleteit, stílusait, beállításait, transzponálást és megjegyzéseket —, de míg az archívum egyetlen átlátszatlan blob, addig a kötés egy mappa, amely közönséges fájlokból áll. Ez lehetővé teszi az olvashatóságot, a vizsgálatot, és hogy a dal által függő médiumokat a dal mellett Platform-agnosztikus módon lehessen szállítani.

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

Mi van benne

A kötés egy ZIP-archívum. Ha kicsomagol egy kötést, egy mappát talál, amely az elem azonosítója után van elnevezve, és a következőket tartalmazza:

• manifest.json — maga az elem, szerializálva. Minden olyan tulajdonság, amelyről az OnSong tud róla, ugyanabban a formában, amelyet az OnSong webes API használ.
• Az archivo fájlja, ha van ilyen. A melléklet megtartja eredeti fájlnevét, tehát a kötésen belül egy PDF vagy egy MP3 csak az a PDF vagy MP3.
• Mappák a gyermekeihez, elnevezve arról, hogy mik azok — songs, attachments — mindegyik ugyanilyen formájú mappákat tartalmaz.

Ez a szerkezet mindaddig megismétlődik: egy készlet dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest mellett, amelynek saját fájljai vannak. A kétszáz dallal rendelkező könyvet tartalmazó kötés ugyanaz a formátum, mint az egyetlen ábrát tartalmazó kötés.

A manifestben a gyermekekre való hivatkozásokat $binder. előtaggal jelölik, így az olvasó meg tudja különböztetni az elemhez tartozó érték és az mellette található mappára mutatót.

Mit tartalmaz

• Dalok — az akkordgrafikon és mindaz, ami hozzá van csatolva.
• Készletek — a dalok sorrendjében, a készlet saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és bármely más, a dalhoz társított fájl. Dönthet úgy, hogy csak a ténylegesen használatban lévő mellékleteket foglalja be, nem pedig minden valaha hozzáadott verziót.

Kötés vagy archívum?

Mindkettő hűen körbefordul a könyvtár tartalma, így a választás arról szól, hogy mit kell a fájlból:

• OnSong^® Archive a régebbi 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 lehet nyitni és megnézni.

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

A kötések ugyanúgy importálódnak, mint bármely más fájl: nyisson meg egy fájlt a Fájlokból, Levelezésből, AirDropból vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. A készletet tartalmazó kötés importálása újra létrehozza a készletet és minden benne lévő dalt; egyetlen dalt tartalmazó kötés importálása hozzáadja azt a dalt.

Az elkészítéshez használja a Megosztás lehetőséget, és válassza az OnSong Binder formátumot.

A kötések az is, amit az OnSong Connect az eszközök között küld, amikor az egyik eszköz egy másiktól egy dalt vagy egy készletet kér, így az ugyanaz a formátum, amely a Fájlok alkalmazásban él, az, amely a hálózaton keresztül utazik.

Mivel a kötés egy ZIP-fájl, amely egyszerű JSON-ból és közönséges médiafájlokból áll, ez a megfelelő formátum, amikor meg kell nézni, hogy az OnSong ténylegesen mit tárol — vagy amikor valami másnak kell olvasnia a tartalmát, és nem OnSong.