Папка 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, содержащей сет, воссоздаёт сет и каждую песню в нём; импорт папки, содержащей одну песню, добавляет эту песню.

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

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

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