Como criar e usar uma chave de API do banco de dados de TV: Dicas para desenvolvedores Kodi

O software Kodi é gratuito e de código aberto,ou seja, é possível que alguém verifique o código ou até contribua com alterações no funcionamento principal. O verdadeiro poder por trás do Kodi é sua comunidade, no entanto. O software foi projetado para interagir com complementos criados pelo usuário que fornecem uma enorme variedade de conteúdo, coisas que a equipe principal da Kodi nunca poderia implementar por conta própria. Esses são chamados de complementos não oficiais e são tão fáceis de criar que você pode começar o seu em uma tarde!

Um serviço incrivelmente útil fornecido à Kodidesenvolvedores de complementos são indexadores de bancos de dados de TV, sites como TheTVDB.com ou Trakt. Ambos os recursos coletam metadados de toda a web e fornecem as informações ao público gratuitamente. Isso significa que você pode criar um complemento que encontre programas de TV diferentes e use o TheTVDB para categorizar, rotular e classificar todos eles. Não é necessário buscar informações por conta própria nem criar seu próprio rastreador. Basta pegar uma chave de API de um banco de dados de TV e conectá-la ao complemento e pronto. Nosso guia abaixo mostra o processo do começo ao fim.

Oferta exclusiva: economize 49%. Experimente o ExpressVPN sem riscos!

Obtenha a VPN nº 1 classificada

Garantia de devolução do dinheiro em 30 dias

Como obter uma VPN GRÁTIS por 30 dias

Se você precisar de uma VPN por um curto período de tempo ao viajar, por exemplo, poderá obter nossa VPN de primeira linha gratuitamente. O ExpressVPN inclui uma garantia de devolução do dinheiro em 30 dias. Você precisará pagar pela assinatura, isso é fato, mas permite acesso total por 30 dias e, em seguida, você cancela para um reembolso total. Sua política de cancelamento sem perguntas faz jus ao seu nome.

Lembrete

Se você está desenvolvendo um complemento para o Kodi, estábem ciente da posição que o software ocupa aos olhos do público. O Kodi em si é seguro, e a maioria de seus complementos também. Os ISPs e os criadores de conteúdo geralmente pensam o contrário, o que significa que, no momento em que você transmitir algo no Kodi, sua conta poderá estar sendo examinada. Não importa se o seu complemento é legítimo ou não, você ainda corre o risco de ser estrangulado ou ter sua conta rastreada.

A boa notícia é que redes privadas virtuais são ummaneira fácil de derrotar essas invasões de privacidade. Com uma VPN, seus dados serão criptografados antes de sair do dispositivo, impossibilitando a visualização de sites que você está visitando ou quais fluxos Kodi você está acessando. As VPNs também dificultam a descoberta de sua identidade ou localização, trazendo uma medida de anonimato de volta à Internet.

A melhor VPN para Kodi - IPVanish

IPVanish atinge todos os pontos certos para a VPN perfeitause com Kodi. É rápido, oferecendo mais de 950 servidores em 60 países diferentes, para que você possa sempre obter uma conexão de baixa latência, independentemente de onde mora. Também é seguro, oferecendo criptografia AES de 256 bits, proteção contra vazamento de DNS e um interruptor automático de interrupção para todos os dispositivos. Você também aproveitará uma excelente política de registro zero no tráfego e poderá baixar torrents e conteúdo de rede P2P com total anonimato. Com o IPVanish, tudo o que você precisa fazer é executar o aplicativo e sua conexão é segura.

Mais recursos do IPVanish:

• Aplicativos fáceis de usar para Windows, Mac, Linux, Android e iOS.
• Largura de banda ilimitada, sem limites de velocidade ou aceleração.
• Acesso completo e anônimo a todos os complementos da Kodi.

O IPVanish oferece uma garantia de devolução do dinheiro em 7 dias, o que significa que você tem uma semana para testá-lo sem riscos. Por favor note que Os leitores do Addictive Tips podem economizar 60% aqui no plano anual do IPVanish, reduzindo o preço mensal para apenas US $ 4,87 / mês.

Antes de você começar

Assim como qualquer bom desenvolvedor, você faz o seupesquisa antes de mergulhar na cabeça primeiro. Leia as seções a seguir para esclarecer quaisquer equívocos que você possa ter, sinta-se à vontade para pegar sua API e iniciar o teste.

O que é um banco de dados de TV?

Se você estiver desenvolvendo um complemento Kodi, é provável quevocê planeja indexar uma quantidade significativa de conteúdo de filmes ou programas de TV. Os sites que fornecem a maioria desses arquivos geralmente entregam apenas vídeos, não os dados que acompanham, o que ajuda a identificar o conteúdo. O nome do arquivo provavelmente contém o programa, a temporada e o número do episódio, mas e os atores ou o título real do episódio? É aí que os bancos de dados de indexação entram em jogo.

