Folder OnSong^®

Format pliku OnSong^® Binder to sposób, w który OnSong przenosi piosenkę, zestaw lub całą książkę między bibliotekami. Podobnie jak Archiwum OnSong^®, zawiera wszystko, co jest potrzebne do odbudowania zawartości gdzie indziej — tekst piosenki, załączniki, style, ustawienia, transponowanie i adnotacje — ale podczas gdy archiwum to pojedynczy nieprzezroczysty blok, plik Binder to folder zwykłych plików. To sprawia, że jest czytelny, inspektowalny i może przenosić media, od których zależy piosenka, obok samej piosenki w niezależny od platformy sposób.

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 go i znajdziesz folder o nazwie identyfikatora elementu, zawierający:

• manifest.json — sam element, serializowany. Każda właściwość, którą zna OnSong, w tym samym kształcie, który używa OnSong web API.
• Jego plik, jeśli go ma. Załącznik zachowuje swoją oryginalną nazwę pliku, więc plik PDF lub MP3 wewnątrz 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 dokładnie o tym samym kształcie.

Ta struktura powtarza się aż do końca: zestaw zawiera piosenki, piosenka zawiera załączniki, a każdy z nich to folder ze swoim manifestem obok swoich plików. Plik Binder zawierający książkę dwustu piosenek ma ten sam format co ten zawierający pojedynczy akord.

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

Co niesie

• Piosenki — napis akordów i wszystko, co jest z nim połączone.
• Zestawy — piosenki w ich kolejności, wraz z własnym aranżacją zestawu.
• Książki — całą kolekcję.
• Załączniki — pliki PDF, obrazy, audio i wszelkie inne pliki powiązane z piosenką. Możesz wybrać dołączenie tylko załączników, które są faktycznie w użyciu, zamiast każdej wersji kiedykolwiek dodanej.

Plik Binder czy Archiwum?

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

• Archiwum OnSong^® to starszy format i to jest to, co należy użyć do kompatybilności z wcześniejszymi wersjami OnSong.
• OnSong^® Binder to obecny format. Użyj go do udostępniania z nowszymi wersjami OnSong — i gdy chcesz pliku, który możesz otworzyć i zobaczyć wnętrze.

Importowanie i eksportowanie

Pliki Binder importują się tak samo jak każdy inny plik: otwórz jeden z Plików, Poczty, AirDrop lub usługi chmury i wybierz OnSong. Importowanie pliku Binder zawierającego zestaw odtwarza zestaw i każdą piosenkę w nim; importowanie zawierającego pojedynczą piosenkę dodaje tę piosenkę.

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

Pliki Binder to również 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 przez sieć.

Ponieważ plik Binder to ZIP zwykłego JSON i zwykłych plików multimedialnych, to właściwy format do wyboru, gdy chcesz zobaczyć, co OnSong faktycznie przechowywał — lub gdy coś musi odczytać twoją zawartość i nie jest to OnSong.