에러 코드
Kollus 서비스 이용 중 발생할 수 있는 주요 에러 코드 목록입니다. 에러 발생 시 출력되는 코드와 메시지를 통해 장애 원인을 진단하고 대응할 수 있습니다.
주요 에러 코드
보안 플레이어
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
NO_INIT | -19 | 플레이어 초기화 전 기능 호출 | - |
BAD_VALUE | -22 | 재생 URL 누락 또는 미디어 콘텐츠 키 불일치 | - |
INVALID_OPERATION | -38 | 잘못된 파라미터 값 입력 | - |
ERROR_IO | -1004 | 데이터 입출력 과정의 오류 | - |
ERROR_MALFORMED | -1007 | 미지원 프로토콜 (HTTP/HTTPS 누락) | 콘텐츠를 불러오는 데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNSUPPORTED | -1010 | 미지원 콘텐츠 유형 | 지원되지 않는 콘텐츠입니다. 서비스 제공 업체에 문의해주시기 바랍니다. |
ERROR_UNSUPPORTED_DEVICE | -1015 | 미지원 디바이스 | 지원되지 않는 단말기입니다. 서비스 제공 업체에 문의해주시기 바랍니다. |
ERROR_CODEC_DECODE | -1103 | 영상 디코딩 처리 실패 | 시스템 초기화로 재시도가 필요합니다. |
Android
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_CODEC_TIMED_OUT | -110 | 하드웨어 코덱(OMX) 동작 Timeout | - |
ERROR_CODEC_INIT | -1102 | 하드웨어 코덱 연동 실패 (서버 로그 수집용) | 코덱 초기화에 실패하였습니다. 다시 시도해주시기 바랍니다. |
[-1000 ~ -1027] Html5 Player for PC (Agent)
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_NOT_RESPONSE_AGENT | -1000 | Kollus Agent 응답 지연 (3초 이상) | Kollus Agent가 실행되어 있지 않거나 응답이 없습니다. 잠시 후 재시도 해 주세요. |
ERROR_UNSUPPORTED_HTML5_VIDEO | -1001 | 브라우저의 HTML5 미지원 | 현재 사용하시는 브라우저 환경에서 콘텐츠를 재생하실 수 없습니다. Chrome, Firefox 등의 다른 브라우저를 통해 접속해주시기 바랍니다. |
ERROR_CAPUTRE | -1002 | 화면 녹화 또는 캡처 프로그램 감지 | 화면 녹화 또는 캡처 프로그램이 감지되었습니다. 해당 프로그램을 종료하신 후 다시 시도해주시기 바랍니다. |
ERROR_TVOUT | -1003 | 외부 출력(HDMI, TV OUT) 감지 | 외부 디바이스로의 출력 시도가 감지되어 재생을 중단합니다. HDMI 등의 외부 연결을 해제하신 후 다시 시도해주시기 바랍니다. |
ERROR_CHROME_EXTENTION_CAPTURE | -1004 | 녹화 관련 Chrome 확장 프로그램 감지 | Chrome 확장 프로그램에 화면 녹화 또는 캡처 프로그램이 감지되었습니다. 해당 프로그램을 제거 후 다시 시도해주시기 바랍니다. |
ERROR_REMOTE_CONNECT | -1005 | 원격 제어 프로그램 감지 | 원격 연결 프로그램이 감지되었습니다. 해당 프로그램을 종료하신 후 다시 시도해주시기 바랍니다. |
ERROR_SCRIPT | -1011 | 보안 스크립트 인증 오류 | 인증 처리 과정에서 일시적인 오류가 발생하였습니다. 잠시 후 새로고침하여 다시 재생 시도해주세요. |
ERROR_DUPLICATE_APP | -1012 | 중복 재생 시도 (1인 1플레이어 제한) | 플레이어를 동시에 하나 이상 실행할 수 없으므로 기존 재생을 종료합니다. |
ERROR_CONTENTRAGE | -1013 | 응답 지연 또는 비정상 다운로드 요청 | 기본 플레이어(HTML5)를 통한 영상 재생이 원활하지 않습니다. 아래의 확인 버튼을 클릭하시어 보안 플레이어를 통해 재생해주시기 바랍니다. |
ERROR_USERAGENT | -1014 | 요청 간 User-Agent 불일치 | - |
ERROR_HTML5_VIDEO_PLAY | -1016 | HTML5 재생 환경 미지원 | 본 콘텐츠는 보안 플레이어를 통해 재생됩니다. 잠시만 기다려주세요. |
ERROR_DATA_READ | -1017 | 영상 데이터 로드 실패 | 영상 데이터를 읽어오지 못했습니다. 잠시 후 새로고침하여 다시 재생 시도해주세요. |
ERROR_NETWORK_DISCONNECTED | -1018 | 재생 중 네트워크 단절로 인한 세션 종료 | 세션 연결이 끊어졌습니다. 브라우저를 새로고침 해주시기 바랍니다. |
ERROR_VIRTUALMACHINE | -1019 | 가상 머신(VM) 환경 감지 | 가상 머신에서는 영상을 재생하실 수 없습니다. |
ERROR_BUFFERING_CONTENT | -1020 | 브라우저 환경 문제로 인한 무한 버퍼링 | 현재 브라우저 환경에서는 영상을 원활하게 재생하실 수 없습니다. 다른 브라우저에서 다시 시도해주시기 바랍니다. |
ERROR_SCRIPT_REF | -1022 | 비정상적 다중 접속/다운로드 시도 | 비정상적인 방법을 통하여 다운로드 하실 수 없습니다. |
ERROR_SCRIPT | -1025 | 보안 스크립트 인증 오류 | 인증 처리 과정에서 일시적인 오류가 발생하였습니다. 잠시 후 새로고침하여 다시 재생 시도해주세요. |
ERROR_DETECT_MANIPULATION | -1027 | 브라우저 플러그인 등에 의한 데이터 위변조 감지 | 콘텐츠 위변조가 감지되어 재생을 중단합니다. 해당 프로그램을 종료한 후 다시 시도해 주세요. |
[-2005 ~ -2111] SDK
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_EMURATOR_VIA_DEVICE | -2005 | 에뮬레이터 환경에서 재생 시도 감지 | - |
ERROR_DISABLED_BOOKMARK_CONTENT | -2100 | 북마크 미지원 콘텐츠에서 북마크 명령 실행 | 북마크가 포함되지 않은 콘텐츠입니다. |
ERROR_CONTENT_NOT_PREPARED | -2101 | 초기화 및 재생 준비 미완료 상태에서 재생 시도 | 콘텐츠 재생 준비가 완료되지 않았습니다. |
ERROR_COULD_NOT_SCROLL_MODE | -2102 | 현재 모드에서 지원하지 않는 화면 이동 시도 | 현재 모드에서는 화면을 이동할 수 없습니다. |
ERROR_INCORRECT_BUNDLE_ID | -2103 | 라이선스에 등록된 것과 다른 Bundle ID 사용 | 입력된 Bundle ID가 정확하지 않습니다. |
ERROR_EXPIRED_AUTH_DATE | -2104 | 발급된 SDK 사용 라이선스 기한 만료 | SDK 사용 기한이 만료되었습니다. |
ERROR_INCORRECT_AUTH_DATE | -2105 | SDK 사용 기한 입력 형식 오류 | 입력된 SDK 사용 기한이 정확하지 않습니다. |
ERROR_INCORRECT_AUTH_KEY | -2106 | 발급된 SDK 인증 키 정보 불일치 | 입력된 SDK 인증 키가 정확하지 않습니다. |
ERROR_NOT_ENOUGH_AUTH_INFO | -2107 | SDK 인증 필수 정보 누락 | SDK 인증을 위한 정보가 모두 입력되지 않았습니다. |
ERROR_KOLLUS_STORAGE_IS_EMPTY | -2108 | 필수 객체인 KollusStorage 미설정 | KollusStorage가 설정되지 않았습니다. |
ERROR_CONTENT_URL_IS_EMPTY | -2109 | 재생 URL 또는 인덱스 정보 누락 | 재생할 콘텐츠의 URL이 설정되지 않았습니다. |
ERROR_CONTENT_IS_MIRRORING | -2110 | 미러링 차단 상태에서 미러링 감지 | - |
ERROR_DISCONNECT_PLAY_SESSION | -2111 | 내장 플레이어와 로컬 프록시 간 세션 단절 | 재생할 수 없습니다. 다시 재생 시도해주세요. |
[3000 ~ 3019] Html5 Player for All
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_API_CONNECTION | 3000 | API 호출 실패 | API 호출에 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
MEDIA_ERR_ABORTED | 3001 | 사용자 또는 시스템에 의한 비디오 재생 취소 | 비디오 재생을 취소했습니다. |
MEDIA_ERR_NETWORK | 3002 | 데이터 전송 중 네트워크 연결 유실 | 네트워크 오류로 인하여 비디오 일부를 다운 로드하지 못 했습니다. |
MEDIA_ERR_DECODE | 3003 | 브라우저 내 미디어 디코더 오류 또는 손상 | 비디오를 로드할 수 없습니다. 서버 혹은 네트워크 오류 때문이거나 지원되지 않는 형식 때문일 수 있습니다. |
MEDIA_ERR_SRC_NOT_SUPPORTED | 3004 | 브라우저 기능 미지원 | 비디오 재생이 취소됐습니다. 비디오가 손상되었거나 비디오가 사용하는 기능을 브라우저에서 지원하지 않는 것 같습니다. |
MEDIA_ERR_ENCRYPTED | 3005 | 브라우저 기능 미지원 (암호화 콘텐츠) | 비디오에 호환되지 않는 소스가 있습니다. |
ERROR_DUPLICATE_PLAYER | 3008 | 동일 브라우저 내 다중 플레이어 실행 감지 | 플레이어를 동시에 하나 이상 실행할 수 없으므로 기존 재생을 종료합니다. |
MEDIA_ERR_LIVE_NOT_BROADCASTING | 3012 | 라이브 송출 신호 부재 또는 재생 실패 | 현재 방송 중이 아니거나, 방송 신호가 정상적으로 수신되지 않습니다. 잠시 후, 다시 시도해주세요. |
ERROR_DUPLICATION_BLOCK_OR_EXPIRED_TIME_MEDIA_KEY | 3013 | 중복 ID 접속 또는 재생 허용 시간 만료 | ID 중복 또는 재생 허용 시간 초과로 재생을 중단합니다. 페이지 새로고침 후 재시도해 주세요. |
ERROR_CONCURRENTLY_VIEWER_LIMIT | 3015 | 동시 접속 가능 인원 초과 | 시청 가능 인원을 초과하여 재생을 중단합니다. |
ERROR_DETECT_MANIPULATION | 3019 | 브라우저 플러그인 등에 의한 데이터 위변조 감지 | 콘텐츠 위변조가 감지되어 재생을 중단합니다. 해당 프로그램을 종료한 후 다시 시도해 주세요. |
[-4001 ~ -4087] VideoGateway
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_INVALID_MEDIA_CONTENT_KEY | -4001 | 유효하지 않은 미디어 콘텐츠 키 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_SECURITY_KEY | -4002 | 유효하지 않은 보안 키 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_CHANNEL_KEY | -4003 | 유효하지 않은 채널 키 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_USER_KEY | -4004 | 유효하지 않은 사용자 키 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_TRANSCODING_FILE_PATH | -4005 | 동영상 파일의 물리적 경로 오류 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_ALIAS_KEY | -4006 | Alias 키 인증 실패 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_JWT | -4007 | JWT 규격 또는 서명 오류 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_INVALID_MEDIA_TOKEN | -4008 | 유효하지 않은 미디어 토큰 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_TRANSCODING_FILE | -4011 | 실제 동영상 파일(트랜스코딩 파일) 부재 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_MEDIA_CONTENT | -4012 | 요청한 동영상 데이터 부재 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_CONTENT_OWNER | -4013 | 콘텐츠 공급자 정보 부재 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_CONTENT_DISTRIBUTOR | -4014 | 콘텐츠 공급자 정보 부재 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_CHANNEL | -4015 | 요청한 채널 부재 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_PAYMENT | -4016 | 과금 이력 문제로 서비스 정지 상태 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_DEFAULT_MAIN_SITE | -4019 | 서비스 제공자(Main Site) 설정 오류 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NO_MAIN_MEDIA_CONTENT | -4020 | 인트로 영상 뒤에 재생할 본 콘텐츠 부재 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNAVAILABLE_TRANSCODING_FILE | -4021 | 특정 트랜스코딩 파일 서비스 중지 상태 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNAVAILABLE_MEDIA_CONTENT | -4022 | 동영상 서비스 중지(비활성화) 상태 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNAVAILABLE_CONTENT_OWNER | -4023 | 콘텐츠 공급 계정 서비스 중지 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNAVAILABLE_CONTENT_DISTRIBUTOR | -4024 | 콘텐츠 공급자 서비스 중지 상태 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNAVAILABLE_CHANNEL | -4025 | 해당 채널 서비스 중지(비활성화) 상태 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_UNAVAILABLE_CHANNEL_DISTRIBUTION | -4026 | 배포 위임 채널 서비스 중지 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NOT_ALLOWED_REFERER | -4031 | 허용되지 않은 도메인(Referer) 접근 | 본 콘텐츠는 허용되지 않은 도메인에서 재생하실 수 없습니다. |
ERROR_NOT_ALLOWED_ACCESS_FOR_BLOCKING_CAPTURE | -4032 | 캡처 시도로 인한 사용자 접근 차단 | 귀하는 무단 캡처 시도로 인해 서비스 담당자로부터 콘텐츠 접근이 차단된 상태입니다. 상세 내용은 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NOT_PUBLIC_SHARED_CHANNEL | -4081 | 비공개 채널 콘텐츠 요청 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_MISMATCH_USER_KEY | -4082 | 사용자 키 정보 불일치 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_ACCESS_WITHOUT_MEDIA_CONTENT_KEY | -4083 | 미디어 콘텐츠 키 누락 | 콘텐츠를 불러오는데 실패했습니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_NOT_SUPPORT_DEVICE | -4084 | 보안 정책상 지원하지 않는 디바이스 접근 | 본 디바이스에서 재생할 수 없는 콘텐츠입니다. 서비스 제공 업체에 문의하여 주시기 바랍니다. |
ERROR_TOKEN_EXPIRED | -4085 | 재생 토큰(JWT) 만료 | 재생 가능한 유효시간이 지났습니다. 다시 시도하여 주시기 바랍니다. |
ERROR_NOT_SUPPORT_BROWSER | -4087 | 미지원 브라우저(IE 등) | Chrome 브라우저를 이용해주세요. |
[-5106 ~ -5156] Html5 Player for PC (Live) - Curl Send
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_CURLE_COULDNT_RESOLVE_HOST | -5106 | 도메인 주소 해석(DNS Resolving) 실패 | 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해주세요. |
ERROR_CURLE_COULDNT_CONNECT | -5107 | 라이브 서버 접속 실패 | 서버에 연결할 수 없습니다. 네트워크를 확인 후 재시도 해 주세요. |
ERROR_CURLE_PARTIAL_FILE | -5118 | 데이터 전송 중 끊김 (일부 데이터 미수신) | 네트워크 환경이 불안정하여 데이터 수신에 실패하였습니다. |
ERROR_CURLE_WRITE_ERROR | -5123 | 로컬 시스템 데이터 기록(Write) 실패 | 현재 방송 중이 아니거나, 방송 신호가 정상적으로 수신되지 않습니다. 다시 시도해 주세요. |
ERROR_CURLE_RECV_ERROR | -5156 | 서버 응답 수신 중 연결 종료 | 네트워크 상태를 확인하신 후 재시도 해 주세요. |
Curl 에러 코드 판별 가이드
-51XX 에러 코드의 마지막 두 자리 숫자는 표준 Curl 에러 코드를 따릅니다.
- 예:
-5128에러가 발생했다면 이는 Curl 에러 28번(Timeout)을 의미합니다. - 상세한 Curl 에러 목록은 공식 문서를 참조하세요.
[-6106 ~ -6156] Html5 Player for PC (Live) - Curl Receive
| 타입 | 에러 코드 | 상세 내용 | 사용자 노출 메시지 |
|---|---|---|---|
ERROR_CURLE_COULDNT_RESOLVE_HOST | -6106 | 도메인 주소 해석(DNS Resolving) 실패 | 일시적인 오류가 발생하였습니다. 잠시 후 다시 시도해주세요. |
ERROR_CURLE_COULDNT_CONNECT | -6107 | 라이브 서버 접속 실패 | 서버에 연 결할 수 없습니다. 네트워크를 확인 후 재시도 해 주세요. |
ERROR_CURLE_PARTIAL_FILE | -6118 | 데이터 전송 중 끊김 (일부 데이터 미수신) | 네트워크 환경이 불안정하여 데이터 수신에 실패하였습니다. |
ERROR_CURLE_WRITE_ERROR | -6123 | 로컬 시스템 데이터 기록(Write) 실패 | 현재 방송 중이 아니거나, 방송 신호가 정상적으로 수신되지 않습니다. 다시 시도해 주세요. |
ERROR_CURLE_RECV_ERROR | -6156 | 서버 응답 수신 중 연결 종료 | 네트워크 상태를 확인하신 후 재시도 해 주세요. |
Curl 에러 코드 판별 가이드
-61XX 에러코드의 마지막 두 자리 숫자는 표준 Curl 에러 코드를 따릅니다.
- 예:
-6128에러가 발생했다면 이는 Curl 에러 28번(Timeout)을 의미합니다. - 상세한 Curl 에러 목록은 공식 문서를 참조하세요.