Як створити та використовувати ключ API бази даних телевізора: поради для розробників Kodi

Програмне забезпечення Kodi безкоштовне та відкрите,тобто кожен може перевірити код або навіть внести зміни в основні роботи. Однак справжньою силою Коді є його громада. Програмне забезпечення було розроблено для взаємодії з створеними користувачами доповненнями, які надають величезний різноманітний вміст, що основна команда Kodi ніколи не може реалізувати самостійно. Вони називаються неофіційними доповненнями, і зробити їх так просто, ви можете почати своє власне в другій половині дня!

Одна неймовірно корисна послуга, надана KodiРозробниками додатків є індексатори баз даних ТВ, сайти, такі як TheTVDB.com або Trakt. Обидва ресурси викреслюють метадані з усього Інтернету та надають інформацію громадськості безкоштовно. Це означає, що ви можете створити надбудову, яка знаходить різні телешоу та використовувати TheTVDB для категоризації, маркування та сортування їх усіх. Не потрібно самостійно отримувати інформацію та не потрібно створювати власний трекер. Просто захопіть ключ API з бази даних телевізора та підключіть його до свого додатка, і тоді все налаштовано. Наш довідник нижче перегляне вас через процес від початку до кінця.

Ексклюзивна пропозиція: заощадите 49%. Спробуйте ExpressVPN без ризику!

Отримайте номінальну VPN №1

30-денна гарантія повернення грошей

Як отримати безкоштовну VPN на 30 днів

Якщо вам потрібен VPN на короткий час, наприклад, подорожуючи, ви можете безкоштовно отримати наш топ-рейтинг VPN. ExpressVPN включає 30-денну гарантію повернення грошей. Вам потрібно буде заплатити за підписку, це факт, але це дозволяє повний доступ протягом 30 днів, а потім ви скасуєте повне повернення коштів. Їх політика щодо скасування без запитань відповідає його назві.

Нагадування

Якщо ви розробляєте надбудову для Kodi, ви єдобре знає позицію, яку займає програмне забезпечення в очах громадськості. Коді сама по собі є безпечною, і більшість її доповнень є також. Інтернет-провайдери та творці вмісту часто думають про інше, а це означає, що щоразу, коли ви щось передаватимете на Kodi, ваш обліковий запис може бути перевірений. Не має значення, чи ваш законний додаток легітимний чи ні, ви все ще ризикуєте отримати передачу чи відстежувати ваш рахунок.

Хороша новина - віртуальні приватні мережіпростий спосіб перемогти ці вторгнення в приватне життя. За допомогою VPN ваші дані будуть зашифровані до того, як вони вийдуть з вашого пристрою, тому неможливо побачити, які веб-сайти ви відвідуєте чи які потоки Kodi ви отримуєте доступ. VPN також ускладнюють виявлення вашої особи чи місцезнаходження, повертаючи міру анонімності у всесвітню мережу.

Найкращий VPN для Kodi - IPVanish

IPVanish потрапляє в усі потрібні місця для ідеального VPNвикористання з Kodi. Це швидко, пропонуючи понад 950 серверів у 60 різних країнах, щоб ви могли завжди налаштувати з низьким часом затримки, незалежно від того, де ви живете. Він також захищений, забезпечує 256-бітове шифрування AES, захист від витоку DNS та автоматичний перемикач на знищення для всіх пристроїв. Ви також скористаєтесь чудовою політикою нульового журналу щодо трафіку та зможете завантажувати торенти та вміст мережі P2P з повною анонімністю. За допомогою IPVanish все, що вам потрібно зробити, це запустити додаток і ваше з'єднання захищене.

Більше функцій IPVanish:

• Прості у використанні програми для Windows, Mac, Linux, Android та iOS.
• Необмежена пропускна здатність, без обмеження швидкості та дроселювання.
• Повний, анонімний доступ до всіх додатків Kodi.

IPVanish пропонує 7-денну гарантію повернення грошей, що означає, що у вас є тиждень, щоб перевірити його без ризику. Будь ласка, зверніть увагу, що Читачі порад із пристрастям можуть заощадити величезні 60% тут на щорічному плані IPVanish, знижуючи щомісячну ціну до всього 4,87 дол. / міс.

Перед тим як ти почнеш

Як і будь-який хороший розробник, ви робите своєдослідження, перш ніж пірнати в голову. Прочитайте наступні розділи, щоб усунути будь-які помилки, а потім сміливо захопіть API та розпочніть тестування.

Що таке база даних телевізора?

Якщо ви розробляєте додаток Kodi, це, ймовірно,Ви плануєте індексувати значну кількість контенту кіно- або телешоу. Сайти, які надають більшість цих файлів, зазвичай доставляють лише відео, не супроводжуючи дані, що допомагають ідентифікувати вміст. Ім'я файлу, ймовірно, містить показ шоу, сезон та епізод, але як бути з акторами чи фактичною назвою епізоду? Тут починають грати бази даних індексації.

