Docs Overview/
Call/
Web/
인터페이스 문서/
Engine APIs/
TUICallEvent/

TUICallEvent

TUICallEvent API

TUICallEvent API는 음성/영상 통화 컴포넌트의 콜백 API입니다.

이벤트 목록

EVENT
설명
SDK 내부 오류 발생
SDK가 ready 상태
반복되는 로그인으로 인해 현재 사용자가 방에서 제거되었음
사용자가 통화를 수락
사용자가 통화에 참여
사용자가 통화를 종료
사용자가 통화를 거절
초대된 사용자가 응답하지 않았음
초대된 사용자가 통화 중
통화 시간 초과(초대 대상자가 수신)
원격 사용자가 카메라를 켜거나 끔
원격 사용자가 마이크를 켜거나 끔
원격 사용자가 통화 볼륨을 조정
그룹 통화 초대 목록이 업데이트되었음
통화에 초대되었음
통화가 취소되었음(초대 대상자가 수신함)
통화가 종료되었음
장치 목록이 업데이트되었음
통화 유형이 변경되었음

ERROR

SDK 내부에서 오류가 발생했습니다.
let onError = function(error) {
  console.log(error)
};
tuiCallEngine.on(TUICallEvent.ERROR, onError);

SDK_READY

SDK ready 상태 진입 시, 이 콜백을 수신합니다.
let onSDKReady = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.SDK_READY, onSDKReady);

KICKED_OUT

반복 로그인으로 인해 방에서 퇴장되었습니다.
let handleOnKickedOut = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.KICKED_OUT, handleOnKickedOut);

USER_ACCEPT

사용자가 전화를 받았습니다.
let handleUserAccept = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.USER_ACCEPT, handleUserAccept);

USER_ENTER

사용자가 통화 참여에 동의했습니다.
let handleUserEnter = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.USER_ENTER, handleUserEnter);

USER_LEAVE

사용자가 통화를 종료하는 데 동의했습니다.
let handleUserLeave = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.USER_LEAVE, handleUserLeave);

REJECT

사용자가 통화를 거절했습니다.
let handleInviteeReject = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.REJECT, handleInviteeReject);

NO_RESP

초대 받은 사람이 응답하지 않았습니다.
C2C 통화에서 초대받은 사람이 응답하지 않으면 초대한 사람이 이 콜백을 받게 됩니다.
그룹 통화에서 모든 초대 대상자는 이 콜백을 받을 수 있습니다. 예를 들어 사용자 A가 사용자 B와 사용자 C를 그룹 통화에 초대했지만 B가 응답하지 않으면 A와 C 모두 이 콜백을 받습니다.
let handleNoResponse = function(event) {
console.log(event)
};
tuiCallEngine.on(TUICallEvent.NO_RESP, handleNoResponse);

LINE_BUSY

초대받은 사람이 통화 중입니다.
let handleLineBusy = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.LINE_BUSY, handleLineBusy);

CALLING_TIMEOUT

통화 시간이 초과되었습니다. 이 콜백은 초대받은 사람이 받았습니다.
let handleCallingTimeout = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.CALLING_TIMEOUT, handleCallingTimeout);

USER_VIDEO_AVAILABLE

원격 사용자가 카메라를 켜거나 끕니다.
let handleUserVideoChange = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.USER_VIDEO_AVAILABLE, handleUserVideoChange);

USER_AUDIO_AVAILABLE

원격 사용자가 마이크를 켜거나 끕니다.
let handleUserAudioChange = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.USER_AUDIO_AVAILABLE, handleUserAudioChange);

USER_VOICE_VOLUME

원격 사용자가 통화 볼륨을 조정했습니다.
let handleUserVoiceVolumeChange = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.USER_VOICE_VOLUME, handleUserVoiceVolumeChange);

GROUP_CALL_INVITEE_LIST_UPDATE

그룹 통화의 초대 대상자 목록이 업데이트되었습니다.
let handleGroupInviteeListUpdate = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.GROUP_CALL_INVITEE_LIST_UPDATE, handleGroupInviteeListUpdate);

INVITED

통화에 초대되었습니다.
let handleNewInvitationReceived = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.INVITED, handleNewInvitationReceived);

CALLING_CANCEL

통화가 취소되었습니다. 이 콜백은 초대받은 사람이 받았습니다.
let handleCallingCancel = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.CALLING_CANCEL, handleCallingCancel);

CALLING_END

통화가 종료되었습니다.
let handleCallingEnd = function(event) {
  console.log(event)
};
tuiCallEngine.on(TUICallEvent.CALLING_END, handleCallingEnd);

DEVICED_UPDATED

장치 목록이 업데이트되었습니다.
let handleDeviceUpdated = function({ microphoneList, cameraList, currentMicrophoneID, currentCameraID }) {
  console.log(microphoneList, cameraList, currentMicrophoneID, currentCameraID)
};
tuiCallEngine.on(TUICallEvent.DEVICED_UPDATED, handleDeviceUpdated);

CALL_TYPE_CHANGED

통화 유형이 변경되었습니다.
let handleCallTypeChanged = function({ oldCallType, newCallType }) {
  console.log(oldCallType, newCallType)
};
tuiCallEngine.on(TUICallEvent.CALL_TYPE_CHANGED, handleDeviceUpdated);