Uživatelská příručka

OnSong® Pořadač

Formát souboru OnSong® Binder je způsob, jakým OnSong přesunuje píseň, sadu nebo celou knihu mezi knihovnami. Podobně 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 jediný neprůhledný objekt, binder je složka s běžnými soubory. To jej dělá čitelným, inspekčním a schopným přenášet média, na kterých píseň závisí, spolu se samotnou písní platformě nezávislým způsobem.

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

Co se v něm nachází

Binder je archiv ZIP. Když jej rozbalíte, 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é podobě, jakou používá OnSong webové API.
  • Její soubor, pokud jej má. Příloha si zachovává své původní jméno, takže PDF nebo MP3 uvnitř binderu je pouze toto PDF nebo MP3.
  • Složky pro její podřízené prvky, 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á 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í jediný chart.

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

Co obsahuje

  • Písně — akordový chart a vše k němu připojené.
  • Sady — písně v jejich pořadí, s vlastním uspořádáním sady.
  • Knihy — celou kolekci.
  • Přílohy — PDF, obrázky, zvuk a jakýkoli jiný soubor spojený s písní. Můžete si vybrat, zda zahrnout pouze přílohy, které se skutečně používají, nebo každou verzi, která byla kdy přidána.

Binder nebo archiv?

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

  • OnSong® Archive je starší formát a je to, co použít pro kompatibilitu s dřívějšími verzemi OnSongu.
  • OnSong® Binder je ten aktuální. Používejte jej pro sdílení s novějšími verzemi OnSongu — 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, AirDropu nebo cloudové služby a zvolte OnSong. Import binderu obsahujícího sadu obnoví sadu a každou v ní obsaženou píseň; import binderu obsahujícího jednu píseň přidá tuto píseň.

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

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

Protože binder je ZIP běžného JSON a běžných mediálních souborů, je to správný formát pro použití, když potřebujete vidět, co OnSong skutečně uložil — nebo když něco potřebuje číst váš obsah a není to OnSong.

2026.3 — Poslední aktualizace: September 1, 2026