كيفية إنشاء واستخدام مفتاح API لقاعدة بيانات التلفزيون: نصائح مطور Kodi

برنامج Kodi مجاني ومفتوح المصدر ، مما يعني أنه من الممكن لأي شخص التحقق من الرمز أو حتى المساهمة في تغييرات في الأعمال الأساسية. القوة الحقيقية وراء كودي هي مجتمعها. تم تصميم البرنامج للتفاعل مع الوظائف الإضافية التي يقدمها المستخدم والتي توفر مجموعة كبيرة ومتنوعة من المحتوى ، وهو ما لم يتمكن فريق Kodi الأساسي من تنفيذه بمفرده. تسمى هذه الإضافات غير الرسمية ، وهي سهلة الصنع ، يمكنك أن تبدأ بنفسك في فترة ما بعد الظهر!

إحدى الخدمات المفيدة للغاية المقدمة لمطوري Kodi الإضافيين هي مفهرسات قاعدة بيانات التلفزيون ، مواقع مثل TheTVDB.com أو Trakt. كلا الموارد تستحوذ على البيانات الوصفية من جميع أنحاء الويب وتوفر المعلومات للجمهور مجانًا. هذا يعني أنه يمكنك إنشاء وظيفة إضافية تعثر على برامج تلفزيونية مختلفة واستخدام TheTVDB لتصنيفها وتصنيفها وفرزها جميعًا. لا حاجة لجلب المعلومات بنفسك ، ولا داعي لبناء أداة تتبع خاصة بك. ما عليك سوى الحصول على مفتاح واجهة برمجة التطبيقات من قاعدة بيانات التلفزيون وتوصيله بالوظيفة الإضافية ، ثم يتم تعيينك. يرشدك دليلنا أدناه خلال العملية من البداية إلى النهاية.

تذكير

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

الخبر السار هو أن الشبكات الافتراضية الخاصة هي طريقة سهلة لهزيمة غزوات الخصوصية هذه. باستخدام شبكة افتراضية خاصة (VPN) ، سيتم تشفير بياناتك قبل أن تغادر جهازك ، مما يجعل من المستحيل على أي شخص رؤية المواقع التي تزورها أو أي مجموعات Kodi التي تقوم بالوصول إليها. تجعل الشبكات الافتراضية الخاصة أيضًا من الصعب اكتشاف هويتك أو موقعك ، مما يجلب قدرًا من عدم الكشف عن الهوية إلى شبكة الويب العالمية.

أفضل VPN لكودي - IPVanish

IPVanishتصل إلى جميع المواقع المناسبة لاستخدام VPN المثالي مع Kodi. إنه سريع ، حيث يوفر أكثر من 950 خادمًا في 60 دولة مختلفة ، لذا يمكنك دائمًا الحصول على اتصال منخفض الكمون بغض النظر عن المكان الذي تعيش فيه. كما أنها آمنة ، وتوفر تشفير 256-bit AES ، وحماية تسرب DNS ، ومفتاح إيقاف تلقائي لجميع الأجهزة. ستستفيد أيضًا من سياسة عدم تسجيل الدخول الرائعة بشأن حركة المرور وستتمكن من تنزيل السيول ومحتوى شبكة P2P مع عدم الكشف عن هويته بالكامل. مع IPVanish ، كل ما عليك فعله هو تشغيل التطبيق واتصالك آمن.

المزيد من ميزات IPVanish:

• تطبيقات سهلة الاستخدام لأنظمة Windows و Mac و Linux و Android و iOS.
• عرض نطاق ترددي غير محدود بدون أغطية للسرعة أو اختناق.
• وصول كامل ومجهول إلى جميع وظائف Kodi الإضافية.

تقدم IPVanish ضمان استعادة الأموال لمدة 7 أيام مما يعني أن لديك أسبوعًا لاختباره بدون مخاطر. يرجى ملاحظة ذلك يمكن للقراء نصائح الإدمان حفظ 60٪ ضخمة هنا على الخطة السنوية IPVanish، مع تخفيض السعر الشهري إلى 4.87 دولار شهريًا فقط.

قبل ان تبدأ

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

ما هي قاعدة بيانات التلفزيون؟

إذا كنت تطور إضافة Kodi ، فمن المحتمل أنك تخطط لفهرسة قدر كبير من محتوى الفيلم أو البرنامج التلفزيوني. عادةً ما تقدم المواقع التي توفر معظم هذه الملفات مقاطع فيديو فقط ، وليس البيانات المصاحبة التي تساعد في تحديد المحتوى. من المحتمل أن يحتوي اسم الملف على العرض والموسم ورقم الحلقة ، ولكن ماذا عن الممثلين أو العنوان الفعلي للحلقة؟ وهنا يأتي دور قواعد بيانات الفهرسة.

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

ما المعلومات التي تتضمنها قاعدة البيانات؟

