TUIRoom(Android)
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 | 설명 |
관련 설정 인터페이스
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
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 설정을 권장합니다. |
설명:
stopScreenCapture
화면 수집을 중지합니다.
void stopScreenCapture();
뷰티 필터 관련 API
getBeautyManager
TXBeautyManager getBeautyManager();
뷰티 필터 관리를 통해 다음 기능을 사용할 수 있습니다.
'뷰티 필터 스타일', '미백', '안색 보정', '눈 크게', '갸름하게', 'V라인', '턱 조정', '얼굴 짧게', '코 작게', '반짝이는 눈', '치아 미백', '아래 눈꺼풀 조정', '주름 제거', '팔자 주름 제거' 등 뷰티 효과를 설정할 수 있습니다.
'헤어 라인', '눈 간격', '눈 각도', '입 모양', '콧볼', '코 위치', '입술 두께', '얼굴형'을 조정할 수 있습니다.
얼굴 효과(소재) 등 동적 효과를 설정할 수 있습니다.
메이크업 효과를 추가합니다.
손 동작을 인식합니다.
관련 설정 인터페이스
setVideoQosPreference
네트워크 트래픽 제어와 관련된 매개변수를 설정합니다.
void setVideoQosPreference(TRTCCloudDef.TRTCNetworkQosParam preference);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
preference | TRTCCloudDef.TRTCNetworkQosParam | 네트워크 트래픽 제어 정책. |
setAudioQuality
오디오 품질을 설정합니다.
void setAudioQuality(int quality);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
quality | int |
setVideoResolution
해상도를 설정합니다.
void setVideoResolution(int resolution);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
resolution | int |
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 |
설명:
해당 방법으로 호출하면 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&lt;TRTCCloudDef.TRTCQuality&gt; | 다운스트림 네트워크 품질. |
설명
화면 공유 이벤트 콜백
onScreenCaptureStarted
화면 공유 시작 콜백입니다.
void onScreenCaptureStarted();
onScreenCaptureStopped
화면 공유 중지 콜백입니다.
void onScreenCaptureStopped(int reason);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
reason | int | 중지 사유. 0: 사용자가 중지, 1: 다른 애플리케이션으로 인한 강제 중지. |
- TUIRoom API 개요
- TUIRoomCoreListener API 개요
- TUIRoomCore 기본 함수
- 로컬 푸시 스트림 인터페이스
- 원격 사용자 관련 인터페이스
- 메시지 인터페이스 보내기
- 필드 제어 관련 인터페이스
- muteUserMicrophone
- muteAllUsersMicrophone
- muteUserCamera
- muteAllUsersCamera
- muteChatRoom
- kickOffUser
- startCallingRoll
- stopCallingRoll
- replyCallingRoll
- sendSpeechInvitation
- cancelSpeechInvitation
- replySpeechInvitation
- sendSpeechApplication
- cancelSpeechApplication
- replySpeechApplication
- forbidSpeechApplication
- sendOffSpeaker
- sendOffAllSpeakers
- exitSpeechState
- 화면 공유 인터페이스
- 뷰티 필터 관련 API
- 관련 설정 인터페이스
- SDK 버전 인터페이스 가져오기
- 오류 이벤트 콜백
- 기본 이벤트 콜백
- 원격 사용자 콜백 이벤트
- 채팅방 메시지 이벤트 콜백
- 필드 제어 메시지 콜백
- 통계 및 품질 콜백
- 화면 공유 이벤트 콜백