-1XXX (Secure Player for PC Errors)
This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.
These are errors that occur in the agent-based App Player for Windows (v3e) and HTML5 Player for PC (v3h). They primarily occur in environments where DRM and security policies are applied.
-1002
- Error code: -1002
- Type:
ERROR_CAPTURE - Summary: Screen recording/capture program, remote control program, or external display output detected
Cause
- Occurs when
cpcheck: 1(capture program blocking) is enabled in the channel policy or playback callback response. If a screen recording program such as OBS or Bandicam is running when playback is attempted, the system detects it and stops playback. - Occurs when
disable_tvout: 1(block external display output) is enabled in the channel security policy. If an external output signal such as an HDMI cable connection is detected, playback is blocked to protect the content.
If this error appears to a legitimate user, it is possible that some antivirus or security software installed on the PC has been falsely detected as a capture program. To resolve the issue, please send the name of the software to Technical Support(tech_support@kollus.com).
Reference: Recording/capture prevention policy
| Policy | Description |
|---|---|
| Stop playback and warn | Immediately stops playback and displays a warning message when a recording/capture attempt is detected. |
| Apply pattern | Applies a blackout effect to recording/capture output. |
| Process blocking | Forcibly terminates the detected recording program's process at the system level. |
User guidance (example)
"Please close any screen recording programs, disconnect any external displays, and try again."
-1012
- Error code: -1012
- Type:
ERROR_DUPLICATE_APP - Summary: Concurrent playback attempt detected
Cause
Occurs when a "one player per user" restriction is set in the security policy. If the same account is already watching a video in another browser tab, window, or on another device and attempts to start an additional playback, it is blocked to protect the active session.
User guidance (example)
"Playback is already in progress elsewhere. Please stop the existing playback and try again."
-1015
- Error code: -1015
- Type:
ERROR_UNSUPPORTED_DEVICE - Summary: Device or web browser environment not supported by the Kollus secure player
Cause
- The user is accessing with an outdated browser (Chrome below 45, Internet Explorer 11 or below).
- The user is running an older operating system version not supported by the player.
- A mobile device browser is incorrectly accessing a PC-only secure player call URL.
Resolution
- Method A: Instruct users to download and use the latest version of Chrome, Edge, or Firefox.
- Method B: Consider switching to HTML5 Player for All (v4), which is a player dedicated to standard content(unencrypted).
-1018
- Error code: -1018
- Type:
ERROR_NETWORK_DISCONNECTED - Summary: Network disconnection occurred during video playback
Resolution
Implement source code so that a retry logic runs automatically when a network disconnection occurs.
controller.on('error', function() {
var detail = controller.get_error_detail();
if (detail.code === -1018) {
// Detect reconnection status and retry automatically
showNetworkErrorWithRetry();
}
});
-1019
- Error code: -1019
- Type:
ERROR_VIRTUALMACHINE - Summary: Playback attempted in a virtual machine (VM) environment
Cause
Occurs when vmcheck: 1 (block playback in virtual machine environments) is enabled in the channel security policy. If video playback is attempted in an environment where virtual machine software such as VirtualBox or VMware is active, execution is completely blocked according to the security policy.
Note for development/test environments
This error code may occur when a customer's development team conducts integration testing inside a virtualized development environment (VM).
To proceed with testing smoothly, temporarily disable the vmcheck option in the channel settings, or conduct testing on a physical machine without virtualization.
-1020
- Error code: -1020
- Type:
ERROR_BUFFERING_CONTENT - Summary: Infinite buffering
Cause
- The current user's internet network bandwidth (speed) is insufficient.
- A temporary traffic delay has occurred in the CDN edge server segment.
- There is a problem with the encoded file itself.
Resolution
First recommend that users check their current internet network connection status and bandwidth speed. If the issue persists after taking action, please contact Technical Support(tech_support@kollus.com) with the error details.
-1022
- Error code: -1022
- Type:
ERROR_SCRIPT_REF - Summary: Abnormal multiple access and content download attempt detected
Cause
Traffic is blocked for security when it is determined that a user has sent numerous playback and download API requests using automated script tools or crawler programs, rather than a normal browser environment.
-1027
- Error code: -1027
- Type:
ERROR_DETECT_MANIPULATION - Summary: Player data manipulation detected
Cause
If tampering with player-related data is detected, it is treated as a security threat and the video playback process is immediately blocked.
Primary detection targets
- Ad-blocking tools: Programs such as AdGuard and uBlock Origin that interfere with the flow of video playback scripts
- Userscript execution tools: Plugins such as Tampermonkey and Greasemonkey that arbitrarily modify the default behavior of the browser
- Unofficial video downloaders: Browser extensions that forcibly extract video streaming URLs
Resolution
Browser extensions that conflict with the security policy must be removed or disabled. After changing the settings, be sure to completely close and restart the browser.
- See Also: Browser extension conflicts