ملف OnSong^® للمستندات

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

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

ما بالداخل

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

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

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

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

ما يحمله

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

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

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

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

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

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

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

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

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