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

ملف 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® Binder هو الحالي. استخدمه للمشاركة مع الإصدارات الأحدث من OnSong — وعندما تريد ملفًا يمكنك فتحه والنظر بداخله.

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

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

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

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

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

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