tencent cloud

피드백

Electron

마지막 업데이트 시간:2024-07-24 14:29:06
    본 문서는 방에 있는 다른 사용자의 오디오/비디오 스트림을 구독하는 방법, 즉 다른 사용자의 오디오/비디오를 재생하는 방법을 설명합니다. 편의상 이 문서에서는 ‘방에 있는 다른 사용자’를 ‘원격 사용자’라고 합니다.
    
    

    호출 가이드

    1단계: 필수 단계 수행

    iOS에 안내된 대로 SDK를 가져옵니다.

    2단계: 구독 모드 설정(선택 사항)

    TRTCCloud에서 setDefaultStreamRecvMode API를 호출하여 구독 모드를 설정할 수 있습니다. TRTC는 두 가지 구독 모드를 제공합니다.
    자동 구독: SDK는 별도의 수동 조작 없이 원격 사용자의 오디오를 자동으로 재생합니다. 이것은 기본 구독 모드입니다.
    수동 구독: SDK는 원격 사용자의 오디오를 자동으로 가져오거나 재생하지 않습니다. 오디오를 재생하려면 **muteRemoteAudio(userId, false)**를 수동으로 호출해야 합니다.
    주의사항:
    SDK의 기본 구독 모드는 자동 구독이므로 setDefaultStreamRecvMode를 호출할 필요가 없습니다. 그러나 수동 구독을 사용하려는 경우 setDefaultStreamRecvMode는 enterRoom보다 먼저 호출되어야만 적용된다는 점에 유의하십시오.

    3단계: TRTC 방 입장

    방 입장의 안내에 따라 현재 사용자가 TRTC 방에 입장하도록 합니다. 사용자는 성공적인 방 입장 후에만 원격 사용자의 오디오/비디오 스트림을 구독할 수 있습니다.
    

    4단계: 오디오 스트림 재생

    muteRemoteAudio("denny", true)를 호출하여 원격 사용자 denny를 음소거한 다음 muteRemoteAudio(‘denny’, false) API를 호출하여 denny의 음소거를 해제할 수 있습니다.
    import TRTCCloud from 'trtc-electron-sdk';
    const rtcCloud = new TRTCCloud();
    
    // Reference https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCCloud.html#muteRemoteAudio
    // Mute user with id denny
    rtcCloud.muteRemoteAudio('denny', true);
    // Unmute user with id denny
    rtcCloud.muteRemoteAudio('denny', false);

    5단계: 비디오 스트림 재생

    1. 재생 시작 및 중지(startRemoteView + stopRemoteView)

    startRemoteView를 호출하여 원격 사용자의 비디오 이미지를 재생할 수 있지만 사용자의 비디오 이미지를 전달하는 렌더링 컨트롤로 SDK에 view 객체를 전달한 후에만 가능합니다.
    startRemoteView의 첫 번째 매개변수는 원격 사용자의 userId, 두 번째는 사용자의 스트림 유형, 세 번째는 전달할 view 객체입니다. 여기서 두 번째 매개변수 streamType에는 세 가지 유효한 값이 있습니다.:
    TRTCVideoStreamTypeBig: 사용자의 기본 스트림 이미지로, 일반적으로 사용자의 카메라 이미지를 전송하는 데 사용됩니다.
    TRTCVideoStreamTypeSub: 사용자의 서브 스트림 이미지로, 일반적으로 사용자의 화면 공유 이미지를 전송하는 데 사용됩니다.
    TRTCVideoStreamTypeSmall: 사용자의 기본 스트림 이미지의 작은 저화질 이미지. 사용자가 ‘듀얼 스트림 모드(enableEncSmallVideoStream)’를 활성화한 후에만 원격 사용자의 저화질 이미지를 재생할 수 있습니다. 원본 품질의 기본 스트림과 낮은 품질의 작은 스트림은 동시에 재생할 수 없습니다.
    stopRemoteView API를 호출하여 한 원격 사용자의 비디오 재생을 중지하거나 stopAllRemoteView API를 호출하여 모든 원격 사용자의 비디오 재생을 중지할 수 있습니다.
    // https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCCloud.html#startRemoteView를 참고하십시오.
    
    import TRTCCloud, { TRTCVideoStreamType } from 'trtc-electron-sdk';
    
    const cameraView = document.querySelector('.user-dom');
    const screenView = document.querySelector('.screen-dom');
    const rtcCloud = new TRTCCloud();
    // denny의 카메라(‘기본 스트림’) 이미지 재생
    rtcCloud.startRemoteView('denny', cameraView, TRTCVideoStreamType.TRTCVideoStreamTypeBig);
    // denny의 화면 공유(‘서브 스트림’) 이미지 재생
    rtcCloud.startRemoteView('denny', screenView, TRTCVideoStreamType.TRTCVideoStreamTypeSub);
    // denny의 저화질 영상 재생 (원본 화질의 기본 스트림과 저화질의 작은 스트림은 동시에 재생할 수 없음)
    rtcCloud.startRemoteView('denny', cameraView, TRTCVideoStreamType.TRTCVideoStreamTypeSmall);
    // denny의 카메라 이미지 재생 중지
    rtcCloud.stopRemoteView('denny', TRTCVideoStreamType.TRTCVideoStreamTypeBig);
    // 모든 원격 사용자의 비디오 이미지 재생 중지
    rtcCloud.stopAllRemoteView();

    2. 재생 매개변수 설정(setRemoteRenderParams)

    setRemoteRenderParams를 사용하여 비디오 이미지 채우기 모드, 회전 각도 및 미러 모드를 설정할 수 있습니다.
    채우기 모드: 채우기 모드 또는 맞춤 모드를 사용할 수 있습니다. 두 모드에서 원본 이미지 종횡비는 변경되지 않고 유지되지만 차이점은 검은색 바가 있는지 여부입니다.
    회전 각도: 회전 각도를 0, 90, 180, 270도로 설정할 수 있습니다.
    미러 모드: 이미지를 수평으로 뒤집을지 여부를 나타냅니다.
    // https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCCloud.html#setRemoteRenderParams를 참고하십시오.
    // 원격 사용자 denny의 기본 스트림 이미지의 채우기 모드를 채우기로 설정하고 미러 모드 비활성화
    import TRTCCloud, {
    TRTCRenderParams, TRTCVideoStreamType, TRTCVideoRotation,
    TRTCVideoFillMode, TRTCVideoMirrorType
    } from 'trtc-electron-sdk';
    
    const param = new TTRTCRenderParams(
    TRTCVideoRotation.TRTCVideoRotation0,
    TRTCVideoFillMode.TRTCVideoFillMode_Fill,
    TRTCVideoMirrorType.TRTCVideoMirrorType_Enable
    );
    const rtcCloud = new TRTCCloud();
    rtcCloud.setRemoteRenderParams('denny', TRTCVideoStreamType.TRTCVideoStreamTypeBig, param);

    6단계: 방에 있는 원격 사용자의 오디오/비디오 상태 가져오기

    4단계5단계에서 원격 사용자의 오디오/비디오 재생을 제어할 수 있습니다. 그러나 정보가 충분하지 않으면 다음을 알 수 없습니다:
    현재 방에는 어떤 사용자가 있습니까?
    카메라와 마이크가 켜져 있습니까?
    이 문제를 해결하려면 SDK에서 다음 이벤트 콜백을 수신 대기해야 합니다:
    오디오 상태 변경 알림(onUserAudioAvailable) 원격 사용자가 마이크를 켜고 끌 때 onUserAudioAvailable(userId, boolean)을 수신하여 상태 변경을 가져올 수 있습니다.
    비디오 상태 변경 알림(onUserVideoAvailable) 원격 사용자가 카메라를 켜고 끌 때 onUserVideoAvailable(userId, boolean)을 수신하여 상태 변경을 가져올 수 있습니다. 원격 사용자가 화면 공유를 활성화/비활성화할 때 onUserSubStreamAvailable(userId, boolean)을 수신하여 상태 변경을 가져올 수 있습니다.
    사용자 방 입장/퇴장 알림(onRemoteUserEnter/LeaveRoom) 원격 사용자가 현재 방에 들어갈 때 onRemoteUserEnterRoom(userId)을 사용하여 사용자의 userId를 얻을 수 있습니다. 원격 사용자가 현재 방을 나갈 때 onRemoteUserLeaveRoom(userId, reason)을 사용하여 사용자의 userId와 퇴장 이유를 얻을 수 있습니다.
    주의사항:
    구체적으로, onRemoteUserEnter/LeaveRoom은 앵커의 방 입/퇴장 알림만 받을 수 있습니다. 이는 방에 많은 수의 온라인 시청자가 있을 때 방 입/퇴장 알림을 자주 수신하는 문제를 방지합니다.
    이러한 이벤트 콜백을 사용하면 다음 샘플 코드를 참고하여 방에 있는 사용자와 카메라와 마이크를 켰는지 여부를 알 수 있습니다. 여기서 mCameraUserList, mMicrophoneUserList 및 mUserList는 각각 다음 정보를 유지하는 데 사용됩니다.
    방에 있는 사용자(앵커)
    카메라를 켠 사용자
    마이크를 켠 사용자
    import TRTCCloud from 'trtc-electron-sdk';
    let openCameraUserList = [];
    let openMicUserList = [];
    let roomUserList = [];
    
    function onUserVideoAvailable(userId, available) {
    if (available === 1) {
    openCameraUserList.push(userId);
    } else {
    openCameraUserList = openCameraUserList.filter((item) => item !== userId);
    }
    }
    
    function onUserAudioAvailable(userId, available) {
    if (available === 1) {
    openMicUserList.push(userId);
    } else {
    openMicUserList = openMicUserList.filter((item) => item !== userId);
    }
    }
    
    function onRemoteUserEnterRoom(userId) {
    roomUserList.push(userId);
    }
    
    function onRemoteUserLeaveRoom(userId, reason) {
    roomUserList = roomUserList.filter((item) => item !== userId);
    }
    
    const rtcCloud = new TRTCCloud();
    rtcCloud.on('onUserVideoAvailable', onUserVideoAvailable);
    rtcCloud.on('onUserAudioAvailable', onUserAudioAvailable);
    rtcCloud.on('onRemoteUserEnterRoom', onRemoteUserEnterRoom);
    rtcCloud.on('onRemoteUserLeaveRoom', onRemoteUserLeaveRoom);

    고급 가이드

    다른 ‘음소거’ 방법의 차이점은 무엇입니까?

    완전히 다른 방식으로 작동하는 세 가지 ‘음소거’ 방법이 있습니다.
    방법1: 플레이어단 오디오 스트림 구독 중지 원격 사용자 denny의 오디오 재생을 중지하려면 muteRemoteAudio("denny", true) 함수를 호출하면 SDK가 denny에서 오디오 데이터 스트림 가져오기를 중지합니다. 이 모드에서는 더 적은 트래픽이 사용됩니다. 그러나 SDK는 오디오 재생을 재개하기 위해 오디오 데이터 풀 프로세스를 다시 시작해야 하므로 ‘음소거’ 상태에서 ‘음소거 해제 상태’로 전환하는 속도가 느립니다.
    방법2: 재생 볼륨 레벨을 0으로 조정 음소거 상태를 더 빠르게 전환하려면 setRemoteAudioVolume("denny", 0)을 사용하여 원격 사용자 denny의 재생 볼륨 수준을 0으로 설정할 수 있습니다. 이 API는 네트워크 작업을 포함하지 않기 때문에 매우 빠르게 적용됩니다.
    방법3: 원격 사용자 마이크 끄기 본 문서에 설명된 모든 작업은 플레이어에서 수행되며 현재 사용자에게만 적용됩니다. 예를 들어 muteRemoteAudio("denny", true)를 호출하여 원격 사용자 denny를 음소거하면 방의 다른 사용자는 여전히 denny를 들을 수 있습니다. denny의 소리를 완전히 ‘없애’려면 denny의 오디오 게시 동작에 영향을 주어야 합니다. 자세한 내용은 오디오/비디오 스트림 게시를 참고하십시오.
    문의하기

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

    기술 지원

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

    연중무휴 24시간 전화 지원