OnSong^® Mappa

Az OnSong^® Binder fájlformátum az a módszer, ahogy az OnSong könyvtárak között mozgatja a dalokat, szetteket vagy egész könyveket. A OnSong^® Archive-hoz hasonlóan tartalmazza az összes információt, amely szükséges a tartalom máshol történő helyreállításához — a daltextet, mellékleteket, stílusokat, beállításokat, transzpozíciót és megjegyzéseket —, de míg az archívum egy egyetlen átlátszatlan blob, a binder egy közönséges fájlok mappája. Ez lehetővé teszi, hogy olvasható, ellenőrizhető legyen, és a dal által igényelt médiát a dal mellett platformfüggetlen módon hordozza.

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

Mi Van Benne

A binder egy ZIP-archívum. Csomagolj ki egy ilyet, és találni fogsz egy mappát az elem azonosítója alapján elnevezve, amely tartalmazza:

• manifest.json — maga az elem, szerializálva. Minden olyan tulajdonság, amelyet az OnSong ismer róla, ugyanolyan formában, ahogyan az OnSong webes API-ja használja.
• Saját fájlját, ha van ilyen. A melléklet megtartja eredeti fájlnevét, így egy PDF vagy MP3 a binderben csak az az PDF vagy MP3.
• Mappákat annak gyermekeire, elnevezve azok típusa szerint — songs, attachments — mindegyik ugyanezzel az alakú további mappastruktúrákkal.

Ez a szerkezet végig ismétlődik: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest-jével az oldala mellett. A kétszáz dalt tartalmazó könyvet hordozó binder formátuma megegyezik az egyetlen chart-ot hordozóval.

A manifestban a gyermekekre való hivatkozásokat egy $binder. előtag jelöli, így az olvasó meg tudja különböztetni az elemhez tartozó értéket attól, amely az oldala mellett lévő mappára mutat.

Mit Hordoz

• Dalok — az akkordtáblázat és az összes hozzá tartozó melléklet.
• Szettek — a dalok sorrendben, a szett saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, audió és bármely más, a dalhoz kapcsolódó fájl. Választhatod, hogy csak a ténylegesen használt mellékleteket vagy minden hozzáadott verziót is beveszel.

Binder vagy Archive?

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

• OnSong^® Archive az régebbi formátum, és ezt kell használni az OnSong korábbi verzióival való kompatibilitáshoz.
• OnSong^® Binder az aktuális. Használd az újabb OnSong-verziókkal való megosztáshoz — és amikor olyan fájlt szeretnél, amit meg tudsz nyitni és megnézhetsz.

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 alkalmazásból, a Mail-ből, az AirDrop-ból vagy egy felhőszolgáltatásból, és válaszd az OnSong-ot. Egy szett-et tartalmazó binder importálásakor az szett és minden benne lévő dal újjáalakul; egyetlen dalt tartalmazó binder importálásakor az a dal kerül hozzáadásra.

Az egyik létrehozásához használd a Megosztás lehetőséget, és válaszd a formátumként az OnSong Binder opciót.

A binderek azok is, amelyeket a OnSong Connect az eszközök között küld, amikor az egyik eszköz a másiktól dal vagy szett után kérdez, így az ugyanez a formátum, amely a Files alkalmazásodban él, a hálózaton utazik.

Mivel a binder egy sima JSON és közönséges médiafájlok ZIP-je, ez a megfelelő formátum arra, amikor meg akarod nézni, hogy az OnSong valójában mit tárol — vagy amikor valami más is szeretné olvasni a tartalmadát, és nem az OnSong.