tencent cloud

Tencent Real-Time Communication

문서Tencent Real-Time Communication

TUIRoom(Android)

Download
포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-25 10:40:08
TUIRoom은 Tencent Real-Time Communication(TRTC)과 Instant Messaging(IM)을 기반으로 하며, 다음 기능을 지원합니다.
호스트가 방을 생성하고 방에 입장하는 사람이 방 번호를 입력한 후 참여.
방에 입장하는 사람들 간의 화면 공유.
다양한 텍스트 메시지 및 사용자 정의 메시지 발송 지원.
설명：
TUIKit 시리즈 컴포넌트는 Tencent Cloud의 두 가지 기본 PaaS 서비스, 즉 Tencent Real-Time Communication 및 Instant Messaging을 사용합니다. TRTC를 활성화하면 IM과 IM SDK 평가판(100 DAU만 지원)이 자동으로 활성화됩니다. IM 과금 규정은 요금 안내를 참고하십시오.
TUIRoom은 오픈 소스 Class로, Tencent Cloud의 두 가지 클로즈드 소스 SDK에 종속됩니다. 자세한 구현 방법은 TUIRoom (Android) 통합을 참고하십시오.
TRTC SDK: TRTC SDK를 사용하는 저지연 멀티미디어 방 컴포넌트입니다.
IM SDK: IM SDK를 사용하여 채팅방 기능을 구현합니다(IM SDK는 Android 버전 사용).

TUIRoom API 개요

TUIRoomCore 기본 함수

API
설명
싱글톤 객체 가져오기.
싱글톤 객체 폐기.
이벤트 콜백 설정.

방 관련 API

API
설명
방 생성(호스트 호출).
방 폐기(호스트 호출).
방 입장(참석자 호출).
방 퇴장(참석자 호출).
방 정보 가져오기.
방에 있는 모든 참석자 정보 가져오기.
특정 사용자 정보 가져오기.
호스트 권한 이전(호스트 호출).

로컬 멀티미디어 작업 인터페이스

API
설명
로컬 비디오 화면 미리보기 시작.
로컬 비디오 수집 및 미리보기 중지.
마이크 수집 활성화.
마이크 수집 정지.
로컬 화면 이미지 미리보기 모드 설정.
스피커 활성화 설정.

원격 사용자 관련 인터페이스

API
설명
지정된 참석자의 원격 비디오 화면 구독 및 재생.
구독 취소 및 원격 비디오 화면 재생 중지.

채팅 메시지 발송 인터페이스

API
설명
채팅 메시지 발송.
사용자 정의 메시지 발송.

필드 제어 관련 인터페이스

API
설명
사용자의 마이크 비활성화/복원.
모든 사용자의 마이크 비활성화/복원, 상태를 회의실 정보에 동기화.
사용자 카메라 비활성화/복원.
모든 사용자의 카메라 비활성화/복원, 상태를 방 정보에 동기화.
채팅방 음소거 활성화/비활성화(호스트 호출).
방에서 특정인 강제 퇴장(호스트 호출).
호스트 통화 시작.
호스트 지명 종료.
참석자가 호스트의 지명에 응답.
호스트의 참석자 발언 요청.
호스트의 참석자 발언 요청 취소.
참석자가 호스트의 발언 요청 수락/거절.
참석자 발언 신청.
호스트가 참석자 발언 신청 수락/거절.
호스트의 발언 신청 금지.
호스트의 참석자 발언 금지.
호스트의 전원 발언 금지.
참석자 발언 중지, 시청자로 전환.

화면 공유 인터페이스

API
설명
화면 공유 시작.
화면 수집 중지.

뷰티 필터 관련 API

API
설명
뷰티 필터 관리 객체 TXBeautyManager. 가져오기

관련 설정 인터페이스

API
설명
네트워크 트래픽 제어 관련 매개변수 설정.

SDK 버전 인터페이스 함수 가져오기

API
설명
SDK 버전 가져오기.

TUIRoomCoreListener API 개요

오류 이벤트 콜백

API
설명
오류 콜백.

