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, please refer to the Korean documentation.

This document explains how to call the player for embedding live streams into customer websites. Each method differs in channel settings and security requirements, so choose the method that best suits your service environment.

Kollus Live supports two main integration mechanisms.

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

Related information

Refer to the document below for key(Key/ID) information.

Standard call method (public channel)​

The standard call is a non-secure method that calls the player using only the channel key without separate security authentication (JWT).

Caution

The standard call method works correctly only when the channel is set to public. For private channels, use the secure call method.

Basic call (Share URL)​

Used when distributing a broadcast URL in the simplest way without modifying existing website logic. This URL is identical to the [Video Gateway Link] on the channel details page.

https://v-live-kr.kollus.com/{CHANNEL_KEY}

When a user enters this URL in the browser address bar, the Kollus player loads and playback starts immediately.

Embedding in a web page​

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

<iframe
  width="#"
  height="#"
  src="https://v-live-kr.kollus.com/{CHANNEL_KEY}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
Implementation guide
  • Aspect ratio: width and height should be set to match the resolution ratio of the content to display without black bars (Letterbox).
  • Full screen: To support full screen functionality, the allowfullscreen, webkitallowfullscreen, and mozallowfullscreen attributes must be specified.
  • Chrome policy: allow="local-network-access" is a required option when calling content with Kollus DRM applied via <iframe> in Chrome browser (142.X or later).

R-link is used when utilizing a custom player developed directly by the customer rather than the Kollus player.

Caution
  • Feature activation: R-link is disabled by default. To enable this feature, please 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 the analytics features within the Kollus Live console are not available.
https://v-live-kr.kollus.com/r/{CHANNEL_KEY}

When this URL is called, the Kollus system performs an HTTP 302 redirect to a playable stream address.

Secure call method​

The secure call method allows live streams only to 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 duplicate playback blocking and access expiration time settings.

Note

The secure call method can be applied regardless of the channel's public/private setting.

S-link is used when applying security and additional features while using the Kollus player.

Key features

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

  • Duplicate playback blocking: Detects and blocks multiple device access from the same account in real time.
  • Expiration time setting: Sets an expiration time within the token (JWT) to block access after a specific point in time.
  • LMS callback integration: Sends per-user viewing history and playback progress rate data to a learning management system (LMS).
https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}

When a user accesses this URL, the Kollus player loads after security verification.

Embedding in a web page​

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

<iframe
  width="#"
  height="#"
  src="https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
Implementation guide
  • Aspect ratio: width and height should be set to match the resolution ratio of the content to display without black bars (Letterbox).
  • Full screen: To support full screen functionality, the allowfullscreen, webkitallowfullscreen, and mozallowfullscreen attributes must be specified.
  • Chrome policy: allow="local-network-access" is a required option when calling content with Kollus DRM applied via <iframe> in Chrome browser (142.X or later).

SR-link is used when applying security and additional features while using a player developed directly by the customer.

Caution

When using SR-link, the basic features of the Kollus player and the analytics features within the Kollus Live console are not available.

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

When this URL is called, the Kollus system validates the JWT and then performs an HTTP 302 redirect to a playable stream address.