开发文档

TDLib 请求、状态、选项与通知

理解 TDLib 异步请求与更新、可配置选项和通知分组,正确恢复聊天历史并避免重复系统通知。

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

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

本页内容
  1. 请求响应与主动更新同时存在
  2. 选项需要类型与适用版本
  3. 通知组与系统通知衔接
  4. 应用实现建议

请求响应与主动更新同时存在

TDLib 的主要接口是异步的;响应关联方式取决于语言绑定,JSON 接口使用 @extra。主动更新同样驱动客户端状态,不能只等待自己发出的请求。

聊天历史可能返回少于 limit 的结果,需要按游标继续读取,不能直接判断已经到头。

选项需要类型与适用版本

选项具有明确类型,未列出的选项可以忽略。应用自行保存的小数据可使用文档允许的命名范围,但不应用它代替完整的业务数据库或秘密存储方案。

通知组与系统通知衔接

TDLib 通知 API 管理分组及增删变化,操作系统上的实际呈现由应用负责。移除通知不等同于把聊天标记已读。该入门说明最初对应较早版本,具体字段仍应结合当前 schema 和版本核对。

应用实现建议

持续消费更新,将账号与客户端实例隔离;关闭后等待完整结束状态再清理资源。恢复通知时使用稳定 ID 避免重复弹出。官方生成式 API 文档用于查参数和返回类型,本库的 方法与类型索引 可帮助定位名称。