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