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 opětovnému vytvoření obsahu jinde — 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, inspekčním a schopným nést média, na kterých píseň závisí, vedle samotné písně nezávisle na platformě.

Formát souboru OnSong^® Binder má příponu souboru .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, obsahující:

• manifest.json — samotná položka, serializovaná. Každá vlastnost, kterou OnSong zná, ve stejné formě, kterou používá OnSong web API.
• Jeho soubor, pokud nějaký má. Příloha si zachová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 její potomky, pojmenované podle toho, jaké jsou — songs, attachments — každá obsahující více složek přesně stejné struktury.

Tato struktura se opakuje až na konec: 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 binder obsahující jeden jediný chart.

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

Co nese

• Písně — akordový chart a vše, co je k němu připojeno.
• Sady — písně v jejich pořadí se svou vlastní úpravou.
• Knihy — celá kolekce.
• Přílohy — PDF, obrázky, zvuk a jakýkoli jiný soubor spojený s písní. Můžete se rozhodnout zahrnout pouze přílohy, které se skutečně používají, místo každé verze, která byla kdy přidána.

Binder nebo archiv?

Oba věrně rekonstruují obsah knihovny, takže volba se týká toho, co z tohoto souboru potřebujete:

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

Import a export

Bindery se importují jako jakýkoli jiný soubor: otevřete jeden ze Souborů, Pošty, AirDrop nebo cloudové služby a vyberte OnSong. Import binderu obsahujícího sadu znovu vytvoří sadu a každou píseň v ní; import toho obsahujícího jednu píseň tuto 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ž jedno zařízení požádá druhé o píseň nebo sadu, takže stejný formát, který se nachází v aplikaci Soubory, je ten cestující přes síť.

Protože binder je ZIP prostého JSON a běžných mediálních souborů, je to správný formát, který si vezměte, 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.