实时音视频
有奖：腾讯混元大模型征文大赛邀您参加！> HOT
文档中心>实时音视频>无 UI 集成>API-使用指引>01. 导入 SDK 到项目中>QT

QT

最近更新时间：2024-09-27 17:48:12

我的收藏

本页目录：

本文主要介绍如何快速地将腾讯云 TRTC SDK（QT 的 Windows 和 Mac 版本）集成到您的项目中，只要按照如下步骤进行配置，就可以快速完成 SDK 的集成工作。




Windows 端集成

开发环境要求

操作系统：Windows 7及以上版本。
开发环境：Visual Studio 2015及以上版本，推荐使用 Visual Studio 2015，前提是您已经配置好 VS 相关的 QT 开发环境。
说明
如果您不熟悉配置 VS 相关 QT 开发环境的步骤，请参见 README 中的操作步骤的步骤4相关内容。

操作步骤

本节通过创建一个简单的 QT 项目，介绍如何在 Visual Studio 工程中集成 C++ SDK。

步骤1：下载 SDK

1. 下载 SDK，解压并打开。 本文示例中，您只需要引用 SDK 目录下 C++ 版的 SDK 文件即可。以64位为例，其 SDK 位置为./SDK/CPlusPlus/Win64/下，主要包含以下几个部分：
目录名
说明
include
带有详细接口注释的 API 头文件
lib
编译用的 .lib 文件和运行时加载的 .dll 文件

步骤2：新建工程

以 Visual Studio 2015 为例，在确保本地已经安装了 QT 和 VS 开发插件 的前提下，打开 Visual Studio。新建一个名字叫TRTCDemo的 QT 应用程序，如下图所示：

为了便于介绍如何快速集成，在向导中我们选择 Qt Widgets Application 类型，单击确定，在之后的页面中单击 Next 直到工程创建完成即可。

步骤3：拷贝文件

将解压后的 SDK 文件夹拷贝到 TRTCDemo.vcxproj 所在目录下，如下图所示：
说明
当前只需要 C++ SDK，可以将 SDK 路径下的 CSharp 目录删除。




步骤4：修改工程配置

打开 TRTCDemo 属性页，在解决方案资源管理器 >TRTCDemo 工程的右键菜单 > 属性，请按照以下步骤进行配置：
1. 添加包含目录： 在 C/C++ > 常规 > 附加包含目录，以64位为例，添加 SDK 头文件目录$(ProjectDir)SDK\\CPlusPlus\\Win64\\include 和 $(ProjectDir)SDK\\CPlusPlus\\Win64\\include\\TRTC，如下图所示：
说明
如果为32位，则需要将 SDK 头文件目录设为 $(ProjectDir)SDK\\CPlusPlus\\Win32\\include 和 $(ProjectDir)SDK\\CPlusPlus\\Win32\\include\\TRTC。



2. 添加库目录： 在链接器 > 常规 > 附加库目录，以64位为例，添加 SDK 库目录$(ProjectDir)SDK\\CPlusPlus\\Win64\\lib，如下图所示：
说明
如果为32位，则需要将 SDK 库目录设为$(ProjectDir)SDK\\CPlusPlus\\Win32\\lib 。



3. 添加库文件： 在链接器 > 输入 > 附加依赖项，添加 SDK 库文件liteav.lib，如下图所示：


4. 添加 copy 命令： 在生成事件 > 后期生成事件 > 命令行，添加拷贝命令copy /Y $(ProjectDir)SDK\\CPlusPlus\\Win64\\lib\\*.dll $(OutDir)，能够在编译完成后，自动将 SDK 的 .dll 文件拷贝到程序的运行目录下，如下图所示：
说明
如果为32位，则添加拷贝命令为copy /Y $(ProjectDir)SDK\\CPlusPlus\\Win32\\lib\\*.dll $(OutDir) 。




步骤5：打印 SDK 版本号