기본 이벤트 콜백

API
설명
방 해산 콜백.
볼륨 크기 콜백 콜백.
호스트 변경 콜백.

원격 사용자 이벤트 콜백

API
설명
원격 사용자 방 입장 콜백.
원격 사용자 방 퇴장 콜백.
원격 사용자 카메라 활성화 여부 콜백.
원격 사용자 화면 공유 활성화 여부 콜백.
원격 사용자의 오디오 업스트림 활성화 여부 콜백.
원격 사용자 발언 시작 콜백.
원격 사용자가 발언 종료 콜백.

메시지 이벤트 콜백

API
설명
텍스트 메시지 수신 콜백.
사용자 정의 메시지 수신 콜백.

필드 제어 이벤트 콜백

API
설명
사용자의 호스트의 발언 요청 수신 콜백.
사용자가 호스트의 발언 요청 취소 수신 콜백.
호스트가 사용자의 발언 요청 수신 콜백.
사용자의 발언 신청 취소 콜백.
사회자 발언 신청 금지 콜백.
참석자가 발언 중단 요청 수신 콜백.
호스트 지명 시작 시 참석자가 수신하는 콜백.
호스트 지명 종료 시 참석자가 수신하는 콜백.
참석자의 지명 응답 시 호스트가 수신하는 콜백.
호스트의 채팅방 음소거 상태 변경 콜백.
호스트의 마이크 비활성화 설정 콜백.
호스트의 카메라 비활성화 설정 콜백.
참석자가 수신하는 호스트의 내보내기 콜백.

네트워크 품질 및 기술 메트릭에 대한 통계를 위한 콜백 API

API
설명
기술 지표 통계 콜백.
네트워크 품질 콜백.

화면 공유 관련 콜백

API
설명
화면 공유 콜백 시작.
화면 공유 콜백 중지.

TUIRoomCore 기본 함수

getInstance

TUIRoomCore 싱글톤 객체 가져오기.
public static TUIRoomCore getInstance(Context context);
매개변수는 다음과 같습니다.
매개변수
유형
의미
context
Context
Android 컨텍스트로, 내부가 ApplicationContext로 전환되어 시스템 API 호출에 사용됩니다.

destroyInstance

void destroyInstance();

setListener

TUIRoomCore 이벤트 콜백. TUIRoomCoreListener을 통해 TUIRoomCore 에서 다양한 상태 알림을 받을 수 있습니다.
void setListener(TUIRoomCoreListener listener);
매개변수는 다음과 같습니다.
매개변수
유형
의미
listener
TUIRoomCoreListener
이벤트 콜백 클래스 수신.

createRoom

