ملف OnSong^®

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

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

ما بالداخل

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

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

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

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

ما يحمله

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

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

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

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

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

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

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

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

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