OnSong^® Binder

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

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

Co se nachází uvnitř

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

• manifest.json — samotná položka, serializovaná. Každá vlastnost, kterou OnSong o ní zná, ve stejné formě, kterou používá OnSong web API.
• Její soubor, pokud existuje. Příloha si ponechává svůj původní název souboru, takže PDF nebo MP3 uvnitř binderu je právě ten PDF nebo MP3.
• Složky pro své podřízené položky, pojmenované podle toho, co jsou — songs, attachments — každá obsahuje další složky přesně stejného tvaru.

Tato struktura se opakuje po celou cestu: sada obsahuje písně, píseň obsahuje přílohy a každá z nich 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 obsahující jeden singel.

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

Co nese

• Písně — tabulaturu akordu a vše, co je k ní připojeno.
• Sady — písně v jejich pořadí s vlastním uspořádáním sady.
• Knihy — celou sbírku.
• Přílohy — PDF, obrázky, zvuk a jakýkoli jiný soubor spojený s písní. Můžete se rozhodnout, zda chcete zahrnout pouze přílohy, které se skutečně používají, spíše než každou verzi, která byla někdy přidána.

Binder nebo archiv?

Oba věrně převádějí obsah knihovny, takže výběr závisí na tom, co ze 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 prohlédnout si jeho obsah.

Import a export

Bindery se importují stejně jako jakýkoli jiný soubor: otevřete jej 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 binderu obsahujícího jednu píseň přidá tu píseň.

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ž jedno zařízení požádá druhé o píseň nebo sadu, takže stejný formát, který se nachází ve vaší aplikaci Soubory, je ten, který cestuje po síti.

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