دليل المستخدم
ملف OnSong®
صيغة ملف OnSong® Binder هي الطريقة التي يستخدمها OnSong لنقل أغنية أو مجموعة أو كتاب كامل بين المكتبات. مثل أرشيف OnSong®، فهو يحمل كل ما هو مطلوب لإعادة بناء المحتوى في مكان آخر — نص الأغنية والمرفقات والأنماط والإعدادات والتنقل والتعليقات التوضيحية — لكن حيث يكون الأرشيف كتلة معتمة واحدة، فإن Binder هو مجلد من الملفات العادية. هذا يجعله قابلاً للقراءة والفحص وقادراً على حمل الوسائط التي تعتمد عليها الأغنية إلى جانب الأغنية نفسها بطريقة مستقلة عن النظام الأساسي.
صيغة ملف OnSong® Binder لها امتداد ملف إما .onsongbinder أو .binder، ونوع MIME يساوي application/onsong-binder.
ما في الداخل
Binder عبارة عن أرشيف ZIP. قم بفك ضغط واحد وستجد مجلد مسمى بعد معرف العنصر، يحتوي على:
manifest.json— العنصر نفسه، مسلسل. كل خاصية يعرفها OnSong عنها، بنفس الشكل الذي تستخدمه واجهة برمجة تطبيقات OnSong للويب.- ملفه، إذا كان لديه واحد. يحتفظ المرفق باسم الملف الأصلي، لذا فإن ملف PDF أو MP3 داخل Binder هو فقط هذا ملف PDF أو MP3.
- مجلدات لأطفاله، مسماة بناءً على ما هي عليه —
songsوattachments— كل منها يحتوي على مزيد من المجلدات بنفس الشكل بالضبط.
تتكرر هذه البنية طوال الطريق للأسفل: تحتوي المجموعة على أغاني، والأغنية تحتوي على مرفقات، وكل منها عبارة عن مجلد يحتوي على بيان البيانات الخاص به بجانب ملفاته الخاصة. Binder الذي يحتوي على كتاب من مائتي أغنية له نفس صيغة الملف مثل الملف الذي يحتوي على مخطط واحد.
داخل البيان، يتم وضع علامات على المراجع للأطفال بـ $binder. بادئة، بحيث يمكن للقارئ معرفة الفرق بين القيمة التي تنتمي إلى العنصر وواحدة تشير إلى مجلد بجانبه.
ما الذي يحمله
- الأغاني — مخطط الوتر وكل شيء مرفق به.
- المجموعات — الأغاني بترتيبها، مع ترتيب المجموعة الخاصة بها.
- الكتب — مجموعة كاملة.
- المرفقات — ملفات PDF والصور والصوت وأي ملف آخر مرتبط بأغنية. يمكنك اختيار تضمين المرفقات المستخدمة بالفعل فقط بدلاً من كل نسخة تمت إضافتها على الإطلاق.
Binder أم الأرشيف؟
كلاهما ينقل محتوى المكتبة بأمانة ذهاباً وإياباً، لذا فإن الخيار يتعلق بما تحتاجه من الملف:
- أرشيف OnSong® هو الصيغة الأقدم، وهو ما يجب استخدامه للتوافق مع الإصدارات الأقدم من OnSong.
- OnSong® Binder هو الحالي. استخدمه عند المشاركة مع إصدارات أحدث من OnSong — وعندما تريد ملف يمكنك فتحه والنظر بداخله.
الاستيراد والتصدير
تستورد Binders بالطريقة التي يستوردها أي ملف آخر: افتح واحد من Files أو Mail أو AirDrop أو خدمة سحابية واختر OnSong. استيراد Binder الذي يحمل مجموعة يعيد إنشاء المجموعة وكل أغنية فيها؛ استيراد واحد يحمل أغنية واحدة يضيف تلك الأغنية.
لإنشاء واحد، استخدم المشاركة واختر OnSong Binder كالصيغة.
Binders هي أيضاً ما يرسله OnSong Connect بين الأجهزة عندما يطلب جهاز واحد من جهاز آخر أغنية أو مجموعة، لذا فإن نفس الصيغة التي تعيش في تطبيق Files هي التي تنتقل عبر الشبكة.
لأن Binder عبارة عن ZIP من JSON عادي وملفات وسائط عادية، فهي الصيغة الصحيحة التي يجب الوصول إليها عندما تحتاج إلى رؤية ما قام OnSong بتخزينه فعلاً — أو عندما يحتاج شيء ما إلى قراءة محتواك وليس OnSong.