Підключивши свій додаток Kodi до гарної бази данихви можете легко назвати та категоризувати весь вміст, до якого ваша програма має доступ з Інтернету. Епізоди будуть легко сортувати та шукати у вашому додатку, і вони будуть набагато легшими на очах завдяки метаданим, зібраним із служби індексування.

Яка інформація включає в себе базу даних?

Це може змінюватися залежно від служби, яку ви використовуєте, але більшість індексаторів зосереджені на базовому наборі даних, який включає в себе наступне:

• Повна назва шоу та оригінальна дата ефіру.
• Назви та цифри епізодів.
• Жанрова інформація.
• Дані про акторів, режисерів, письменників тощо.
• Бокс-арт, як віяло, так і офіційний.
• Оцінки користувачів та оцінки критики.
• Метадані перекладені іншими мовами.

Звідки береться інформація?

Різноманітні джерела, які можуть вас здивувати. Оскільки точна інформація важлива, скребки бази даних підходять максимально близько до джерела. Зазвичай це означає посилання на офіційні сайти, такі як Amazon або IMDB, обидва з яких отримують свої заголовки шоу та пов'язану інформацію з самих студій. Якщо цього не відбувається, інші індексатори перехрещують свій вміст з іншими відкритими трекерами або покладаються на представлені користувачем дані для позначення випусків тегів.

Ключі API

API означає інтерфейс програмування додатків. Ключі API - це або невеликі файли дозволів, або рядки рандомізованих літер та цифр, які надають програмі доступ до певної послуги. Наприклад, якщо ви створюєте додаток для використання в Twitter, вам потрібен ключ API, щоб веб-сайт дозволив вашому коду взаємодіяти зі змістом Twitter. Клавіші для індексів баз даних ТБ працюють майже однаково. Додавши ключ API у свою надбудову Kodi, ви надаєте йому необхідні облікові дані для витягування даних із зовнішнього веб-сайту та використання їх у Kodi.

Яку базу даних використовувати

Плаває більше однієї бази даних індексаціїу всьому світі. Деякі з них простіші у використанні, ніж інші, а деякі просто більш сучасні, ніж їх конкуренція. У нашому посібнику нижче ми розповімо про процес створення API для TheTVDB.com, який є відкритою базою даних для любителів телебачення. Це один із найповніших ресурсів, його легко налаштувати та розмістити.

Чи законні показники метаданих?

Вони, безумовно, є. Служби індексації, такі як ТБ-база даних, які ми будемо використовувати нижче, отримують доступ лише до метаданих, що оточують фрагмент вмісту, а не до самого файлу. Ви не можете використовувати їх для передачі будь-якого потоку, і вони жодним чином не сприяють піратству. Вони також зазвичай ліцензуються відповідно до Creative Commons для безкоштовного розповсюдження. Це цифровий еквівалент організації колекції DVD на полиці. Повністю безпечний і 100% законний.

Створення ключа API бази даних ТБ

Після того, як у вас надходить проект надбудови Kodi в робочому стані, ви можете взяти ключ API і почати використовувати його для тестування речей.

Крок 1 - Створіть обліковий запис

Відвідайте TheTVDB.com і створити обліковий запис у сервісі. Використовуйте ручку кодування або навіть назву додатка для послідовності. Після реєстрації вам потрібно буде увійти, а потім погоджуйтесь з умовами, прокручуючи вниз і поставивши галочку внизу сторінки.

Крок 2 - Створіть ключ

Коли у вас є обліковий запис, перейдіть на сторінку реєстрації ключів API. Унизу вам потрібно буде ввести ім’я проекту разом з його офіційним веб-сайтом. Після завершення натисніть "Отримати ключ API".

Крок 3 - Збережіть ключ API

TheTVDB відобразить ваш код ключа окремосторінки. Скопіюйте це кудись надійно і не діліться ним з ким-небудь ще, оскільки він створений саме для вашої програми. Вам потрібно буде посилатися на це пізніше, тому тримай його поруч.

Використання ключа API у вашому додатку Kodi

Щойно ви створили ключ API за допомогою TheTVDB абобудь-яку іншу службу індексації метаданих, саме час підключити її до свого додаткового коду, щоб переконатися, що він працює. Цей процес може відрізнятися залежно від того, як ви структурували свій додаток. Ми будемо використовувати шаблон «Джен», широко використовуваний метод поєднання трекерів з додатками Kodi.

Крок 1 - Завантажте шаблон Джен

Завітайте на сторінку github-шаблону Джен. Клацніть зелену кнопку вгорі праворуч із написом "клонувати або завантажувати", а потім завантажте zip-файл на робочий стіл. Витягніть його у власну папку, після чого приготуйтеся зробити кілька редагувань.