Ao conectar o complemento Kodi a um bom banco de dadosvocê pode nomear e categorizar facilmente todo o conteúdo que seu programa acessa na web. Os episódios serão fáceis de classificar e pesquisar no complemento e serão muito mais fáceis aos olhos, graças aos metadados extraídos do serviço de indexação.

Quais informações incluem um banco de dados?

Isso pode variar dependendo do serviço que você usa, mas a maioria dos indexadores se concentra em um conjunto principal de dados que inclui o seguinte:

• O título completo e a data original do show.
• Nomes e números de episódios.
• Informações de gênero.
• Dados sobre atores, diretores, escritores, etc.
• Arte de caixa, feita por fãs e oficial.
• Classificações de usuários e pontuações da crítica.
• Metadados traduzidos para outros idiomas.

De onde vem a informação?

Uma variedade de fontes que podem surpreendê-lo. Como informações precisas são importantes, os raspadores de banco de dados ficam o mais próximo possível da fonte. Isso geralmente significa fazer referência a sites oficiais como Amazon ou IMDB, os quais obtêm seus títulos de programas e informações relacionadas dos próprios estúdios. Caso contrário, outros indexadores fazem referência cruzada de seu conteúdo com outros rastreadores abertos ou confiam nos dados enviados pelo usuário para marcar as liberações dos shows.

Chaves de API

API significa interface de programação de aplicativos. As chaves da API são pequenos arquivos de permissão ou cadeias de letras e números aleatórios que um grande programa acessa a um serviço específico. Se você estiver criando um aplicativo para usar com o Twitter, por exemplo, precisará de uma chave de API para que o site permita que seu código faça interface com o conteúdo do Twitter. As chaves para índices de banco de dados de TV funcionam da mesma maneira. Ao adicionar uma chave de API ao seu complemento Kodi, você fornece as credenciais necessárias para extrair dados do site externo e usá-lo no Kodi.

Qual banco de dados usar

Há mais de um banco de dados de indexação flutuandoem toda a Internet. Alguns deles são mais fáceis de usar do que outros, e outros são simplesmente mais atualizados que seus concorrentes. Para o nosso guia abaixo, abordaremos o processo de criação da API do TheTVDB.com, que é um banco de dados aberto para fãs de televisão. É um dos recursos mais completos e fácil de configurar e implantar.

Os índices de metadados são legais?

Eles certamente são. Os serviços de indexação, como o banco de dados de TV que usaremos abaixo, acessam apenas os metadados em torno de um conteúdo, não o arquivo em si. Você não pode usá-los para transmitir nada, nem eles contribuem para a pirataria de forma alguma. Eles também são geralmente licenciados sob Creative Commons para distribuição gratuita. É o equivalente digital de organizar sua coleção de DVD na prateleira. Completamente seguro e 100% legal.

Criando uma chave de API do banco de dados de TV

Depois de ter seu projeto de complemento Kodi em um estado funcional, você pode pegar uma chave de API e começar a usá-la para testar as coisas.

Etapa 1 - Criar uma conta

Visite TheTVDB.com e crie uma conta com o serviço. Use sua alça de codificação ou até o título do complemento para obter consistência. Depois de se registrar, você precisará fazer login e concorde com os termos e condições rolando para baixo e marcando a caixa na parte inferior da página.

Etapa 2 - Gere a chave

Depois de ter uma conta, vá para a página de registro de chave da API. Na parte inferior, você precisará inserir o nome do seu projeto junto com o site oficial. Clique em "Recuperar chave da API" quando terminar.

Etapa 3 - Salve a chave da API

OTVDB exibirá seu código de chave em umpágina. Copie-o em algum lugar seguro e não o compartilhe com mais ninguém, pois foi gerado apenas para o seu aplicativo. Você precisará fazer referência a isso mais tarde, então mantenha-o próximo.

Usando uma chave de API no complemento Kodi

Depois de gerar uma chave de API com o TheTVDB ouqualquer outro serviço de indexação de metadados, é hora de conectá-lo ao seu código complementar para garantir que funcione. Esse processo pode variar dependendo de como você estruturou seu complemento. Usaremos o Jen Template, um método amplamente usado para combinar rastreadores com complementos Kodi.

Etapa 1 - Faça o download do modelo Jen

Visite a página do github do Jen Template. Clique no botão verde no canto superior direito que diz “clonar ou baixar” e, em seguida, baixe o arquivo zip na área de trabalho. Extraia-o em sua própria pasta e prepare-se para editar.