방을 생성합니다(호스트 호출).
void createRoom(String roomId, TUIRoomCoreDef.SpeechMode speechMode, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
roomId
String
방 Id. 귀하가 직접 할당하고 통합 관리합니다.
speechMode
TUIRoomCoreDef.SpeechMode
발언 모드.
callback
TUIRoomCoreCallback.ActionCallback
방 생성 결과 콜백.
호스트 정상 호출 프로세스는 다음과 같습니다.
1. 호스트는 createRoom()을 호출하여 방을 생성하고, 방 생성 성공 여부는 TUIRoomCoreCallback.ActionCallback을 통해 호스트에게 알림됩니다.
2. 호스트는 'startCameraPreview()'를 호출하여 카메라 캡처 및 미리보기를 시작합니다.
3. 호스트는 'startLocalAudio()'를 호출하여 로컬 마이크를 켭니다.

destroyRoom

방 폐기(호스트 호출). 호스트는 방 생성 후 해당 함수를 호출해 방을 폐기할 수 있습니다.
void destroyRoom(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
UIRoomCoreCallback.ActionCallback
방 폐기 결과 콜백.

enterRoom

방에 입장합니다(참석자 호출).
void enterRoom(String roomId, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
roomId
String
방 Id.
callback
UIRoomCoreCallback.ActionCallback
결과 콜백.
참석자의 방 입장 정상 호출 프로세스는 다음과 같습니다.
1. 참석자는 'enterRoom'을 호출하고 roomId를 입력하여 방에 입장합니다.
2. 참석자는 startCameraPreview()를 호출하여 카메라 미리보기를 열고 startLocalAudio()를 호출하여 마이크 수집을 시작합니다.
3. 참석자는 onRemoteUserCameraAvailable 이벤트를 수신하고 startRemoteView()를 호출하여 비디오 재생을 시작합니다.

leaveRoom

방에서 퇴장합니다(참석자 호출).
 void leaveRoom(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
UIRoomCoreCallback.ActionCallback
결과 콜백.

getRoomInfo

방 정보 가져오기.
TUIRoomCoreDef.RoomInfo getRoomInfo();

getRoomUsers

방의 모든 구성원에 대한 정보를 가져옵니다.
 List<TUIRoomCoreDef.UserInfo> getRoomUsers();

getUserInfo

참석자 정보를 가져옵니다.
void getUserInfo(String userId, TUIRoomCoreCallback.UserInfoCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 Id.
callback
UIRoomCoreCallback.UserInfoCallback
방 참석자 세부 정보 콜백.

setSelfProfile

사용자 정보를 설정합니다.
void setSelfProfile(String userName, String avatarURL, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userName
String
사용자 이름.
avatarURL
String
사용자 프로필 URL.
callback
TUIRoomCoreCallback.ActionCallback
성공적인 결과 콜백의 설정 여부.

transferRoomMaster

그룹을 다른 사용자에게 이전합니다.
 void transferRoomMaster(String userId, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 Id.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

로컬 푸시 스트림 인터페이스

startCameraPreview

로컬 카메라 미리보기를 시작합니다.
void startCameraPreview(boolean isFront, TXCloudVideoView view);
매개변수는 다음과 같습니다.
매개변수
유형
의미
isFront
boolean
true: 전면 카메라, false: 후면 카메라.
view
TXCloudVideoView
비디오 모니터를 탑재한 컨트롤러.

stopCameraPreview

로컬 카메라 미리보기를 중지합니다.
 void stopCameraPreview();

startLocalAudio

마이크 수집을 시작합니다.
 void startLocalAudio(int quality);
매개변수는 다음과 같습니다.
매개변수
유형
의미
quality
int
수집된 사운드의 음질: <li/>TRTC_AUDIO_QUALITY_MUSIC<li/>TRTC_AUDIO_QUALITY_DEFAULT<li/>TRTC_AUDIO_QUALITY_SPEECH

stopLocalAudio

마이크 수집 중지
void stopLocalAudio();

setVideoMirror

로컬 화면 미리보기 모드를 설정합니다.
 void setVideoMirror(int type);
매개변수는 다음과 같습니다.
매개변수
유형
의미
type
int
이미지 유형.

setSpeaker

스피커를 활성화합니다.
 void setSpeaker(boolean isUseSpeaker);
매개변수는 다음과 같습니다.
매개변수
유형
의미
isUseSpeaker
boolean
true: 스피커, false: 핸드셋.

원격 사용자 관련 인터페이스

startRemoteView

원격 사용자의 비디오 스트림을 구독합니다.
void startRemoteView(String userId, TXCloudVideoView view, TUIRoomCoreDef.SteamType streamType, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
재생할 사용자 ID.
view
TXCloudVideoView
영상 화면 view 컨트롤러.
streamType
TUIRoomCoreDef.SteamType
스트림 유형.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

stopRemoteView

구독을 취소하고 원격 영상 화면 재생을 중지합니다.
void stopRemoteView(String userId, TUIRoomCoreCallback.ActionCallback callback);

매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
재생을 중지할 사용자 ID.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

switchCamera

전면/후면 카메라를 전환합니다.
void switchCamera(boolean isFront);

매개변수는 다음과 같습니다.
매개변수
유형
의미
isFront
boolean
true: 전면 카메라, false: 후면 카메라.

메시지 인터페이스 보내기

sendChatMessage

방 안에서 텍스트 메시지 발송, 일반적으로 텍스트 채팅에 사용됩니다.
void sendChatMessage(String message, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
message
String
메시지 내용.
callback
TUIRoomCoreCallback.ActionCallback
발송 결과 콜백.

sendCustomMessage

사용자 정의 메시지 발송.
void sendCustomMessage(String data, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
data
String
메시지 콘텐츠.
callback
TUIRoomCoreCallback.ActionCallback
발송 결과 콜백.

필드 제어 관련 인터페이스

muteUserMicrophone

사용자의 마이크를 비활성화/복원합니다.
void muteUserMicrophone(String userId, boolean mute, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
mute
boolean
비활성화 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

muteAllUsersMicrophone

모든 사용자의 마이크를 비활성화/복원합니다.
void muteAllUsersMicrophone(boolean mute, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
mute
boolean
비활성화 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

muteUserCamera

사용자의 카메라를 비활성화/복원합니다.
void muteUserCamera(String userId, boolean mute, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
mute
boolean
비활성화 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

muteAllUsersCamera

모든 사용자의 카메라를 비활성화/복원합니다.
void muteAllUsersCamera(boolean mute, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
mute
boolean
비활성화 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

muteChatRoom

텍스트 채팅을 비활성화/복원합니다.
void muteChatRoom(boolean mute, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
mute
boolean
비활성화 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

kickOffUser

호스트의 내보내기.
void kickOffUser(String userId, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

startCallingRoll

호스트가 지명을 시작합니다.
 void startCallingRoll(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

stopCallingRoll

호스트가 지명을 종료합니다.
 void stopCallingRoll(TUIRoomCoreCallback.ActionCallback callback);

매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

replyCallingRoll

참석자가 호스트의 지명에 응답합니다.
void replyCallingRoll(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

sendSpeechInvitation

호스트가 참석자에게 발언을 요청합니다.
void sendSpeechInvitation(String userId, TUIRoomCoreCallback.InvitationCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
callback
TUIRoomCoreCallback.InvitationCallback
결과 콜백.

cancelSpeechInvitation

호스트가 참석자에 대한 발언 요청을 취소합니다.
 void cancelSpeechInvitation(String userId, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

replySpeechInvitation

참석자가 호스트의 발언 요청을 수락/거절합니다.
void replySpeechInvitation(boolean agree, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
agree
boolean
수락 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

sendSpeechApplication

참석자가 발언을 신청합니다.
void sendSpeechApplication(TUIRoomCoreCallback.InvitationCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.InvitationCallback
결과 콜백.

cancelSpeechApplication

참석자가 발언 신청을 취소합니다.
void cancelSpeechApplication(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

replySpeechApplication

호스트가 참석자의 발언 신청을 수락/거절합니다.
void replySpeechApplication(boolean agree, String userId, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
agree
boolean
수락 여부.
userId
String
사용자 ID.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

forbidSpeechApplication

호스트가 발언 신청을 금지합니다.
 void forbidSpeechApplication(boolean forbid, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
forbid
boolean
금지 여부.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

sendOffSpeaker

호스트가 참석자의 발언을 금지합니다.
void sendOffSpeaker(String userId, TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

sendOffAllSpeakers

호스트가 모든 참석자의 발언을 금지합니다.
void sendOffAllSpeakers(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

exitSpeechState

참석자는 발언을 중지하고 시청자로 전환합니다.
void exitSpeechState(TUIRoomCoreCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수
유형
의미
callback
TUIRoomCoreCallback.ActionCallback
결과 콜백.

화면 공유 인터페이스

startScreenCapture

화면 공유를 시작합니다.
void startScreenCapture(TRTCCloudDef.TRTCVideoEncParam encParams, TRTCCloudDef.TRTCScreenShareParams screenShareParams);
매개변수는 다음과 같습니다.
매개변수
유형
의미
encParams
TRTCCloudDef.TRTCVideoEncParam
화면 공유 설정 시 인코딩 매개변수입니다. 위의 권장 설정을 참고하십시오. encParams가 null인 경우, startScreenCapture 호출 전 인코딩 매개변수 설정이 적용됩니다.
screenShareParams
TRTCCloudDef.TRTCScreenShareParams
화면 공유 특수 설정을 설정합니다. 시스템으로 인한 App 강제 종료를 방지하고 사용자 프라이버시 보호를 위해 floatingView 설정을 권장합니다.
설명：
자세한 내용은 TRTC SDK를 참고하십시오.

stopScreenCapture

화면 수집을 중지합니다.
void stopScreenCapture();

뷰티 필터 관련 API

getBeautyManager

뷰티 필터 관리 객체 TXBeautyManager를 가져옵니다.
TXBeautyManager getBeautyManager();
뷰티 필터 관리를 통해 다음 기능을 사용할 수 있습니다.
'뷰티 필터 스타일', '미백', '안색 보정', '눈 크게', '갸름하게', 'V라인', '턱 조정', '얼굴 짧게', '코 작게', '반짝이는 눈', '치아 미백', '아래 눈꺼풀 조정', '주름 제거', '팔자 주름 제거' 등 뷰티 효과를 설정할 수 있습니다.
'헤어 라인', '눈 간격', '눈 각도', '입 모양', '콧볼', '코 위치', '입술 두께', '얼굴형'을 조정할 수 있습니다.
얼굴 효과(소재) 등 동적 효과를 설정할 수 있습니다.
메이크업 효과를 추가합니다.
손 동작을 인식합니다.

관련 설정 인터페이스

setVideoQosPreference

네트워크 트래픽 제어와 관련된 매개변수를 설정합니다.
 void setVideoQosPreference(TRTCCloudDef.TRTCNetworkQosParam preference);
매개변수는 다음과 같습니다.
매개변수
유형
의미
preference
TRTCCloudDef.TRTCNetworkQosParam
네트워크 트래픽 제어 정책.

setAudioQuality

오디오 품질을 설정합니다.
void setAudioQuality(int quality);
매개변수는 다음과 같습니다.
매개변수
유형
의미
quality
int
오디오의 품질입니다. 자세한 내용은 TRTC SDK를 참고하십시오.

setVideoResolution

해상도를 설정합니다.
void setVideoResolution(int resolution);
매개변수는 다음과 같습니다.
매개변수
유형
의미
resolution
int
비디오 해상도. 자세한 내용은 TRTC SDK를 참고하십시오.

setVideoFps

프레임 레이트를 설정합니다.
void setVideoFps(int fps);
매개변수는 다음과 같습니다.
매개변수
유형
의미
fps
int
비디오에서 수집하는 프레임 레이트.
설명：
권장 설정값: 15fps 또는 20fps를 권장합니다. 5fps는 랙이 심하게 발생하며, 10fps 이하는 약간의 랙이 발생하고, 20fps 이상은 너무 높습니다(영화 프레임 레이트 24fps).

setVideoBitrate

비트 레이트를 설정합니다.
void setVideoBitrate(int bitrate);
매개변수는 다음과 같습니다.
매개변수
유형
의미
bitrate
int
비트 레이트, SDK는 타깃 비트 레이트에 따라 인코딩하며, 네트워크가 불안정한 상태에서만 자체적으로 비디오 비트 레이트를 줄입니다. 자세한 내용은 TRTC SDK를 참고하십시오.
설명：
권장 설정값: TRTCVideoResolution의 각 단계별 권장 최적 비트 레이트를 참고하고, 이를 기반으로 적합하게 높일 수 있습니다. 예를 들어 TRTC_VIDEO_RESOLUTION_1280_720의 권장 비트 레이트는 1200kbps이지만, 1500kbps로 설정하여 더 선명한 화면을 볼 수도 있습니다.

enableAudioEvaluation

볼륨 알림을 활성화합니다.
void enableAudioEvaluation(boolean enable);
매개변수는 다음과 같습니다.
매개변수
유형
의미
enable
boolean
true: 활성화, false: 비활성화.
설명：
활성화하면 음량 크기값에 대한 SDK의 평가를 onUserVolumeUpdate에서 가져옵니다.

setAudioPlayVolume

재생 볼륨을 설정합니다.
void setAudioPlayVolume(int volume);
매개변수는 다음과 같습니다.
매개변수
유형
의미
volume
int
재생 음량으로, 0-100으로 설정할 수 있으며 기본 값은 100입니다.

setAudioCaptureVolume

마이크 수집 볼륨을 설정합니다.
void setAudioCaptureVolume(int volume);
매개변수는 다음과 같습니다.
매개변수
유형
의미
volume
int
수집 음량으로, 0-100으로 설정할 수 있으며 기본 값은 100입니다.

startFileDumping

녹음을 시작합니다.
void startFileDumping(TRTCCloudDef.TRTCAudioRecordingParams trtcAudioRecordingParams);
매개변수는 다음과 같습니다.
매개변수
유형
의미
trtcAudioRecordingParams
TRTCCloudDef.TRTCAudioRecordingParams
녹음 매개변수. 자세한 내용은 TRTC SDK를 참고하십시오.
설명：
해당 방법으로 호출하면 SDK에서 통화 중 모든 오디오(로컬 오디오, 원격 오디오, BGM 등 포함)를 하나의 파일로 녹음합니다. 방 입장 여부에 상관 없이 해당 인터페이스를 호출하면 모두 적용되며, leaveRoom 호출 시 녹음 중인 경우 녹음은 자동으로 중지됩니다.

stopFileDumping

녹음을 중지합니다.
void stopFileDumping();

SDK 버전 인터페이스 가져오기

getSdkVersion

SDK 버전 정보를 가져옵니다.
int getSdkVersion();

오류 이벤트 콜백

onError

void onError(int code, String message);
매개변수는 다음과 같습니다.
매개변수
유형
의미
code
int
오류 코드.
message
String
오류 정보.

기본 이벤트 콜백

onDestroyRoom

방 해산 콜백입니다.
void onDestroyRoom();

onUserVoiceVolume

사용자 볼륨 크기 콜백입니다.
void onUserVoiceVolume(String userId, int volume);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
volume
int
사용자의 볼륨 크기, 범위: 0 - 100.

onRoomMasterChanged

호스트 변경 콜백입니다.
void onRoomMasterChanged(String previousUserId, String currentUserId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
previousUserId
String
변경 전의 호스트 사용자 ID.
currentUserId
String
변경 후의 호스트 사용자 ID.

원격 사용자 콜백 이벤트

onRemoteUserEnter

원격 사용자 방 입장 콜백입니다.
void onRemoteUserEnter(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

onRemoteUserLeave

원격 사용자 방 퇴장 콜백입니다.
void onRemoteUserLeave(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

onRemoteUserCameraAvailable

원격 사용자 카메라 활성화 여부입니다.
void onRemoteUserCameraAvailable(String userId, boolean available);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
available
boolean
true: 동영상 스트리밍 데이터 있음, false: 동영상 스트리밍 데이터 없음.

onRemoteUserScreenVideoAvailable

참석자의 비디오 공유 알림을 활성화/비활성화합니다.
void onRemoteUserScreenVideoAvailable(String userId, boolean available);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
available
boolean
화면 공유 스트림 데이터가 있는지 여부.

onRemoteUserAudioAvailable

원격 사용자 오디오 업스트림 활성화 여부 콜백입니다.
void onRemoteUserAudioAvailable(String userId, boolean available);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
available
boolean
오디오 데이터가 있는지 여부.

onRemoteUserEnterSpeechState

원격 사용자가 발언을 시작합니다.
void onRemoteUserEnterSpeechState(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

onRemoteUserExitSpeechState

원격 사용자가 발언을 종료합니다.
void onRemoteUserExitSpeechState(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

채팅방 메시지 이벤트 콜백

onReceiveChatMessage

텍스트 메시지를 수신합니다.
void onReceiveChatMessage(String userId, String message);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
message
String
텍스트 메시지.

onReceiveRoomCustomMsg

사용자 정의 메시지를 수신합니다.
void onReceiveRoomCustomMsg(String userId, String data);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.
message
String
사용자 정의 메시지.

필드 제어 메시지 콜백

onReceiveSpeechInvitation

사용자가 호스트로부터 발언 요청을 받았을 때의 콜백입니다.
void onReceiveSpeechInvitation(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
호스트 사용자 ID.

onReceiveInvitationCancelled

사용자가 호스트로부터 발언 요청 취소 수신 콜백입니다.
void onReceiveInvitationCancelled(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
호스트 사용자 ID.

onReceiveSpeechApplication

호스트의 사용자 발언 요청 수신 콜백입니다.
void onReceiveSpeechApplication(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

onSpeechApplicationCancelled

사용자가 발언 신청을 취소하는 콜백입니다.
void onSpeechApplicationCancelled(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

onSpeechApplicationForbidden

호스트가 발언 신청을 금지하는 콜백입니다.
void onSpeechApplicationForbidden(boolean isForbidden);
매개변수는 다음과 같습니다.
매개변수
유형
의미
isForbidden
boolean
금지 여부.

onOrderedToExitSpeechState

참석자의 발언 중지 요청 수신 콜백입니다.
void onOrderedToExitSpeechState(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
호스트 사용자 ID.

onCallingRollStarted

호스트가 지명을 시작하면 참석자가 수신하는 콜백입니다.
void onCallingRollStarted(String userId);

onCallingRollStopped

호스트가 지명을 종료하면 참석자가 수신하는 콜백입니다.
void onCallingRollStopped(String userId);

onMemberReplyCallingRoll

참석자가 지명에 응답하면 호스트가 수신하는 콜백입니다.
void onMemberReplyCallingRoll(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
사용자 ID.

onChatRoomMuted

호스트의 채팅방 음소거 여부 변경에 대한 콜백입니다.
void onChatRoomMuted(boolean muted);
매개변수는 다음과 같습니다.
매개변수
유형
의미
muted
boolean
음소거 여부.

onMicrophoneMuted

호스트의 마이크 음소거 설정에 대한 콜백입니다.
void onMicrophoneMuted(boolean muted);
매개변수는 다음과 같습니다.
매개변수
유형
의미
muted
boolean
음소거 여부.

onCameraMuted

호스트의 카메라 음소거 설정에 대한 콜백입니다.
void onCameraMuted(boolean muted);
매개변수는 다음과 같습니다.
매개변수
유형
의미
muted
boolean
음소거 여부.

onReceiveKickedOff

호스트의 내보내기 콜백.
void onReceiveKickedOff(String userId);
매개변수는 다음과 같습니다.
매개변수
유형
의미
userId
String
호스트/관리자 사용자 ID.

통계 및 품질 콜백

onStatistics

기술 지표 통계 콜백입니다.
void onStatistics(TRTCStatistics statistics);
매개변수는 다음과 같습니다.
매개변수
유형
의미
statis
TRTCStatistics
통계 데이터.

onNetworkQuality

네트워크 상태 콜백입니다.
void onNetworkQuality(TRTCCloudDef.TRTCQuality localQuality, List<TRTCCloudDef.TRTCQuality> remoteQuality);

매개변수는 다음과 같습니다.
매개변수
유형
의미
localQuality
TRTCCloudDef.TRTCQuality
업스트림 네트워크 품질.
remoteQuality
List&amp;lt;TRTCCloudDef.TRTCQuality&amp;gt;
다운스트림 네트워크 품질.
설명
자세한 내용은 TRTC SDK를 참고하십시오.

화면 공유 이벤트 콜백

onScreenCaptureStarted

화면 공유 시작 콜백입니다.
 void onScreenCaptureStarted();

onScreenCaptureStopped

화면 공유 중지 콜백입니다.
void onScreenCaptureStopped(int reason);
매개변수는 다음과 같습니다.
매개변수
유형
의미
reason
int
중지 사유. 0: 사용자가 중지, 1: 다른 애플리케이션으로 인한 강제 중지.
다음 주제: Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가

도움말 및 지원

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

피드백