OnSong^® Gyűjtő

A OnSong^® Binder fájlformátum az, ahogy az OnSong egy dalt, egy szerkesztést 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 való újraépítéséhez — a dal szövegét, mellékleteket, stílusokat, beállításokat, transzponálást és megjegyzéseket — de míg az archívum egyetlen átlátszatlan blob, a binder egy közönséges fájlok mappája. Ez lehetővé teszi, hogy olvasható, vizsgálható legyen, és a platformtól függetlenül hordozza az adott dalhoz szükséges médiumot magával.

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

Mi van benne

A binder egy ZIP-archívum. Kicsomagol egy -et, és találni fogsz egy mappát, amely az elem azonosítója után van elnevezve, és tartalmaz:

• manifest.json — maga az elem, szerializálva. Minden tulajdonság, amelyről az OnSong tud, ugyanabban a formátumban, amely a OnSong webes API-ja használ.
• Annak fájlja, ha van neki. A melléklet megtartja az eredeti fájlnevet, így egy PDF vagy egy MP3 a binderben csak az a PDF vagy MP3.
• Mappákat annak gyermekeihez, azok neve alapján elnevezve — songs, attachments — mindegyik több mappát tartalmaz pontosan ugyanabban az alakban.

Ez a szerkezet egészen lefelé ismétlődik: egy szerkesztés dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest mellett a saját fájljaival. A kétszáz dalt tartalmazó könyvet tartalmazó binder ugyanabban a formátumban van, mint az egyetlen chart-ot tartalmazó.

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

Mit szállít

• Dalok — az akkord chart és minden, ami hozzá van csatolva.
• Szerkesztések — a dalok sorrendjükben, a szerkesztés 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 társul. Választhatsz, hogy csak a ténylegesen használatban lévő mellékleteket tartalmazza, nem pedig minden valaha hozzáadott verziót.

Binder vagy Archive?

Mindkettő hűen átfordítja a könyvtár tartalmát, így a választás arról szól, hogy mit kell az fájlból:

• OnSong^® Archive a régebbi formátum, és az OnSong korábbi verzióival való kompatibilitáshoz szükséges.
• OnSong^® Binder a jelenlegi. Használd az újabb verzióival való megosztáshoz — és amikor olyan fájlra van szükséged, amely megnyitható és belsejébe lehet nézni.

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

A binderek ugyanúgy importálódnak, mint bármely más fájl: nyiss meg egyet a Files, Mail, AirDrop vagy egy felhőszolgáltatásból, és válassz OnSong. Az egy szerkesztést tartalmazó binder importálása újra létrehozza a szerkesztést és minden dalot benne; az egyetlen dalt tartalmazó importálása hozzáadja azt a dalt.

Az egyik létrehozásához használd a Share opciót, és válassz OnSong Binder formátumot.

A binderek az OnSong Connect által az eszközök között küldött fájlok is, amikor egy eszköz egy másiktól egy dal vagy szerkesztés igénylésére kér, így ugyanaz a formátum, amely a Files appban él, az, amely a hálózaton utazik.

Mivel a binder egyszerű JSON és közönséges médiafájlok ZIP-je, ez a megfelelő formátum, amelyhez akkor fordul, amikor meg kell látnod, hogy az OnSong mit tárolt valójában — vagy amikor valami másnak kell olvasnia a tartalmadat, és az nem OnSong.