ملف 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 — كل منها يحمل مجلدات إضافية بنفس الشكل تماماً.

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

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

ما يحمله

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

المجلد أم الأرشيف؟

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

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

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

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

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

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

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