Kakao i Connect Live::Kakao i Connect Live 2.0::개발자 가이드::Error Code

페이지 이동경로

클라이언트 에러

본 문서는 클라이언트에서 발생시키는 에러 목록을 설명합니다. 각 에러는 Room 이벤트의 onError 이벤트나 각 메서드의 exception 등 플랫폼과 메서드 정의에 맞춰 전달됩니다. 클라이언트 에러 발생 시 본 문서에 정의된 전체 에러가 전달되는 것은 아니며, 각 플랫폼에 따라 아래 에러 코드에서 필요한 에러를 선택해 발생시키게 됩니다. 서버에서 전달하는 에러의 경우 코드는 음수(-) 값으로 아래에 정의된 에러와는 별도로 해당 서버 에러 코드와 메시지를 전달하게 됩니다. 서버 에러는 플랫폼별 API 레퍼런스 문서에서 설명합니다.

인증 에러

인증 에러
코드 메시지 설명
1101 미 인증 오류(내부 처리용으로 별도 메시지 없음) 프로비저닝 미인증 관련 에러: 정상 처리됨
1102 인증 서비스가 해제되었습니다. SDK 내부 객체 Nil 체크 에러
1103 인증을 위한 서비스 정보가 입력되지 않았습니다. 서비스 ID 등의 정보가 입력되지 않았을 경우
1104 인증 응답 데이터를 확인할 수 없습니다. 프로비저닝 응답에 API, CNL 정보가 없는 경우
1105 인증 오류(native 원본 메시지) 프로비전 처리 중 정의된 에러로, 서버 에러 이외의 OS 에러가 발생한 경우
1106 Room 생성 전 인증이 필요합니다. signIn() 메서드 호출없이 createRoom() 메서드를 호출한 경우

미디어 에러

미디어 에러
코드 메시지 설명
1201 카메라 디바이스 접근에 실패했습니다. 카메라 디바이스 얻기 실패
1202 카메라 캡처러 생성 전 미디어를 시작할 수 없습니다. 캡처러 생성 전에 시작 호출됨
1203 getUserMedia 실패(native 원본 메시지) getUserMedia가 실패할 경우
1204 getDisplayMedia 실패(native 원본 메시지) getDisplayMedia가 실패할 경우
1205 오디오 트랙을 획득했지만 종료 상태입니다. 오디오 트랙을 획득했지만 readyState가 ended인 경우
1206 비디오 트랙을 획득했지만 종료 상태입니다. 비디오 트랙을 획득했지만 readyState가 ended인 경우
1207 비디오 품질 변경 인자는 'l', 'm', 'h' 중 하나여야 합니다. 리모트 비디오 품질 변경 시 인자가 l, m, h가 아닌 경우
1208 로컬 카메라 생성에 실패했습니다 카메라 캡처 생성 중 실패
1209 로컬 오디오 생성에 실패했습니다. 오디오 디바이스 또는 오디오매니저 얻기 실패
1210 이미 Focus가 존재합니다. AudioHelper의 acquireFocus의 중복 요청

룸 에러

