• 서비스
  • 가격
  • 리소스
  • 기술지원
Feedback

Demo 실행

여기서는 주로 Tencent Cloud TRTC Web SDK Demo를 빠르게 실행하는 방법을 소개합니다.

전제 조건

당신은 이미 Tencent Cloud 등록 계정이 있습니다.

조작 절차

1. 애플리케이션 생성

Tencent Real-Time Communication(TRTC) 콘솔에 로그인한 후 Create Application를 클릭하여 RTC Engine 애플리케이션을 생성하며, 이미 생성했으면 무시할 수 있습니다.

2. SDKAppID 및 SDKSecretKey 획득

애플리케이션 생성 완료 후 기본 정보에서 당신의 SDKAppIDSDKSecretKey를 획득할 수 있습니다. Demo를 체험하시려면 이 2개 정보가 필요합니다.


3. Demo 실행

1. 온라인 Demo 실행
TRTC Web는 현재 아래 몇 가지 기본 Demo를 제공하므로 익숙한 프로젝트 프레임워크를 선택하여 실행할 수 있습니다.
1.1 quick-demo-js는 Javascript를 사용하여 개발한 Demo입니다. 소스 코드: github
1.2 quick-demo-vue2-js는 Vue2 + Javascript을 사용하여 개발한 Demo입니다. 소스 코드: github
1.3 quick-demo-vue3-ts는 Vue3 + Typescript를 사용하여 개발한 Demo입니다. 소스 코드: github
2. 로컬 Demo 실행
2.1 Github or Zip에서 소스 코드를 다운로드합니다.
2.2 아래 안내에 로컬 Demo를 실행합니다.
quick-demo-js
quick-demo-vue2-js
quick-demo-vue3-ts
1. 다운로드된 소스 코드에서 TRTC_Web/quick-demo-js/index.html 파일을 찾아 브라우저로 엽니다.
2. 브라우저의 페이지에서 단계 2에서 획득한 SDKAppIdSDKSecretKey를 기입합니다.



3. 기능 체험
Enter Room를 클릭하여 방으로 들어갑니다.
Start Local Audio/Video를 클릭하면 마이크 또는 카메라 수집을 시작할 수 있습니다.
Stop Local Audio/Video를 클릭하면 마이크 또는 카메라 수집을 종료할 수 있습니다.
Start Share Screen를 클릭하여 화면 공유를 시작합니다.
Stop Share Screen를 클릭하여 화면 공유를 취소합니다.
4. 방에 들어간 후 초대 링크를 공유하는 것을 통해 피초대자와 함께 TRTC Web 음성 및 비디오 인터워킹 기능을 체험할 수 있습니다.
1. 다운로드된 소스 코드에서 찾아 TRTC_Web/quick-demo-vue2-js/ 디렉터리로 들어갑니다.
cd quick-demo-vue2-js
2. 로컬에서 Demo를 실행하는 경우, 단말기에서 아래 명령을 실행하면 자동으로 종속성을 설치하고 demo를 실행합니다.
이 명령을 실행하려면 먼저 Nodejs를 설치해야 합니다.
npm start
3. 브라우저는 기본적으로 http://localhost:8080/ 주소를 자동으로 엽니다.
4. 브라우저의 페이지에서 단계 2에서 획득한 SDKAppIdSDKSecretKey를 기입합니다.



5. 기능 체험
방에 들어가기 버튼을 클릭하여 방에 들어갑니다.****
마이크/카메라 수집 버튼을 클릭하면 마이크 또는 카메라 수집을 시작할 수 있습니다.
마이크/카메라 수집 종료 버튼을 클릭하면 마이크 또는 카메라 수집을 종료할 수 있습니다.
화면 공유 시작 버튼을 클릭하여 화면 공유를 시작합니다.
화면 공유 종료 버튼을 클릭하여 화면 공유를 취소합니다.
6. 방에 들어간 후 초대 링크를 공유하는 것을 통해 피초대자와 함께 TRTC Web 음성 및 비디오 인터워킹 기능을 체험할 수 있습니다.
1. 다운로드된 소스 코드에서 찾아 TRTC_Web/quick-demo-vue3-ts/ 디렉터리로 들어갑니다.
2. 로컬에서 Demo를 실행하는 경우, 단말기에서 아래 명령을 실행하면 자동으로 종속성을 설치하고 demo를 실행합니다.
이 명령을 실행하려면 먼저 Nodejs를 설치해야 합니다.
npm start
3. 브라우저는 기본적으로 http://localhost:3000/ 주소를 자동으로 엽니다.
4. 브라우저의 페이지에서 단계 2에서 획득한 SDKAppIdSDKSecretKey를 기입합니다.



