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.