يمكن أن يختلف هذا بناءً على الخدمة التي تستخدمها ، لكن معظم المفهرسين يركزون على مجموعة أساسية من البيانات التي تتضمن ما يلي:

• عنوان العرض الكامل وتاريخ البث الأصلي.
• أسماء وأرقام الحلقات.
• معلومات النوع.
• بيانات عن الممثلين والمخرجين والكتاب ، إلخ.
• فن الملاكمة ، سواء كان من صنع مروحة أو رسمي.
• تقييمات المستخدمين وعشرات مراجعة النقاد.
• ترجمة البيانات الوصفية إلى لغات أخرى.

أين المعلومات تأتي من؟

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

مفاتيح API

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

أي قاعدة بيانات للاستخدام

هناك أكثر من قاعدة بيانات فهرسة عائمة حول الشبكة العالمية. بعضها أسهل في الاستخدام من غيرها ، والبعض الآخر ببساطة أكثر حداثة من منافسيهم. في دليلنا أدناه ، سنغطي عملية إنشاء واجهة برمجة التطبيقات لموقع TheTVDB.com ، وهي قاعدة بيانات مفتوحة لعشاق التلفزيون. إنه أحد الموارد الأكثر اكتمالاً ويسهل إعداده ونشره.

هل مؤشرات البيانات الوصفية قانونية؟

هم بالتأكيد. خدمات الفهرسة مثل قاعدة بيانات التلفزيون التي سنستخدمها أدناه لا تصل إلا إلى البيانات الوصفية المحيطة بجزء من المحتوى ، وليس الملف نفسه. لا يمكنك استخدامها لتدفق أي شيء ، ولا تساهم في القرصنة بأي شكل من الأشكال. عادة ما يتم ترخيصهم أيضًا بموجب ترخيص Creative Commons للتوزيع المجاني. إنه المعادل الرقمي لتنظيم مجموعة أقراص DVD الخاصة بك على الرف. آمنة تماما وقانونية 100٪.

إنشاء مفتاح API لقاعدة بيانات التلفزيون

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

الخطوة 1 - إنشاء حساب

يزور TheTVDB.com وإنشاء حساب بالخدمة. استخدم مقبض الترميز الخاص بك أو حتى عنوان الوظيفة الإضافية لتحقيق الاتساق. بمجرد التسجيل ، ستحتاج إلى تسجيل الدخول ، ثم الموافقة على الشروط والأحكام عن طريق التمرير لأسفل وتحديد المربع الموجود أسفل الصفحة.

الخطوة 2 - توليد المفتاح

بمجرد أن يكون لديك حساب ، توجه إلى صفحة تسجيل مفتاح API. في الجزء السفلي ، ستحتاج إلى إدخال اسم مشروعك جنبًا إلى جنب مع موقعه الرسمي على الويب. انقر على "استرداد مفتاح واجهة برمجة التطبيقات" بمجرد الانتهاء.

الخطوة 3 - حفظ مفتاح API

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

استخدام مفتاح API في إضافة Kodi الخاصة بك

بمجرد إنشاء مفتاح API مع TheTVDB أو أي خدمة أخرى لفهرسة البيانات الوصفية ، فقد حان الوقت لتوصيله برمز الوظيفة الإضافية للتأكد من أنه يعمل. يمكن أن تختلف هذه العملية اعتمادًا على كيفية تنظيم إضافتك. سنستخدم قالب Jen ، وهي طريقة مستخدمة على نطاق واسع للجمع بين المتتبعات وإضافات Kodi.

الخطوة 1 - قم بتنزيل قالب جين

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

الخطوة 2 - تحرير Addon.xml

داخل المجلد plugin.video.jen-master الذي قمت بفك ضغطه للتو ، ستجد ملفًا يسمى addon.xml. افتح هذا في محرر التعليمات البرمجية الخاص بك. ستحتاج إلى إجراء بعض التعديلات على بعض الأسطر لتخصيص البيانات التي يشير إليها القالب. ابدأ بملء المعلومات في السطر الثاني من الملف ، المشار إليه أدناه. تذكر استخدام الأحرف والأرقام فقط ، ولا توجد مسافات أو أحرف غير قياسية ، ولا تنس تعيين رقم الإصدار أيضًا.

بعد ذلك ، قم بتحرير السطور 19 و 21 لإعطاء مزيد من المعلومات حول إضافتك.

ملخص أدون

وصف أدون أطول

قد ترى خطوط مكررة تشير إلى لغات أخرى. يمكنك تركها بمفردها أو إزالتها كما تراه مناسبًا.

احفظ ملف addon.xml ، لقد انتهيت من تحريره الآن.

الخطوة 3 - تحرير Default.py

هذا هو المكان الذي نبدأ فيه الدخول إلى معلومات مفتاح واجهة برمجة التطبيقات. في نفس المجلد ذي المستوى الأعلى ، ابحث عن الملف المسمى default.py. افتحها في محرر التعليمات البرمجية ، ثم قم بالتمرير لأسفل حتى ترى السطر المشار إليه أدناه. يجب أن يكون حول السطر 25.

