Telegram TDLib 客户端

在 Delphi/C++ Builder 中构建 Telegram 用户账户或机器人应用程序。封装官方 Telegram TDLib,公开身份验证、聊天、消息和更新事件。

TsgcTDLib_Telegram

官方 Telegram TDLib(tdjson)的 Delphi/C++ Builder 封装器。处理 client_id 生命周期、身份验证状态、消息发送/接收和长轮询更新流。

组件类

TsgcTDLib_Telegram

支持平台

Windows, macOS, Linux, iOS, Android

版本

Standard / Professional / Enterprise

设置 TDLib,验证身份,发送消息

设置 ApiId / ApiHash,将组件指向 tdjson 库,绑定 OnTelegramUpdate 处理身份验证状态,并开始发送消息。

uses
  sgcLibs;

var
  Telegram: TsgcTDLib_Telegram;
begin
  Telegram := TsgcTDLib_Telegram.Create(nil);
  Telegram.TDLibParameters.ApiId   := 123456;
  Telegram.TDLibParameters.ApiHash := 'your-api-hash';
  Telegram.LibraryPath := 'tdjson.dll';

  Telegram.OnTelegramUpdate := procedure(Sender: TObject;
    const aUpdate: string)
  begin
    Memo1.Lines.Add(aUpdate);
  end;

  Telegram.Active := True;
  Telegram.SendMessage('@username', 'hello from Delphi');
end;
// uses: sgcLibs
TsgcTDLib_Telegram *Telegram = new TsgcTDLib_Telegram(this);
Telegram->TDLibParameters->ApiId   = 123456;
Telegram->TDLibParameters->ApiHash = "your-api-hash";
Telegram->LibraryPath = "tdjson.dll";

Telegram->Active = true;
Telegram->SendMessage("@username", "hello from Delphi");

内部功能

官方 TDLib(tdjson)共享库的 Delphi 外观——与官方 Telegram 客户端使用相同的协议。

身份验证流程

组件驱动 TDLib 身份验证状态机:电话号码、验证码、可选的双因素验证密码,并将会话持久保存在本地数据库目录中。

发送消息

SendMessageSendPhotoSendVideoSendDocumentSendVoiceNote 及其他类型化方法涵盖 TDLib 消息内容类型。

聊天与联系人

GetChatsGetChatSearchPublicChatGetUser 以类型化响应的形式公开 Telegram 通讯录和已加入的频道/群组。

更新流

OnTelegramUpdate 以原始 JSON 形式传递每个 TDLib updateXxx 事件——新消息、用户输入、频道帖子、编辑、删除——供下游路由使用。

原生 TDLib

使用官方 tdjson.dll / libtdjson.so / libtdjson.dylib——与官方 Telegram 客户端相同的端到端加密保障。

跨平台

TDLib 支持 Windows、macOS、Linux、Android 和 iOS。按平台配置 LibraryPath;组件为您处理类型化的桥接。

规范与参考

本组件实现的 API 的权威来源。

文档与演示

直接访问组件参考文档,获取即用型演示项目,并下载试用版。

在线帮助 — API_Telegram 本组件的完整属性、方法和事件参考。
演示项目 — Demos\50.Other\01.Telegram_Client 即用型示例项目,随 sgcWebSockets 包提供——请在下方下载试用版。
技术文档 (PDF) 本组件的功能介绍、快速入门、Delphi & C++ Builder 代码示例及主要来源参考。
用户手册 (PDF) 涵盖库中所有组件的综合手册。

准备好构建 Telegram 客户端了吗?

下载免费试用版,将 Telegram 消息功能添加到您的 Delphi 应用程序中。