OnSong^® Binder

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 jest potrzebne do odbudowy zawartości gdzie indziej — tekst piosenki, załączniki, style, ustawienia, transponowanie i adnotacje — ale tam, gdzie archiwum jest jednym nieprzezroczystym obiektem blob, segregator to folder zwykłych plików. To sprawia, że jest czytelny, kontrolowalny i może zawierać media, od których zależy piosenka, wraz z samą piosenką w sposób niezależny od platformy.

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

Co się w nim znajduje

Segregator to archiwum ZIP. Rozpakuj je, a znajdziesz folder nazwany identyfikatorem elementu zawierający:

• manifest.json — sam element, serializowany. Każda właściwość, którą zna OnSong, w tym samym kształcie, którego używa internetowy interfejs API OnSong.
• Jego plik, jeśli go ma. Załącznik zachowuje swoją oryginalną nazwę pliku, więc plik PDF lub MP3 wewnątrz segregatora to po prostu ten plik PDF lub MP3.
• Foldery dla jego elementów podrzędnych, nazwane na podstawie tego, czym są — songs, attachments — każdy zawierający więcej folderów dokładnie tego samego kształtu.

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

Wewnątrz manifestu odniesienia do elementów podrzędnych są oznaczone prefiksem $binder., aby czytnik mógł rozróżnić wartość należącą do elementu od wartości wskazującej na folder obok niego.

Co zawiera

• Piosenki — nuty akordowe i wszystko, co do nich dołączone.
• Zestawy — piosenki w ich kolejności z własnym aranżacją zestawu.
• Książki — całą kolekcję.
• Załączniki — pliki PDF, obrazy, audio i inne pliki skojarzone z piosenką. Możesz wybrać dołączenie tylko załączników, które są rzeczywiście używane, zamiast każdej wersji kiedykolwiek dodanej.

Segregator czy archiwum?

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

• Archiwum OnSong^® to starszy format i jest to format do użytku w celu zgodności z wcześniejszymi wersjami OnSong.
• OnSong^® Binder to obecny format. Użyj go do udostępniania z nowszymi wersjami OnSong — i gdy chcesz plik, który możesz otworzyć i zajrzeć do jego wnętrza.

Importowanie i eksportowanie

Segregatory importują się tak jak każdy inny plik: otwórz jeden z plików, poczty, AirDrop lub usługi w chmurze i wybierz OnSong. Zaimportowanie segregatora zawierającego zestaw powoduje odtworzenie zestawu i każdej piosenki w nim; zaimportowanie zawierającego pojedynczą piosenkę dodaje tę piosenkę.

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

Segregatory 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 podróżujący przez sieć.

Ponieważ segregator to ZIP zawierający zwykły JSON i zwykłe pliki multimedialne, to właściwy format do wykorzystania, gdy musisz zobaczyć, co OnSong faktycznie przechował — lub gdy coś musi przeczytać Twoją zawartość i nie jest to OnSong.