5. 기능 체험
userId 및 roomId를 입력합니다.
Enter Room 버튼을 클릭하여 방에 들어갑니다.
Start Local Audio/Video 버튼을 클릭하면 마이크 또는 카메라 수집을 시작할 수 있습니다.
Stop Local Audio/Video 버튼을 클릭하면 마이크 또는 카메라 수집을 종료할 수 있습니다.
Start Share Screen 버튼을 클릭하여 화면 공유를 시작합니다.
Stop Share Screen 버튼을 클릭하여 화면 공유를 취소합니다.
6. 방에 들어간 후 초대 링크를 공유하는 것을 통해 피초대자와 함께 TRTC Web 음성 및 비디오 인터워킹 기능을 체험할 수 있습니다.
주의사항:
여기서 사용된 UserSig 생성 솔루션은 로컬에서 SECRETKEY를 구성하는 것이며, 이 솔루션에서 SECRETKEY는 역컴파일에 의해 쉽게 해독되며, 암호키가 유출되면 공격자가 당신의 Tencent Cloud 트래픽을 도용할 수 있으므로, 이 방법은 로컬 Demo 실행 및 기능 디버깅에만 적용됩니다. 정확한 UserSig 발급 방식은 당신의 서버 측에서 UserSig를 생성하는 것이며, 사용자가 방에 들어갈 때:
http 요청을 당신의 서버 측으로 보냅니다.
서버 측에서 1개 UserSig를 생성합니다.
방에 들어갈 수 있도록 이를 사용자에게 반환합니다.
Demo를 공중에 배치하여 체험하시려면 HTTPS 프로토콜을 통해, 즉 https://도메인/xxx에 액세스해야 합니다. 이유는 페이지 액세스 프로토콜 제한 설명을 참고하시기 바랍니다.

자주 받는 질문들

지원되는 플랫폼

TRTC Web SDK는 WebRTC를 기반으로 구현되며, 현재는 데스크톱 버전 및 모바일 버전의 주류 브라우저(Chrome, Edge, Safari, Firefox, Opera)를 지원하며, 자세한 지원도 테이블은 지원되는 플랫폼을 참고하시기 바랍니다.

URL 도메인 프로토콜 제한

브라우저 보안 정책의 제한으로 인해 WebRTC 능력 사용은 페이지의 액세스 프로토콜에 대해 엄격한 요구사항이 있으므로, 아래 테이블을 참조하여 애플리케이션을 개발 및 배치하시기 바랍니다.
애플리케이션 시나리오
프로토콜
수신(재생)
송신(마이크 연결)
화면 공유
비고
생산 환경
HTTPS 프로토콜
지원
지원
지원
추천
생산 환경
HTTP 프로토콜
지원
지원 안 됨
지원 안 됨
-
로컬 개발 환경
http://localhost
지원
지원
지원
추천
로컬 개발 환경
http://127.0.0.1
지원
지원
지원
-
로컬 개발 환경
http://[로컬 IP]
지원
지원 안 됨
지원 안 됨
-
로컬 개발 환경
file:///
지원
지원
지원
-

방화벽 규제

TRTC Web SDK를 사용할 때, 사용자는 방화벽 규제로 인해 정상적인 오디오/비디오 통화를 진행하지 못할 수 있으므로, 방화벽 규제 대응 관련을 참고하여 해당 포트 및 도메인을 방화벽 얼로우리스트에 추가하시기 바랍니다.

기타

기타 자주 받는 질문에 대해서는 Web 측 자주 받는 질문들을 참고하십시오.