P2P Media Loader - Shaka Player integration
P2P sharing of segmented media streams (i.e. HLS, DASH) using WebRTC for Shaka Player
Useful links:
Basic usage
General steps are:
- Include P2P Medial Loader scripts.
- Create P2P Medial Loader engine instance.
- Create a player instance.
- Call init function for the player.
<!DOCTYPE html>
<html lang="en">
<head>
<title>Shaka Player with P2P Media Loader</title>
<meta charset="utf-8">
<script src="https://cdn.jsdelivr.net/npm/p2p-media-loader-core@latest/build/p2p-media-loader-core.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/p2p-media-loader-shaka@latest/build/p2p-media-loader-shaka.min.js"></script>
<script src="https://github.com/videojs/mux.js/releases/download/v4.4.0/mux.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/shaka-player/2.4.4/shaka-player.compiled.js"></script>
</head>
<body>
<video id="video" width="640" controls autoplay muted></video>
<script>
shaka.polyfill.installAll();
if (shaka.Player.isBrowserSupported() && p2pml.shaka.Engine.isSupported()) {
function onError(error) { console.error("Error code", error.code, "object", error); }
var engine = new p2pml.shaka.Engine();
var player = new shaka.Player(document.getElementById("video"));
player.addEventListener("error", function(event) { onError(event.detail); });
engine.initShakaPlayer(player);
player.load("https://akamai-axtest.akamaized.net/routes/lapd-v1-acceptance/www_c4/Manifest.mpd").catch(onError);
} else {
document.write("Not supported :(");
}
</script>
</body>
</html>
API
The library uses window.p2pml.shaka
as a root namespace in Web browser for:
Engine
- Shaka Player support engineversion
- API version
Engine
Shaka Player support engine.
Engine.isSupported()
Returns result from p2pml.core.HybridLoader.isSupported()
.
engine = new Engine([settings])
Creates a new Engine
instance.
settings
structure:
segments
forwardSegmentCount
- Number of segments for building up predicted forward segments sequence; used to predownload and share via P2P. Default is 20;maxHistorySegments
- Maximum amount of requested segments manager should remember; used to build up sequence with correct priorities for P2P sharing. Default is 50;swarmId
- Override default swarm ID that is used to identify unique media stream with trackers (manifest URL without query parameters is used as the swarm ID if the parameter is not specified);
loader
engine.getSettings()
Returns engine instance settings.
engine.destroy()
Destroys engine; destroy loader and segment manager.
engine.initShakaPlayer(player)
Shaka Player integration.
player
should be valid Shaka Player instance.
Example
shaka.polyfill.installAll();
var engine = new p2pml.shaka.Engine();
var video = document.getElementById("video");
var player = new shaka.Player(video);
engine.initShakaPlayer(player);
player.load("https://example.com/path/to/your/dash.mpd");