Skip to content

Teleport SDK Integration with Clappr (DASH)

This section provides instructions for integrating the Teleport SDK with the Clappr media player for DASH content playback.

1. Script Connection

Ensure that you have connected the main Teleport SDK script and the loader for Clappr DASH. You can use separate scripts or a ready-made bundle.

Separate Scripts:

html
<!-- Main Teleport SDK script -->
<script src="https://cdn.teleport.media/stable/teleport.js"></script>
<!-- Loader for Clappr DASH -->
<script src="https://cdn.teleport.media/stable/teleport.clappr-dash.js"></script>

Bundle (includes SDK, loader, and polyfills):

html
<script src="https://cdn.teleport.media/stable/teleport.clappr-dash.bundle.js"></script>

2. Teleport SDK Initialization

After connecting the scripts, you need to initialize the Teleport SDK, passing your API key and the player instance.

js
// 1. Initialize Clappr
const player = new Clappr.Player({
    source: 'YOUR_DASH_MANIFEST_URL', // URL of your DASH manifest
    parentId: '#player-container', // ID of the element where the player will be embedded
    plugins: [DashShakaPlayback] // Ensure the DASH plugin is connected
});

// 2. Initialize Teleport SDK
teleport.initialize({
    apiKey: "YOUR_API_KEY", // Your API key from the Teleport cabinet
    loader: {
        type: "clappr-dash", // Plugin identifier for Clappr DASH
        params: {
            player: player // Pass the Clappr instance
        }
    }
})
.then(function (instance) {
    console.log('Teleport SDK successfully initialized for Clappr DASH!', instance);
    player.play();
})
.catch(function (error) {
    console.error('Teleport SDK initialization error:', error);
});

// Optional: release Teleport resources when closing the page
window.addEventListener("unload", function () {
    if (tlprt) {
        tlprt.dispose();
        tlprt = null;
    }
});

Additional Configuration

For finer tuning of Teleport SDK behavior (e.g., URL cleaning, segment quality detection), refer to the Customization section.