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 gdzie indziej — tekst piosenki, załączniki, style, ustawienia, transponowanie i adnotacje — ale podczas gdy archiwum to jeden nieprzejrzysty obiekt blob, plik Binder to folder zwykłych plików. To czyni go czytelnym, sprawdzalnym i zdolnym do przenoszenia 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 oraz typ MIME application/onsong-binder.

Co jest w środku

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

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

Ta struktura powtarza się aż do dołu: zestaw zawiera piosenki, piosenka zawiera załączniki, a każdy jest folderem z własnym manifestem obok własnych plików. Plik Binder zawierający książkę dwustu piosenek ma ten sam format co plik zawierający jeden utwór.

Wewnątrz manifestu odniesienia do elementów podrzędnych są oznaczone prefiksem $binder., dzięki czemu czytnik może rozróżnić wartość należącą do elementu od tej, która wskazuje do folderu obok niej.

Co zawiera

• Piosenki — nuty akordowe i wszystko, co do nich dołączono.
• Zestawy — piosenki w ich kolejności z własnym aranżacją zestawu.
• Książki — całą kolekcję.
• Załączniki — pliki PDF, obrazy, dźwięk i dowolny inny plik powiązany z piosenką. Możesz wybrać, czy dołączyć tylko załączniki, które są faktycznie w użyciu, zamiast każdej wersji kiedykolwiek dodanej.

Binder czy archiwum?

Oba wierne odzwierciedlają zawartość biblioteki, więc wybór zależy od tego, co potrzebujesz z pliku:

• Archiwum OnSong^® to starszy format i to właśnie należy używać w celu kompatybilności z wcześniejszymi wersjami OnSong.
• OnSong^® Binder to bieżący format. Użyj go do udostępniania z nowszymi wersjami OnSong — i gdy chcesz plik, który możesz otworzyć i zajrzeć do środka.

Importowanie i eksportowanie

Pliki Binder importują się tak jak każdy inny plik: otwórz jeden z aplikacji Pliki, Poczta, AirDrop lub usługi w chmurze i wybierz OnSong. Zaimportowanie pliku Binder zawierającego zestaw odtwarza zestaw i każdą piosenkę w nim; zaimportowanie zawierającego pojedynczą piosenkę dodaje tę piosenkę.

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

Pliki Binder to także to, co OnSong Connect wysyła między urządzeniami, gdy jedno urządzenie prosi drugie o piosenkę lub zestaw, więc ten sam format, który znajduje się w aplikacji Pliki, to ten, który podróżuje przez sieć.

Ponieważ plik Binder to ZIP zwykłego JSON i zwykłych plików medialnych, to właściwy format, do którego sięgnąć, gdy musisz zobaczyć, co OnSong faktycznie zapisał — lub gdy coś musi odczytać Twoją zawartość i nie jest to OnSong.