1. 在TRTCDemo.cpp文件顶部增加头文件引入，代码如下：
#include "ITRTCCloud.h"
#include <QLabel>
2. 在TRTCDemo.cpp文件的TRTCDemo::TRTCDemo构造函数中，添加下面的测试代码：
ITRTCCloud * pTRTCCloud = getTRTCShareInstance();
std::string version(pTRTCCloud->getSDKVersion());

QString sdk_version = QString("SDK Version: %1").arg(version.c_str());
QLabel* label_text = new QLabel(this);
label_text->setAlignment(Qt::AlignCenter);
label_text->resize(this->width(), this->height());
label_text->setText(sdk_version);
3. 按键盘 F5 运行，打印 SDK 的版本号，如下图所示：




Mac 端集成

开发环境要求

操作系统：Mac OS X 12.2及以上版本。
开发环境：xcode 13.2.1及以上版本；Qt Creator 4.10.3及以上版本，推荐使用 Qt Creator 4.13.3及以上。
开发框架：Based on Qt 5.9及以上版本。
其他要求：项目已配置有效的开发者签名。

操作步骤

本节以创建一个简单的 QTDemo 项目为例，介绍如何在 Qt Creator 工程中集成 C++ 跨平台 SDK。
1. 下载 C++ 跨平台 SDK
1.1 下载 SDK，解压并打开文件。
1.2 在您的 QTDemo 目录下新建一个空的 SDK 目录，将步骤 1.1 下载的 SDK 中TXLiteAVSDK_TRTC_Mac/TXLiteAVSDK_TRTC_Mac.framework 、TXLiteAVSDK_TRTC_Mac/TXFFmpeg.xcframework 、TXLiteAVSDK_TRTC_Mac/TXSoundTouch.xcframework 拷贝到您新建的 SDK 目录下。
2. 新建 QT 项目
2.1. 使用 Qt Creator 创建一个新项目，如下图所示：



选择新建一个 Qt Widgets Application 模板应用程序。
2.2. 构建系统选择 qmake，如下图所示：



选择完成后点击继续，直到 Kits 套件选择。
2.3. 选择 Kits 开发套件，如下图所示：



选择套件后点击继续，直到完成。
3. 配置 QTDemo.pro 打开 QTDemo 工程目录，使用一任意文本编辑器打开QTDemo.pro文件，然后添加 TRTC SDK 库依赖相关配置，部分代码如下：
QMAKE_INFO_PLIST += Info.plist
INCLUDEPATH += $$PWD/.
DEPENDPATH += $$PWD/.

# 添加TXLiteAVSDK_TRTC_Mac.framework头文件
INCLUDEPATH += $$PWD/SDK/TXLiteAVSDK_TRTC_Mac.framework/Headers/cpp_interface
INCLUDEPATH += $$PWD/SDK/TXLiteAVSDK_TRTC_Mac.framework/Headers

# 引用TXLiteAVSDK_TRTC_Mac库
LIBS += "-F$$PWD/SDK"
LIBS += -framework TXLiteAVSDK_TRTC_Mac

# 引用的系统库
QMAKE_CXXFLAGS += -x objective-c++
LIBS += -framework Accelerate
LIBS += -framework AudioUnit
LIBS += -lbz2
LIBS += -lresolv
LIBS += -framework AppKit
LIBS += -framework Foundation
LIBS += -framework CoreFoundation
LIBS += -framework Cocoa
LIBS += -framework Security
LIBS += -framework SystemConfiguration
LIBS += -framework JavaScriptCore
LIBS += -framework CoreMedia
LIBS += -framework CoreAudio
LIBS += -framework CoreVideo
LIBS += -framework CoreImage
LIBS += -framework AVFoundation
LIBS += -framework AudioToolbox
LIBS += -framework VideoToolbox
LIBS += -framework MetalKit
LIBS += -framework Metal
LIBS += -framework CoreTelephony
LIBS += -framework CoreGraphics
LIBS += -framework OpenGL
LIBS += -framework OpenAL
LIBS += -framework QuartzCore
LIBS += -lz
LIBS += -ObjC

