OnSong^® Binder

Formát souboru OnSong^® Binder je způsob, jak OnSong přesouvá píseň, sadu nebo celou knihu mezi knihovnami. Stejně jako OnSong^® Archive obsahuje vše potřebné k obnovení obsahu na jiném místě — text písně, přílohy, styly, nastavení, transpozici a poznámky — ale zatímco archiv je jeden neprůhledný blob, binder je složka běžných souborů. To jej činí čitelným, kontrolovatelným a schopným nést média, na která píseň závisí, spolu s písní samotnou na platformě nezávislým způsobem.

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

Co je uvnitř

Binder je ZIP archiv. Rozbalte jej a najdete složku nazvanou podle identifikátoru položky obsahující:

• manifest.json — samotná položka, serializovaná. Každá vlastnost, kterou OnSong zná, ve stejném tvaru, jaký používá OnSong web API.
• Její soubor, pokud má nějaký. Příloha si zachovává své původní jméno souboru, takže PDF nebo MP3 uvnitř binderu je právě to PDF nebo MP3.
• Složky pro jeho děti, pojmenované podle toho, co jsou — songs, attachments — každá obsahující další složky přesně stejného tvaru.

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

Uvnitř manifestu jsou odkazy na děti označeny předponou $binder., takže čtenář může rozlišit mezi hodnotou, která patří položce, a hodnotou, která ukazuje do složky vedle ní.

Co to přenáší

• Písně — akordový diagram a vše, co je s ním připojeno.
• Sady — písně v jejich pořadí s vlastním uspořádáním sady.
• Knihy — celá kolekce.
• Přílohy — PDF, obrázky, zvuk a jakýkoli jiný soubor související s písní. Můžete se rozhodnout zahrnout pouze přílohy, které se skutečně používají, místo každé verze kdy přidané.

Binder nebo archiv?

Oba věrně přenesou obsah knihovny, takže výběr závisí na tom, co od souboru potřebujete:

• OnSong^® Archive je starší formát a je to, co se používá 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í stejně 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 jednoho obsahujícího jedinou píseň danou píseň přidá.

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

Bindery jsou také to, co OnSong Connect odesílá mezi zařízeními, když si jedno zařízení požádá druhé o píseň nebo sadu, takže stejný formát, který žije v aplikaci Soubory, je ten, který cestuje po síti.

Protože je binder ZIP se plain JSON a obyčejný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.