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