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 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집

Web

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-24 14:29:06
본 문서는 TRTC 방에 들어가는 방법을 설명합니다. 오디오/비디오 방에 입장한 후에만 사용자는 방에 있는 다른 사용자의 오디오/비디오 스트림을 구독하거나 사용자 자신의 오디오/비디오 스트림을 다른 사용자에게 게시할 수 있습니다.


TRTC Web SDK를 사용하다 보면 종종 다음과 같은 객체를 접하게 됩니다.
Client 객체는 로컬 클라이언트를 말합니다. Client 타입으로 통화방 입장, 로컬 스트림 배포, 원격 스트림 구독 등 기능을 제공합니다.
Stream 객체는 멀티미디어 스트림 객체를 말하며, 로컬 멀티미디어 스트림 객체 LocalStream와 원격 멀티미디어 스트림 객체 RemoteStream로 나뉩니다. Stream 타입은 오디오 및 비디오의 재생과 관련한 멀티미디어 스트림 객체 행위를 지원합니다.

1단계: Client 객체 생성

TRTC.createClient()Client 객체를 생성합니다. 주요 매개변수는 다음과 같습니다.
매개변수
필드 의미
보충 설명
데이터 유형
샘플 값
기본값
비고
mode
응용 시나리오
'rtc'모드는 일대일 음성/화상 통화 또는 최대 300명이 참여할 수 있는 회의에 적합합니다.
live는 최대 10만 명까지 실시간 스트리밍할 수 있습니다.
string
rtc
rtc
-
sdkAppId
애플리케이션 ID
TRTC 콘솔에서 sdkAppId를 볼 수 있습니다. 아직 애플리케이션이 없다면 ‘애플리케이션 생성’을 클릭하여 애플리케이션을 생성합니다.
number
1400000123
없음
필수
userId
사용자 ID
사용자 이름. 영어 대문자 및 소문자(a-z, A-Z), 숫자(0-9), 밑줄 및 하이픈만 포함할 수 있습니다.
참고: TRTC에서 사용자는 동일한 사용자 ID를 사용하여 두 개의 다른 장치에서 동시에 같은 방에 들어갈 수 없습니다.
string
‘denny’ 또는 ‘123321’
없음
필수
userSig
방에 들어가기 위해 필요한 인증 티켓
계산 방법은 UserSig 계산 및 사용 방법을 참고하십시오.
문자열
eJyrVareCeYrSy1SslI...
없음
필수
useStringRoomId
문자열 유형의 방 ID 사용 여부
string 유형의 roomId 사용 여부를 지정합니다.
boolean
true
false
-
자세한 매개변수 설명은 TRTC.createClient()를 참고하십시오.
// 실시간 통화 모드에서 클라이언트 객체 생성
const client = TRTC.createClient({
mode: 'rtc',
sdkAppId,
userId,
userSig
});

// 라이브 스트리밍 모드에서 클라이언트 객체 생성
const client = TRTC.createClient({
mode: 'live',
sdkAppId,
userId,
userSig
});

2단계: 영상 통화방 입장

Client.join()을 호출하여 음성/영상 통화방에 입장합니다. 주요 매개변수는 다음과 같습니다.
매개변수
필드 의미
보충 설명
데이터 유형
샘플 값
기본값
비고
roomId
방 ID
데이터 유형은 기본적으로 number입니다. string 유형의 roomId를 사용하려면 createClient()의 useStringRoomId 매개변수를 true로 설정합니다.
number roomId는 [1에서 4294967294] 사이의 정수여야 합니다.
roomId가 string 유형일 때 64바이트 미만의 다음 문자 세트만 지원됩니다:
영문 대문자 및 소문자(a-zA-Z); 숫자(0-9); 스페이스, !, #, $, %, &, (,), +, -, :, ;, <, =, ., >, ?, @, [,], ^, _, {,}, |, ~,
number / string
3364 또는 class-room
없음
필수
role
사용자 역할
이 매개변수는 모드가 live로 설정된 경우에만 필요합니다. 현재 지원되는 두 가지 역할: anchor 앵커, audience 시청자
string
anchor
audience
-
자세한 매개변수 설명은 Client.join()을 참고하십시오.
// Promise 구문 사용
client
.join({ roomId })
.then(() => {
console.log('입장 성공');
})
.catch(error => {
console.error('입장 실패, 나중에 다시 시도하십시오' + error);
});

// async/await 구문을 사용하는 것이 좋습니다.
try {
await client.join({ roomId });
console.log('입장 성공');
} catch (error) {
console.error('입장 실패, 나중에 다시 시도하십시오' + error);
}

// 앵커 역할로 방 입장
try {
await client.join({
roomId,
role: 'anchor'
});
console.log('입장 성공');
} catch (error) {
console.error('입장 실패, 나중에 다시 시도하십시오' + error);
}

도움말 및 지원

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

피드백