Папка OnSong^®

Формат файла OnSong^® Binder — это способ, которым OnSong перемещает песню, набор или целую книгу между библиотеками. Как и OnSong^® Archive, он содержит всё необходимое для восстановления контента где-то ещё — текст песни, вложения, стили, параметры, транспозицию и примечания — но если архив — это единый непрозрачный blob, то папка 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 импортируются как любой другой файл: откройте его из приложения "Файлы", Почты, AirDrop или облачного сервиса и выберите OnSong. При импорте папки Binder, содержащей набор, воссоздаются набор и каждая песня в нём; при импорте одной содержащей одну песню добавляется эта песня.

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

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

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