面向安卓开发者的Telegram TDLib集成指南：从下载库文件到构建自定义客户端

android {
    // ...
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }
    sourceSets {
        main {
            jniLibs.srcDirs = ['src/main/jniLibs']
        }
    }
}

public class TdLibManager {
    private static TdLibManager instance;
    private Client client;
    private final Handler responseHandler; // 用于将回调切换到主线程

    private TdLibManager(Context context) {
        // 加载原生库
        System.loadLibrary("tdjni");
        responseHandler = new Handler(Looper.getMainLooper());
        // 创建客户端实例，传入接收更新的回调函数
        client = Client.create(new UpdatesHandler(), null, null);
    }

    // 接收更新和响应的内部类
    private class UpdatesHandler extends Client.ResultHandler {
        @Override
        public void onResult(TdApi.Object object) {
            // 处理来自 TDLib 的所有响应和更新
            // 根据 object.getConstructor() 判断类型并分发处理
            switch (object.getConstructor()) {
                case TdApi.UpdateAuthorizationState.CONSTRUCTOR:
                    handleAuthorizationState((TdApi.UpdateAuthorizationState) object);
                    break;
                case TdApi.UpdateNewChat.CONSTRUCTOR:
                    // 处理新聊天...
                    break;
                // ... 处理其他多种更新类型
            }
        }
    }

    public void sendRequest(TdApi.Function function, Client.ResultHandler handler) {
        client.send(function, handler);
    }

    // 处理复杂的授权状态流
    private void handleAuthorizationState(TdApi.UpdateAuthorizationState update) {
        TdApi.AuthorizationState state = update.authorizationState;
        if (state instanceof TdApi.AuthorizationStateWaitTdlibParameters) {
            // 必须首先设置 TDLib 参数
            TdApi.TdlibParameters parameters = new TdApi.TdlibParameters();
            parameters.apiId = YOUR_API_ID; // 从 https://my.telegram.org 获取
            parameters.apiHash = "YOUR_API_HASH";
            parameters.systemLanguageCode = "en";
            parameters.deviceModel = android.os.Build.MODEL;
            parameters.applicationVersion = "1.0";
            parameters.useMessageDatabase = true;
            parameters.useSecretChats = true;
            parameters.databaseDirectory = context.getFilesDir() + "/tdlib"; // 重要：数据存储路径
            parameters.filesDirectory = context.getFilesDir() + "/tdlib/files";
            sendRequest(new TdApi.SetTdlibParameters(parameters), new UpdatesHandler());
        } else if (state instanceof TdApi.AuthorizationStateWaitPhoneNumber) {
            // 请求用户输入手机号
            postToUI(() -> showPhoneNumberInputDialog());
        } else if (state instanceof TdApi.AuthorizationStateWaitCode) {
            // 请求输入验证码
            TdApi.AuthorizationStateWaitCode waitCodeState = (TdApi.AuthorizationStateWaitCode) state;
            postToUI(() -> showCodeInputDialog(waitCodeState));
        } else if (state instanceof TdApi.AuthorizationStateReady) {
            // 授权完成，可以开始正常操作
            postToUI(() -> onAuthorized());
        } else if (state instanceof TdApi.AuthorizationStateLoggingOut) {
            // 正在退出登录...
        } else if (state instanceof TdApi.AuthorizationStateClosed) {
            // TDLib 客户端被关闭
        }
    }

    private void postToUI(Runnable action) {
        responseHandler.post(action);
    }

    // ... 其他方法，如登录、获取聊天列表等
}

public void loadChatList() {
    // 请求获取主聊天列表，限制一次获取20个
    TdApi.LoadChats loadChats = new TdApi.LoadChats(new TdApi.ChatListMain(), 20);
    sendRequest(loadChats, new Client.ResultHandler() {
        @Override
        public void onResult(TdApi.Object object) {
            if (object.getConstructor() == TdApi.Ok.CONSTRUCTOR) {
                // 加载成功，现在可以获取具体的聊天信息
                // 通常，您会监听 UpdateNewChat, UpdateChatTitle 等更新来构建和更新UI列表
            } else if (object.getConstructor() == TdApi.Error.CONSTRUCTOR) {
                // 处理错误
                TdApi.Error error = (TdApi.Error) object;
                Log.e("TDLib", "Failed to load chats: " + error.message);
            }
        }
    });
    // 同时，获取已经存在的聊天（从本地数据库）
    sendRequest(new TdApi.GetChats(new TdApi.ChatListMain(), 100), new Client.ResultHandler() {
        @Override
        public void onResult(TdApi.Object object) {
            if (object.getConstructor() == TdApi.Chats.CONSTRUCTOR) {
                TdApi.Chats chats = (TdApi.Chats) object;
                for (long chatId : chats.chatIds) {
                    // 对每个 chatId，发送 GetChat 请求获取详细信息
                    sendRequest(new TdApi.GetChat(chatId), chatDetailHandler);
                }
            }
        }
    });
}

public void sendTextMessage(long chatId, String text) {
    TdApi.InputMessageContent content = new TdApi.InputMessageText(
            new TdApi.FormattedText(text, new TdApi.TextEntity[0]),
            false,
            true
    );
    TdApi.SendMessage sendMessage = new TdApi.SendMessage(chatId, 0, null, null, content);
    sendRequest(sendMessage, sendResultHandler);
}

public void downloadFile(int fileId, String localPath) {
    TdApi.DownloadFile downloadFile = new TdApi.DownloadFile(
            fileId,
            1, // 优先级
            0, // 偏移量
            0, // 限制
            false // 是否同步
    );
    sendRequest(downloadFile, new Client.ResultHandler() {
        @Override
        public void onResult(TdApi.Object object) {
            if (object.getConstructor() == TdApi.File.CONSTRUCTOR) {
                TdApi.File file = (TdApi.File) object;
                // file.local.path 即为下载完成的本地路径
                // 注意：需要监听 UpdateFile 来跟踪下载进度
            }
        }
    });
}

// 添加一个 MTProto 代理（Telegram 专属协议）
TdApi.AddProxy addProxy = new TdApi.AddProxy(
        "proxy.server.com", // 服务器
        443,                // 端口
        true,               // 启用
        new TdApi.ProxyTypeMtproto("your_proxy_secret") // MTProto 代理密钥
);
sendRequest(addProxy, proxyResultHandler);

// 启用代理
TdApi.EnableProxy enableProxy = new TdApi.EnableProxy(proxyId);
sendRequest(enableProxy, enableResultHandler);

// 设置日志回调，将 TDLib 日志输出到 Android Logcat
Client.execute(new TdApi.SetLogStream(new TdApi.LogStreamDefault()));
Client.execute(new TdApi.SetLogVerbosityLevel(1)); // 设置日志级别，1为错误，2为警告，3为信息，4为调试