클라이언트 에러
본 문서는 클라이언트에서 발생시키는 에러 목록을 설명합니다. 각 에러는 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 종료 상태에서 메시지를 송신하는 경우 |