TCMeet (TCmeet_qc)

简体中文说明 — 基于 Qt 的桌面视频会议客户端，集成 Agora SDK

概述

• 项目名：TCmeet_qc
• 这是一个使用 Qt（Widgets）开发的桌面会议客户端，包含 UI、资源（图片、声音）以及与 Agora 视频/音频 SDK 的集成。

主要特点

• 基于 Qt 的界面 (Widgets)
• 集成 Agora 高/低级 SDK（在 ui/mainwidget__/tool/settings/Video/sdk 目录）
• 资源管理位于 res/，UI 文件位于 ui/ 目录

依赖

• CMake >= 3.16
• Qt (Qt5 或 Qt6，需包含 Core 和 Widgets 模块)
• C++ 编译器（Windows: MSVC 或 MinGW）
• Agora SDK（仓库中包含了 SDK 的头文件与二进制目录结构，具体平台库请确认 ui/mainwidget__/tool/settings/Video/sdk 下的子目录）

构建（通用步骤，Windows）

1. 安装 Qt，并记下 Qt 的安装路径（用于 CMAKE_PREFIX_PATH）。
2. 在仓库根目录下创建构建目录并运行 CMake：

mkdir build
cd build
cmake .. -DCMAKE_PREFIX_PATH="/path/to/Qt"    # Windows 示例: C:/Qt/6.x.x/<compiler>/lib/cmake
cmake --build . --config Release

Windows（Visual Studio）示例：

cmake .. -G "Visual Studio 17 2022" -A x64 -DCMAKE_PREFIX_PATH="C:/Qt/6.x.x/msvc2019_64/lib/cmake"
cmake --build . --config Release

如果使用 Qt5，将 -DCMAKE_PREFIX_PATH 指向对应的 Qt5 安装路径；CMake 会尝试查找 Qt6 或 Qt5（见 CMakeLists.txt）。

生成的可执行文件名称为 TCmeet_qc（见 CMake 配置）。运行时请确保依赖的 Qt DLL 与 Agora 平台库可被找到。

关键文件/目录说明

• 入口文件: main.cpp
• 构建脚本: CMakeLists.txt
• 全局头: global.h
• UI 目录: ui/（包含各窗口、对话框与设置界面）
• 资源: res/（图片、声音等）
• Agora SDK: ui/mainwidget__/tool/settings/Video/sdk

调试与常见问题

• 若 CMake 找不到 Qt，请设置 CMAKE_PREFIX_PATH 指向 Qt 的 lib/cmake 目录。
• 运行时若缺少 Qt DLL，确保把相应的 Qt 运行时库路径加入系统环境变量或与可执行文件放在同一目录。
• 若使用 Agora，本地需要匹配对应平台的 SDK 二进制文件（x86/x86_64），请检查 sdk/x86 与 sdk/x86_64 子目录。

贡献

• 欢迎提交 issue 与 PR。描述清楚问题/改进点，并附上重现步骤。

许可与作者

• 请在仓库中补充 LICENSE 信息以明确许可条款。

---

如果你希望我把 README 翻译成英文、添加更详细的构建示例（如针对 MinGW 或不同 VS 版本），或把 README 内的路径/命令调整为你本地的 Qt/工具链设置，我可以继续更新。