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