ملزمة OnSong^®

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

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

ما بالداخل

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

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

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

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

ما يحمله

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

ملزمة أم أرشيف؟

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

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

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

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

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

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

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