룸 에러
코드 메시지 설명
1301 입력한 룸 id가 지원하지 않는 길이, 문자를 포함합니다. (32자 이하, 영문자/숫자/- 만 가능) 영어 대소문자, 대시, 숫자 외의 문자가 포함되거나 최대 32자를 초과할 경우
1302 룸 정보가 해제되어 요청을 처리할 수 없습니다. Room 객체 Nil 체크
1303 룸 입장 요청의 응답 데이터에 문제가 있습니다. 엔터룸 응답 데이터 체크 오류
1304 룸 입장을 위한 인증 정보가 없습니다. 프로비저닝에서 전달받은 값에 엔터룸을 위한 토큰 정보가 없음
1305 룸 입장을 위한 API 서버 정보로 연결을 생성할 수 없습니다. 프로비저닝에서 전달받은 API URL로 커넥션 생성 실패
1306 룸 입장 실패(native 원본 메시지) Room 입장에 실패한 경우
1311 세션을 생성하기 위해 로컬 미디어 생성과 게시가 필요합니다. 로컬 미디어를 publish() 메서드를 사용하여 게시하지 않은 경우
1312 세션의 연결이 끊어졌습니다. 업세션, 다운세션 연결이 끊어져 요청을 처리할 수 없음
1321 이미 구독 중인 스트림입니다. xxx, xxx 이미 구독 중인 스트림을 다시 구독하려고 할 경우. 맨 뒤에 해당 스트림 아이디가 표시됨
1322 리시버 개수는 maxReceiverCount를 초과할 수 없습니다. subscribe() 호출 시 최대 receiver count를 초과했을 경우
1323 빈 streamIds이 전달되었습니다. subscribe() 호출 시 빈 배열이 전달되었을 경우
1324 빈 배열이 전달되었습니다. publish() 메서드 호출 시 빈 LocalMedia, LocalScreen이 전달되었을 경우
1325 다운세션이 해제되어 비디오를 구독할 수 없습니다. 구독: 다운세션 체크
1326 비디오 구독을 위한 리시버를 할당받을 수 없습니다. 구독: 할당할 리시버 없음
1327 구독하지 않은 비디오는 pause, profile 변경 할 수 없습니다. configure(pause, profile) 변경 요청 시 구독되지 않은 비디오
1328 해당 비디오 스트림이 존재하지 않습니다. 구독: 스트림 없음
1329 구독 에러(native 원본 메시지) 구독: 에러
1331 구독 해제 에러(native 원본 메시지) 구독 해제: 에러
1351 pause 변경 요청 에러(native 원본 메시지) pause 변경 요청 시 내부 에러
1352 해당 비디오는 profile 변경을 지원하지 않습니다. profile 변경이 지원되지 않는 비디오
1353 profile 변경 요청 에러(native 원본 메시지) profile 변경 요청 시 내부 에러
1354 다운세션이 해제되어 profile을 변경할 수 없습니다. profile 변경 SDK Nil 체크
1361 비정상 스트림 정보가 존재합니다. OnParticipantsInfoParams의 정보에 누락이 존재함
1362 이미 게시중인 video 입니다. 구독: 이미 게시된 비디오
1363 이미 게시중인 audio 입니다. 구독: 이미 게시된 오디오

세션 에러

