Overview

Goals

This article will give you an overview of how to integrate StriveCast eCDN into your Microsoft Teams environment for usage with Microsoft Teams live events and how you can verify your integration.

Requirements

  • Access to the StriveCast web portal

  • Access to your Microsoft Teams admin center

Who should use this document?

Developers, responsible for integrating the StriveCast eCDN Solution into their Microsoft Teams environment.

The integration process

Step

Description

Step 1 - Prepare an Integration

Create a configuration for your Microsoft Teams environment, you need to create a Integration in the StriveCast web portal.

Step 2 - Integrate in Microsoft Teams

Integrate the Deployment via the Microsoft Teams admin center.

Step 3 - Verify your integration

Use StriveCast’s debug mode and the web portal to verify the integration works properly.

Step 1 - Create an Integration Deployment

To get the Microsoft Teams configuration, you need to create a Deployment in the StriveCast web portal. A Deployment is a cloud object which contains two things:

  1. A set of configurations

  2. A generated JSON string referencing to a Javascript file containing the StriveCast eCDN

The JSON string will be integrated statically into your “StriveCast eCDN” integration.

When creating your Deployment, please make sure to:

  • Select “Microsoft Teams” as integration type

  • Set your Deployment’s status to “Online”

  • Enable the P2P module in the “P2P” tab of your Deployment

  • Enable the “Debug Mode” for further evaluation of your integration

  • Set the “Matching Policy” to “No Restrictions” for further evaluation of your integration

Please note: The settings above should only be used during testing. They are not designed for use in production.

After you created a Deployment, the generated JSON configuration string will be made available to you in the StriveCast web portal:

Step 2 - Integrate “eCDN for Microsoft Teams live events”

The StriveCast eCDN support is integrated via the Microsoft Teams admin center.
Once logged in, enter the Meetings / Live event settings section at the left side in the Microsoft Teams admin center.
Here, the following steps need to be tackled:

  1. Enable third-party video distribution provider.

  2. Select Ramp as SDN provider in the dropdown menu.

  3. Paste your integration code into the SDN configuration input field.

The integration code will be pre-rendered in the StriveCast web portal for each created Deployment and looks like the following:

{"verbose":true,"overlay":true,"extern":{"name":"StriveCast P2P","root":"striveCastMediaTracker","key":"_","title":"","url":{"src":"//amsglob0cdnstream14.azureedge.net/ramp/p2p/strive/3.7.0/pluginscript.min.js","root":"striveCastMediaTracker","method":"blob","blobPrefix":true,"prefix":"RampMOPlugin.s={a:\"<ACCOUNT-ID>\",d:\"<DEPLOYMENT-ID>\",m:null,mv:\"v0.24.0\",p:null,pv:\"v0.33.0\",v:undefined};RampMOPlugin.s.c=\"https://cdn.strivetech.io/services/storage/v0/entity-resource/\"+RampMOPlugin.s.a+\"/\"+RampMOPlugin.s.d+\"/strivecast-\";Object.defineProperty(window,\"0fc3d5d229c04855a952795091c2df81\",{get:function(){return RampMOPlugin.s.v;},set:function(v){var s=RampMOPlugin.s;if(!v||!v.configURL||v.configURL.indexOf(\".json\")<0){return;}if(v.configURL.indexOf(\"media-tracker\")!==-1){s.v=s.m={configURL:s.c+\"media-tracker-\"+s.mv+\".json\"};}if(v.configURL.indexOf(\"p2pdn-proxy\")!==-1){s.v=s.p={configURL:s.c+\"p2pdn-proxy-\"+s.pv+\".json\"};}},enumerable:true,configurable:true});"}}}
JSON

In order to get your Account ID and Deployment ID, please head to the Integration section of the StriveCast Web Portal and click on the specific Deployment you would like to implement.

Step 3 - Verify your integration

This step assumes you have configured your Deployment as described in Step 1. If not, please make sure to:

  • Set your Deployment’s status to “Online”

  • Enable the P2P module in the “P2P” tab of your Deployment

  • Enable the “Debug Mode” for further evaluation of your integration

  • Set the “Matching Policy” to “No Restrictions” for further evaluation of your integration

You can now create a Microsoft Teams Live Event and join as a viewer. The following window should appear on your screen:

Please note: The debug window will only be shown when joining the event via browser.
The Microsoft Teams app cannot load the external chart.

Each loaded video segment is represented by a single bar in the chart. The bar’s color indicates whether it has been delivered via P2P or via your video infrastructure. By opening multiple browser tabs or multiple browsers with the same URL, you can simulate multiple users and start the P2P mechanism. You should see the following behavior in the debug window:

  1. The first tab is open. Black bars start filling the chart (one user, no P2P).

  2. The second tab is open. One of the tabs starts showing blue bars instead of black bars (the second user joins and received content via P2P).

  3. Switching bar colors. You might experience bars to turn black and blue from time to time. You should see the exact same color pattern in reverse in the other browser tab. This means that StriveCast decides which user should be the P2P sender and receiver. This decision is made on a per-segment basis. Seeing the color switching between one another is expected behavior and shows that both peers have excellent connectivity.

  4. Orange bar colors. You might experience bars appearing in orange color. This means that the video segment was expected to be delivered by P2P but did not arrive in time and was fetched via your video infrastructure. This fallback mechanism activates in case of bad connectivity between peers and indicates that the P2P connection between two users is not strong enough to support video delivery. In this case, please verify that regardless of the orange bars, the video is still running smoothly.

Frequently asked questions

  • The Debug Window is not displayed
    The debug window will only be shown when joining via browser.
    Please check that Debug mode is checked in the deployment configuration.

  • What other integrations do you provide?
    StriveCast offers out-of-the-box integration with most enterprise video platforms. For a full list, please visit this page: Supported Video Platforms

Contact us

For any further questions or problems, please open a ticket at the StriveCast Help Center.