API Discord Gateway

Connettiti al Discord Gateway tramite WebSocket per creare bot che reagiscono in tempo reale a messaggi, presence, guild ed eventi voice-state.

TsgcWSAPI_Discord

Client tipizzato Delphi/C++ Builder per l'API WebSocket Discord Gateway — gestisce heartbeat, identify, intent, sharding e dispatch degli eventi.

Classe componente

TsgcWSAPI_Discord

Protocollo

Discord Gateway

Piattaforme

Windows, macOS, Linux, iOS, Android

Edizione

Standard / Professional / Enterprise

Inserisci il componente, imposta il token, ascolta gli eventi

Abbinalo a TsgcWebSocketClient, imposta Discord.Token e Discord.Intents, poi aggancia OnDiscordMessageCreate / OnDiscordReady per gestire gli eventi del 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 pronto');
  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;

Cosa c'è all'interno

Implementa il protocollo Discord Gateway sopra TsgcWebSocketClient: IDENTIFY, RESUME, HEARTBEAT, routing dei dispatch.

Handshake del gateway

Alla connessione il componente invia IDENTIFY con token, intent e proprietà; alla disconnessione invia RESUME con l'ultimo numero di sequenza per non perdere eventi.

Heartbeat

Discord richiede messaggi HEARTBEAT con opcode-1 all'intervallo restituito dal gateway in HELLO. Il componente li pianifica e verifica HEARTBEAT_ACK per rilevare connessioni zombie.

Intent

Discord.Intents seleziona quali categorie di eventi il gateway consegna (GUILD_MESSAGES, GUILD_MEMBERS, MESSAGE_CONTENT, VOICE_STATES — bitmask completo degli intent).

Dispatch degli eventi

Ogni evento dispatch del gateway emerge come proprietà tipizzata: OnDiscordReady, OnDiscordMessageCreate, OnDiscordGuildCreate, OnDiscordPresenceUpdate e molti altri.

Hook del voice gateway

Ricevi gli eventi VOICE_STATE_UPDATE e VOICE_SERVER_UPDATE — combinali con l'endpoint voice-WebSocket per l'automazione dei canali vocali.

Pronto per lo sharding

Imposta Discord.Shard e Discord.ShardCount per partecipare al gateway sharded di Discord quando il tuo bot supera la soglia di guild consigliata.

Specifiche e riferimenti

Fonti autorevoli per le API implementate da questo componente.

Documentazione e demo

Accedi al riferimento del componente, scarica il progetto demo pronto all'uso e ottieni la versione di prova.

Guida online — API_Discord Riferimento completo di proprietà, metodi ed eventi per questo componente.
Versione di prova gratuita — sgcWebSockets Crea il tuo bot Discord sopra il pacchetto di prova sgcWebSockets.
Documento tecnico (PDF) Funzionalità, guida rapida, esempi di codice per Delphi e C++ Builder e riferimenti delle fonti primarie — solo per questo componente.
Manuale utente (PDF) Manuale completo che copre ogni componente della libreria.

Pronto a creare un bot Discord?

Scarica la versione di prova gratuita e connettiti al Discord Gateway dalle tue applicazioni Delphi.