TRTCKaraokeRoom은 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 과금 내역은 요금 안내를 참고하십시오.
TRTCKaraokeRoom은 오픈 소스 Class로, Tencent Cloud의 두 가지 클로즈드 소스 SDK에 종속됩니다. 자세한 구현 방법은 Karaoke(Android)를 참고하십시오.
API | 설명 |
---|---|
sharedInstance | 컴포넌트 싱글톤 가져오기. |
destroySharedInstance | 컴포넌트 싱글톤 폐기. |
setDelegate | 이벤트 콜백 설정. |
setDelegateHandler | 이벤트 콜백이 있는 스레드 설정. |
login | 로그인. |
logout | 로그아웃. |
setSelfProfile | 개인 정보 수정. |
API | 설명 |
---|---|
createRoom | 방 생성(방 주인 호출), 방이 없는 경우 시스템에서 자동으로 새로운 방 생성. |
destroyRoom | 방 폐기(방 주인 호출). |
enterRoom | 방 입장(청취자 호출). |
exitRoom | 방 퇴장(청취자 호출). |
getRoomInfoList | 방 리스트의 세부 정보 획득. |
getUserInfoList | 지정 userId의 사용자 정보 획득. null인 경우 방 안에 있는 모든 사용자 정보 획득. |
API | 설명 |
---|---|
startPlayMusic | 음악 재생 시작. |
stopPlayMusic | 음악 재생 중지. |
pausePlayMusic | 음악 재생 일시 중지. |
resumePlayMusic | 음악 재생 재개. |
API | 설명 |
---|---|
enterSeat | 마이크 연결(청취자와 방 주인 모두 호출 가능). |
leaveSeat | 마이크 연결 해제(호스트 호출). |
pickSeat | 마이크 넘기기(방 주인 호출). |
kickSeat | 마이크 강제 끄기(방 주인 호출). |
muteSeat | 특정 마이크 위치 음소거/음소거 해제(방 주인 호출). |
closeSeat | 특정 마이크 위치 차단/차단 해제(방 주인 호출). |
API | 설명 |
---|---|
startMicrophone | 마이크 수집 시작. |
stopMicrophone | 마이크 수집 중지. |
setAudioQuality | 오디오 품질 설정. |
muteLocalAudio | 로컬 음소거 활성화/비활성화. |
setSpeaker | 스피커 활성화 설정. |
setAudioCaptureVolume | 마이크 수집 음량 설정. |
setAudioPlayoutVolume | 재생 볼륨 설정. |
setVoiceEarMonitorEnable | 인이어 모니터링 활성화/비활성화. |
API | 설명 |
---|---|
muteRemoteAudio | 특정 사용자 음소거/음소거 해제. |
muteAllRemoteAudio | 모든 사용자 음소거/음소거 해제. |
API | 설명 |
---|---|
getAudioEffectManager | 배경 음악 음향 효과 관리 객체 TXAudioEffectManager 가져오기. |
API | 설명 |
---|---|
sendRoomTextMsg | 방 안에서 텍스트 메시지 발송, 일반적으로 댓글 자막 채팅에 사용. |
sendRoomCustomMsg | 사용자 정의 텍스트 메시지 발송. |
API | 설명 |
---|---|
sendInvitation | 사용자에게 초대 발송. |
acceptInvitation | 초대 수락. |
rejectInvitation | 초대 거부. |
cancelInvitation | 초대 취소. |
API | 설명 |
---|---|
onError | 오류 콜백. |
onWarning | 경고 콜백. |
onDebugLog | Log 콜백. |
API | 설명 |
---|---|
onRoomDestroy | 방 폐기 콜백. |
onRoomInfoChange | Karaoke 방 정보 변경 콜백. |
onUserVolumeUpdate | 사용자 통화 볼륨 콜백. |
API | 설명 |
---|---|
onSeatListChange | 전체 마이크 위치 리스트 변경. |
onAnchorEnterSeat | 사용자 마이크 켜짐(직접 마이크 켬/방 주인 특정 사용자 마이크 켬). |
onAnchorLeaveSeat | 사용자 마이크 꺼짐(직접 마이크 끔/방 주인이 특정 사용자 마이크 끔). |
onSeatMute | 방 주인 마이크 음소거. |
onUserMicrophoneMute | 사용자 마이크 음소거 여부. |
onSeatClose | 방 주인 마이크 차단. |
API | 설명 |
---|---|
onAudienceEnter | 청취자 입장 알림 수신. |
onAudienceExit | 청취자 퇴장 알림 수신. |
API | 설명 |
---|---|
onRecvRoomTextMsg | 텍스트 메시지 수신. |
onRecvRoomCustomMsg | 사용자 정의 메시지 수신. |
API | 설명 |
---|---|
onReceiveNewInvitation | 새로운 초대 요청 수신. |
onInviteeAccepted | 초대된 사용자가 초대 수락. |
onInviteeRejected | 초대된 사용자가 초대 거절. |
onInvitationCancelled | 초대한 사용자가 초대 취소. |
API | 설명 |
---|---|
onMusicProgressUpdate | 음악 재생 진행률 콜백. |
onMusicPrepareToPlay | 음악 재생 준비 콜백. |
onMusicCompletePlaying | 재생 완료 음악 콜백. |
TRTCKaraokeRoom 컴포넌트 싱글톤 객체 가져오기.
public static synchronized TRTCKaraokeRoom sharedInstance(Context context);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
context | Context | Android 컨텍스트로, 내부가 ApplicationContext로 전환되어 시스템 API 호출에 사용됩니다. |
TRTCKaraokeRoom 컴포넌트 싱글톤 폐기.
설명:인스턴스 폐기 후에는 외부에 캐시된 TRTCKaraokeRoom 인스턴스를 다시 사용할 수 없으며, 다시 sharedInstance를 호출해 새로운 인스턴스를 획득해야 합니다.
public static void destroySharedInstance();
TRTCKaraokeRoom 이벤트 콜백은 TRTCKaraokeRoomDelegate를 통해 TRTCKaraokeRoom의 다양한 상태 알림을 받아볼 수 있습니다.
public abstract void setDelegate(TRTCKaraokeRoomDelegate delegate);
설명:setDelegate는 TRTCKaraokeRoom의 콜백 프록시입니다.
이벤트 콜백이 존재하는 스레드를 설정합니다.
public abstract void setDelegateHandler(Handler handler);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
handler | Handler | TRTCKaraokeRoom상의 다양한 상태 알림 콜백은 해당 handler 스레드로 배포됩니다. |
로그인
public abstract void login(int sdkAppId,
String userId, String userSig,
TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
sdkAppId | int | TRTC 콘솔 >[애플리케이션 관리]> 애플리케이션 정보에서 SDKAppID를 확인할 수 있습니다. |
userId | String | 현재 사용자 ID입니다. 문자열 유형은 영어 알파벳(a-z, A-Z), 숫자(0-9), 대시 부호(-), 언더바(_)만 허용됩니다. |
userSig | String | Tencent Cloud가 설계한 일종의 보안 서명입니다. 획득 방식은 UserSig 계산 및 사용 방법을 참고하십시오. |
callback | ActionCallback | 로그인 콜백이며, 성공 시 code는 0입니다. |
로그아웃합니다.
public abstract void logout(TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
callback | ActionCallback | 로그아웃 콜백이며, 성공 시 code는 0입니다. |
개인 정보를 수정합니다.
public abstract void setSelfProfile(String userName, String avatarURL, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userName | String | 닉네임. |
avatarURL | String | 프로필 사진 주소. |
callback | ActionCallback | 개인 프로필 정보 설정 콜백이며, 성공 시 code는 0입니다. |
방 생성(방 주인 호출).
public abstract void createRoom(int roomId, TRTCKaraokeRoomDef.RoomParam roomParam, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
roomId | int | 방 식별 번호이며, 사용자가 할당하고 통합 관리합니다. 여러 개의 roomID를 1개의 Karaoke 방 리스트로 통합할 수 있습니다. Tencent Cloud는 현재 Karaoke 방 리스트 관리 서비스를 제공하지 않으므로 직접 관리하시기 바랍니다. |
roomParam | TRTCCreateRoomParam | 방 정보입니다. 방 이름, 마이크 위치 정보, 썸네일 정보 등과 같이 방을 설명하는 데 사용됩니다. 마이크 위치 관리가 필요한 경우 방의 마이크 위치 개수를 설정해야 합니다. |
callback | ActionCallback | 방 생성 결과 콜백이며, 성공 시 code는 0입니다. |
방 주인의 정상적인 방송 시작 호출 프로세스는 다음과 같습니다.
createRoom
을 호출하여 새로운 Karaoke 방을 생성합니다. 이 때, 방 ID, 마이크 연결 시 방 주인 확인 필요 여부, 마이크 위치 개수 등 방 속성 정보를 전송합니다.enterSeat
을 호출하여 자리에 입장합니다.onSeatListChange
마이크 위치 리스트 변경 이벤트 알림을 수신합니다. 이때 마이크 위치 리스트의 변경 내용을 UI 인터페이스에 새로고침할 수 있습니다.onAnchorEnterSeat
이벤트 알림 또한 수신하며, 이때 자동으로 마이크 수집이 활성화됩니다.방 폐기(방 주인 호출). 방 주인은 방 생성 후 해당 함수를 호출해 방을 폐기할 수 있습니다.
public abstract void destroyRoom(TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
callback | ActionCallback | 방 폐기 결과 콜백이며, 성공 시 code는 0입니다. |
방 입장(청취자 호출).
public abstract void enterRoom(int roomId, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
roomId | int | 방 식별 번호. |
callback | ActionCallback | 방 입장 결과 콜백이며, 성공 시 code는 0입니다. |
청취자가 방에 입장하여 청취하는 정상적인 호출 프로세스는 다음과 같습니다.
enterRoom
을 호출하여 방 번호를 전송하면 즉시 해당 방에 입장할 수 있습니다.onRoomInfoChange
방 속성 변경 이벤트 알림을 수신합니다. 이때 UI에 방 이름 표시, 마이크를 켤 때 방 주인에게 동의 요청 필요 여부 기록 등 방의 속성을 기록할 수 있으며 그에 해당하는 변경이 가능합니다.onSeatListChange
마이크 위치 리스트 변경 이벤트 알림을 수신합니다. 이때 마이크 위치 리스트의 변경 내용을 UI 인터페이스에 새로고침할 수 있습니다.onAnchorEnterSeat
이벤트 알림도 수신합니다.방 퇴장.
public abstract void exitRoom(TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
callback | ActionCallback | 방 퇴장 결과 콜백이며, 성공 시 code는 0입니다. |
방 리스트의 세부 정보를 획득합니다. 방 이름, 방 썸네일은 방 주인이 createRoom()
생성 시 roomInfo를 통해 설정할 수 있습니다.
설명:방 리스트 및 방 정보를 모두 직접 관리하는 경우 해당 함수는 생략할 수 있습니다.
public abstract void getRoomInfoList(List<Integer> roomIdList, TRTCKaraokeRoomCallback.RoomInfoCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
roomIdList | List<Integer> | 방 번호 리스트. |
callback | RoomInfoCallback | 방 세부 정보 콜백. |
지정 userId의 사용자 정보 획득.
public abstract void getUserInfoList(List<String> userIdList, TRTCKaraokeRoomCallback.UserListCallback userlistcallback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userIdList | List<String> | 획득해야 할 사용자 ID 리스트입니다. null인 경우 방 안에 있는 모든 사용자 정보를 획득합니다. |
userlistcallback | UserListCallback | 사용자 세부 정보 콜백. |
음악 재생(마이크를 켠 후 호출).
설명:
- 음악을 재생하면
onMusicPrepareToPlay
이벤트 알림을 받습니다.- 음악 재생 중에는 방안의 모든 참석자는 계속해서
onMusicProgressUpdate
이벤트 알림을 받습니다.- 음악 재생이 완료되면
onMusicCompletePlaying
이벤트 알림을 받습니다.
public abstract void startPlayMusic(int musicID, String originalUrl, String accompanyUrl);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
musicID | int | 음악 ID. |
originalUrl | String | 원곡 음악의 절대 경로. |
accompanyUrl | String | 반주 음악의 절대 경로. |
해당 인터페이스를 호출하면 현재 재생 중인 음악이 중지됩니다.
음악 재생 중지(음악 재생 시 호출).
설명:재생 중지 후,
onMusicCompletePlaying
이벤트 알림을 받습니다.
public abstract void stopPlayMusic();
재생 중인 음악 중지(음악 재생 시 호출).
설명:
onMusicProgressUpdate
이벤트 알림을 일시 중지합니다.onMusicCompletePlaying
이벤트 알림을 받지 않습니다.
public abstract void pausePlayMusic();
일시 중지한 음악 다시 재생(일시 중지 후 호출).
설명:
onMusicPrepareToPlay
이벤트 알림을 받지 않습니다.
public abstract void resumePlayMusic();
직접 마이크 켜기(청취자 및 방 주인 모두 호출 가능).
설명:마이크 연결 완료 후, 방 안에 있는 모든 사용자가
onSeatListChange
및onAnchorEnterSeat
이벤트 알림을 수신합니다.
public abstract void enterSeat(int seatIndex, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
seatIndex | int | 마이크를 연결할 마이크 위치 번호. |
callback | ActionCallback | 작업 콜백. |
해당 인터페이스를 호출하면 마이크 위치 리스트가 즉시 수정됩니다. 청취자의 마이크 연결에 방 주인의 동의가 필요한 시나리오의 경우, 먼저 sendInvitation
을 호출하여 방 주인에게 신청하고 onInvitationAccept
수신 후 다시 해당 함수를 호출합니다.
직접 마이크 끔(호스트 호출).
설명:마이크 연결 해제 완료 후, 방 안에 있는 모든 사용자가
onSeatListChange
및onAnchorLeaveSeat
이벤트 알림을 수신합니다.
public abstract void leaveSeat(TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
callback | ActionCallback | 작업 콜백. |
특정 사용자 마이크 켜기(방 주인 호출).
설명:방 주인이 마이크를 연결할 사용자를 지정하면 방 안에 있는 모든 사용자가
onSeatListChange
및onAnchorEnterSeat
이벤트 알림을 수신합니다.
public abstract void pickSeat(int seatIndex, String userId, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
seatIndex | int | 마이크를 연결할 마이크 위치 번호. |
userId | String | 사용자 ID. |
callback | ActionCallback | 작업 콜백. |
해당 인터페이스를 호출하면 마이크 위치 리스트가 즉시 수정됩니다. 방 주인이 청취자의 동의를 얻어야만 청취자가 마이크를 연결할 수 있는 시나리오의 경우, 먼저 sendInvitation
을 호출하여 청취자에게 신청하고 onInvitationAccept
수신 후 다시 해당 함수를 호출합니다.
특정 사용자 마이크 끄기(방 주인 호출).
설명:방 주인이 특정 사용자의 마이크를 끄면 방 안에 있는 모든 사용자가
onSeatListChange
및onAnchorLeaveSeat
이벤트 알림을 수신합니다.
public abstract void kickSeat(int seatIndex, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
seatIndex | int | 마이크 연결을 해제할 마이크 위치 번호. |
callback | ActionCallback | 작업 콜백. |
해당 인터페이스를 호출하면 마이크 위치 리스트가 즉시 수정됩니다.
특정 마이크 위치 음소거/음소거 해제(방 주인 호출).
설명:특정 마이크 위치를 음소거/음소거 해제하면 방 안에 있는 모든 사용자가
onSeatListChange
및onSeatMute
이벤트 알림을 수신합니다.
public abstract void muteSeat(int seatIndex, boolean isMute, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
seatIndex | int | 작업을 진행할 마이크 위치 번호. |
isMute | boolean | true: 음소거, false: 음소거 해제. |
callback | ActionCallback | 작업 콜백. |
해당 인터페이스를 호출하면 마이크 위치 리스트가 즉시 수정됩니다. 해당 seatIndex 자리에 있는 호스트는 자동으로 muteAudio가 호출되어 음소거/음소거 해제됩니다.
특정 마이크 위치 차단/차단 해제(방 주인 호출).
설명:방 주인이 해당 마이크 위치를 차단/차단 해제하면 방 안에 있는 모든 사용자가
onSeatListChange
및onSeatClose
이벤트 알림을 수신합니다.
public abstract void closeSeat(int seatIndex, boolean isClose, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
seatIndex | int | 작업을 진행할 마이크 위치 번호. |
isClose | boolean | true: 차단, false: 차단 해제. |
callback | ActionCallback | 작업 콜백. |
해당 인터페이스를 호출하면 마이크 위치 리스트가 즉시 수정됩니다. 해당 seatIndex 자리가 차단되고 자동으로 마이크 연결이 해제됩니다.
마이크 수집을 시작합니다.
public abstract void startMicrophone();
마이크 수집 중지
public abstract void stopMicrophone();
오디오 품질을 설정합니다.
public abstract void setAudioQuality(int quality);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
quality | int | 오디오의 품질입니다. 자세한 내용은 TRTC SDK를 참고하십시오. |
로컬 오디오를 음소거/음소거 취소합니다.
public abstract void muteLocalAudio(boolean mute);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
mute | boolean | 오디오를 음소거/음소거 취소합니다. 자세한 내용은 TRTC SDK를 참고하십시오. |
스피커를 활성화합니다.
public abstract void setSpeaker(boolean useSpeaker);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
useSpeaker | boolean | true: 스피커, false: 핸드셋. |
마이크 수집 볼륨을 설정합니다.
public abstract void setAudioCaptureVolume(int volume);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
volume | int | 수집 볼륨, 범위: 0 - 100, 기본값: 100. |
재생 볼륨을 설정합니다.
public abstract void setAudioPlayoutVolume(int volume);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
volume | int | 재생 볼륨, 범위: 0 - 100, 기본값: 100. |
지정 사용자 음소거/음소거 해제.
public abstract void muteRemoteAudio(String userId, boolean mute);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userId | String | 지정 사용자 ID. |
mute | boolean | true: 음소거 켜기, false: 음소거 끄기. |
모든 사용자 음소거/음소거 해제.
public abstract void muteAllRemoteAudio(boolean mute);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
mute | boolean | true: 음소거 켜기, false: 음소거 끄기. |
인이어 모니터링 활성화/비활성화.
public abstract void setVoiceEarMonitorEnable(boolean enable);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
enable | boolean | true: 인이어 모니터링 활성화; false: 인이어 모니터링 비활성화. |
배경 음악 음향 효과 관리 객체 TXAudioEffectManager 획득.
public abstract TXAudioEffectManager getAudioEffectManager();
방 안에서 텍스트 메시지 발송, 일반적으로 댓글 자막 채팅에 사용.
public abstract void sendRoomTextMsg(String message, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
message | String | 텍스트 메시지. |
callback | ActionCallback | 발송 결과 콜백. |
사용자 정의 텍스트 메시지를 발송합니다.
public abstract void sendRoomCustomMsg(String cmd, String message, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
cmd | String | 명령어, 개발자가 사용자 정의할 수 있으며 주로 서로 다른 메시지 유형을 구분하는 데 사용합니다. |
message | String | 텍스트 메시지. |
callback | ActionCallback | 발송 결과 콜백. |
사용자에게 초대 발송.
public abstract String sendInvitation(String cmd, String userId, String content, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
cmd | String | 서비스의 사용자 정의 명령. |
userId | String | 초대한 사용자 ID. |
content | String | 초대 내용. |
callback | ActionCallback | 발송 결과 콜백. |
반환값:
반환값 | 유형 | 의미 |
---|---|---|
inviteId | String | 해당 초대 ID를 식별하는 데 사용. |
초대 수락.
public abstract void acceptInvitation(String id, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
callback | ActionCallback | 발송 결과 콜백. |
초대 거부.
public abstract void rejectInvitation(String id, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
callback | ActionCallback | 발송 결과 콜백. |
초대 취소.
public abstract void cancelInvitation(String id, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
callback | ActionCallback | 발송 결과 콜백. |
오류 콜백.
설명:SDK가 복구할 수 없는 오류는 반드시 수신하고 상황에 따라 인터페이스를 통해 사용자에게 적절히 안내해야 합니다.
void onError(int code, String message);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
code | int | 오류 코드. |
message | String | 오류 정보. |
경고 콜백.
void onWarning(int code, String message);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
code | int | 오류 코드. |
message | String | 경고 정보. |
Log 콜백.
void onDebugLog(String message);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
message | String | 로그 정보. |
방 폐기 콜백. 방 주인이 방을 종료하면 방 안에 있는 모든 사용자는 해당 알림을 받게 됩니다.
void onRoomDestroy(String roomId);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
roomId | String | 방 ID. |
방 입장 후 해당 인터페이스를 콜백합니다. roomInfo의 정보는 방 주인이 방 생성 시 입력한 정보입니다.
void onRoomInfoChange(TRTCKaraokeRoomDef.RoomInfo roomInfo);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
roomInfo | RoomInfo | 방 정보. |
사용자 마이크의 음소거 여부 콜백으로 사용자가 muteLocalAudio 호출하면 방의 모든 사용자는 해당 알림을 받게 됩니다.
void onUserMicrophoneMute(String userId, boolean mute);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userId | String | 사용자 ID. |
mute | boolean | 볼륨 크기, 값: 0 - 100. |
음량 크기 알림을 활성화하여 모든 참석자의 음량 크기를 통지합니다.
void onUserVolumeUpdate(List<TRTCCloudDef.TRTCVolumeInfo> userVolumes, int totalVolume);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userVolumes | List | 사용자 리스트. |
totalVolume | int | 볼륨 크기, 값: 0 - 100. |
모든 마이크 위치 리스트를 포함한 전체 마이크 위치 리스트를 변경합니다.
void onSeatListChange(List<SeatInfo> seatInfoList);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
seatInfoList | List<SeatInfo> | 전체 마이크 위치 리스트. |
사용자 마이크 켜짐(직접 마이크 켬/방 주인이 특정 사용자 마이크 켬).
void onAnchorEnterSeat(int index, TRTCKaraokeRoomDef.UserInfo user);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
index | int | 마이크가 연결된 마이크 위치. |
user | UserInfo | 마이크가 연결된 사용자의 세부 정보. |
사용자 마이크 꺼짐(직접 마이크 끔/방 주인이 특정 사용자 마이크 끔).
void onAnchorLeaveSeat(int index, TRTCKaraokeRoomDef.UserInfo user);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
index | int | 연결을 해제할 마이크 위치. |
user | UserInfo | 마이크가 꺼진 사용자의 세부 정보. |
방 주인 마이크 비활성화.
void onSeatMute(int index, boolean isMute);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
index | int | 작업 진행할 마이크 위치. |
isMute | boolean | true: 음소거, false: 음소거 해제. |
방 주인 마이크 차단.
void onSeatClose(int index, boolean isClose);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
index | int | 작업 마이크 위치. |
isClose | boolean | true: 차단, false: 차단 해제. |
청취자 방 입장 알림 수신.
void onAudienceEnter(TRTCKaraokeRoomDef.UserInfo userInfo);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userInfo | UserInfo | 입장한 청취자 정보. |
청취자 방 퇴장 알림 수신.
void onAudienceExit(TRTCKaraokeRoomDef.UserInfo userInfo);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
userInfo | UserInfo | 퇴장한 청취자 정보. |
텍스트 메시지를 수신합니다.
void onRecvRoomTextMsg(String message, TRTCKaraokeRoomDef.UserInfo userInfo);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
message | String | 텍스트 메시지. |
userInfo | UserInfo | 발신자 정보. |
사용자 정의 메시지를 수신합니다.
void onRecvRoomCustomMsg(String cmd, String message, TRTCKaraokeRoomDef.UserInfo userInfo);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
command | String | 명령어, 개발자가 사용자 정의할 수 있으며 주로 서로 다른 메시지 유형을 구분하는 데 사용합니다. |
message | String | 텍스트 메시지. |
userInfo | UserInfo | 발신자 정보. |
새로운 초대 요청 수신.
void onReceiveNewInvitation(String id, String inviter, String cmd, String content);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
inviter | String | 초대한 사용자 ID. |
cmd | String | 서비스 지정 명령어. 개발자가 사용자 정의함. |
content | String | 서비스에서 지정한 내용. |
초대된 사용자가 초대 수락.
void onInviteeAccepted(String id, String invitee);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
invitee | String | 초대된 사용자 ID. |
초대된 사용자가 초대 거부.
void onInviteeRejected(String id, String invitee);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
invitee | String | 초대된 사용자 ID. |
초대한 사용자가 초대 취소.
void onInvitationCancelled(String id, String inviter);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
id | String | 초대 ID. |
inviter | String | 초대한 사용자 ID. |
음악 재생 준비 콜백.
void onMusicPrepareToPlay(int musicID);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
musicID | int | 재생 시 입력한 musicID. |
음악 재생 진행률 콜백.
void onMusicProgressUpdate(int musicID, long progress, long total);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
musicID | int | 재생 시 입력한 musicID입니다. |
progress | long | 현재 재생 시간, 단위: ms. |
total | long | 총 시간으로 단위는 ms입니다. |
음악 재생 완료 콜백.
void onMusicCompletePlaying(int musicID);
매개변수는 다음과 같습니다.
매개변수 | 유형 | 의미 |
---|---|---|
musicID | int | 재생 시 입력한 musicID입니다. |
문제 해결에 도움이 되었나요?