Giter VIP home page Giter VIP logo

twitch4k's Introduction

Twitch4K

O que é o Twitch4K

O Twitch4K é uma biblioteca escrita na linguagem de programação Kotlin que permite a criação de bots voltados ao chat da Twitch. O intuito de escrever esta biblioteca é de compreender melhor como a infraestrutura de char da Twitch funcionaa, praticar a construção de um cliente IRC com Kotlin e possibilitar a criação de ferramentas visando melhorar a experiência das pessoas que assistem lives na Twitch através de chatbots

Como utilizar a biblioteca

Para utilizar a biblioteca será necessário executar os seguintes passos:

  1. Realizar o clone projeto com o seguinte comando:
git clone [email protected]:Kotlinautas/twitch4k.git
  1. Entrar no diretório do projeto:
cd twitch4k
  1. Construir e publicar para o repositório Maven local com o comando:

Para Linux e MacOS

./gradlew publishToMavenLocal

Para Windows:

./gradlew.bat publishToMavenLocal
  1. Após terminar o processo de construção e compilação, declare a biblioteca no build.gradle do seu projeto realizando as seguintes alterações:
// ...
// ...
// ...

repositories {
    mavenLocal()
    // mavenCentral()
}

// ...
// ...
// ...

dependencies {
    implementation("dev.kotlinautas:twitch4k:1.0")
    // ...
    // ...
    // ...
}

Exemplo de código

É necessário obtero o token OAuth. O mesmo pode ser obtido AQUI. Realize o login com as credenciais da conta do bot e, em seguida, será apresentado o token de acesso da conta do bot. O tokem possui o seguinte formato oauth:xxyyzz112233, copie a string e utilize-a para realizar a autenticação do bot.

O trecho de código abaixo exemplifica como utilizar a biblioteca. Lembre-se de realizar os devidos imports no código abaixo (os mesmos foram retirados para deixar o exemplo enxuto).

// Classe que implementa as interfaces do Bot
class Bot : OnReceivedChatMessageListener, OnConnectedListener {

    // Método executado quando o bot estiver conectado no IRC da Twitch
    override fun onConnected(channels: List<String>, chat: Chat) {
        channels.forEach { channel ->
            chat.send(channel, "<3 A mãe ta on! <3")
        }
    }

    // Método executado toda vez que o bot recebe uma mensagem do chat dos canais registrados
    override fun onReceived(message: ChatMessage, chat: Chat) {
        
        // Se a mensagem inicar com "!teste" o bot responderá com "Teste"
        if(message.text.startsWith("!teste")){
            chat.send(message.channel, "Teste")
        }
    }

}

fun main() {

    // Variável de ambiente com a conta da Twitch do bot
    val username = System.getenv("TWITCH_BOT_USERNAME")

    // Variável de ambiente com o token OAuth de acesso à Twitch
    val token = System.getenv("TWITCH_BOT_TOKEN")

    val bot = Bot()

    // Criação da instância da biblioteca 
    val t4k = Twitch4K(
        // Nome de usuário da conta do bot
        username = username,

        // Token oauth da conta do bot
        // (vide texto acima para maiores informações)
        token = token,

        // Lista de canais da Twitch
        channels = listOf("canal_01", "canal_02","canal_03")
    )

    // Registra o evento de conexão com o IRC da Twitch
    t4k.setOnConnectedListener(bot)

    // Registra o evento de mensagem recebida de algum chat registrado
    t4k.setOnReceivedChatMessageListener(bot)

    // Inicia o Bot
    t4k.start()
}

⚠️ Todos os registros de eventos devem ser efetuados antes da execução do método start() ⚠️

Créditos

twitch4k's People

Contributors

brunolopesjn avatar felipenathan avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.