tencent cloud

Tencent Real-Time Communication

소식 및 공지 사항
제품 업데이트
Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가
TRTC 월간 구독 패키지 출시 관련 안내
제품 소개
제품 개요
기본 개념
제품 기능
제품 장점
응용 시나리오
성능 데이터
구매 가이드
Billing Overview
무료 시간 안내
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
과금 FAQ
Refund Instructions
신규 사용자 가이드
Demo 체험
Call
개요(TUICallKit)
Activate the Service
Run Demo
빠른 통합(TUICallKit)
오프라인 푸시
Conversational Chat
온클라우드 녹화(TUICallKit)
AI Noise Reduction
UI 사용자 정의
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
릴리스 노트
FAQs
라이브 스트리밍
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo 실행
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK 다운로드
API 코드 예시
Usage Guidelines
API 클라이언트 API
고급 기능
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
콘솔 가이드
애플리케이션 관리
사용량 통계
모니터링 대시보드
개발 보조
Solution
Real-Time Chorus
FAQs
과금 개요
기능 관련
UserSig 관련
방화벽 제한 처리
설치 패키지 용량 축소 관련 질문
Andriod 및 iOS 관련
Web 관련
Flutter 관련
Electron 관련
TRTCCalling Web 관련
멀티미디어 품질 관련
기타 질문
Protocols and Policies
컴플라이언스 인증
보안 백서
정보 보안에 관한 참고 사항
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집
문서Tencent Real-Time CommunicationRTC EngineUsage Guidelines01. SDK를 프로젝트로 가져오기QT

QT

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-24 14:15:38
본 문서에서는 Tencent Cloud 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 다운로드

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 통합

개발 환경 요건

운영 체제: Mac10.10 이상 버전
개발 환경: Qt Creator 4.10.3 이상 버전, Qt Creator 4.13.3 이상 사용 권장
개발 프레임워크: Based on Qt 5.10 이상

작업 단계

이 섹션에서는 QTTest 프로젝트 생성을 예시로 TRTC C++ SDK를 Qt Creator의 프로젝트에 통합하는 방법을 소개합니다.

1. C++용 크로스 플랫폼 SDK 다운로드
1.1 SDK를 다운로드한 후 파일의 압축을 풀고 엽니다.
1.2 QtTest 프로젝트 디렉터리에 SDK용 빈 폴더를 생성하고 SDK의 TXLiteAVSDKTRTCMacx.x.x/SDK/TXLiteAVSDKTRTC_Mac.framework를 해당 폴더에 복사합니다.
2. QTTest.pro 구성 QTTest 프로젝트의 디렉터리로 이동하여 텍스트 편집기로 QTTest.pro를 열고 다음 SDK 참조를 추가하십시오.
INCLUDEPATH += $$PWD/.
DEPENDPATH += $$PWD/.

LIBS += "-F$$PWD/base/util/mac/usersig"
LIBS += "-F$$PWD/../SDK"
LIBS += -framework TXLiteAVSDK_TRTC_Mac
LIBS += -framework Accelerate
LIBS += -framework AudioUnit

INCLUDEPATH += $$PWD/../SDK/TXLiteAVSDK_TRTC_Mac.framework/Headers/cpp_interface

INCLUDEPATH += $$PWD/base/util/mac/usersig/include
DEPENDPATH += $$PWD/base/util/mac/usersig/include
3. 카메라 및 마이크 권한 요청 TRTC SDK에서 카메라와 마이크를 사용하려면 Info.plist에 권한 요청을 추가해야 합니다. 권한 신청 설명은 다음과 같습니다.
NSMicrophoneUsageDescription: 마이크 사용 권한 신청
NSCameraUsageDescription: 카메라 사용 권한 신청
다음 이미지 참고:


4. TRTC SDK 참조
헤더 파일 #include "ITRTCCloud.h"를 사용하여 SDK를 참조하십시오.
네임스페이스 사용: 크로스 플랫폼 C++ API의 메소드 및 유형은 trtc 네임스페이스에 정의됩니다. 코드를 단순화하려면 trtc 네임스페이스를 사용하는 것이 좋습니다.
설명：
이것으로 통합 프로세스가 완료되고 프로젝트 컴파일을 진행할 수 있습니다. QTDemo를 다운로드하여 SDK의 크로스 플랫폼 API 사용에 대해 참고하십시오.

FAQ

다음 오류가 발생하는 경우 상기 프로그램 설정에 따라 SDK 헤더 파일의 디렉터리를 정확하게 추가했는지 확인합니다.
fatal error C1083: 포함된 파일을 열 수 없습니다. “TRTCCloud.h”: No such file or directory
다음 오류가 발생하는 경우 상기 프로그램 설정에 따라 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) 함수에 참조됩니다.
이전 주제: 빠른 통합(Flutter)다음 주제: 빠른 통합(Unity)

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백