ملف OnSong^®

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

تنسيق ملف 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.