Папка 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.