Крок 2 - Відредагуйте Addon.xml

Просто всередині плагіна.video.щойно розпакувавши папку jen-master, ви знайдете файл з назвою addon.xml. Відкрийте це в редакторі коду. Вам потрібно буде внести декілька змін до деяких рядків, щоб налаштувати дані, на які посилаються шаблони. Почніть із заповнення інформації у другому рядку файлу, на який посилається нижче. Не забудьте використовувати лише літери та цифри, без пробілів чи нестандартних символів, а також не забудьте встановити номер версії.

Далі відредагуйте рядки 19 та 21, щоб дати трохи більше інформації про свій додаток.

Можливо, ви побачите повторювані рядки, що посилаються на інші мови. Ви можете залишити їх у спокої або зняти їх, як вважаєте за потрібне.

Збережіть файл addon.xml, ви його вже редагували.

Крок 3 - Редагування Default.py

Тут ми починаємо вводити ключ APIінформація. У цій же папці верхнього рівня знайдіть файл з назвою default.py. Відкрийте його в редакторі коду, а потім прокрутіть вниз, поки не побачите рядок, на який посилається нижче. Це повинно бути біля лінії 25.

Вставте ключ API вашої бази даних телевізора, де зазначено вище. Насправді у рядку буде два лапки без нічого середнього.

Збережіть default.py та поки що закрийте. Ваш ключ API введено!

Крок 4 - Змінення налаштувань.xml

Останній файл для редагування, потім він повернувся до тестування. Введіть папку "Ресурси", що знаходиться в робочому каталозі плагіна. Відкрийте settings.xml у своєму редакторі коду, а потім прокрутіть униз до рядка 27. Тут потрібно ввести кілька фрагментів інформації, щоб закінчити налаштування шаблону Jen.

Перевірте наступний рядок у коді файлу. Він повинен з’являтися тричі на рядках 27, 31 та 36.

Подивіться, де йдеться plugin.video.jen? Змініть це на те саме ім’я плагіна, яке ви ввели у файл addon.xml. Якщо, наприклад, ви ввели plugin.video.addictivetips, рядок виглядатиме так:

Збережіть цей файл та вийдіть.

Крок 5 - Перейменування та тест

Тепер, коли дані API та налаштування булиувійшли, ви готові завершити речі. Переконайтеся, що всі редаговані файли збережені, а потім вийдіть із них та поверніться на робочий стіл. Папка, над якою ми працюємо, має мати назву приблизно так:

Змініть це, щоб відобразити ім’я, яке ви ввели у файл addon.xml, а потім номер версії, яку ви ввели в цьому ж розділі. Використовуючи наш вище приклад, тепер файл отримав би ім'я:

Це воно! Тепер ви додали дані API TVDB у своє доповнення і готові почати скребки метаданих з Інтернету.

Інші налаштування додатків

Як тільки ви отримаєте шаблон Джен і телевізорКлюч API бази даних подбає про те, чому б не зайти і не додати ще декілька функцій налаштування, щоб допомогти брендувати ваш реліз? Це швидкі та прості кроки, які допоможуть зробити ваш додаток більш впізнаваним.

Додати значок

Зображення піктограм відображаються в Коді злівазбоку екрана щоразу, коли ваш додаток виділяється. Додаючи його, можна легко помітити вміст, не читаючи заголовки, що може бути корисніше, ніж ви думаєте! Щоб використовувати піктограму, все, що вам потрібно зробити, - це створити файл PNG 256 × 256, бажано без тексту або брендингу Kodi, а потім додати його до верхнього рівня вашої папки з назвою icon.png. Це воно!

Використовуйте фан-арт

Подібно до піктограми вище, фан-арт - це сплескфон, який відображається за текстом виділення в Kodi, коли користувачі виділяють ваш вміст. Це може бути пов’язано з брендингом значків або може бути тематичним для вашого додаткового вмісту. Наприклад, якщо плагін показує телепередачі, створіть оригінальний банер арт-банерів із символами з "Як я познайомився з вашою матір'ю". Щоб додати це до свого випуску, просто зробіть зображення у форматі JPG 1280 × 720, назвіть його fanart.jpg, після чого вставте його у папку верхнього рівня додатку.

Висновок

Розробка надбудови може бути заплутаною іскладний процес. Однак громада надає безліч корисних ресурсів, щоб допомогти вам на цьому шляху. Додавання ключа API ТБ-бази даних - лише один приклад вмісту, створеного користувачем, який готовий взаємодіяти з вашим додатком, не перестрибуючи всі види обручів, щоб він працював. Чи є які-небудь поради, які допоможуть допомогти розробникам Kodi-початківців? Поділіться своїми знаннями в коментарях нижче!