Theta P2P Javascript SDK
Here are instructions for integrating Theta P2P with any HLS.js compatible video player. Below examples are using video.js and hls.js as a video player solution, and can serve as a guide for integrating into custom players.
To integrate Theta into your video.js powered player, simply include the theta scripts and setup the options for your video.js player as shown below. You can also check here for a full integration example.
1. Include scripts
Enter the following script tags in your head
tag. Ensure HLS.js is included before the theta-hls-plugin.
<script src='https://vjs.zencdn.net/7.15.4/video.js'></script>
<script src="https://cdn.jsdelivr.net/npm/[email protected]"></script>
<script src="https://d1ktbyo67sh8fw.cloudfront.net/js/theta.umd.min.js"></script>
<script src="https://d1ktbyo67sh8fw.cloudfront.net/js/theta-hls-plugin.umd.min.js"></script>
<script src="https://d1ktbyo67sh8fw.cloudfront.net/js/videojs-theta-plugin.min.js"></script>
2. Setup video.js options
<body>
play video boii {{.}}
<video id="my-player" controls></video>
</body>
<script>
const optionalHlsOpts = null;
const optionalThetaOpts = {
allowRangeRequests: true, // false if cdn does not support range headers
};
const player = window.player = videojs('my-player', {
techOrder: ["theta_hlsjs", "html5"],
sources: [{
src: "YOUR_VIDEO_URL",
type: "application/vnd.apple.mpegurl",
label: "1080p"
}],
theta_hlsjs: {
videoId: "YOUR_INTERNAL_VIDEO_ID",
userId: "YOUR_AUTHED_USER_ID (optional)",
onThetaReady: null, // optional listener
onStreamReady: null, // optional listener
hlsOpts: optionalHlsOpts,
thetaOpts: optionalThetaOpts,
}
});
</script>
All set! Now your web clients should start to peer with each other and share video streams to offload the CDN bandwidth. For more controls for the Theta lib, e.g. turning off the p2p feature, please refer to the 4. Additional Controls section.
3. Theta Blockchain Micro-Payment Integration (Optional)
Theta Wallet token generator
To allow authenticated users to earn TFUEL in your application, your backend needs to generate a Theta Wallet access token. Please implement a function which will call your backend to generate a new access token for the user's Theta Wallet.
async function getWalletAccessToken() {
//Check if a user is logged in...
let isAuthenticated = true;
if (!isAuthenticated) {
//No user is logged in, no wallet will be used
return null;
}
//This API should check the user's auth
let body = await yourAPIRequestToGenerateThetaWalletAccessTokenForAuthedUser();
//Return the access token from the request body
return body.access_token;
}
Note: If you do not have a secret key to generate a Theta Wallet access token, please contact your Theta rep for access.
Setup video.js options
In the video.js options, add the walletUrl
and onWalletAccessToken
attributes as shown below to configure the TFUEL wallet for the user.
<script>
const optionalHlsOpts = null;
const optionalThetaOpts = {
allowRangeRequests: true, // false if cdn does not support range headers
};
const player = window.player = videojs('my-player', {
techOrder: ["theta_hlsjs", "html5"],
sources: [{
src: "YOUR_VIDEO_URL",
type: "application/vnd.apple.mpegurl",
label: "1080p"
}],
theta_hlsjs: {
videoId: "YOUR_INTERNAL_VIDEO_ID",
userId: "YOUR_AUTHED_USER_ID (optional)",
walletUrl: "wss://api-wallet-service.thetatoken.org/theta/ws",
onWalletAccessToken: getWalletAccessToken,
onThetaReady: null, // optional listener
onStreamReady: null, // optional listener
hlsOpts: optionalHlsOpts,
thetaOpts: optionalThetaOpts,
}
});
</script>
4. Additional Controls (Optional)
Toggle CDN Only
Sometimes you want to only allow CDN (user pref, etc). This code will enable or disable CDN only mode.
player.tech_.trigger('toggleUseCDN');
Updated 9 months ago