OnSong^® Binder

Az OnSong^® Binder fájlformátum az, ahogy az OnSong egy dalt, egy szettet vagy egy teljes könyvet mozgat a könyvtárak között. Mint az OnSong^® Archive, minden szükséges információt tartalmaz 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 míg az archívum egyetlen átláthatatlan blob, a binder egy mappa az egyszerű fájlokkal. Ez lehetővé teszi, hogy olvasható, vizsgálható legyen, és platformfüggetlen módon magában vigye azt az adatmédiát, amelyre a dal függ, valamint magát a dalt.

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

Mi található benne

A binder egy ZIP-archívum. Ha kicsomagol egyet, talál egy mappát, amely az elem azonosítójáról kapta a nevét, amely tartalmaz:

• manifest.json — maga az elem, szerializálva. Minden tulajdonság, amelyet az OnSong ismer róla, ugyanabban az alakban, amelyet az OnSong web API használ.
• Saját fájlja, ha van. A melléklet megtartja eredeti fájlnevét, így egy PDF vagy MP3 egy binderben csak az az PDF vagy MP3.
• Mappáit gyermekeinek, elnevezve, hogy mik azok — songs, attachments — mindegyik több mappát tartalmaz, pontosan ugyanabban az alakban.

Ez a szerkezet egészen lefelé ismétlődik: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa, amely saját manifest mellett saját fájlokat tartalmaz. Az egy kétszáz dalból álló könyvet tartalmazó binder ugyanabban a formátumban van, mint az egyetlen tábláját tartalmazó.

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

Mit szállít

• Dalok — az akkordiagramon és minden hozzá kapcsolódó.
• Szettek — a dalok sorrendjében, a szett saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és bármely más, egy dalhoz kapcsolódó fájl. Dönthet úgy, 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 visszajátssza 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 a régebbi formátum, és ezt használja az OnSong korábbi verzióival való kompatibilitáshoz.
• OnSong^® Binder a jelenlegi. Használja az újabb OnSong-verziókkal való megosztásához — és amikor szüksége van egy fájlra, amelyet megnyithat és megnézhet.

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

A binderek az ugyanúgy importálódnak, mint bármely más fájl: nyisson meg egy-et a Files alkalmazásból, Mail-ből, AirDrop-ból vagy egy felhőszolgáltatásból, és válassza az OnSong-ot. Egy szettet tartalmazó binder importálása újra létrehozza a szettet és minden dalát; egyetlen dalt tartalmazó importálása hozzáadja azt a dalt.

Egyet létrehozásához használja a Share (Megosztás) lehetőséget, és válassza az OnSong Binder formátumot.

A binderek az, amit az OnSong Connect küld az eszközök között, ha az egyik eszköz egy másik eszköztől egy dalt vagy egy szettet kér, így ugyanaz a formátum, amely a Files alkalmazásban található, az, amely a hálózaton utazik.

Mivel a binder egy ZIP-archívum, amely egyszerű JSON-ből és közönséges médiafájlokból áll, ez a megfelelő formátum, amelyet akkor kell választania, amikor meg kell tudnia, hogy az OnSong ténylegesen mit tárol — vagy amikor valami szükséges az Ön tartalmának olvasásához, és az nem OnSong.