Папка OnSong^®

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

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

Що Всередині

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

• manifest.json — сам елемент, серіалізований. Кожна властивість, яку знає OnSong про нього, у тій же формі, яку використовує OnSong веб-API.
• Його файл, якщо він у нього є. Вкладення зберігає своє оригінальне ім'я файлу, тому PDF або MP3 всередині папки-Binder це просто цей PDF або MP3.
• Папки для його дітей, названі за тим, чим вони є — songs, attachments — кожна містить більше папок абсолютно тієї ж форми.

Ця структура повторюється весь час: набір містить пісні, пісня містить вкладення, і кожна це папка зі своєю маніфестом поруч зі своїми файлами. Папка-Binder, що тримає книгу з двохсот пісень, має той же формат, що і одна, яка тримає один чарт.

Всередину маніфесту посилання на дітей позначаються префіксом $binder., щоб читач міг розрізнити значення, яке належить елементу, та те, яке вказує на папку поруч з ним.

Що Вона Несе

• Пісні — акордова схема та все, що до неї додано.
• Набори — пісні в їх порядку зі своїм аранжуванням набору.
• Книги — вся колекція.
• Вкладення — PDF, зображення, аудіо та будь-які інші файли, пов'язані з піснею. Ви можете вибрати включення лише вкладень, які фактично використовуються, а не кожної версії, коли-небудь доданої.

Папка-Binder Чи Архів?

Обидва бездоганно повертають вміст бібліотеки, тому вибір залежить від того, що вам потрібно від файлу:

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

Імпорт І Експорт

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

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

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

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