OnSong^® Binder

Az OnSong^® Binder fájlformátum az, ahogy az OnSong egy dalt, egy szettet vagy egy egész könyvet mozgat a könyvtárak között. Mint a OnSong^® Archive, minden szükséges információt tartalmaz az innehover máshol történő újraépítéséhez — a dalt, mellékleteket, stílusokat, beállításokat, transzpozíciót és jegyzeteket — de míg az archívum egy egyetlen átlátszatlan blob, a binder közönséges fájlok mappája. Ez teszi olvashatóvá, vizsgálhatóvá, és lehetővé teszi, hogy hordozza azokat a médiafájlokat, amelyektől a dal függ, a dal mellett platformfüggetlen módon.

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

Mit Tartalmaz

A binder egy ZIP archívum. Ha kicsomagol egyet, találni fog egy mappát, amely az elem azonosítója után van elnevezve, amely 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 webes API használ.
• Annak fájlja, ha van ilyen. Egy melléklet megtartja az eredeti fájlnevet, így egy PDF vagy MP3 egy binderbeben egyszerűen az a PDF vagy MP3.
• Mappák az alrendszereihez, az alapján elnevezve, hogy mik azok — songs (dalok), attachments (mellékletek) — mindegyik több mappát tartalmaz, amelyek pontosan ugyanabban a formában vannak.

Ez a struktúra ismétlődik végig: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy olyan mappa, amely a saját manifestjét és saját fájljait tartalmazza. Egy binder, amely egy kétszáz dalt tartalmazó könyvet tartalmaz, ugyanabban a formátumban van, mint az, amely egyetlen charts tartalmaz.

Egy manifestban az alrendszerekre való hivatkozásokat $binder. előtaggal jelölik meg, így az olvasó meg tudja különböztetni egy elem értékét és olyat, amely a mellette lévő mappára mutat.

Mit Hordoz

• Dalok — az akkord-diagram és minden, ami hozzá van csatolva.
• Szettek — a dalok a sorrendben, a szett saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, audió és bármilyen más fájl, amely egy dalhoz kapcsolódik. Választhatja, hogy csak a ténylegesen használatban lévő mellékleteket tartalmazza, nem pedig az összes valaha hozzáadott verziót.

Binder Vagy Archive?

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

• OnSong^® Archive a régebbi formátum, és azt kell használni az OnSong korábbi verzióival való kompatibilitás érdekében.
• OnSong^® Binder a jelenlegi. Használja az újabb verzióval rendelkező OnSong-verziókkal való megosztásra — és amikor olyan fájlra van szükség, amelyet meg tud nyitni és megtekinteni.

Importálás És Exportálás

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

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

A binderek azok is, amelyeket a OnSong Connect küld az eszközök között, amikor az egyik eszköz egy másiktól kér egy dalt vagy egy szettet, így ugyanaz a formátum, amely a Files alkalmazásban él, az a hálózaton utazik.

Mivel a binder egy ZIP, amely egyszerű JSON és közönséges médiafájlokat tartalmaz, ez a helyes formátum, amelyet választhat, amikor látni kell, hogy az OnSong valójában mit tárol — vagy amikor valami az OnSong-on kívül olvassa el a tartalmat.