OnSong^® Binder

Az OnSong^® Binder fájlformátum az a módszer, ahogy az OnSong egy dalt, egy készletet vagy egy egész könyvet tud áthelyezni a könyvtárak között. Az OnSong^® Archive formátumhoz hasonlóan minden szükséges információt tartalmaz a tartalom máshol történő újraépítéséhez — a dal szövegét, mellékleteket, stílusokat, beállításokat, transzpozíciókat és megjegyzéseket — de míg az archívum egyetlen átlátszatlan blob, addig a binder egy mappák mappa. Ez teszi azt olvashatóvá, vizsgálhatóvá, és képessé arra, hogy a dalt támogató médiát platformfüggetlen módon magában vigye a dallal együtt.

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

Mi van benne

A binder egy ZIP archívum. Ha kicsomagolsz egyet, találsz egy mappát az elem azonosítója szerint elnevezve, amely tartalmazza:

• manifest.json — az elem maga, szérializálva. Minden tulajdonság, amelyről az OnSong tud, ugyanabban a formában, mint ahogy az OnSong web API használja.
• Az elem fájlja, ha van. Egy melléklet megtartja eredeti fájlnevét, így egy PDF vagy MP3 a binderben csak egy PDF vagy MP3.
• Mappákat az elemnek megfelelő gyermekeihez, az azoknak megfelelő névvel elnevezve — songs, attachments — mindegyik azonos formájú mappákat tartalmazva.

Ez a szerkezet mindaddig ismétlődik: egy készlet dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest mellett a saját fájljaival. Egy binder, amely egy kétszáz dalt tartalmazó könyvet tart, ugyanabban a formátumban van, mint egy egyetlen dal.

Egy manifestban a gyermekekre történő hivatkozások egy $binder. előtaggal vannak megjelölve, így az olvasó meg tudja mondani a különbséget egy az elemhez tartozó érték és egy mellette lévő mappára mutató érték között.

Mit tartalmaz

• Dalok — az akkorddiagram és mindez, ami csatolt hozzá.
• Készletek — a dalok a sorrendjükben, a készlet saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, audiók és bármilyen más fájl, amely egy dalhoz kapcsolódik. Választhatod, hogy csak a ténylegesen használatban lévő mellékleteket vagy minden valaha hozzáadott verziót fogod-e bevonni.

Binder vagy Archive?

Mindkettő hűen körbeforgatja a könyvtár tartalmát, így a választás arról szól, hogy mire van szükséged a fájlból:

• OnSong^® Archive a régebbi formátum, és ezt használd az OnSong korábbi verzióival való kompatibilitáshoz.
• OnSong^® Binder a jelenlegi. Használd az újabb OnSong verzióival való megosztáshoz — és akkor, amikor olyan fájlt szeretnél, amelyet meg tudsz nyitni és megnézni belülről.

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

A binderek úgy importálódnak, mint bármilyen más fájl: nyiss meg egyet a Files alkalmazásból, a Mailből, az AirDropból vagy egy felhőszolgáltatásból, és válaszd az OnSong lehetőséget. Egy készletet tartalmazó binder importálása újraalkotja a készletet és az abban lévő minden dalt; egy egyetlen dalt tartalmazó binder importálása hozzáadja azt a dalt.

Egy létrehozásához használd a Share (Megosztás) lehetőséget, és válaszd az OnSong Binder formátumot.

A binderek az, amit a OnSong Connect küld az eszközök között, amikor az egyik eszköz egy másikat megkér egy dalra vagy egy készletre, így ugyanaz a formátum, amely a Files alkalmazásodban található, az, amely a hálózaton utazik.

Mivel a binder egy ZIP fájl, amely egyszerű JSON és hagyományos médiafájlokból áll, ez az ideális formátum arra, amikor meg kell tudnod, hogy az OnSong pontosan mit tárol — vagy amikor valaminek el kell olvasnia a tartalmadat, és az nem OnSong.