Skip to main content

Player Call

Notice

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.

This page describes the various methods for calling the Kollus Player to play content. Each method differs depending on the integration purpose and security requirements, so choose the method best suited for your service environment.

Kollus VOD supports two main integration mechanisms.

  • Kollus Player call: Recommended when you want to immediately use the standard UI and features provided by Kollus VOD without developing a separate player.
  • Direct Stream call: Applied when implementing a custom UI or integrating an external player.
See Also

Refer to the documents below for identification information required to call the player.

Standard call method​

The standard call is a non-secure method that calls the player using only the media content key, which is the unique content identifier, without separate security authentication (JWT).

Basic call (Share URL)​

Used to distribute Playback URLs most simply without modifying existing website logic. When a user enters the URL in the browser address bar, the Kollus Player loads and playback begins immediately.

https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}

Embedding in a web page​

To embed the player in a customer web page, set the URL in the src attribute of the <iframe> tag.

<iframe
  width="#"
  height="#"
  src="https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}?"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
Implementation guide
  • Aspect ratio: Set width and height according to the resolution ratio of the content to display without black borders (Letterbox).
  • Full screen: To support full-screen functionality, include the allowfullscreen, webkitallowfullscreen, and mozallowfullscreen attributes.
  • Chrome policy: allow="local-network-access" is a required option when calling Kollus DRM-protected content via <iframe> in Chrome browser (version 142.X and above).
Caution
  • Feature activation: R-link is disabled by default. To activate this feature, contact your Account Manager(biz@catenoid.net) or Technical Support(tech_support@catenoid.net).
  • Limitations: When using R-link, the basic features of the Kollus Player and analysis data (Insight menu) in the Kollus VOD console are not available.

R-link is used to play standard content(unencrypted) through a custom player built by the customer, rather than the Kollus Player. When this URL is called, the Kollus system performs an HTTP 302 redirect to a playable stream address.

https://v.kr.kollus.com/r/{MEDIA_CONTENT_KEY}

I-link is used to load standard content(unencrypted) in an app environment developed using the Kollus mobile SDK. Set this URL as the media source address in your SDK initialization code.

https://v.kr.kollus.com/i/{MEDIA_CONTENT_KEY}

Secure call method​

The secure call method allows playback only for users whose permissions have been verified based on JWT(JSON Web Token). It prevents unauthorized viewing through simple link sharing and enables fine-grained control such as concurrent playback prevention and playback expiration date settings. The secure call method can be applied regardless of channel settings (standard content(unencrypted)/encrypted content-only).

S-link is used when applying security and additional features while using the Kollus Player. When a user accesses this URL, the Kollus Player loads after security verification.

https://v.kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}
Key features

The following features can be controlled when using S-link.

  • Concurrent playback prevention: Detects and blocks simultaneous access from multiple devices on the same account in real time.
  • Expiration date setting: Sets an expiration date in the token (JWT) to block access after a specific point in time.
  • Seek blocking: Controls users from arbitrarily skipping to different playback positions in the video.
  • Playback speed restriction: Disables the playback speed feature or locks it to a specific speed.
  • Resume: Automatically resumes playback from where the user left off.
  • LMS callback integration: Transmits per-user viewing history and playback progress rate data to a Learning Management System (LMS).

Embedding in a web page​

To embed the player in a customer web page, set the URL in the src attribute of the <iframe> tag.

<iframe
  width="#"
  height="#"
  src="https://v.kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
Implementation guide
  • Aspect ratio: Set width and height according to the resolution ratio of the content to display without black borders (Letterbox).
  • Full screen: To support full-screen functionality, include the allowfullscreen, webkitallowfullscreen, and mozallowfullscreen attributes.
  • Chrome policy: allow="local-network-access" is a required option when calling Kollus DRM-protected content via <iframe> in Chrome browser (version 142.X and above).
Caution

When using SR-link, the basic features of the Kollus Player and analysis data (Insight menu) in the Kollus VOD console are not available.

SR-link is used when applying security and additional features while using a custom player built by the customer. When this URL is called, the Kollus system validates the JWT and then performs an HTTP 302 redirect to a playable stream address.

https://v.kr.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_KEY}

SI-link is used to load encrypted content in an app environment developed using the Kollus mobile SDK. Use S-link for standard web browser environments. Set this URL as the media source address in your SDK initialization code.

https://v.kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_KEY}
Key features

The following features can be controlled when using SI-link.

  • Concurrent playback prevention: Detects and blocks simultaneous access from multiple devices on the same account in real time.
  • Expiration date setting: Sets an expiration date in the token (JWT) to block access after a specific point in time.
  • Seek blocking: Controls users from arbitrarily skipping to different playback positions in the video.
  • Playback speed restriction: Disables the playback speed feature or locks it to a specific speed.
  • Resume: Automatically resumes playback from where the user left off.
  • LMS callback integration: Transmits per-user viewing history and playback progress rate data to a Learning Management System (LMS).