OnSong^® Mappa

Az OnSong^® Binder fájlformátum az, ahogyan az OnSong egy dalt, egy sorozatot vagy egy egész könyvet mozgat a könyvtárak között. Mint az OnSong^® Archive, tartalmazza az összes szükséges információt a tartalom máshol történő újraépítéséhez — a dalszöveget, a mellékleteket, a stílusokat, a beállításokat, a transzponálást és a megjegyzéseket —, de míg az archívum egyetlen átlátszatlan blob, a binder egy mappa közönséges fájlokkal. Ez olvashatóvá, ellenőrizhetővé és képessé teszi arra, hogy egy dallal együtt szállítson olyan médiákat, amelyektől a dal függ, platformfüggetlen módon.

Az 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. Csomagolja ki egyet, és találni fog egy mappát az elem azonosítója után elnevezve, amely tartalmazza:

• manifest.json — maga az elem, szerializálva. Minden tulajdonság, amelyről az OnSong tud, ugyanabban a formában, amelyet az OnSong web API használ.
• Saját fájl, ha van. Egy melléklet megtartja az eredeti fájlnevet, így egy PDF vagy MP3 egy binderben csak az a PDF vagy MP3.
• Mappák az alomanyagaihoz, elnevezve azok típusa szerint — songs, attachments — mindegyik további, pontosan ugyanolyan szerkezetű mappákat tartalmaz.

Ez a szerkezet végig ismétlődik: egy sorozat dalokat tartalmaz, egy dal mellékleteket tartalmaz, és mindegyik egy mappa a saját manifest és fájljai mellett. Egy kétszáz dalt tartalmazó könyv bindere ugyanolyan formátumban készül, mint egy egyetlen akkordtáblázatot tartalmazó.

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

Mit szállít

• Dalok — az akkordtáblázat és mindez, ami hozzá van csatolva.
• Sorozatok — a dalok sorrendben, a sorozat saját elrendezésével.
• Könyvek — egy teljes gyűjtemény.
• Mellékletek — PDF-ek, képek, hang és minden más, egy dalhoz kapcsolódó fájl. Választhat úgy, hogy csak az aktuálisan használt mellékleteket foglalja bele, ahelyett, hogy minden valaha hozzáadott verzió szerepelne.

Binder vagy Archive?

Mindkettő hűen körbefordul egy könyvtár tartalma, í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 ezt kell használni az OnSong korábbi verzióival való kompatibilitás érdekében.
• OnSong^® Binder a jelenlegi. Használja az OnSong újabb verzióival való megosztáshoz — és amikor olyan fájlra van szüksége, amelyet ki tud nyitni és meg tud nézni.

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

A binderek úgy importálódnak, mint bármely más fájl: nyissa meg egyet a Files alkalmazásból, a Mailből, az AirDropból vagy egy felhőszolgáltatásból, és válassza az OnSong lehetőséget. Egy sorozatot tartalmazó binder importálása újraalkotja a sorozatot és annak minden dalát; egy egyetlen dalt tartalmazó binder importálása azt a dalt adja hozzá.

Egyet létrehozásához használja a Share lehetőséget, és válassza az OnSong Binder formátumot.

A binderek azok is, amelyeket az OnSong Connect eszközök között küld, amikor az egyik eszköz egy másiktól egy dalt vagy egy sorozatot kér, így ugyanez a formátum, amely a Files alkalmazásban található, az a hálózaton átutazik.

Mivel a binder egy ZIP sima JSON-ből és közönséges médiafájlokból, ez a helyes formátum akkor, amikor meg kell nézni, hogy az OnSong ténylegesen mit tárol — vagy amikor valami olvasni szeretné a tartalmat, és az nem OnSong.