Menu

Lumen help

Lumen Mesh Delivery and CDN Load Balancer removal

Important: Before beginning the process of removing Mesh Delivery or CDN Load Balancer integration, we recommend deactivating the product on Streamroot dashboard by setting the activation ratio to 0.

For web

Step 1: Remove all Lumen libraries

When using CDN

Remove the sources in the HTML <head>

 

Example:

                <!-- Mesh Delivery wrapper -->
<script src="//cdn.streamroot.io/hlsjs-dna-wrapper/1/stable/hlsjs-dna-wrapper.js?srKey=YOUR_STREAMROOT_KEY"></script>

When using npm

Remove runtime and dev dependencies.

 

Example:

                npm install @streamroot/hlsjs-dna-wrapper

Delete the import/require of the package in your application.

 

Example:

                import HlsjsDnaWrapper from '@streamroot/hlsjs-dna-wrapper';

Step 2: Remove specific code in the HTML <body>

Remove anything related to Lumen libraries like player wrapping, “dnaConfig” or player recommended options.

 

Example:

                <video id="demoplayer"></video>
<script>
    var hlsjsConfig = {};
    var dnaConfig = {};
    var hls = new Hls(hlsjsConfig);
    var wrapper = new HlsjsDnaWrapper(hls, 'YOUR_STREAMROOT_KEY', dnaConfig);
    var video = document.getElementById('demoplayer');
    hls.loadSource('YOUR_PLAYLIST_URL');
    hls.attachMedia(video);
    hls.on(Hls.Events.MANIFEST_PARSED,function() {
        video.play();
    });
</script>

            
                                
var hlsjsConfig = {
   "maxBufferSize": 0,
   "maxBufferLength": 30,
   "liveSyncDuration": 30,
   "liveMaxLatencyDuration": Infinity
}

For Android & iOS/tvOS

Step 1: Remove all SDK dependencies

Remove all dependencies from Gradle dependencies or from Xcode Framework.

 

Example:

 

Android

 

In Settings.gradle

                dependencyResolutionManagement {
    repositories {
        maven { url 'https://sdk.streamroot.io/android' }
    }
}

In build.gradle  

                // It is good practice to lock dependencies version
def dc_version = "23.3.0"

implementation "io.streamroot.lumen.delivery.client:mesh-sdk:$dc_version"

 

iOS & tvOS

                target 'MyApp' do
  use_frameworks!
  pod 'LumenMeshSDK'
end

Step 2: Remove all specific project configurations

Android

 

Remove obfuscation in proguard

                -keep class io.streamroot.** { *; }
-dontwarn io.streamroot.lumen.**

Remove permissions in your AndroidManifest.xml  

                <uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Delete network security xml resource called network_security_config.xml

                <?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="false">127.0.0.1</domain>
    </domain-config>
</network-security-config>

and attribute in the application of your AndroidManifest.xml 

                <manifest ...>
    <application
        ...
        android:networkSecurityConfig="@xml/network_security_config">
    </application>
</manifest>

Remove the the multiDexEnabled true line in your app.gradle file 

 

Remove the key in your AndroidManifest.xml

                <meta-data
android:name="io.streamroot.lumen.delivery.client.DeliveryClientKey"
android:value="<delivery-client-key>"
/>

 

iOS and tvOS

 

Re-enable App Transport Security ("set to false"), it should currently be as shown below:

                <key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

Remove the key in the info.plist  

                <key>DeliveryClient</key>
<dict>
  <key>Key</key>
  <string><delivery-client-key></string>
</dict>

Step 3: Remove SDK integration code

Android

 

Remove anything linked to "LumenDeliveryClient" or "LumenDeliveryClientPlugin".

 

Example:

 

The SDK initialization in the application context subclass

                class Application: MultiDexApplication() {

    override fun onCreate() {
        super.onCreate()
        /* If you could not add your Delivery Client Key in your AndroidManifest.xml
         * Call instead: LumenDeliveryClient.initializeApp(this, "<delivery-client-key>")
         */
        LumenDeliveryClient.initializeApp(this)
        ...
    }
}

The SDK instantiation

                private fun createDeliveryClient(
    player: ExoPlayer,
    loadControl: DefaultLoadControl,
    bandwidthMeter: ExoPlayerBandwidthMeter
) : LumenDeliveryClient {
    val playerInteractor = PlayerInteractor(player, loadControl, bandwidthMeter)
    return LumenDeliveryClient.meshBuilder(this) //< applicationContext
            /*
             * Set the player interactor that will be used by the SDK
             * Check the bridge section to know more
             *
             * param: an instance of a class subclassing LumenPlayerInteractorBase.
             */
            .playerInteractor(playerInteractor)
            /*
             * Set the optional parameters (more details below)
             * NOTE: This is required even if empty
             */
            .options {}
            /*
             * Build a LumenDeliveryClient instance
             *
             * param: String. The video stream url
             */
            .build(manifestUrl)
}

The change to local URL

                deliveryClient.start()
val finalUrl = deliveryClient.localUrl()

            
                val mediaItem = MediaItem.fromUri(Uri.parse(finalUrl))

Also remove the PlayerInteractor class to completely de-integrate Mesh Delivery and CDN Load Balancer on android.

iOS & tvOS

 

Remove anything linked to "LMDeliveryClient" or "LMDeliveryClientPlugin".

 

Example:

 

The SDK initialization from the AppDelegate

                @main
class AppDelegate: UIResponder, UIApplicationDelegate {
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    /*
     * If you can not add your Delivery Client Key in Info.plist
     * Call instead: LMDeliveryClient.initializeApp(withDeliveryKey: "<delivery-client-key>")
     */
    LMDeliveryClient.initializeApp()
    ...
  }

  ...
}

The SDK instantiation

                func createDeliveryClient() -> LMDeliveryClient {
  return LMDeliveryClientBuilder.clientBuilder()
         /*
          * Set the player interactor to use
          * Check the bridge section to know more
          *
          * param: an instance of a class subclassing LMPlayerInteractorBase.
          */
         .playerInteractor(PlayerInteractor())
         /*
          * Build a LumenDeliveryClient instance
          *
          * param: String. The video stream url
          */
         .build(url)

The change to local URL

                var deliveryClient = createDeliveryClient()
deliveryClient.start();

guard let deliveryUrl = deliveryClient.localManifestURL else {
  fatalError("Local url manifest could not be generated")
}

let playerItem = AVPlayerItem(asset: AVURLAsset(url: deliveryUrl))

            
                let player = AVPlayer(playerItem: playerItem)
playerInteractor.linkPlayer(player!, playerItem: playerItem)