OnSong^® Mappa

Az OnSong^® Binder fájlformátum az, ahogy az OnSong között mozgat egy dalt, egy szettet vagy egy egész könyvet 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ásutt történő újraépítéséhez — a dal szövegét, mellékleteit, stílusait, beállításait, transzponálását és megjegyzéseit — de míg az archívum egyetlen átlátszatlan blob, a binder egy mappa közönséges fájlokkal. Ez lehetővé teszi, hogy olvasható, vizsgálható legyen, és hogy a dal által igényelt médiafájlokat a dalhoz tartozóan, platformfüggetlen módon szállítsa.

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

Mi van benne

A binder egy ZIP archívum. Ha kicsomagol egyet, egy mappát fog találni, amely az elem azonosítója után van elnevezve, és amely tartalmazza:

• manifest.json — maga az elem, szerializálva. Minden tulajdonság, amelyről az OnSong tud róla, ugyanabban a formában, mint ahogy az OnSong web API használja.
• A hozzá tartozó fájl, ha van ilyen. A melléklet megtartja az eredeti fájlnevet, így egy PDF vagy egy MP3 egy binder-ben csak ez a PDF vagy MP3.
• Mappákat az alanyainak, elnevezve az alapján, hogy mik azok — songs, attachments — mindegyik több mappát tartalmaz pontosan ugyanabban a formában.

Ez a szerkezet így ismétlődik végig: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest-tel a maga fájljai mellett. A kétszáz dalt tartalmazó könyvet tartalmazó binder ugyanabban a formátumban van, mint az egyetlen akkorddiagramot tartalmazó binder.

A manifest-en belül az alanyokra való hivatkozások $binder. előtaggal vannak jelölve, így az olvasó el tudja különböztetni az elemhez tartozó értéket az olyan értéktől, amely az mellett a mappára mutat.

Mit szállít

• Dalok — az akkorddiagram és az összes melléklete.
• Szettek — a dalok a sorrendben, a szett saját megrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és más, a dalhoz tartozó fájlok. Dönthet úgy, hogy csak a ténylegesen használt mellékleteket tartalmazza, nem minden korábban hozzáadott verziót.

Binder vagy Archive?

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

• OnSong^® Archive a régebbi formátum, és ezt kell használni az OnSong korábbi verzióival való kompatibilitáshoz.
• OnSong^® Binder az aktuális. Használja az újabb OnSong verziókkal való megosztáshoz — és amikor olyan fájlt akar, amelyet megnyithat és betekinthet.

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

A binderek úgy importálódnak, mint bármely más fájl: nyisson meg egyet a Files, Mail, AirDrop vagy egy felhőszolgáltatás közül, és válassza az OnSong-ot. A szett-et tartalmazó binder importálása újraalkotja a szett és az összes benne lévő dalt; az egyetlen dalt tartalmazó binder importálása ezt a dalt adja hozzá.

Egy létrehozásához használja a Megosztás funkciót, és válassza az OnSong Binder formátumot.

A binderek az is, amit az OnSong Connect küld az eszközök között, amikor az egyik eszköz a másiktól dal vagy szett kérésezik, így ugyanez a formátum, amely a Files alkalmazásban él, az a hálózaton keresztül szállított.

Mivel a binder egyszerű JSON és közönséges médiafájlok ZIP-je, ez a megfelelő formátum, amikor meg kell látnia, hogy az OnSong ténylegesen mit tárol — vagy amikor valami másnak kell olvasnia a tartalmat, és ez nem OnSong.