세션 에러
코드 메시지 설명
1401 PeerConnection 생성이 실패했습니다. or (native 원본 메시지) PeerConnection 객체 생성 실패
1402 데이터 채널 생성이 실패했습니다. or (native 원본 메시지) 데이터 채널 생성 실패
1403 데이터 채널 전송이 실패했습니다. 데이터 채널 전송 실패
1411 PeerConnection 연결 상태가 failed입니다. connectionState가 failed일 경우
1412 PeerConnection 연결이 해제되었습니다. SDK 내부에서 send 요청 시 연결 상태 체크 오류
1413 ICE 연결이 해제되었습니다. WebRTC ice connection 해제
1421 세션 요청을 처리하기 위한 인증정보가 없습니다. 세션 생성 오류, 인증 정보가 없음
1422 인증정보 중 api 서버 정보가 존재하지 않습니다. 세션 생성 오류, 인증정보 중 API 서버가 없음
1431 PeerConnection Offer 에러(native 원본 메시지) WebRTC의 offer 오류
1432 Offer Description 생성에 실패했습니다. WebRTC의 offer 실패
1433 PeerConnection Answer 에러(native 원본 메시지) WebRTC의 answer 오류
1434 Answer Description 생성에 실패했습니다. WebRTC의 answer 실패
1435 세션이 해제되어 Candidate 정보를 전달할 수 없습니다. candidate 정보 전달 실패
1436 로컬 Description 설정이 실패했습니다. 로컬 Description 설정 실패
1437 리모트 Desciption 설정이 실패했습니다. 리모트 Desciption 설정 실패
1438 수신 세션의 Offer, Answer 설정이 실패했습니다. 수신 세션의 Offer, Answer 설정 실패
1439 송신 세션의 Offer, Answer 설정이 실패했습니다. 송신 세션의 Offer, Answer 설정 실패
1440 Description 설정에 실패했습니다. setLocalDescription 또는 setRemoteDescription 실패
1441 스트림 추가 요청이 실패했습니다. 스트림 추가 에러
1442 스트림 추가 에러(native 원본 메시지) add stream 시 발생
1443 스트림 추가 요청과 응답이 서로 일치하지 않습니다. 스트림 추가 에러, 응답과 일치하는 요청 Negotiation ID가 없음
1444 Answer Description 설정 에러(native 원본 메시지) 스트림 추가 에러, answer 설정 관련 내부 에러
1445 스트림 제거 요청이 실패했습니다. 스트림 제거 에러
1446 스트림 제거 에러(native 원본 메시지) removeStream 시 발생
1447 리시버 추가 요청이 실패했습니다. 리시버 추가 실패
1448 리시버 추가 에러(native 원본 메시지) add Receiver 시 발생
1450 스트림 설정 변경에 실패했습니다. 스트림 설정 에러
1451 스트림 할당을 위해 선택된 리시버를 찾을 수 없습니다. 스트림 할당 에러, 일치하는 리시버 없음
1452 스트림 설정 요청이 실패했습니다. 스트림 설정 에러
1453 오디오 설정 오류(native 원본 메시지) 스트림 설정 에러, 정의된 오류 외 에러
1454 비디오 설정 오류(native 원본 메시지) 스트림 설정 에러, 정의된 오류 외 에러
1461 세션 데이터 전송 시 JSON 인코딩이 실패했습니다. 세션 전송 시 JSON 인코딩 에러
1462 JSON 문자열을 DATA 형식으로 변환 시 오류가 발생했습니다. JSON 문자열을 Data 형식으로 변환 에러
1471 메시지 전송에 실패했습니다. 메시지 전송 에러
1472 송신 세션의 Offer 데이터 파싱에 실패했습니다. 업세션 Offer 데이터 파싱 에러
1473 송신 세션의 Profile 데이터 파싱에 실패했습니다. 업세션 Profile 데이터 파싱 에러
1474 송신 세션의 Error 데이터 파싱에 실패했습니다. 업세션 Error 데이터 파싱 에러
1475 송신 세션의 Message 데이터 파싱에 실패했습니다. 업세션 Message 데이터 파싱 에러
1481 수신 세션의 Offer 데이터 파싱에 실패했습니다. 다운세션 Offer 데이터 파싱 에러
1482 수신 세션의 Error 데이터 파싱에 실패했습니다. 다운세션 Error 데이터 파싱 에러
1483 수신 세션의 StreamChanged 데이터 파싱에 실패했습니다. 다운세션 스트림 데이터 파싱 에러
1484 수신 세션의 ParticipantsInfo 데이터 파싱에 실패했습니다. 다운세션 participants info 파싱 에러
1485 수신 세션의 KvDoc 데이터 파싱에 실패했습니다. 다운세션 kvdocChanged 데이터 파싱 에러
1486 수신 세션의 메시지 데이터 파싱에 실패했습니다. 다운세션 Message 데이터 파싱 에러
1487 수신 세션의 Session Description 교환시 오류가 발생했습니다. 다운세션 SDP(Session Description Protocol) 교환 오류

기타 에러

기타 에러
코드 메시지 설명
1901 ConnectLive로 부턱 직접 객체를 선언할 수 없습니다. static인 ConnectLive로 부턱 직접 객체를 선언하려고 할 경우
1902 HTTP 응답에 오류가 발생했습니다. HTTP 에러
1903 HTTP 응답이 정의되지 않은 형식입니다. 응답 데이터 형식 에러
1904 HTTP 세션에 오류가 발생했습니다. HTTP 에러
1905 화면공유를 위한 데이터 인코딩에 오류가 발생했습니다. 화면 공유 시 인코딩 에러
1906 화면공유를 위한 UserDefaults 객체 생성에 실패했습니다. SDK 내부 에러
1907 화면 공유를 위한 룸 입장 정보가 없습니다. 화면 공유가 불가능 합니다. 화면 공유 시작을 위해 임시 저장된 엔터룸 응답 데이터 체크 에러
1911 publish 후 extraValue 변경은 불가합니다. publish() 메서드 호출 후 extraValue를 설정한 경우
1912 통신 프로토콜 종료됨 webSocket 종료 상태에서 메시지를 송신하는 경우
이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.