tencent cloud

피드백

마지막 업데이트 시간: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);
    }
    문의하기

    고객의 업무에 전용 서비스를 제공해드립니다.

    기술 지원

    더 많은 도움이 필요하시면, 티켓을 통해 연락 바랍니다. 티켓 서비스는 연중무휴 24시간 제공됩니다.

    연중무휴 24시간 전화 지원