כיצד ליצור ולהשתמש במפתח API של מסד נתונים לטלוויזיה: טיפים למפתחים של Kodi
תוכנת Kodi הינה בחינם וקוד פתוח,כלומר, כל אחד יכול לבדוק את הקוד או אפילו לתרום שינויים בתפקוד הליבה. אולם הכוח האמיתי שמאחורי קודי הוא הקהילה שלה. התוכנה תוכננה לממשק עם תוספות תוצרת משתמש המספקות מגוון עצום של תכנים, דברים שצוות הליבה של קודי לא יכול היה ליישם מעצמם. אלה נקראים תוספות לא רשמיות, והם כל כך קלים להכין, אתה יכול להתחיל משלך אחר צהריים!
שירות שימושי להפליא הניתן לקודימפתחי תוספים הם אינדקסים למסדי נתונים בטלוויזיה, אתרים כמו TheTVDB.com או Trakt. שני המשאבים מגרדים מטא נתונים מרחבי הרשת ומספקים את המידע לציבור בחינם. המשמעות היא שתוכלו לבנות תוסף שמוצא תכניות טלוויזיה שונות ולהשתמש ב- TheTVDB כדי לסווג, לתייג ולמיין את כולם. אין צורך להביא מידע בעצמך, ואין צורך לבנות גשש משלך. פשוט תפוס מפתח API ממסד נתונים טלוויזיה וחבר אותו לתוסף שלך ואז אתה מוגדר. המדריך שלנו להלן מדריך אותך בתהליך מתחילתו ועד סופו.
הצעה בלעדית: חסוך 49%. נסה ExpressVPN ללא סיכון!
קבל את ה- VPN מדורג 1
ערבות 30 יום להחזר הכסף
כיצד להשיג VPN בחינם למשך 30 יום
אם אתה זקוק ל- VPN למשך זמן קצר בעת נסיעה למשל, אתה יכול לקבל את ה- VPN המדורג המוביל שלנו ללא תשלום. ExpressVPN כולל ערבות להחזר כספי של 30 יום. תצטרך לשלם עבור המנוי, עובדה זו, אך היא מאפשרת זאת גישה מלאה למשך 30 יום ואז אתה מבטל לקבלת החזר מלא. מדיניות הביטול ללא השאלות שלהם עומדת בשמה.
תזכורת
אם אתה מפתח תוסף עבור Kodi, אתהמודע היטב לעמדה של התוכנה בעיני הציבור. קודי עצמה בטוחה, ורוב התוספות שלה גם כן. ספקי שירותי אינטרנט ויוצרי תוכן חושבים לעתים קרובות אחרת, מה שאומר שברגע שאתה זורם משהו בקודי, חשבונך עשוי להיבדק. לא משנה אם ההרחבה שלך לגיטימית או לא, אתה עדיין בסכנת שיחנק או שתעקוב אחר חשבונך.
החדשות הטובות הן שרשתות וירטואליות פרטיות הןדרך קלה להביס את פלישות הפרטיות הללו. עם VPN הנתונים שלך יוצפנו לפני שהם עוזבים את המכשיר שלך, מה שמאפשר לאף אחד לראות באילו אתרים אתה מבקר או לאילו Kodi הזרמים אתה ניגש. VPNs גם מקשים על גילוי זהותך או מיקומך, ומחזירים מידה של אנונימיות לרשת העולמית.
ה- VPN הטוב ביותר לקודי - IPVanish
IPVanish מכה בכל המקומות הנכונים עבור ה- VPN המושלם אליולהשתמש עם קודי. זה מהיר, ומציע למעלה מ- 950 שרתים ב -60 מדינות שונות, כך שתוכל תמיד לגשת לחיבור אחסון נמוך לא משנה היכן אתה גר. זה גם מאובטח, ומספק הצפנת AES של 256 סיביות, הגנת דליפות DNS ומתג להרוג אוטומטי לכל המכשירים. תוכלו לנצל מדיניות נהדרת של רישום אפס בתעבורה ותוכלו להוריד סיקורים ותכני רשת P2P באנונימיות מלאה. עם IPVanish כל שעליך לעשות הוא להפעיל את האפליקציה והחיבור שלך מאובטח.
תכונות נוספות של IPVanish:
- אפליקציות קלות לשימוש עבור Windows, Mac, Linux, Android ו- iOS.
- רוחב פס בלתי מוגבל ללא כובעי מהירות או מצערת.
- גישה מלאה ואנונימית לכל התוספות של קודי.
IPVanish מציעה אחריות להחזר כספי למשך 7 ימים, מה שאומר שיש לך שבוע לבדוק אותו ללא סיכון. שים לב ש קוראים של טיפים ממכרים יכולים לחסוך 60% מאסיביים כאן בתוכנית השנתית IPVanishומוריד את המחיר החודשי לרמה של 4.87 $ לחודש בלבד.
לפני שאתה מתחיל
בדיוק כמו כל מפתח טוב, אתה עושה את שלךמחקר לפני שצוללים ראשונים ראשונים. קרא את הסעיפים הבאים כדי לברר את התפיסות השגויות שיש לך, ואז אל תהסס לתפוס את ה- API שלך ולהתחיל לבדוק.
מהו מאגר טלוויזיה?
אם אתה מפתח תוסף לקודי, סביר להניחאתה מתכנן להוסיף לאינדקס כמות משמעותית של תכני סרטים או תכניות טלוויזיה. האתרים שמספקים את מרבית הקבצים הללו בדרך כלל מספקים סרטונים בלבד, ולא נתונים נלווים המסייעים בזיהוי התוכן. שם הקובץ מכיל כנראה את ההצגה, העונה ומספר הפרק, אבל מה עם השחקנים או הכותרת בפועל של הפרק? כאן נכנסים לשחק מאגרי אינדקס.
על ידי חיבור התוסף שלך לקודי למסד נתונים טובאתה יכול בקלות לקטלג ולסווג את כל התוכן אליו נגשת התוכנית שלך מהאינטרנט. קל יהיה למיין את הפרקים ולחפש את התוסף שלך, והם יהיו קלים יותר בעיניים בזכות המטא נתונים שנגרדו משירות האינדקס.
איזה מידע כולל מסד נתונים?
זה יכול להשתנות בהתאם לשירות בו אתה משתמש, אך רוב המדדים מתמקדים בקבוצת ליבה הכוללת את הדברים הבאים:
- כותרת השלמה של המופע ותאריך האוויר המקורי.
- שמות ומספרים של הפרק.
- מידע על ז'אנר.
- נתונים על שחקנים, במאים, סופרים וכו '.
- אמנות קופסא, מעוצבת על ידי אוהדים וגם רשמית.
- ציוני ביקורות וביקורות מבקרים.
- מטא נתונים המתורגמים לשפות אחרות.
מאיפה המידע מגיע?
מגוון מקורות שעשויים להפתיע אתכם. מכיוון שמידע מדויק חשוב, מגרדי מסד הנתונים מתקרבים ככל האפשר למקור. פירוש הדבר בדרך כלל הפניה לאתרים רשמיים כמו אמזון או IMDB, ששניהם מקבלים את כותרות התצוגה שלהם וקטעי מידע קשורים מהאולפנים עצמם. אם נכשל בכך, אינדקסרים אחרים צולבים את התוכן שלהם עם עוקבים פתוחים אחרים או מסתמכים על נתונים שהוגשו על ידי המשתמש כדי לתייג גרסאות מופע.
מפתחות API
API מייצג ממשק תכנות יישומים. מפתחות API הם קבצי הרשאה קטנים או מחרוזות של אותיות ומספרים אקראיים המקנים גישה לתוכנית לשירות ספציפי. אם אתה בונה אפליקציה שתשתמש בה בטוויטר, למשל, אתה צריך מפתח API כדי שהאתר יאפשר לקוד שלך להתממשק עם התוכן של טוויטר. מפתחות לאינדקסים של מסדי נתונים בטלוויזיה פועלים באותה צורה. על ידי הוספת מפתח API לתוסף Kodi שלך, אתה נותן לו את האישורים הדרושים לו כדי לשלוף נתונים מהאתר החיצוני ולהשתמש בהם בתוך Kodi.
באיזה בסיס נתונים להשתמש
יש יותר ממסד נתונים לאינדקסים צף אחדברחבי העולם. לחלקם קל יותר להשתמש בהשוואה לאחרים, וחלקם פשוט מעודכנים יותר מהתחרות שלהם. עבור המדריך שלנו להלן, אנו נסקור את תהליך יצירת ה- API עבור TheTVDB.com, המהווה בסיס נתונים פתוח עבור חובבי טלוויזיה. זהו אחד המשאבים השלמים יותר וקל להתקנה ולפריסה.
האם מדדי מטא נתונים חוקיים?
הם בהחלט. שירותי אינדקס כמו מסד נתונים לטלוויזיה בהם אנו משתמשים להלן רק ניגשים למטא-נתונים המקיפים פיסת תוכן ולא לקובץ עצמו. אתה לא יכול להשתמש בהם כדי להזרים שום דבר, והם גם לא תורמים לפיראטיות בשום דרך. בדרך כלל הם מורשים תחת Creative Commons להפצה בחינם. זה המקבילה הדיגיטלית לארגון אוסף ה- DVD שלך על המדף. בטוח לחלוטין ו -100% חוקי.
יצירת מפתח API של מסד נתונים לטלוויזיה
ברגע שיש לך את פרויקט התוספות Kodi במצב עבודה, אתה יכול לתפוס מפתח API ולהתחיל להשתמש בו כדי לבדוק דברים.
שלב 1 - צור חשבון
בקר ב- TheTVDB.com וליצור חשבון עם השירות. השתמש בידית הקידוד שלך או אפילו בכותרת התוסף לצורך עקביות. לאחר ההרשמה תצטרך להתחבר, אז אתה מסכים לתנאים ולהגבלות על ידי גלילה למטה וסימון התיבה בתחתית העמוד.
שלב 2 - צור את המפתח
לאחר שיש לך חשבון, עבור אל דף הרישום של מפתח ה- API. בתחתית תצטרך להזין את שם הפרויקט שלך יחד עם האתר הרשמי שלו. לאחר שתסיים, לחץ על "אחזר מפתח API".
שלב 3 - שמור את מפתח ה- API
ה- TVDB יציג את קוד המפתח שלך בנפרדעמוד. העתק את זה במקום מאובטח ואל תשתף אותו עם אף אחד אחר, מכיוון שהוא נוצר רק עבור היישום שלך. תצטרך להתייחס לזה מאוחר יותר, אז שמור על זה קרוב.
שימוש במפתח API בתוסף Kodi שלך
לאחר שיצרת מפתח API עם TheTVDB אוכל שירות אינדקס מטא-נתונים אחר, הגיע הזמן לחבר אותו לקוד התוסף שלך כדי לוודא שהוא עובד. תהליך זה יכול להשתנות בהתאם לאופן בו בניתם את התוסף. אנו משתמשים בתבנית Jen, שיטה נפוצה לשילוב עוקבים עם תוספות קודי.
שלב 1 - הורד את תבנית ג'ן
בקר בדף ה- github של התבנית של ג'ן. לחץ על הכפתור הירוק בפינה השמאלית העליונה שאומר "שיבוט או הורדה", ואז הורד את קובץ ה- zip לשולחן העבודה. חלץ אותו לתיקיה משלו, ואז התכונן לעשות קצת עריכה.
שלב 2 - ערוך את Addon.xml
ממש בתוך plugin.video.תיקיית ג'ן-מאסטר שרק ריתמת, תמצא קובץ בשם addon.xml. פתח את זה בעורך הקוד שלך. יהיה עליך לערוך כמה עריכות לחלק מהשורות כדי להתאים אישית את הנתונים אליהם מתייחס התבנית. התחל על ידי מילוי המידע בשורה השנייה של הקובץ, להלן. זכור להשתמש רק באותיות ומספרים, ללא רווחים או תווים לא סטנדרטיים, ואל תשכח להגדיר גם את מספר הגרסה.
<addon id = "plugin.video. ADDON שלך" name = "השם של ADDON שלך" גרסה = "0.01 ″ provider-name =" השם שלך ">
בשלב הבא, ערוך את השורות 19 ו- 21 כדי לספק קצת יותר מידע על התוסף שלך.
<סיכום lang = ”he”> סיכום ADDON </summary>
<תיאור lang = ”he”> תיאור ADDON ארוך יותר </ תיאור>
אתה עשוי לראות שורות כפולות המתייחסות לשפות אחרות. אתה יכול להשאיר את אלה לבד או להסיר אותם כראות עיניך.
שמור את קובץ addon.xml, סיימת לערוך אותו לעת עתה.
שלב 3 - ערוך את Default.py
כאן מתחילים להיכנס למפתח ה- APIמידע. באותה תיקיה ברמה העליונה, חפש את הקובץ ששמו default.py. פתח אותו בעורך הקוד שלך, ואז גלול מטה עד שתראה את השורה שמופנית בהמשך. זה צריך להיות סביב קו 25.
__builtin __. tvdb_api_key = "מפתח ממשק API כאן" # tvdb api מפתח
הכנס את מפתח ה- API של מסד הנתונים לטלוויזיה שלך כמצוין למעלה. בשורה בפועל יהיו רק שני מרכאות בלי שום דבר שביניהם.
שמור default.py וצא לעת עתה. מפתח ה- API שלך הוזן!
שלב 4 - ערוך את Settings.xml
קובץ אחרון לעריכה ואז הוא חוזר לבדיקה. הכנס לתיקיית המשאבים שנמצאת בספריית העבודה של התוסף. פתח את הגדרות.xml בעורך הקוד שלך, ואז גלול מטה לכדי קו 27. יש כמה פיסות מידע שנצטרך להזין כאן כדי לסיים את הגדרת התבנית של ג'ן.
בדוק את השורה הבאה בקוד הקובץ. זה אמור להופיע שלוש פעמים בשורות 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 - שינוי שם ובדיקה
כעת, לאחר נתוני ה- API וההתאמה האישיתנכנס, אתה מוכן לעטוף דברים. ודא שכל הקבצים שערכת נשמרים, צא מהם ונחזור לשולחן העבודה שלך. התיקייה שאנו עובדים בה צריכה להיות כותרת כזו:
שנה זאת כדי לשקף את השם שהזנת בקובץ addon.xml, ואחריו את מספר הגרסה שהזנת באותו סעיף. בעזרת הדוגמה שלנו למעלה, עכשיו הקובץ ייקרא כך:
plugin.video.addictivetips.0.1.zip
זהו זה! כעת הוספת את נתוני ה- API של TVDB לתוסף שלך ומוכנים להתחיל לגרד מטא נתונים מהאינטרנט.
התאמות אישיות נוספות לתוספות
ברגע שיש לך את תבנית ג'ן והטלוויזיה שלךמפתח API של מסד הנתונים מטופל, מדוע לא לקפוץ פנימה ולהוסיף עוד כמה מאפייני התאמה אישית שיעזרו למתג את השחרור שלך? אלה צעדים מהירים ופשוטים שיכולים לעשות דרך ארוכה כדי להפוך את התוסף שלך לזיהוי יותר.
הוסף אייקון
תמונות אייקון מוצגות בקודי משמאלבצד המסך בכל פעם שההרחבה שלך מודגשת. הוספת תוכן מקלה על מיקום התוכן שלך מבלי שתצטרך לקרוא את הכותרות, שיכולות להיות שימושיות יותר מכפי שאתה חושב! כדי להשתמש באייקון, כל שעליכם לעשות הוא ליצור קובץ PNG 256 × 256, רצוי ללא טקסט או מיתוג Kodi, ואז להוסיף אותו לרמה העליונה של התיקיה שלכם בשם icon.png. זהו זה!
השתמש במאוורר
בדומה לסמל שלמעלה, אמנות המעריצים היא התזהרקע שמופיע מאחורי טקסט הבחירה בקודי בכל פעם שמשתמשים מדגישים את התוכן שלך. זה יכול להיות קשור למיתוג האייקונים שלך, או שזה יכול להיות נושא כלשהו לתוכן התוסף שלך. לדוגמה, אם התוסף מספק תוכניות טלוויזיה, צור באנר מעריצים מקורי עם תווים מתוך How I Met Your Mother. כדי להוסיף את זה לשחרורך, פשוט צרו תמונה בגודל 1280 × 720 JPG, קראו לזה fanart.jpg, ואז הדביקו אותה בתיקיה ברמה העליונה של התוסף שלכם.
סיכום
פיתוח תוסף יכול להיות מבלבלתהליך מסובך. הקהילה מספקת המון משאבים מועילים כדי לתת לך יד לאורך הדרך, עם זאת. הוספת מפתח API של מסד נתונים לטלוויזיה היא רק דוגמא אחת לתוכן מתוצרת המשתמש שמוכן להתממשק עם התוסף שלך מבלי לקפוץ דרך כל מיני חישוקים כדי שזה יעבוד. יש לך טיפים שיעזרו למפתחי קודי המתהווים? שתף את הידע שלך בתגובות למטה!
הערות