Etapa 2 - Editar Addon.xml

Apenas dentro do plugin.video.jen-master, você acabou de descompactar, encontrará um arquivo chamado addon.xml. Abra isso no seu editor de código. Você precisará fazer algumas edições em algumas das linhas para personalizar os dados aos quais o modelo faz referência. Comece preenchendo as informações na segunda linha do arquivo, referenciada abaixo. Lembre-se de usar apenas letras e números, sem espaços ou caracteres não padrão e não se esqueça de definir também o número da versão.

Em seguida, edite as linhas 19 e 21 para fornecer um pouco mais de informação sobre o seu complemento.

Você pode ver linhas duplicadas fazendo referência a outros idiomas. Você pode deixá-los em paz ou removê-los como achar melhor.

Salve o arquivo addon.xml, você terminou de editá-lo por enquanto.

Etapa 3 - Editar Default.py

É aqui que começamos a entrar na chave da APIem formação. Na mesma pasta de nível superior, procure o arquivo chamado default.py. Abra-o no seu editor de código e role para baixo até ver a linha referenciada abaixo. Deve estar na linha 25.

Insira a chave da API do banco de dados de TV onde indicado acima. A linha real terá apenas duas aspas sem nada no meio.

Salve default.py e saia por enquanto. Sua chave de API foi inserida!

Etapa 4 - Editar Settings.xml

Um último arquivo para editar e, em seguida, volta ao teste. Digite a pasta de recursos localizada no diretório de trabalho do plug-in. Abra settings.xml no seu editor de código e role para baixo até a linha 27. Existem algumas informações que precisamos inserir aqui para concluir a configuração do modelo Jen.

Verifique a seguinte linha no código do arquivo. Ele deve aparecer três vezes nas linhas 27, 31 e 36.

Veja onde diz plugin.video.jen? Mude para o mesmo nome de plug-in que você inseriu no arquivo addon.xml. Se você inseriu plugin.video.addictivetips, por exemplo, a linha ficaria assim:

Salve este arquivo e saia.

Etapa 5 - Renomear e testar

Agora que os dados da API e de personalização foraminserido, você está pronto para encerrar as coisas. Verifique se todos os arquivos que você editou foram salvos, saia deles e volte para a área de trabalho. A pasta em que estamos trabalhando deve ter o seguinte título:

Altere isso para refletir o nome digitado no arquivo addon.xml, seguido pelo número da versão digitada na mesma seção. Usando nosso exemplo acima, o arquivo agora seria nomeado como este:

É isso aí! Agora você adicionou os dados da API do TVDB ao complemento e está pronto para começar a coletar metadados da Web.

Outras personalizações de complemento

Depois de obter o modelo Jen e sua TVA chave da API do banco de dados foi resolvida, por que não entrar e adicionar mais alguns recursos de personalização para ajudar a marcar seu lançamento? Estas são etapas rápidas e simples que podem ajudar bastante a tornar seu complemento mais reconhecível.

Adicionar um ícone

As imagens dos ícones são exibidas no Kodi à esquerdalado da tela sempre que o complemento for destacado. Adicionar um facilita a localização do seu conteúdo sem a necessidade de ler os títulos, o que pode ser mais útil do que você pensa! Para usar um ícone, tudo o que você precisa fazer é criar um arquivo PNG de 256 × 256, de preferência sem texto ou marca Kodi, e adicioná-lo ao nível superior da pasta chamado icon.png. É isso aí!

Usar arte dos fãs

Semelhante ao ícone acima, a arte dos fãs é um respingoplano de fundo que aparece atrás do texto de seleção no Kodi sempre que os usuários destacam seu conteúdo. Isso pode estar relacionado à marca do seu ícone ou pode ser algo com tema para o seu conteúdo complementar. Por exemplo, se o plug-in fornecer programas de TV, crie um banner original de arte de fã com os personagens de How I Met Your Mother. Para adicionar isso ao seu lançamento, basta criar uma imagem JPG de 1280 × 720, nomeie-o como fanart.jpg e cole-a na pasta de nível superior do seu complemento.

Conclusão

O desenvolvimento de um complemento pode ser confuso eprocesso complicado. A comunidade fornece uma tonelada de recursos úteis para ajudá-lo ao longo do caminho, no entanto. Adicionar uma chave de API do banco de dados de TV é apenas um exemplo do conteúdo criado pelo usuário que está pronto para interagir com seu complemento, sem passar por todos os tipos de argolas para fazê-lo funcionar. Tem alguma dica para ajudar os desenvolvedores iniciantes do Kodi? Compartilhe seu conhecimento nos comentários abaixo!