OnSong^® Binder

A OnSong^® Binder fájlformátum az a mód, ahogyan az OnSong egy dalt, egy szettet vagy egy teljes könyvet mozgat a könyvtárak között. Akárcsak az OnSong^® Archive esetében, magában hordozza mindazt, ami szükséges a tartalom máshol való ú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 ahol az archívum egyetlen átlátszatlan blob, a binder egy közönséges fájlok mappája. Ez teszi olvashatóvá, vizsgálhatóvá, és képessé arra, hogy a dal által igényelt médiát egy platformfüggetlen módon a dal mellett vigye.

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

Mi van benne

A binder egy ZIP-archívum. Ha kicsomagol egy bindet, egy olyan mappát talál, amely az elem azonosítója után van nevezve, és amely a következőket tartalmazza:

• manifest.json — maga az elem, szerializálva. Minden olyan tulajdonság, amelyről az OnSong tud róla, ugyanolyan formában, mint ahogyan az OnSong webes API-ja használja.
• Az eleme fájlja, ha van. Egy melléklet megtartja az eredeti fájlnevet, így a binder belsejében lévő PDF vagy MP3 csak az az PDF vagy MP3.
• Mappák az eleme gyermekeihez, az elnevezésük után — songs, attachments — mindegyik több, pontosan ugyanolyan formájú mappa tartalmazza.

Ez a szerkezet egészen le: egy szett dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját nyilvántartásával és a saját fájljaival. Egy kétszáz dalt tartalmazó könyv bindet ugyanaz a formátum, mint egyetlen diagramot tartalmazó binder.

Egy nyilvántartáson belül a gyermekek hivatkozásait egy $binder. előtaggal jelölik meg, így az olvasó megkülönböztethet egy olyan értéket, amely az elemhez tartozik, és egy olyat, amely egy mappa mellé mutat.

Mit szállít

• Dalok — az akkordiagram és minden, ami ahhoz csatlakozik.
• Szettek — a dalok a sorrendben, a szett saját rendezésével.
• Könyvek — egy egész gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és bármely más fájl egy dalhoz társítva. Dönthet úgy, hogy csak a ténylegesen használt mellékleteket tartalmazza, nem pedig minden eddig hozzáadott verziót.

Binder vagy archívum?

Mindkettő hűen körbeforgatja a könyvtár tartalmát, ezért a választás arról szól, hogy mit kell 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 OnSong-verziókkal való megosztáshoz — és amikor olyan fájlra van szüksége, amelyet meg tud nyitni és meg tud nézetni.

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-ből, a Mail-ből, az AirDrop-ból vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. Ha egy szattet tartalmazó bindert importál, az újra létrehozza a szattet és az abban lévő összes dalt; ha egyetlen dalt tartalmazó bindert importál, azt hozzáadja azt a dalt.

Egy 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 is elküldi az eszközök között, amikor az egyik eszköz egy másiktól egy dalt vagy egy szattet kér, így ugyanaz a formátum, amely a Files alkalmazásban é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, amikor meg kell nézni, hogy az OnSong ténylegesen mit tárol — vagy amikor valami más eszköznek el kell olvasnia a tartalmát, és az nem OnSong.