دليل المستخدم

ملف OnSong®

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

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

ما بالداخل

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

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

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

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

ما يحمله

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

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

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

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

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

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

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

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

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

OnSong 2026 — آخر تحديث في September 1, 2026