API | 설명 |
컴포넌트 싱글톤 가져오기. | |
컴포넌트 싱글톤 폐기. | |
이벤트 콜백 설정. | |
이벤트 콜백이 있는 스레드 설정. | |
로그인. | |
로그아웃. | |
개인 정보 수정. |
API | 설명 |
방 생성(방 주인 호출), 방이 없는 경우 시스템에서 자동으로 새로운 방 생성. | |
방 폐기(방 주인 호출). | |
방 입장(청취자 호출). | |
방 퇴장(청취자 호출). | |
방 리스트의 세부 정보 획득. | |
지정 userId의 사용자 정보 획득. null인 경우 방 안에 있는 모든 사용자 정보 획득. |
API | 설명 |
음악 재생 시작. | |
음악 재생 중지. | |
음악 재생 일시 중지. | |
음악 재생 재개. |
API | 설명 |
마이크 수집 시작. | |
마이크 수집 중지. | |
오디오 품질 설정. | |
로컬 음소거 활성화/비활성화. | |
스피커 활성화 설정. | |
마이크 수집 음량 설정. | |
재생 볼륨 설정. | |
인이어 모니터링 활성화/비활성화. |
API | 설명 |
특정 사용자 음소거/음소거 해제. | |
모든 사용자 음소거/음소거 해제. |
API | 설명 |
API | 설명 |
방 안에서 텍스트 메시지 발송, 일반적으로 댓글 자막 채팅에 사용. | |
사용자 정의 텍스트 메시지 발송. |
API | 설명 |
사용자에게 초대 발송. | |
초대 수락. | |
초대 거부. | |
초대 취소. |
API | 설명 |
오류 콜백. | |
경고 콜백. | |
Log 콜백. |
API | 설명 |
방 폐기 콜백. | |
Karaoke 방 정보 변경 콜백. | |
사용자 통화 볼륨 콜백. |
API | 설명 |
전체 마이크 위치 리스트 변경. | |
사용자 마이크 켜짐(직접 마이크 켬/방 주인 특정 사용자 마이크 켬). | |
사용자 마이크 꺼짐(직접 마이크 끔/방 주인이 특정 사용자 마이크 끔). | |
방 주인 마이크 음소거. | |
사용자 마이크 음소거 여부. | |
방 주인 마이크 차단. |
API | 설명 |
청취자 입장 알림 수신. | |
청취자 퇴장 알림 수신. |
API | 설명 |
텍스트 메시지 수신. | |
사용자 정의 메시지 수신. |
API | 설명 |
새로운 초대 요청 수신. | |
초대된 사용자가 초대 수락. | |
초대된 사용자가 초대 거절. | |
초대한 사용자가 초대 취소. |
API | 설명 |
음악 재생 진행률 콜백. | |
음악 재생 준비 콜백. | |
재생 완료 음악 콜백. |
public static synchronized TRTCKaraokeRoom sharedInstance(Context context);
매개변수 | 유형 | 의미 |
context | Context | Android 컨텍스트로, 내부가 ApplicationContext로 전환되어 시스템 API 호출에 사용됩니다. |
public static void destroySharedInstance();
public abstract void setDelegate(TRTCKaraokeRoomDelegate delegate);
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 | |
userId | String | 현재 사용자 ID입니다. 문자열 유형은 영어 알파벳(a-z, A-Z), 숫자(0-9), 대시 부호(-), 언더바(_)만 허용됩니다. |
userSig | String | |
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 | 방 세부 정보 콜백. |
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 | 작업 콜백. |
onSeatListChange
및 onSeatClose
이벤트 알림을 수신합니다.public abstract void closeSeat(int seatIndex, boolean isClose, TRTCKaraokeRoomCallback.ActionCallback callback);
매개변수 | 유형 | 의미 |
seatIndex | int | 작업을 진행할 마이크 위치 번호. |
isClose | boolean | true: 차단, false: 차단 해제. |
callback | ActionCallback | 작업 콜백. |
public abstract void startMicrophone();
public abstract void stopMicrophone();
public abstract void setAudioQuality(int quality);
매개변수 | 유형 | 의미 |
quality | int |
public abstract void muteLocalAudio(boolean mute);
매개변수 | 유형 | 의미 |
mute | boolean |
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: 인이어 모니터링 비활성화. |
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 | 발송 결과 콜백. |
void onError(int code, String message);
매개변수 | 유형 | 의미 |
code | int | 오류 코드. |
message | String | 오류 정보. |
void onWarning(int code, String message);
매개변수 | 유형 | 의미 |
code | int | 오류 코드. |
message | String | 경고 정보. |
void onDebugLog(String message);
매개변수 | 유형 | 의미 |
message | String | 로그 정보. |
void onRoomDestroy(String roomId);
매개변수 | 유형 | 의미 |
roomId | String | 방 ID. |
void onRoomInfoChange(TRTCKaraokeRoomDef.RoomInfo roomInfo);
매개변수 | 유형 | 의미 |
roomInfo | RoomInfo | 방 정보. |
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입니다. |
문제 해결에 도움이 되었나요?