Segregator OnSong^®

Format pliku OnSong^® Binder to sposób, w jaki OnSong przenosi piosenkę, zestaw lub całą książkę między bibliotekami. Podobnie jak Archiwum OnSong^®, zawiera wszystko, co potrzebne do odbudowania zawartości w innym miejscu — tekst piosenki, załączniki, style, ustawienia, transponowanie i adnotacje — ale podczas gdy archiwum jest pojedynczym nieprzejrzystym obiektem, plik binder to folder zwykłych plików. To czyni go czytelnym, inspektowalnym i umożliwia przenoszenie mediów, od których zależy piosenka, obok samej piosenki w sposób niezależny od platformy.

Format pliku OnSong^® Binder ma rozszerzenie pliku .onsongbinder lub .binder i typ MIME application/onsong-binder.

Co się w środku znajduje

Plik binder to archiwum ZIP. Rozpakuj je i znajdziesz folder nazwany identyfikatorem elementu, zawierający:

• manifest.json — sam element, zserializowany. Każda właściwość, którą OnSong o nim wie, w tej samej formie, którą używa OnSong web API.
• Jego plik, jeśli go ma. Załącznik zachowuje swoją oryginalną nazwę pliku, więc PDF lub MP3 wewnątrz binderu to po prostu ten PDF lub MP3.
• Foldery dla jego elementów potomnych, nazwane tym, czym są — songs, attachments — każdy zawierający więcej folderów dokładnie o tej samej strukturze.

Ta struktura powtarza się aż do końca: zestaw zawiera piosenki, piosenka zawiera załączniki, a każdy to folder z jego własnym manifestem obok jego własnych plików. Plik binder zawierający książkę z dwustu piosenkach ma ten sam format co ten zawierający jeden utwór.

Wewnątrz manifestu odwołania do elementów potomnych są oznaczone prefiksem $binder., więc czytnik może odróżnić wartość należącą do elementu od tej, która wskazuje na folder obok niego.

Co nosi ze sobą

• Piosenki — akord i wszystko, co jest do niego dołączone.
• Zestawy — piosenki w ich porządku, wraz z własnym arranżem zestawu.
• Książki — cała kolekcja.
• Załączniki — pliki PDF, obrazy, audio i każdy inny plik związany z piosenką. Możesz wybrać, aby uwzględnić tylko załączniki, które są faktycznie w użyciu, a nie każdą kiedykolwiek dodaną wersję.

Binder czy archiwum?

Oba wiernie przenoszą zawartość biblioteki, więc wybór zależy od tego, czego potrzebujesz z pliku:

• Archiwum OnSong^® to starszy format i ten, który należy użyć w celu zgodności z wcześniejszymi wersjami OnSong.
• OnSong^® Binder to obecny format. Użyj go do udostępniania nowszym wersjom OnSong — i gdy chcesz plik, który możesz otworzyć i zajrzeć do środka.

Importowanie i eksportowanie

Bindery importują się jak każdy inny plik: otwórz jeden z Plików, Poczty, AirDrop lub usługi w chmurze i wybierz OnSong. Zaimportowanie binderu zawierającego zestaw odtwarza zestaw i każdą piosenkę w nim; zaimportowanie jednej zawierającej jedną piosenkę dodaje tę piosenkę.

Aby je utworzyć, użyj Udostępnij i wybierz OnSong Binder jako format.

Bindery to również to, co OnSong Connect wysyła między urządzeniami, gdy jedno urządzenie prosi inne o piosenkę lub zestaw, więc ten sam format, który znajduje się w aplikacji Pliki, to ten, który porusza się w sieci.

Ponieważ plik binder to ZIP zawierający zwykły JSON i zwykłe pliki mediów, to odpowiedni format, gdy musisz zobaczyć, co OnSong faktycznie przechowywał — lub gdy coś musi przeczytać twoją zawartość i nie jest to OnSong.