开发文档

MTProto 2.0 协议结构与阅读顺序

从 schema、加密消息和传输层理解 MTProto,区分当前协议与已弃用的 MTProto 1.0。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 分清三个层次
  2. 先看当前版本
  3. 建议阅读顺序

分清三个层次

业务 API 描述方法与对象,MTProto 定义消息与安全会话,传输协议负责字节传送。能够建立 TCP 连接,不等于已授权用户;取得 API ID 也不会直接生成协议授权密钥。

先看当前版本

官方 MTProto 1.0 入口已经标为弃用,保留用于阅读旧实现,不应作为新客户端的实现基线。当前协议说明、协议层 schema 与业务 schema 应分别核对。

机器可读 schema 和方法目录适合代码生成及查找签名;它们不能代替方法的权限、错误和状态说明。

建议阅读顺序

先看协议概览,再看授权密钥、消息格式、服务消息与传输,最后研究 TL 编码。若目标是开发聊天产品,优先考虑 TDLib,把协议工作交给成熟实现。

本库的 接口参考 保留版本和官方入口。升级时比较新增、移除与字段变化;不同日期的 schema 不能随意混合编译。