OnSong^® Binder

A OnSong^® Binder fájlformátum az, ahogyan az OnSong egy dalt, egy szettet vagy egy teljes könyvet mozgat könyvtárak között. Mint az OnSong^® Archive, tartalmaz mindent, ami szükséges 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ót és megjegyzéseket —, de míg az archívum egy egyetlen átlátszatlan blob, a binder egy mappa közönséges fájlokkal. Ez lehetővé teszi, hogy olvasható, áttekinthető legyen, és platformfüggetlen módon hordozza az adatokat, amelyektől egy dal függ, magával a dallal együtt.

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

Mi van benne

A binder egy ZIP-archívum. Ha kicsomagol egy bindert, találni fog egy mappát az elem azonosítójának nevéhez képest, amely tartalmaz:

• manifest.json — maga az elem, szerializálva. Minden tulajdonság, amelyről az OnSong tud, ugyanolyan formában, ahogy az OnSong web API használja.
• Az elemhez tartozó fájl, ha van. A melléklet megtartja eredeti fájlnevét, így egy PDF vagy MP3 a binderben csak az a PDF vagy MP3.
• Mappastruktúra a gyermekelemeire, az elnevezésük alapján — songs, attachments — mindegyik további mappákat tartalmaz pontosan ugyanolyan szerkezettel.

Ez a szerkezet így folytatódik végig: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy saját manifestumú mappa a saját fájljai mellett. Egy kétszáz dalt tartalmazó könyvet tartalmazó binder ugyanolyan formátumú, mint egy egyetlen akkorddiagramot tartalmazó.

A manifestumon belül a gyermekelemekkre való hivatkozások $binder. előtaggal vannak jelölve, így az olvasó meg tudja különböztetni az elemhez tartozó értéket attól, amely a mellette lévő mappára mutat.

Mit hordoz

• Dalok — az akkorddiagram és mindaz, ami hozzá van csatolva.
• Szettek — a dalok sorrendjében, a szett saját arrangemantjével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-fájlok, képek, hangfájlok és minden más, amit egy dalhoz társítanak. Kiválaszthatja, hogy csak a ténylegesen használt mellékleteket vagy minden eddig hozzáadott verziót tartalmazza.

Binder vagy Archive?

Mindkettő hűen körülforgatja egy könyvtár tartalmát, így a választás arról szól, mire van szüksége 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 az aktuális. Használja az újabb OnSong-verziókkal történő megosztáshoz — és amikor egy olyan fájlra van szüksége, amelyet meg tud nyitni és megnézni.

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, Mailból, AirDropról vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. Egy szettet tartalmazó binder importálása újra létrehozza a szettet és benne minden dalt; egy egyetlen dalt tartalmazó binder importálása azt a dalt adja hozzá.

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

A binderek az OnSong Connect által eszközök közötti küldött fájlok is, 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 található, az, amely a hálózaton keresztül utazik.

Mivel a binder egy ZIP-fájl sima JSON-t és közönséges médiafájlokat tartalmaz, ez a megfelelő formátum, amikor meg kell látnod, mit tárolt az OnSong — vagy amikor valami másnak el kell olvasnia a tartalmadat, és ez nem OnSong.