كيفية استخدام ResolveURL في Kodi، نسخة معدلة من URLResolver

ResolveURL هو برنامج تابع يعمل في الخلفية لبرنامج Kodi، وليس مكتبة فيديو أو مشغلًا مستقلًا. يُنصح معظم المستخدمين بتثبيت الإضافة التي تحتاج إليه من مستودع موثوق؛ حيث يمكن لـ Kodi حينها تثبيت ResolveURL كبرنامج تابع. للتحقق من ذلك، افتح مدير التبعيات في Kodi. يمكن لمطوري الإضافات تعريف script.module.resolveurlResolveURL في ملف البيان الخاص بهم واستخدام واجهة برمجة تطبيقات Python الحالية الخاصة به.

ResolveURL هو نسخة معدلة من URLResolver. يُعرّف المشروع المُدار الحزمة script.module.resolveurlوينشرها عبر مستودع Kodi منفصل. أظهر فهرس المشروع الإصدار 5.1.212 عند التحقق منه في 27 أكتوبر 2026؛ استخدم الفهرس المباشر للإصدار الحالي لأنه قابل للتغيير. يتعامل ResolveURL فقط مع الروابط التي يدعمها كوده ولا يبحث في الإنترنت عن الأفلام أو المسلسلات. استخدمه مع المحتوى الذي لديك الحق في الوصول إليه.

ما يفعله ResolveURL في Kodi

قد يتلقى أحد إضافات Kodi رابط صفحة أو ملف لا يمثل بثًا مباشرًا قابلًا للتشغيل. تحاول مكتبة ResolveURL تحويل الروابط المدعومة إلى رابط بث يمكن لـ Kodi فتحه. وهي مكتبة مشتركة تستخدمها إضافات أخرى، لذا عادةً ما تتفاعل مع الإضافة الأصلية بدلًا من فتح ResolveURL من الشاشة الرئيسية لـ Kodi.

ResolveURL وURLResolver القديم عبارة عن حزمتين إضافيتين منفصلتين. لا يؤدي إنشاء نسخة معدلة تلقائيًا إلى استبدال جميع التبعيات القديمة أو إصلاح أي إضافة توقفت عن العمل. يُرجى مراجعة وثائق الإضافة قبل إجراء أي تغييرات أو إزالة أي شيء.

قم بتثبيته بالطريقة المعتادة

1. ابدأ بالإضافة التي تحتاج إلى ذلك. في Kodi، افتح "الإضافات" ، واختر "التثبيت من المستودع" ، ثم حدد ناشر الإضافة أو أي مستودع آخر تثق به، ثم ثبّت الإضافة المتوافقة. إذا كان ملف البيان الخاص بها يتطلب ResolveURL وكانت التبعية متوفرة في مستودع مُثبّت، فسيتولى Kodi تثبيت التبعية أثناء الإعداد.
2. استخدم مستودع المطور عند الحاجة فقط. إذا أرشدك الناشر تحديدًا إلى مستودع ResolveURL، فاحصل على ملف ZIP الخاص بالمستودع من مستودع ZIP الخاص بالمطور . افتح مجلد الأرشيف ZIP وحدد repository.resolveurlالحزمة الحالية. يُسجّل ملف ZIP الخاص بالمستودع مصدر تحديث، وليس وحدة ResolveURL نفسها.
3. قم بتثبيت ملف ZIP في Kodi. في متصفح الإضافات، اختر "التثبيت من ملف ZIP" ، ثم انتقل إلى مكان حفظ أو نسخ ملف ZIP، وحدده. قد يطلب منك Kodi تفعيل " مصادر غير معروفة" . تابع فقط إذا كنت تثق بالمصدر: يحذر Kodi من أن الإضافات من مصادر غير معروفة قد تصل إلى البيانات الشخصية على الجهاز. قد يختلف تصميم القائمة باختلاف إصدار Kodi أو واجهة المستخدم.
4. دع الإضافة التابعة تسحب الوحدة، ثم تحقق منها. ثبّت أو حدّث الإضافة التي تُعرّف ResolveURL. للتحقق من النتيجة، انتقل إلى الإعدادات > النظام > الإضافات > إدارة التبعيات وابحث عن ResolveURL. إذا كان هذا الإعداد مخفيًا، فغيّر مستوى الإعدادات في أسفل اليسار إلى "متقدم" . وجود تبعية مُدرجة ومُفعّلة يؤكد تثبيتها في Kodi، لكنه لا يضمن حلّ جميع روابط المضيف.

