ملزمة OnSong^®

تنسيق ملف OnSong^® Binder هو الطريقة التي ينقل بها OnSong أغنية أو مجموعة أو كتابًا كاملاً بين المكتبات. مثل OnSong^® Archive، فإنه يحمل كل ما هو مضروري لإعادة بناء المحتوى في مكان آخر — نص الأغنية والمرفقات والأنماط والإعدادات والتحويل والملاحظات — لكن حيث أن الأرشيف عبارة عن بلوب معتم واحد، فإن Binder عبارة عن مجلد من الملفات العادية. يجعل هذا قابل للقراءة والفحص، وقادر على نقل الوسائط التي تعتمد عليها أغنية إلى جانب الأغنية نفسها بطريقة مستقلة عن المنصة.

تنسيق ملف OnSong^® Binder له امتداد ملف إما .onsongbinder أو .binder، ونوع MIME من application/onsong-binder.

ما بالداخل

Binder عبارة عن أرشيف ZIP. فك ضغط واحد وستجد مجلدًا باسم معرّف العنصر، يحتوي على:

• manifest.json — العنصر نفسه، معاد تسلسله. كل خاصية يعرفها OnSong، بنفس الشكل الذي تستخدمه واجهة برمجة تطبيقات ويب OnSong.
• ملفه، إن كان لديه واحد. يحتفظ المرفق باسم الملف الأصلي، لذا فإن ملف PDF أو MP3 داخل binder هو فقط ذلك ملف PDF أو MP3.
• مجلدات لعناصره الفرعية، مسماة حسب ما هي عليه — songs، attachments — كل منها يحتفظ بمجلدات أخرى بنفس الشكل تمامًا.

يتكرر هذا الهيكل طوال الطريق: تحتوي المجموعة على أغانٍ، والأغنية تحتوي على مرفقات، وكل منها عبارة عن مجلد به manifest خاص به إلى جانب ملفاته الخاصة. Binder يحتوي على كتاب من مائتي أغنية هو نفس التنسيق الذي يحمل مخطط واحد.

داخل manifest، يتم تمييز المراجع للعناصر الفرعية بـ بادئة $binder.، حتى يتمكن القارئ من التمييز بين قيمة تخص العنصر وقيمة تشير إلى مجلد بجانبه.

ما الذي يحمله

• الأغانى — مخطط الأوتار وكل شيء مرفق به.
• المجموعات — الأغانى بترتيبها، مع ترتيب المجموعة الخاص بها.
• الكتب — مجموعة كاملة.
• المرفقات — ملفات PDF والصور والصوت وأي ملف آخر مرتبط بأغنية. يمكنك اختيار تضمين المرفقات المستخدمة فقط بدلاً من كل إصدار تمت إضافته على الإطلاق.

Binder أم Archive؟

كلاهما يدور بأمان محتويات المكتبة، لذا فإن الاختيار يتعلق بما تحتاجه من الملف:

• OnSong^® Archive هو التنسيق الأقدم، وهو ما يجب استخدامه للتوافق مع الإصدارات السابقة من OnSong.
• OnSong^® Binder هو التنسيق الحالي. استخدمه للمشاركة مع إصدارات أحدث من OnSong — وعندما تريد ملفًا يمكنك فتحه والنظر بداخله.

الاستيراد والتصدير

يتم استيراد Binders بنفس الطريقة مثل أي ملف آخر: افتح واحدًا من Files أو Mail أو AirDrop أو خدمة سحابية واختر OnSong. يؤدي استيراد binder يحتوي على مجموعة إلى إعادة إنشاء المجموعة وكل أغنية فيها؛ يؤدي استيراد واحد يحتوي على أغنية واحدة إلى إضافة تلك الأغنية.

لإنشاء واحدة، استخدم مشاركة واختر OnSong Binder كتنسيق.

Binders هي أيضًا ما يرسله OnSong Connect بين الأجهزة عندما يطلب جهاز من جهاز آخر أغنية أو مجموعة، لذا فإن نفس التنسيق الموجود في تطبيق الملفات الخاص بك هو الذي ينتقل عبر الشبكة.

نظرًا لأن binder عبارة عن ZIP من JSON عادي وملفات وسائط عادية، فهو التنسيق الصحيح الذي يجب اللجوء إليه عندما تحتاج إلى معرفة ما خزنه OnSong فعليًا — أو عندما يحتاج شيء ما إلى قراءة محتواك وليس OnSong.