Uživatelská příručka
OnSong® Pořadač
Formát souboru OnSong® Binder je způsob, jak OnSong přesouvá písničku, sadu nebo celou knihu mezi knihovnami. Jako OnSong® Archive obsahuje vše potřebné k opětovné výstavbě obsahu jinde — text písničky, přílohy, styly, nastavení, transponování 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 přenášet média, na která písnička závisí, spolu s písničkou samotnou 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 ZIP archiv. Rozbalte jej a najdete složku nazvanou podle identifikátoru položky, která obsahuje:
manifest.json— samotná položka, serializovaná. Každá vlastnost, kterou OnSong zná, ve stejné podobě, jakou používá OnSong web API.- Její soubor, pokud ho má. Příloha si zachovává své původní jméno souboru, takže PDF nebo MP3 uvnitř binderu je prostě to PDF nebo MP3.
- Složky pro její potomky, pojmenované podle toho, co jsou —
songs,attachments— každá obsahující další složky přesně stejné struktury.
Tato struktura se opakuje až do konce: sada obsahuje písničky, písnička obsahuje přílohy, a každá je složka s vlastním manifestem vedle vlastních souborů. Binder obsahující knihu dvou set písniček má stejný formát jako jeden obsahující jeden list.
V manifestu jsou odkazy na potomky označeny předponou $binder., aby si čtenář mohl uvědomit rozdíl mezi hodnotou, která patří položce, a hodnotou, která odkazuje do složky vedle ní.
Co nese
- Písničky — akordový list a vše s ním spojené.
- Sady — písničky v jejich pořadí se 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ísničkou. Můžete si vybrat, zda 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ě obnovují obsah knihovny, takže volba závisí na tom, co z souboru potřebujete:
- OnSong® Archive je starší formát a je to, co se používá pro kompatibilitu s dřívějšími verzemi OnSongu.
- OnSong® Binder je ten současný. Používejte jej ke sdílení s novějšími verzemi OnSongu — a když chcete soubor, který si 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 zvolte OnSong. Import binderu obsahujícího sadu znovu vytvoří sadu a každou v ní obsaženou písničku; import jednoho obsahujícího jednu písničku přidá tu písničku.
Chcete-li jej vytvořit, použijte Sdílení a vyberte OnSong Binder jako formát.
Bindery jsou také tím, co OnSong Connect posílá mezi zařízeními, když jedno zařízení požádá druhé o písničku nebo sadu, takže stejný formát, který žije ve vaší aplikaci Soubory, je ten, který se pohybuje v síti.
Protože je binder ZIP souborů plain 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.