يفصل متصفح الإضافات تثبيت ملفات ZIP عن استعراض المستودعات المثبتة.

يحذر برنامج Kodi من أن الإضافات من مصادر غير معروفة قد تعرض البيانات الشخصية للخطر.

حدد ملف ZIP الخاص بالمستودع الذي حصلت عليه من أرشيف المسؤول عن الصيانة.

إدارة التبعيات هي المكان المناسب للتأكد من وجود ResolveURL وتفعيله.

استخدم ResolveURL في إضافة

بالنسبة للمطورين، أضف ResolveURL كاعتمادية مطلوبة في ملف الإضافة addon.xml. سمة الإصدار هي الحد الأدنى للإصدار الذي يحتاجه الكود الخاص بك؛ قم بمطابقته مع واجهة برمجة التطبيقات التي تستخدمها وإصدارات Kodi التي تدعمها.

<requires>
  <import addon="script.module.resolveurl" version="5.1.0" />
</requires>

ثم استخدم واجهة المشروع الأصلي HostedMediaFileللتحقق من عنوان URL المصدر المدعوم وحله:

import resolveurl

hosted_file = resolveurl.HostedMediaFile(source_url)
playable_url = hosted_file.resolve() if hosted_file else None

if not playable_url:
    # Report an unsupported or unavailable source to the user.
    pass

مرر عنوان URL الناتج إلى مسار تشغيل Kodi فقط بعد التأكد من صلاحية النتيجة. قد تعني النتيجة الخاطئة أو المفقودة أن المضيف غير مدعوم، أو أن عنوان URL المصدر قد انتهت صلاحيته، أو أن المضيف قد غيّر صفحته، أو أن الطلب قد فشل. لا يمكن للمُحلِّل تشغيل المحتوى غير المتاح أو غير المصرح به.

تم توثيق الواجهة الحالية ومثال التبعية في مستودع مصدر ResolveURL . يشرح دليل بيان الإضافات في Kodi عملية حل التبعية التلقائية، ويصف مرجع إعدادات الإضافات إدارة التبعيات والمصادر غير المعروفة.

استكشاف الأخطاء وإصلاحها دون التأثير على الإضافات الأخرى

• "التبعية غير متوفرة": قم بتحديث المستودع الذي يوفر الإضافة الرئيسية، وتأكد من اتصال Kodi بالإنترنت، وتأكد من أن الإضافة تدعم إصدار Kodi الخاص بك. لا يمكن لـ Kodi تثبيت سوى التبعيات المتوفرة من مستودع مُهيأ أو المُقدمة وفقًا لتوجيهات الناشر.
• خاصية ResolveURL مفقودة أو معطلة: تحقق من قائمة تبعيات الإضافة ورسالة التثبيت. قم بالتحديث من نفس المستودع الموثوق الذي وفّر الإضافة؛ تجنب استخدام ملفات ZIP من إصدارات مختلفة.
• لا يزال الرابط لا يعمل: تأكد من صحة رابط المصدر ودعمه، ثم راجع سجل الإضافة الأصلية أو صفحة الدعم. قد يتوقف ResolveURL عن العمل مع مضيف معين عند تغيير هذا المضيف لخدمته.
• إزالة مُحلِّل أسماء قديم: لا تحذف مجلدات إضافات Kodi يدويًا. قد يمنع Kodi إلغاء تثبيت أحد التبعيات طالما أن إضافة أخرى تستخدمه. قم بإزالته من خلال Kodi فقط عندما يُشير مدير التبعيات إلى أنه مُهمَل أو عندما لا تتطلبه أي إضافة.

باختصار، ثبّت الإضافة التي تتطلب ResolveURL من مصدر موثوق، ودع Kodi يدير تبعياتها، واستخدم وثائق المشروع المُحدّثة إذا كنت تُطوّر إضافة. تجنّب المستودعات أو الإضافات التي تُقدّم بثًا محميًا بحقوق الطبع والنشر دون ترخيص.