Podręcznik użytkownika
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 jest potrzebne do przebudowania zawartości gdzieindziej — tekst piosenki, załączniki, style, ustawienia, transponowanie i adnotacje — ale podczas gdy archiwum jest jednym nieprzejrzystym obiektem blob, plik binder to folder zwykłych plików. To czyni go czytelnym, inspektowalnym 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 się znajduje w środku
Plik binder to archiwum ZIP. Rozpakuj je, a znajdziesz folder o nazwie identyfikatora elementu, zawierający:
manifest.json— sam element, zserializowany. Każda właściwość, którą zna OnSong, w tym samym kształcie, który używa API sieci Web OnSong.- Jego plik, jeśli go ma. Załącznik zachowuje swoją oryginalną nazwę pliku, więc plik PDF lub MP3 wewnątrz pliku binder to właśnie 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 dokładnie tego samego kształtu.
Ta struktura powtarza się aż do dołu: zestaw zawiera piosenki, piosenka zawiera załączniki, a każda z nich to folder z własnym manifestem obok własnych plików. Plik binder zawierający książkę dwustu piosenek ma ten sam format co ten zawierający pojedynczy utwór.
Wewnątrz manifestu, odniesienia do elementów podrzędnych są oznaczone prefiksem $binder., aby czytnik mógł rozróżnić między wartością, która należy do elementu, a tą, która wskazuje na folder obok niego.
Co nosi ze sobą
- Piosenki — tekst z akorami i wszystko, co jest do niego dołączone.
- Zestawy — piosenki w ich kolejności z własnym układem zestawu.
- Książki — całą kolekcję.
- Załączniki — pliki PDF, obrazy, audio i dowolny inny plik związany z piosenką. Możesz wybrać, aby uwzględnić tylko załączniki, które są faktycznie używane, a nie każdą wersję, która kiedykolwiek została dodana.
Plik Binder czy Archiwum?
Oba wiernie przetwarzają zawartość biblioteki w obie strony, więc wybór dotyczy tego, czego potrzebujesz z pliku:
- Archiwum OnSong® to starszy format i to format do użycia w celu zapewnienia zgodności z wcześniejszymi wersjami OnSong.
- OnSong® Binder to obecny format. Używaj go do udostępniania z nowszymi wersjami OnSong — i gdy chcesz pliku, który możesz otworzyć i zbadać.
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 przesyłany w sieci.
Ponieważ plik binder to archiwum ZIP zwykłych plików JSON i zwykłych plików multimedialnych, to właściwy format do wyboru, gdy musisz zobaczyć, co OnSong faktycznie przechowuje — lub gdy coś musi przeczytać Twoją zawartość, a to nie jest OnSong.