__builtin __. tvdb_api_key = “PASTE API KEY HERE” # tvdb api key

أدخل مفتاح API لقاعدة بيانات التلفزيون في المكان الموضح أعلاه. سيتضمن السطر الفعلي علامتي اقتباس فقط دون وجود أي بينهما.

احفظ default.py واخرج الآن. تم إدخال مفتاح API الخاص بك!

الخطوة 4 - تحرير Settings.xml

ملف أخير للتعديل ، ثم يعود إلى الاختبار. أدخل مجلد الموارد الموجود في دليل عمل المكون الإضافي. افتح settings.xml في محرر التعليمات البرمجية ، ثم قم بالتمرير لأسفل إلى حوالي السطر 27. هناك بعض المعلومات التي سنحتاج إلى إدخالها هنا لإنهاء إعداد قالب Jen.

تحقق من السطر التالي في رمز الملف. يجب أن تظهر ثلاث مرات في السطور 27 و 31 و 36.

action = "RunPlugin (plugin: //plugin.video.jen/؟ mode = ScraperSettings)" />

انظر أين تقول plugin.video.jen? قم بتغيير هذا إلى نفس اسم البرنامج المساعد الذي أدخلته في ملف addon.xml. إذا أدخلت plugin.video.addictivetips ، على سبيل المثال ، فسيبدو السطر كما يلي:

action = "RunPlugin (plugin: //plugin.video.addictivetips/؟ mode = ScraperSettings)" />

احفظ هذا الملف واخرج.

الخطوة 5 - إعادة التسمية والاختبار

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

plugin.video.jen-master

قم بتغيير هذا ليعكس الاسم الذي أدخلته في ملف addon.xml ، متبوعًا برقم الإصدار الذي أدخلته في نفس القسم. باستخدام المثال أعلاه ، سيتم تسمية الملف الآن بهذا:

plugin.video.addictivetips.0.1.zip

هذا هو! لقد أضفت الآن بيانات واجهة برمجة تطبيقات TVDB إلى إضافتك وأنت على استعداد لبدء استخراج البيانات الوصفية من الويب.

تخصيصات إضافية أخرى

بمجرد الحصول على قالب Jen ومفتاح API لقاعدة بيانات التلفزيون ، لماذا لا تقفز وتضيف بعض ميزات التخصيص الإضافية للمساعدة في وضع العلامة التجارية لإصدارك؟ هذه خطوات سريعة وبسيطة يمكن أن تقطع شوطا طويلا لجعل إضافتك أكثر قابلية للتمييز.

أضف أيقونة

يتم عرض صور الرموز في Kodi على الجانب الأيسر من الشاشة في كل مرة يتم فيها تمييز الإضافة. إن إضافة واحدة تجعل من السهل اكتشاف المحتوى الخاص بك دون الحاجة إلى قراءة العناوين ، والتي يمكن أن تكون أكثر فائدة مما تعتقد! لاستخدام الرمز ، كل ما عليك فعله هو إنشاء ملف PNG 256 × 256 ، ويفضل ألا يكون هناك نص أو علامة Kodi التجارية ، ثم إضافته إلى المستوى العلوي من المجلد الخاص بك باسم icon.png. هذا هو!

استخدم فن المعجبين

على غرار الرمز أعلاه ، فإن صورة المعجبين هي خلفية خلفية تظهر خلف نص التحديد في Kodi كلما قام المستخدمون بتمييز المحتوى الخاص بك. يمكن أن يكون هذا مرتبطًا بالعلامة التجارية للرمز الخاص بك أو يمكن أن يكون شيئًا موضوعيًا للمحتوى الإضافي الخاص بك. على سبيل المثال ، إذا كان المكون الإضافي يقدم برامج تلفزيونية ، فقم بإنشاء شعار أصلي لفن المعجبين بأحرف من How I Met Your Mother. لإضافة هذا إلى إصدارك ، ما عليك سوى إنشاء صورة بتنسيق 1280 × 720 JPG ، وتسميتها fanart.jpg ، ثم لصقها في مجلد المستوى الأعلى لإضافتك.

استنتاج

يمكن أن يكون تطوير الوظيفة الإضافية عملية مربكة ومعقدة. يوفر المجتمع الكثير من الموارد المفيدة لمنحك المساعدة على طول الطريق. إن إضافة مفتاح API لقاعدة بيانات التلفزيون هو مجرد مثال واحد على المحتوى الذي صنعه المستخدم والذي يكون جاهزًا للتفاعل مع إضافتك دون القفز عبر جميع أنواع الأطواق لجعلها تعمل. هل لديك أي نصائح لمساعدة مطوري Kodi الناشئين؟ شارك علمك في التعليقات أدناه!