본문으로 건너뛰기

-1XXX (PC용 보안 플레이어 에러)

에이전트 방식의 App Player for Windows(v3e) 및 HTML5 Player for PC(v3h)에서 발생하는 에러입니다. DRM 및 보안 정책이 적용된 환경에서 주로 발생합니다.

-1002​

  • 에러 코드: -1002
  • 타입: ERROR_CAPTURE
  • 요약: 화면 녹화/캡처 프로그램, 원격 제어 프로그램, 또는 외부 디스플레이 출력 감지

원인​

  • 채널 정책 또는 플레이 콜백 응답에 cpcheck: 1(캡처 프로그램 차단) 설정이 활성화된 경우에 발생합니다. OBS, 반디캠 등 화면 녹화 프로그램이 실행 중인 상태에서 재생을 시도하면 시스템이 이를 탐지하여 재생을 중단합니다.
  • 채널 보안 정책에 disable_tvout: 1(외부 디스플레이 출력 차단) 설정이 활성화된 경우에 발생합니다. HDMI 케이블 연결 등의 외부 출력 신호가 감지되면 콘텐츠 보호를 위해 재생이 차단됩니다.
참고

정상적인 사용자에게 해당 에러가 표시되는 경우, PC에 설치된 일부 백신이나 보안 소프트웨어가 캡처 프로그램으로 오탐지되었을 가능성이 있습니다. 문제 해결을 위해 해당 소프트웨어 명칭을 기술 지원팀(tech_support@kollus.com)으로 전달해 주세요.

참고: 녹화/캡처 차단 정책​

정책설명
재생 중단 및 경고 처리녹화/캡처 시도 감지 시 즉시 재생을 중단시키고 경고 메시지를 표시합니다.
패턴 방식 적용녹화/캡처 결과물을 블랙아웃 처리합니다.
프로세스 차단감지된 녹화 프로그램의 프로세스를 시스템 레벨에서 강제로 종료시킵니다.

사용자 안내 (예시)​

"화면 녹화 프로그램을 종료하고 외부 디스플레이 연결을 해제한 후 다시 시도해 주세요."

-1012​

  • 에러 코드: -1012
  • 타입: ERROR_DUPLICATE_APP
  • 요약: 중복 재생 시도

원인​

보안 정책상 '1인 1플레이어' 제한이 설정된 경우에 발생합니다. 동일한 계정이 이미 다른 브라우저 탭, 창 또는 다른 기기에서 영상을 시청 중인 상태에서 추가로 재생을 시도하면 먼저 구동 중인 세션 보호를 위해 차단됩니다.

사용자 안내 (예시)​

"이미 다른 곳에서 재생 중입니다. 기존 재생을 종료 후 다시 시도해 주세요."

-1015​

  • 에러 코드: -1015
  • 타입: ERROR_UNSUPPORTED_DEVICE
  • 요약: Kollus 보안 플레이어를 지원하지 않는 디바이스 또는 웹 브라우저 환경

원인​

  • 구형 브라우저(Chrome 45 미만, Internet Explorer 11 이하)를 사용하여 접속한 경우입니다.
  • 플레이어가 지원하지 않는 구형 운영체제 버전을 사용 중인 경우입니다.
  • 모바일 기기의 브라우저 환경에서 PC 전용 보안 플레이어 호출 URL로 잘못 접근한 경우입니다.

해결 방법​

  • 방법 A: 사용자에게 최신 버전의 Chrome, Edge, Firefox 브라우저를 다운로드하여 이용하도록 안내하세요.
  • 방법 B: 비암호화 콘텐츠 전용 플레이어인 HTML5 Player for All(v4)으로의 전환을 검토하세요.

-1018​

  • 에러 코드: -1018
  • 타입: ERROR_NETWORK_DISCONNECTED
  • 요약: 영상 재생 중 네트워크 단절 현상 발생

해결 방법​

네트워크 단절 발생 시 자동으로 재시도 로직이 구동되도록 소스 코드를 구현하세요.

controller.on('error', function() {
  var detail = controller.get_error_detail();
  if (detail.code === -1018) {
    // 재연결 상태 감지 후 자동 재시도
    showNetworkErrorWithRetry();
  }
});

-1019​

  • 에러 코드: -1019
  • 타입: ERROR_VIRTUALMACHINE
  • 요약: 가상머신(VM) 환경에서 재생 시도

원인​

채널 보안 정책에 vmcheck: 1(가상머신 환경 재생 차단) 설정이 활성화된 경우에 발생합니다. VirtualBox, VMware 등 가상머신 소프트웨어가 활성화된 환경에서 영상 재생을 시도하면 보안 정책에 따라 실행이 전면 차단됩니다.

개발/테스트 환경 주의​

고객사 개발팀이 가상화 개발 환경(VM) 내부에서 통합 테스트를 진행할 때 이 에러 코드가 발생할 수 있습니다. 원활한 테스트 진행을 위해 채널 설정에서 임시로 vmcheck 항목을 비활성화하거나, 가상화가 없는 물리 머신 환경에서 테스트를 수행하세요.

-1020​

  • 에러 코드: -1020
  • 타입: ERROR_BUFFERING_CONTENT
  • 요약: 무한 버퍼링 현상

원인​

  • 현재 사용자 환경의 인터넷 네트워크 대역폭(속도)이 부족한 경우입니다.
  • CDN 엣지 서버 구간에서 일시적인 트래픽 지연이 발생한 경우입니다.
  • 인코딩 파일 자체에 문제가 발생한 경우입니다.

해결 방법​

현재 이용 중인 인터넷 네트워크 연결 상태 및 대역폭 속도를 먼저 점검하도록 권장하세요. 조치 이후에도 현상이 지속해서 발생한다면 기술 지원팀(tech_support@kollus.com)으로 에러 내역을 문의해 주세요.

-1022​

  • 에러 코드: -1022
  • 타입: ERROR_SCRIPT_REF
  • 요약: 비정상적인 다중 접속 및 콘텐츠 다운로드 시도 감지

원인​

사용자가 정상적인 브라우저 환경이 아닌, 자동화 스크립트 도구나 크롤러(Crawler) 프로그램을 활용하여 다수의 재생 및 다운로드 API 요청을 전송한 것으로 판단된 경우 보안을 위해 트래픽을 차단합니다.

-1027​

  • 에러 코드: -1027
  • 타입: ERROR_DETECT_MANIPULATION
  • 요약: 플레이어 데이터 위변조 감지

원인​

플레이어 관련 데이터의 위변조가 감지되면 보안 위협으로 간주하여 비디오 재생 프로세스를 즉시 차단합니다.

주요 감지 대상 프로그램​

  • 광고 차단 도구: AdGuard, uBlock Origin 등 영상 재생 스크립트의 흐름을 간섭하는 프로그램
  • 사용자 스크립트(Userscript) 실행 도구: Tampermonkey, Greasemonkey 등 브라우저의 기본 동작을 임의로 변조하는 플러그인
  • 비공식 동영상 다운로더: 영상 스트리밍 주소를 강제로 추출하는 확장 프로그램

해결 방법​

보안 정책과 충돌하는 확장 프로그램을 브라우저에서 제거하거나 비활성화해야 합니다. 설정을 변경한 후에는 반드시 브라우저를 완전히 종료하고 재시작하세요.