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