OnSong^® Pořadač

Formát souboru OnSong^® Binder je způsob, jak OnSong přesunuje píseň, sadu nebo celou knihu mezi knihovnami. Podobně jako OnSong^® Archive obsahuje vše potřebné k obnovení obsahu jinde — text písně, přílohy, styly, nastavení, transponování a poznámky — ale zatímco archiv je jeden neprůhledný objekt blob, binder je složka s běžnými soubory. To jej činí čitelným, inspektovatelným a schopným přenášet média, která píseň vyžaduje, spolu s písní samotnou nezávislým na platformě.

Formát souboru OnSong^® Binder má příponu souboru buď .onsongbinder nebo .binder a typ MIME application/onsong-binder.

Co je uvnitř

Binder je archiv ZIP. Rozbalte jej a najdete složku pojmenovanou podle identifikátoru položky, která obsahuje:

• manifest.json — samotná položka, serializovaná. Každá vlastnost, kterou OnSong zná, ve stejné podobě, kterou používá API webu OnSong.
• Její soubor, pokud jej má. Příloha si zachovává své původní jméno, takže PDF nebo MP3 uvnitř binderu je právě ten PDF nebo MP3.
• Složky pro její potomky, pojmenované podle toho, co jsou — songs, attachments — každá obsahující více složek přesně stejné struktury.

Tato struktura se opakuje až dolů: sada obsahuje písně, píseň obsahuje přílohy a každá z nich je složka se svým manifestem vedle svých vlastních souborů. Binder obsahující knihu dvou set písní má stejný formát jako ten obsahující jeden jenom chart.

Uvnitř manifestu jsou odkazy na potomky označeny předponou $binder., aby čtenář mohl rozlišit hodnotu, která patří položce, od té, která ukazuje do složky vedle ní.

Co nese

• Písně — akordový diagram a vše s ním spojené.
• Sady — písně v jejich pořadí, s vlastním uspořádáním sady.
• Knihy — celá kolekce.
• Přílohy — soubory PDF, obrázky, zvuk a jakýkoli jiný soubor přidružený k písni. Můžete se rozhodnout zahrnout pouze přílohy, které jsou skutečně používány, spíše než každou verzi, kterou bylo kdy přidáno.

Binder nebo archiv?

Oba věrně obnovují obsah knihovny, takže výběr se týká toho, co potřebujete ze souboru:

• OnSong^® Archive je starší formát a je to co použít pro kompatibilitu s dřívějšími verzemi OnSong.
• OnSong^® Binder je ten současný. Používejte jej pro sdílení s novějšími verzemi OnSong — a když chcete soubor, který si můžete otevřít a podívat se dovnitř.

Import a export

Bindery se importují jako jakýkoli jiný soubor: otevřete jeden ze Souborů, Pošty, AirDrop nebo cloudové služby a zvolte OnSong. Import binderu obsahujícího sadu znovu vytvoří sadu a každou píseň v ní; import obsahujícího jednu píseň přidá tu píseň.

Chcete-li jej vytvořit, použijte Sdílet a zvolte OnSong Binder jako formát.

Bindery jsou také to, co OnSong Connect posílá mezi zařízeními, když si jedno zařízení od druhého vyžádá píseň nebo sadu, takže stejný formát, který se nachází ve vaší aplikaci Soubory, je ten cestující po síti.

Protože binder je ZIP s prostým JSON a běžnými mediálními soubory, je to správný formát, na který se máte obrátit, když potřebujete vidět, co OnSong skutečně uložil — nebo když něco potřebuje přečíst váš obsah a není to OnSong.