# TXFFmpeg库的使用
LIBS += -F$$PWD/SDK/TXFFmpeg.xcframework/macos-arm64_x86_64
LIBS += -framework TXFFmpeg
TXFFmpeg_FRAMEWORK.files = $$PWD/SDK/TXFFmpeg.xcframework/macos-arm64_x86_64/TXFFmpeg.framework
TXFFmpeg_FRAMEWORK.path = /Contents/Frameworks
QMAKE_BUNDLE_DATA += TXFFmpeg_FRAMEWORK

# TXSoundTouch库的使用
LIBS += -F$$PWD/SDK/TXSoundTouch.xcframework/macos-arm64_x86_64
LIBS += -framework TXSoundTouch
TXSoundTouch_FRAMEWORK.files = $$PWD/SDK/TXSoundTouch.xcframework/macos-arm64_x86_64/TXSoundTouch.framework
TXSoundTouch_FRAMEWORK.path = /Contents/Frameworks
QMAKE_BUNDLE_DATA += TXSoundTouch_FRAMEWORK

# 运行时库路径rpath的添加
QMAKE_LFLAGS += -Wl -ObjC
QMAKE_LFLAGS += -Wl,-rpath,@executable_path/../Frameworks/

# usersig的相关引用
LIBS += "-F$$PWD/base/util/mac/usersig"
INCLUDEPATH += $$PWD/base/util/mac/usersig/include
DEPENDPATH += $$PWD/base/util/mac/usersig/include
4. 授权摄像头和麦克风使用权限 因为 TRTC SDK 会使用您的摄像头和麦克风，所以您需要在对应的Info.plist添加对应的权限申请说明：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>NSMicrophoneUsageDescription</key>
	<string>申请使用麦克风</string>
	<key>NSCameraUsageDescription</key>
	<string>申请使用摄像头</string>
	<key>NSPrincipalClass</key>
	<string>NSApplication</string>
	<key>CFBundleIconFile</key>
	<string></string>
	<key>CFBundlePackageType</key>
	<string>APPL</string>
	<key>CFBundleGetInfoString</key>
	<string>Created by Qt/QMake</string>
	<key>CFBundleSignature</key>
	<string>1</string>
	<key>CFBundleExecutable</key>
	<string>QTDemo</string>
	<key>CFBundleIdentifier</key>
	<string>apophis.QTDemo</string>
	<key>NOTE</key>
	<string>This file was generated by Qt/QMake.</string>
</dict>
</plist>
如下图所示：


5. 使用 TRTC SDK
您可以通过头文件#include "ITRTCCloud.h"直接引用。
使用命名空间：C++ 全平台接口的方法、类型等均定义在 trtc 命名空间中，为了让代码更加简洁，建议您直接使用 trtc 命名空间。
说明
至此您的集成工作已经完成，可以编译运行您的项目了。关于更多跨平台 SDK 的 API 使用 Demo，请下载 QTDemo 参考。

常见问题

若出现以下错误，请按照前面的工程配置，检查 SDK 头文件的目录是否正确添加。
fatal error C1083: 无法打开包括文件: “TRTCCloud.h”: No such file or directory
若出现提示无法打开 "xxx.framework"，因为无法验证开发者，可以在系统的安全性和隐私里面进行允许设置，如下：



若出现以下错误，请按照前面的工程配置，检查 SDK 库目录和库文件是否正确添加。
error LNK2019: 无法解析的外部符号 "__declspec(dllimport) public: static class TXString __cdecl TRTCCloud::getSDKVersion(void)" (__imp_?getSDKVersion@TRTCCloud@@SA?AVTXString@@XZ)，该符号在函数 "protected: virtual int __thiscall CTRTCDemoDlg::OnInitDialog(void)" (?OnInitDialog@CTRTCDemoDlg@@MAEHXZ) 中被引用



中国站
文档反馈
文档活动
message-icon联系我们
目录