주요 에러 코드
Kollus 서비스 이용 중 발생할 수 있는 주요 에러 코드 목록입니다. 에러 발생 시 출력되는 코드와 메시지를 통해 장애 원인을 진단하고 대응할 수 있습니다.
에러 코드 판별 가이드
Curl 에러 (-51XX, -61XX, -80XX, -90XX, -100XX)
마지막 두 자리 숫자가 표준 Curl 에러 코드를 나타냅니다.
- 예: -5128, -6128, -8028, -9028, -10028은 모두 Curl 에러 28번(Timeout)을 의미합니다.
HTTP 에러 (-94XX, -95XX, -104XX, -105XX)
마지막 세 자리가 콜백 서버에서 반환한 HTTP 상태 코드입니다.
- 예: -9404는 콜백 URL 조회 실패(404), -10500은 고객사 인증 서버 내부 오류(500)를 의미합니다.
플레이어
| 에러 코드 | 타입 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
| -19 | NO_INIT | 플레이어 초기화 전 기능 호출 | - |
| -22 | BAD_VALUE | 재생 URL 누락 또는 미디어 콘텐츠 키 불일치 | - |
| -38 | INVALID_OPERATION | 잘못된 파라미터 값 입력 | - |
| -1004 | ERROR_IO | 데이터 입출력 과정의 오류 | - |
| -1010 | ERROR_UNSUPPORTED | 지원하지 않는 콘텐츠 유형 | 지원되지 않는 콘텐츠입니다. 서비스 제공 업체에 문의해 주시기 바랍니다. |
| -1015 | ERROR_UNSUPPORTED_DEVICE | 지원하지 않는 디바이스 | 지원되지 않는 단말기입니다. 서비스 제공 업체에 문의해 주시기 바랍니다. |
| -1103 | ERROR_CODEC_DECODE | 동영상 디코딩 처리 실패 | 시스템 초기화로 재시도가 필요합니다. |
| -110 | ERROR_CODEC_TIMED_OUT | (Android) 하드웨어 코덱(OMX) 동작 Timeout | - |
| 0 | PLAYER_NOT_SUPPORTED_OS | 지원하지 않는 운영체제 재생 요청 | Windows 환경에서만 콘텐츠를 재생하실 수 있습니다. Windows XP 서비스 팩2 이상의 OS가 설치된 기기에서 실행해 주세요. |
[-1000 ~ -1027] 에이전트 방식 HTML5 Player for PC
| 에러 코드 | 타입 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
| -1000 | ERROR_NOT_RESPONSE_AGENT | 에이전트 응답 지연 (3초 이상) | KollusAgent가 실행되어 있지 않거나 응답이 없습니다. 잠시 후 재시도해 주세요. |
| -1001 | ERROR_UNSUPPORTED_HTML5_VIDEO | 브라우저가 HTML5 환경을 지원하지 않음 | 현재 사용하시는 브라우저 환경에서 콘텐츠를 재생하실 수 없습니다. Chrome, Firefox 등의 다른 브라우저를 통해 접속해 주시기 바랍니다. |
| -1002 | ERROR_CAPTURE | 화면 녹화/캡처 프로그램, 원격 제어 프로그램, 또는 외부 디스플레이 출력 감지 | 화면 녹화 또는 캡처 프로그램이 감지되었습니다. 해당 프로그램을 종료하신 후 다시 시도해 주시기 바랍니다. |
| -1011 | ERROR_SCRIPT | 보안 스크립트 인증 오류 | 인증 처리 과정에서 일시적인 오류가 발생하였습니다. 잠시 후 새로고침하여 다시 재생 시도해 주세요. |
| -1012 | ERROR_DUPLICATE_APP | 중복 재생 시도 (1인 1플레이어 제한) | 플레이어를 동시에 하나 이상 실행할 수 없으므로 기존 재생을 종료합니다. |
| -1013 | ERROR_CONTENTRAGE | 응답 지연 또는 비정상 다운로드 요청 | 기본 플레이어(HTML5)를 통한 영상 재생이 원활하지 않습니다. 아래의 확인 버튼을 클릭하여 전용 Player를 통해 재생해 주시기 바랍니다. |
| -1014 | ERROR_USERAGENT | 요청 간 User-Agent 불일치 | - |
| -1016 | ERROR_HTML5_VIDEO_PLAY | HTML5 환경을 지원하지 않음 | 본 콘텐츠는 전용 Player를 통해 재생됩니다. 잠시만 기다려주세요. |
| -1017 | ERROR_DATA_READ | 동영상 데이터 로드 실패 | 영상 데이터를 읽어오지 못했습니다. 잠시 후 새로고침하여 다시 재생 시도해 주세요. |
| -1018 | ERROR_NETWORK_DISCONNECTED | 재생 중 네트워크 단절로 인한 세션 종료 | 세션 연결이 끊어졌습니다. 브라우저를 새로고침해 주시기 바랍니다. |
| -1019 | ERROR_VIRTUALMACHINE | 가상머신(VM) 환경 감지 | 가상머신에서는 영상을 재생하실 수 없습니다. |
| -1020 | ERROR_BUFFERING_CONTENT | 브라우저 환경 문제로 인한 무한 버퍼링 | 현재 브라우저 환경에서는 영상을 원활하게 재생하실 수 없습니다. 다른 브라우저에서 다시 시도해 주시기 바랍니다. |
| -1022 | ERROR_SCRIPT_REF | 비정상적 다중 접속/다운로드 시도 | 비정상적인 방법을 통하여 다운로드 하실 수 없습니다. |
| -1025 | ERROR_SCRIPT | 보안 스크립트 인증 오류 | 인증 처리 과정에서 일시적인 오류가 발생하였습니다. 잠시 후 새로고침하여 다시 재생 시도해 주세요. |
| -1027 | ERROR_DETECT_MANIPULATION | 브라우저 플러그인 등에 의한 데이터 위변조 감지 | 콘텐츠 위변조가 감지되어 재생을 중단합니다. 해당 프로그램을 종료한 후 다시 시도해 주세요. |
[-2005 ~ -2111] SDK
| 에러 코드 | 타입 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
| -1007 | - |
| (Windows) 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해 주세요. |
| -2005 | ERROR_EMULATOR_VIA_DEVICE | 에뮬레이터 환경에서 재생 시도 감지 | - |
| -2100 | ERROR_DISABLED_BOOKMARK_CONTENT | 북마크 기능을 지원하지 않는 콘텐츠에서 북마크 명령 실행 | 북마크가 포함되지 않은 콘텐츠입니다. |
| -2101 | ERROR_CONTENT_NOT_PREPARED | 초기화 및 재생 준비 미완료 상태에서 재생 시도 | 콘텐츠 재생 준비가 완료되지 않았습니다. |
| -2102 | ERROR_COULD_NOT_SCROLL_MODE | 현재 모드에서 지원하지 않는 화면 이동 시도 | 현재 모드에서는 화면을 이동할 수 없습니다. |
| -2103 | ERROR_INCORRECT_BUNDLE_ID | (iOS SDK) 라이선스에 등록된 것과 다른 Bundle ID 사용 | 입력된 Bundle ID가 정확하지 않습니다. |
| -2104 | ERROR_EXPIRED_AUTH_DATE | 발급된 SDK 사용 라이선스 기한 만료 | SDK 사용 기한이 만료되었습니다. |
| -2105 | ERROR_INCORRECT_AUTH_DATE | SDK 사용 기한 입력 형식 오류 | 입력된 SDK 사용 기한이 정확하지 않습니다. |
| -2106 | ERROR_INCORRECT_AUTH_KEY | 발급된 SDK 인증 키 정보 불일치 | 입력된 SDK 인증 키가 정확하지 않습니다. |
| -2107 | ERROR_NOT_ENOUGH_AUTH_INFO | SDK 인증 필수 정보 누락 | SDK 인증을 위한 정보가 모두 입력되지 않았습니다. |
| -2108 | ERROR_KOLLUS_STORAGE_IS_EMPTY | 필수 객체인 KollusStorage 미설정 | KollusStorage가 설정되지 않았습니다. |
| -2109 | ERROR_CONTENT_URL_IS_EMPTY | 재생 URL 또는 인덱스 정보 누락 | 재생할 콘텐츠의 URL이 설정되지 않았습니다. |
| -2110 | ERROR_CONTENT_IS_MIRRORING | 미러링 차단 상태에서 미러링 감지 | - |
| -2111 | ERROR_DISCONNECT_PLAY_SESSION | 내장 플레이어와 로컬 프록시 간 세션 단절 | 재생할 수 없습니다. 다시 재생 시도해 주세요. |
[3000 ~ 3019] HTML5 Player for All
| 에러 코드 | 타입 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
| 3000 | ERROR_API_CONNECTION | API 호출 실패 | API 호출에 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| 3001 | MEDIA_ERR_ABORTED | 사용자 또는 시스템에 의한 비디오 재생 취소 | 비디오 재생을 취소했습니다. |
| 3002 | MEDIA_ERR_NETWORK | 데이터 전송 중 네트워크 연결 유실 | 네트워크 오류로 인하여 비디오 일부를 다운로드하지 못했습니다. |
| 3003 | MEDIA_ERR_DECODE | 브라우저 내 미디어 디코더 오류 또는 손상 | 비디오를 로드할 수 없습니다. 서버 혹은 네트워크 오류 때문이거나 지원되지 않는 형식 때문일 수 있습니다. |
| 3004 | MEDIA_ERR_SRC_NOT_SUPPORTED | 브라우저에서 지원하지 않는 기능 | 비디오 재생이 취소됐습니다. 비디오가 손상되었거나 비디오가 사용하는 기능을 브라우저에서 지원하지 않는 것 같습니다. |
| 3005 | MEDIA_ERR_ENCRYPTED | 브라우저에서 지원하지 않는 기능 (암호화 콘텐츠) | 비디오에 호환되지 않는 소스가 있습니다. |
| 3008 | ERROR_DUPLICATE_PLAYER | 동일 브라우저 내 다중 플레이어 실행 감지 | 플레이어를 동시에 하나 이상 실행할 수 없으므로 기존 재생을 종료합니다. |
| 3012 | MEDIA_ERR_LIVE_NOT_BROADCASTING | 라이브 송출 신호 부재 또는 재생 실패 | 현재 방송 중이 아니거나, 방송 신호가 정상적으로 수신되지 않습니다. 잠시 후, 다시 시도해 주세요. |
| 3013 | ERROR_DUPLICATION_BLOCK_OR_EXPIRED_TIME_MEDIA_KEY | 중복 ID 접속 또는 재생 허용 시간 만료 | ID 중복 또는 재생 허용 시간 초과로 재생을 중단합니다. 페이지 새로고침 후 재시도해 주세요. |
| 3015 | ERROR_CONCURRENTLY_VIEWER_LIMIT | 동시 접속 가능 인원 초과 | 시청 가능 인원을 초과하여 재생을 중단합니다. |
| 3019 | ERROR_DETECT_MANIPULATION | 브라우저 플러그인 등에 의한 데이터 위변조 감지 | 콘텐츠 위변조가 감지되어 재생을 중단합니다. 해당 프로그램을 종료한 후 다시 시도해 주세요. |
[-4001 ~ -4087] 비디오 게이트웨이
| 에러 코드 | 타입 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
| -4001 | ERROR_INVALID_MEDIA_CONTENT_KEY | 유효하지 않은 미디어 콘텐츠 키 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4002 | ERROR_INVALID_SECURITY_KEY | 유효하지 않은 보안 키 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4003 | ERROR_INVALID_CHANNEL_KEY | 유효하지 않은 채널 키 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4004 | ERROR_INVALID_USER_KEY | 유효하지 않은 사용자 키(User Key) | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4005 | ERROR_INVALID_TRANSCODING_FILE_PATH | 동영상 파일의 물리적 경로 오류 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4006 | ERROR_INVALID_ALIAS_KEY | Alias 키 인증 실패 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4007 | ERROR_INVALID_JWT | JWT 규격 또는 서명 오류 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4008 | ERROR_INVALID_MEDIA_TOKEN | 유효하지 않은 미디어 토큰 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4011 | ERROR_NO_TRANSCODING_FILE | 실제 동영상 파일(트랜스코딩 파일) 부재 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4012 | ERROR_NO_MEDIA_CONTENT | 요청한 동영상 데이터 부재 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4013 | ERROR_NO_CONTENT_OWNER | 콘텐츠 공급자 정보 부재 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4014 | ERROR_NO_CONTENT_DISTRIBUTOR | 콘텐츠 공급자 정보 부재 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4015 | ERROR_NO_CHANNEL | 요청한 채널 부재 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4016 | ERROR_NO_PAYMENT | 과금 이력 문제로 서비스 정지 상태 | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
| -4019 | ERROR_NO_DEFAULT_MAIN_SITE |