Папка OnSong^®

Формат файла OnSong^® Binder — это способ, которым OnSong перемещает песню, сет или целую книгу между библиотеками. Как OnSong^® Archive, он содержит всё необходимое для восстановления содержимого в другом месте — текст песни, вложения, стили, настройки, транспозицию и примечания — но если архив представляет собой единый непрозрачный блоб, то папка Binder — это папка с обычными файлами. Это делает его читаемым, проверяемым и способным переносить медиафайлы, которые зависят от песни, вместе с самой песней независимо от платформы.

Формат файла OnSong^® Binder имеет расширение файла .onsongbinder или .binder и тип MIME application/onsong-binder.

Что находится внутри

Папка Binder — это ZIP-архив. Разархивируйте его, и вы найдёте папку с названием, основанным на идентификаторе элемента, содержащую:

• manifest.json — сам элемент в сериализованном виде. Каждое свойство, которое знает OnSong, в том же виде, который использует веб-API OnSong.
• Его файл, если он есть. Вложение сохраняет своё исходное имя файла, поэтому PDF или MP3 внутри папки Binder — это просто этот PDF или MP3.
• Папки для его дочерних элементов, названные в соответствии с их типом — songs, attachments — каждая содержит дополнительные папки точно такой же структуры.

Эта структура повторяется на всех уровнях: сет содержит песни, песня содержит вложения, и каждый из них — это папка со своим манифестом рядом со своими файлами. Папка Binder, содержащая книгу из двухсот песен, имеет тот же формат, что и папка, содержащая один лист.

Внутри манифеста ссылки на дочерние элементы отмечены префиксом $binder., так что читатель может отличить значение, принадлежащее элементу, от значения, указывающего на папку рядом с ним.

Что он содержит

• Песни — лист аккордов и всё, что к нему прикреплено.
• Сеты — песни в их порядке с собственной аранжировкой сета.
• Книги — целую коллекцию.
• Вложения — PDF, изображения, аудио и любые другие файлы, связанные с песней. Вы можете выбрать включение только тех вложений, которые фактически используются, а не каждой версии, когда-либо добавленной.

Папка Binder или Archive?

Обе форматы верно воспроизводят содержимое библиотеки, поэтому выбор зависит от того, что вам нужно от файла:

• OnSong^® Archive — более старый формат, его следует использовать для совместимости с более ранними версиями OnSong.
• OnSong^® Binder — текущий формат. Используйте его для совместного использования с новыми версиями OnSong — и когда вам нужен файл, который вы можете открыть и посмотреть внутри.

Импорт и экспорт

Папки Binder импортируются как любой другой файл: откройте одну из приложения Files, Mail, AirDrop или облачного сервиса и выберите OnSong. Импорт папки Binder, содержащей сет, воссоздаёт сет и каждую песню в нём; импорт папки, содержащей одну песню, добавляет эту песню.

Чтобы создать папку, используйте Поделиться и выберите OnSong Binder как формат.

Папки Binder — это также то, что OnSong Connect отправляет между устройствами, когда одно устройство запрашивает у другого песню или сет, поэтому тот же формат, который находится в приложении Files, — это тот, который передаётся по сети.

Поскольку папка Binder — это ZIP-архив простого JSON и обычных медиафайлов, это правильный формат, к которому можно обратиться, когда вам нужно узнать, что OnSong на самом деле сохранил — или когда что-то нужно прочитать ваш контент, а это не OnSong.