Папка OnSong^®

Формат файлу OnSong^® Binder — це спосіб, яким OnSong переміщує пісню, набір або цілу книгу між бібліотеками. Як і OnSong^® Archive, він містить все необхідне для відновлення вмісту в іншому місці — текст пісні, вкладення, стилі, налаштування, транспозицію та примітки — але якщо архів — це один непрозорий blob, то папка — це папка звичайних файлів. Це робить його читаним, перевіряємим і здатним переносити медіа, від яких залежить пісня, поряд з самою піснею платформонезалежним способом.

Формат файлу OnSong^® Binder має розширення файлу .onsongbinder або .binder та тип MIME application/onsong-binder.

Що всередині

Папка — це ZIP-архів. Розпакуйте його, і ви знайдете папку з назвою ідентифікатора елемента, яка містить:

• manifest.json — сам елемент, серіалізований. Кожна властивість, яку OnSong про нього знає, у тій же формі, що й OnSong web API використовує.
• Його файл, якщо він у нього є. Вкладення зберігає своє вихідне ім'я файлу, тому 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.