OnSong^® Binder

Az OnSong^® Köteg fájlformátum az a módszer, ahogy az OnSong közt mozgat egy dalt, egy szettet vagy egy teljes könyvet a könyvtárak között. Mint az OnSong^® Archívum, tartalmazza az összes szükséges információt 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áthatatlan blob, a köteg egy közönséges fájlok mappája. Ez teszi olvashatóvá, vizsgálhatóvá, és képessé egy dal által igényelt médiát a dal mellett platformfüggetlen módon szállítani.

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

Mi van benne

A köteg egy ZIP archívum. Ha kicsomagol egyet, az elem azonosítója után elnevezett mappát találhat, amely tartalmaz:

• manifest.json — az elem maga, szerializálva. Minden tulajdonság, amelyről az OnSong tud róla, ugyanabban a formában, amelyet az OnSong webes API használ.
• **Annak fájlja, ha van neki egy. ** Egy melléklet megtartja az eredeti fájlnevét, ezért egy PDF vagy MP3 egy kötegben csak az a PDF vagy MP3.
• Az elem gyermekeinek mappái, az alapján elnevezve, hogy mik — songs, attachments — mindegyik pontosan ugyanolyan szerkezetű további mappákat tartalmaz.

Ez a szerkezet végigmegy az egészen: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa, amely mellett a saját manifest és saját fájljai vannak. Egy köteg, amely kétszáz dalból álló könyvet tartalmaz, ugyanabban a formátumban van, mint az egyetlen szekvencia.

A manifestban az egyes elemekre való hivatkozások $binder. előtaggal vannak megjelölve, így az olvasó meg tudja mondani a különbséget egy olyan érték között, amely az elemhez tartozik, és egy olyan között, amely egy mellette lévő mappára mutat.

Mit szállít

• Dalok — az akkord diagram és mindaz, ami hozzá van csatolva.
• Szettek — a dalok a sorrendjükben, a szett saját összeállításával.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és minden más fájl, amely egy dalhoz tartozik. Dönthet úgy, hogy csak a ténylegesen használatban lévő mellékleteket tartalmazza, ahelyett hogy minden valaha hozzáadott verziót.

Köteg vagy archívum?

Mindkettő hűen visszajátssza egy könyvtár tartalmát, tehát a választás arról szól, hogy mit kell a fájlból:

• OnSong^® Archívum az idősebb formátum, és ezt kell használni az OnSong korábbi verzióival való kompatibilitás érdekében.
• OnSong^® Köteg az aktuális. Használja az újabb OnSong verziókkal történő megosztáshoz — és amikor azt szeretné, hogy egy fájl, amelyet kinyithat és megnézhet.

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

A kötegek ugyanúgy importálódnak, mint bármely más fájl: nyissa meg az egyik fájlt a Fájlokból, Mailből, AirDropból vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. Az egy szettet tartalmazó köteg importálása újraalkotja a szettet és minden benne lévő dalt; az egyetlen dalt tartalmazó köteg importálása hozzáadja azt a dalt.

Egy köteg létrehozásához használja a Megosztás lehetőséget, és válassza az OnSong Köteg formátumot.

A kötegek azok is, amelyeket az OnSong Connect az eszközök között küld, amikor az egyik eszköz egy másikhoz egy dal vagy szett után kérdez, ezért ugyanaz a formátum, amely a Fájlok alkalmazásban található, az egyik átutazik a hálózaton.

Mivel egy köteg egy ZIP fájl egyszerű JSON-nal és közönséges médiafájlokkal, ez a helyes formátum, amikor látni szeretné, hogy az OnSong valójában mit tárol — vagy amikor valami olvasni szeretné a tartalmát, és nem OnSong.