Discord Gateway API

Conecte-se ao Discord Gateway via WebSocket para criar bots que reagem a mensagens, presença, guild e eventos de estado de voz em tempo real.

TsgcWSAPI_Discord

Cliente tipado para Delphi/C++Builder da Discord Gateway WebSocket API — gerencia o heartbeat, identify, intents, sharding e o despacho de eventos.

Classe do componente

TsgcWSAPI_Discord

Protocolo

Discord Gateway

Plataformas

Windows, macOS, Linux, iOS, Android

Edição

Standard / Professional / Enterprise

Adicione o componente, defina o token e ouça os eventos

Vincule ao TsgcWebSocketClient, defina Discord.Token e Discord.Intents e trate OnDiscordMessageCreate / OnDiscordReady para processar eventos do gateway.

uses
  sgcWebSocket, sgcWebSocket_API_Discord;

var
  WSClient: TsgcWebSocketClient;
  Discord: TsgcWSAPI_Discord;
begin
  WSClient := TsgcWebSocketClient.Create(nil);

  Discord := TsgcWSAPI_Discord.Create(nil);
  Discord.Client := WSClient;
  Discord.Discord.Token := 'your-bot-token';

  Discord.OnDiscordReady := procedure(Connection: TsgcWSConnection;
    const aPayload: string)
  begin
    Memo1.Lines.Add('Discord ready');
  end;

  Discord.OnDiscordMessageCreate := procedure(Connection: TsgcWSConnection;
    const aMessage: string)
  begin
    Memo1.Lines.Add(aMessage);
  end;

  WSClient.Active := True;
end;
// uses: sgcWebSocket, sgcWebSocket_API_Discord
TsgcWebSocketClient *WSClient = new TsgcWebSocketClient(this);
TsgcWSAPI_Discord *Discord = new TsgcWSAPI_Discord(this);
Discord->Client = WSClient;
Discord->Discord->Token = "your-bot-token";

WSClient->Active = true;

O que tem por dentro

Implementa o protocolo Discord Gateway sobre TsgcWebSocketClient: IDENTIFY, RESUME, HEARTBEAT e roteamento de dispatch.

Gateway handshake

Na conexão, o componente envia IDENTIFY com token, intents e propriedades; na desconexão, envia RESUME com o último número de sequência para que eventos não sejam perdidos.

Heartbeat

O Discord exige mensagens HEARTBEAT opcode-1 no intervalo retornado pelo gateway no HELLO. O componente agenda esses envios e monitora HEARTBEAT_ACK para detectar conexões zumbis.

Intents

Discord.Intents seleciona quais categorias de eventos o gateway entrega (GUILD_MESSAGES, GUILD_MEMBERS, MESSAGE_CONTENT, VOICE_STATES — bitmask completo de intents).

Despacho de eventos

Cada evento de dispatch do gateway é exposto como uma propriedade tipada: OnDiscordReady, OnDiscordMessageCreate, OnDiscordGuildCreate, OnDiscordPresenceUpdate e muito mais.

Hooks de voz

Receba eventos VOICE_STATE_UPDATE e VOICE_SERVER_UPDATE — combine com o endpoint WebSocket de voz para automação de canais de voz.

Pronto para sharding

Defina Discord.Shard e Discord.ShardCount para participar do gateway fragmentado do Discord quando seu bot ultrapassar o limite de guilds recomendado.

Especificações e referências

Fontes autoritativas das APIs que este componente implementa.

Documentação e demos

Acesse direto a referência do componente, baixe o projeto de demonstração pronto para rodar e baixe a versão de avaliação.

Ajuda online — API_Discord Referência completa de propriedades, métodos e eventos deste componente.
Trial Gratuito — sgcWebSockets Crie seu bot Discord com o pacote trial do sgcWebSockets.
Documento técnico (PDF) Recursos, quick start, exemplos de código para Delphi & C++ Builder e referências primárias — somente este componente.
Manual do usuário (PDF) Manual abrangente cobrindo todos os componentes da biblioteca.

Pronto para Criar um Bot no Discord?

Baixe o trial gratuito e conecte-se ao Discord Gateway a partir das suas aplicações Delphi.