Папка 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 — і коли вам потрібен файл, який ви можете відкрити та переглянути.

Імпорт і експорт

Папки імпортуються як будь-який інший файл: відкрийте його з Файлів, Пошти, AirDrop або хмарної служби та виберіть OnSong. Імпорт папки, що містить набір, відновлює набір і кожну пісню в ньому; імпорт однієї, що містить одну пісню, додає цю пісню.

Щоб створити одну, використовуйте Поділитися і виберіть OnSong Binder як формат.

Папки також те, що OnSong Connect відправляє між пристроями, коли один пристрій просить у іншого пісню або набір, тому той самий формат, який живе у вашій програмі Файлів, — це той, що подорожує мережею.

Оскільки папка — це ZIP звичайного JSON і звичайних медіафайлів, це правильний формат, коли вам потрібно подивитися, що насправді зберіг OnSong — або коли щось потребує прочитати ваш вміст, а це не OnSong.