Gebruikersgids
OnSong® Binder
Die OnSong® Binder-lêerformaat is hoe OnSong 'n lied, 'n stel of 'n hele boek tussen biblioteke beweeg. Soos die OnSong® Archive dra dit alles wat nodig is om die inhoud elders weer op te bou — die liesteks, aanhangsels, style, instellings, transposisie en aantekeninge — maar waar 'n argief 'n enkele ondeurskynbare blok is, is 'n binder 'n map met gewone lêers. Dit maak dit leesbaar, inspekteerbaar, en in staat om die media waarvan 'n lied afhanklik is saam met die lied self op 'n platform-onafhanklike manier te dra.
Die OnSong® Binder-lêerformaat het 'n lêeruitbreiding van .onsongbinder of .binder, en 'n MIME-tipe van application/onsong-binder.
Wat Is Daarin?
'n Binder is 'n ZIP-argief. Pak een uit en jy sal 'n map vind wat na die item se identifiseerder vernoem is, wat bevat:
manifest.json— die item self, geserialiseer. Elke eienskap wat OnSong daarvan ken, in dieselfde vorm wat die OnSong-webwerf-API gebruik.- Sy lêer, as dit een het. 'n Aanhangsel hou sy oorspronklike lêernaam, dus 'n PDF of 'n MP3 in 'n binder is net daardie PDF of MP3.
- Mppe vir sy kinders, vernoem na wat hulle is —
songs,attachments— elk wat meer mppe van presies dieselfde vorm hou.
Daardie struktuur herhaal al die pad af: 'n stel bevat liedjies, 'n lied bevat aanhangsels, en elk is 'n map met sy eie manifest langs sy eie lêers. 'n Binder wat 'n boek van tweehonderd liedjies hou, is dieselfde formaat as een wat 'n enkele kaart hou.
In 'n manifest word verwysings na kinders gemerk met 'n $binder.-voorvoegsel, sodat 'n leser die verskil kan sê tussen 'n waarde wat tot die item behoort en een wat na 'n map langs dit wys.
Wat Dit Dra
- Liedjies — die akkoordkaart en alles wat daarmee aangeheg is.
- Stelle — die liedjies in hul volgorde, met die stel se eie rangskikking.
- Boeke — 'n hele versameling.
- Aanhangsels — PDF's, beelde, oudio, en enige ander lêer wat met 'n lied geassosieer word. Jy kan kies om slegs die aanhangsels wat werklik in gebruik is in te sluit eerder as elke weergawe ooit bygevoeg.
Binder Of Argief?
Beide vervoer 'n bibliotek se inhoud getrou, dus die keuse gaan oor wat jy van die lêer nodig het:
- OnSong® Archive is die ouer formaat, en is wat om te gebruik vir verenigbaarheid met vroeëre weergawes van OnSong.
- OnSong® Binder is die huidige een. Gebruik dit vir deling met nuwer weergawes van OnSong — en wanneer jy 'n lêer wil hê wat jy kan oopmaak en aankyk.
Invoer En Uitvoer
Binders voer in op die manier van enige ander lêer: maak een oop vanaf Lêers, Pos, AirDrop, of 'n wolkdiens en kies OnSong. 'n Binder wat 'n stel hou invoer, dupliseer die stel en elke lied daarin; 'n stel wat 'n enkele lied hou invoer, voeg daardie lied by.
Om een te skep, gebruik Deel en kies OnSong Binder as die formaat.
Binders is ook wat OnSong Connect tussen toestelle stuur wanneer een toestel 'n ander vir 'n lied of 'n stel vra, dus is dieselfde formaat wat in jou Lêers-app woon die een wat oor die netwerk beweeg.
Omdat 'n binder 'n ZIP van gewone JSON en gewone media-lêers is, is dit die regte formaat om vir aan te gryp wanneer jy moet sien wat OnSong werklik gestoor het — of wanneer iets jou inhoud moet lees en nie OnSong is nie.