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.