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 Communication

TUIRoom (iOS) 통합

포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-25 10:40:36

컴포넌트 개요

TUIRoom은 오픈 소스 오디오/비디오 UI 컴포넌트입니다. 프로젝트에 통합한 후 몇 줄의 코드 작성만으로 화면 공유, 뷰티 필터 및 저지연 영상 통화와 같은 기능을 App에 추가할 수 있습니다. 또한 Android, Windows 및 Mac 플랫폼을 지원합니다. 기본 기능은 다음과 같습니다.
설명：
TUIKit 시리즈 컴포넌트는 Tencent Cloud의 두 가지 기본 PaaS 서비스, 즉 Tencent Real-Time Communication 및 Instant Messaging을 사용합니다. TRTC를 활성화하면 IM과 IM SDK 평가판(100 DAU만 지원)이 자동으로 활성화됩니다. IM 과금 내역은 요금 안내를 참고하십시오.




컴포넌트 통합

1단계: TUIRoom 컴포넌트 가져오기

cocoapods를 통해 컴포넌트를 가져오려면 다음 단계를 따르십시오.
1. 프로젝트의 Podfile과 같은 수준에 TUIRoom 폴더를 만듭니다.
2. 클릭하여 Github/TUILiveRoom으로 이동하고 클론/다운로드 코드를 선택한 다음 TUIRoom/iOS/ 디렉터리에 Source, Resources, TUIBeauty, TXAppBasic 폴더 및 TUIRoom.podspec 파일을 1단계에서 생성한 TUIRoom 폴더에 복사합니다.
3. Podfile에 다음 종속성을 추가하고 pod install을 실행하여 가져오기를 완료합니다.
# :path => "TUIRoom.podspec의 상대 경로를 가리킵니다"
pod 'TUIRoom', :path => "./TUIRoom/TUIRoom.podspec", :subspecs => ["TRTC"]
# :path => "TXAppBasic.podspec의 상대 경로를 가리킵니다"
pod 'TXAppBasic', :path => "./TUIRoom/TXAppBasic/"
# :path => "TUIBeauty.podspec의 상대 경로를 가리킵니다"
pod 'TUIBeauty', :path => "./TUIRoom/TUIBeauty/"
주의사항：
Source 및 Resources 폴더와 TUIRoom.podspec 파일은 동일한 디렉터리에 있어야 합니다.
TXAppBasic.podspec은 TXAppBasic 폴더에 있습니다.
TUIBeauty.podspec은 TCBeautyKit 폴더에 있습니다.

2단계: 권한 구성

오디오/비디오 기능을 사용하려면 마이크 및 카메라 권한을 부여해야 합니다. App의 Info.plist에 아래 두 항목을 추가합니다. 해당 콘텐츠는 사용자가 마이크 및 카메라 액세스 팝업 창에서 보는 것입니다.
<key>NSCameraUsageDescription</key>
<string>RoomApp은 이미지가 포함된 비디오를 촬영하려면 카메라에 액세스해야 합니다.</string>
<key>NSMicrophoneUsageDescription</key>
<string>RoomApp은 오디오가 포함된 비디오를 녹화하려면 마이크에 액세스해야 합니다.</string>




3단계: TUI 컴포넌트 생성 및 초기화

Objective-C
Swift
@import TUIRoom;
@import TUICore;

// 1. 컴포넌트에 로그인
[TUILogin login:@"사용자 SDKAppID" userID:@"사용자 UserID" userSig:@"사용자 UserSig" succ:^{

} fail:^(int code, NSString *msg) {

}];
// 2. TUIRoom 인스턴스 초기화
TUIRoom *tuiRoom = [TUIRoom sharedInstance];
```

import TUIRoom
import TUICore

// 1. 컴포넌트에 로그인
TUILogin.login("사용자 SDKAppID", userID: "사용자 UserID", userSig: "사용자 UserSig") {

} fail: { code, msg in

}

// 2. TUIRoom 인스턴스 초기화
let tuiRoom = TUIRoom.sharedInstance
```

매개변수 설명:
SDKAppID: TRTC 애플리케이션 ID입니다. TRTC 서비스를 활성화하지 않은 경우 TRTC 콘솔에 로그인하여 TRTC 애플리케이션을 생성하고 애플리케이션 정보를 클릭합니다. SDKAppID는 아래와 같습니다.


