Папка OnSong^®

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

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

Что внутри

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

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

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

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

Что она несёт

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

Папка для привязки или архив?

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

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

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

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

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

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

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