Secretkey: SDKAppID에 해당하는 TRTC 애플리케이션 키입니다. TRTC 콘솔의 애플리케이션 관리 페이지로 이동한 후, SecretKey는 아래와 같습니다.
userId: 문자열이며 최대 32바이트의 문자와 숫자를 포함할 수 있는 현재 사용자 ID입니다(특수 기호는 지원되지 않음). 실제 계정 시스템에 따라 사용자 정의할 수 있습니다.
UserSig: SDKAppId, UserID 및 SecretKey를 기반으로 계산된 보안 보호 서명입니다. 여기를 클릭하여 디버깅 userSig를 온라인으로 직접 생성하거나 TUIRoom 데모 프로젝트를 참고하여 직접 계산할 수 있습니다. 자세한 내용은 UserSig를 참고하십시오.

4단계: 그룹 오디오/비디오 인터랙션 구현

방 소유자가 그룹 오디오/비디오 인터랙션 방 생성 구현.
Objective-C
Swift
Objective-C
Swift
@import TUIRoom;

[tuiRoom createRoomWithRoomId:12345 speechMode:TUIRoomFreeSpeech isOpenCamera:YES isOpenMicrophone:YES];

import TUIRoom

tuiRoom.createRoom(roomId: 12345, speechMode: .freeSpeech, isOpenCamera: true, isOpenMicrophone: true)
```

@import TUIRoom;

[tuiRoom enterRoomWithRoomId:12345 isOpenCamera:YES isOpenMicrophone:YES]

import TUIRoom

tuiRoom.enterRoom(roomId: 12345, isOpenCamera: true, isOpenMicrophone: true)
```


5단계: 방 관리(옵션)

1. 방 소유자는 TUIRoomCore#destroyRoom을 통해 방을 해산합니다.
Objective-C
Swift
@import TUIRoom;

[[TUIRoomCore shareInstance] destroyRoom:^(NSInteger code, NSString * _Nonnull message) {

}];
```

import TUIRoom

TUIRoomCore.shareInstance().destroyRoom { [weak self] _, _ in
    guard let self = self else { return }
    self.navigationController?.popViewController(animated: true)
}
```

2. 다른 구성원은 TUIRoomCore#leaveRoom을 통해 방을 나갑니다.
Objective-C
Swift
@import TUIRoom;

[[TUIRoomCore shareInstance] leaveRoom:^(NSInteger code, NSString * _Nonnull message) {

}];
```

import TUIRoom

TUIRoomCore.shareInstance().leaveRoom { [weak self] _, _ in
    guard let self = self else { return }
    self.navigationController?.popViewController(animated: true)
}
```


6단계: 화면 공유(옵션)

TUIRoomCore#startScreenCapture를 통해 화면 공유를 구현합니다. 화면 공유 프로젝트 구성은 실시간 화면 공유(iOS)를 참고하십시오.
Objective-C
Swift 
@import TUIRoom;
@import TXLiteAVSDK_Professional;

TRTCVideoEncParam *params = [[TRTCVideoEncParam alloc] init];
params.videoResolution = TRTCVideoResolution_1280_720;
params.resMode = TRTCVideoResolutionModePortrait;
params.videoFps = 10;
params.enableAdjustRes = NO;
params.videoBitrate = 1500;

[[TUIRoomCore shareInstance] startScreenCapture:param];
```

import TUIRoom

 // 화면 공유
let params = TRTCVideoEncParam()
params.videoResolution = TRTCVideoResolution._1280_720
params.resMode = TRTCVideoResolutionMode.portrait
params.videoFps = 10
params.enableAdjustRes = false
params.videoBitrate = 1500
TUIRoomCore.shareInstance().startScreenCapture(params)

```


FAQ

CocoaPods는 어떻게 설치합니까?

터미널 창에 다음 명령어를 입력합니다(먼저 Mac에 Ruby를 설치해야 함).
sudo gem install cocoapods
설명：
요구 사항이나 피드백이 있는 경우 colleenyu@tencent.com으로 문의하십시오.
다음 주제: 제품 업데이트

도움말 및 지원

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

피드백