Kaltura MediaSpace Go (KMS Go) Mobile Application Admin Guide

Printer-friendly version
Audience / Tech Expertise: 

This guide is for KMS Go Mobile App for iOS and Android administrators.

The following topics are described:

Setup Instructions and Configuration

  1. In your KMS admin, enable the Kmsapi module. There is no need to turn off the native module that serves the old KMS app.
  2. If your app was Branded by Kaltura, make sure to:
    Modify the iOSAppId value, or the AndroidAppId, to the branded iOSAppId, or AndroidAppId,  after the app is published in the App Store or Google Play.
    Note that the iOSAppId is displayed in iTunes Connect after Publish.
  3. Configure the instance's mobile home playlists.
    NOTE – The mobile playlists are not the same as the web playlists. You must configure them here so they will appear in the app’s home screen.
  4. If you want the player to auto play, set accordingly here.
  5. If you want to modify the app color – update the values for appColorR/G/B with RGB color.
  6. If you choose to, you can add a custom splash image (2nd image that will appear after the Kaltura splash image), using the splashImageUrl field.
    Be certain that the custom splash image is HTTPS , or you won’t see it. 
  7. Note the download configuration (enabled, and which quality).
  8. Note that smart banner is enabled to all accounts by default. You may want to to set this to off while testing the generic app.
  9. Set the Authentication method in the Auth module in the Management Conosle.
    If you do not change it, you will not be able to log in.
    Go to Auth - SSLsettings - and change the setting. The minimum requirement is "Login Only".
  10. Click SAVE.

GO ahead and try it out!
Get the 
Kaltura Media Space GO app on the App Store, or Google Play Store and be certain that you are not downloading the legacy app.
Install, and GO!

Kmsapi Module

Configure the Kmsapi module to enable the KMS Go application on your mobile device.

For additional information about the KMS Go mobile app, see the articles about Kaltura MediaSpace Go (KMS Go) on the Knowledge Center.




Enable the Kmsapi Module.


The Apple Application ID that will be used when smart banners on iOS Safari will be displayed.


The bundle ID of the iOS app to use to open the smart banner link


The Android Application ID that will be used when smart banners on Android mobile browsers will be displayed.


The iOS/Andorid branded application subdomain. Used for deep-linking.


The name of the branded mobile application.


(iOS) Your app's App Store ID, used to send users to the App Store when the app isn't installed


The URL for the branded application logo. Image dimensions: 64x64 pixels. Keep empty to use default


Define the playlists for the native home screen. You can add and delete playlists using this field.


+Add Home_Playlists


Select the type of playlist from the drop down menu.


Enter the playlist name that will be displayed.


When entry page loads, should the video begin playing automatically?


The length of a mobile KMS user session (in seconds). Note that every KMS SaaS version deployment will force a new session (on top of the value input here).


The R value for RGB that is used as the custom brand color of the application. Input a number between 0-255. Note: RGB.alpha fields cannot be partially filled out.


The G value for RGB that is used as the custom brand color of the app. Input a number between 0-255. Note: RGB alpha fields cannot be partially filled out.


The B value for RGB that is used as the custom brand color of the app. Input a number between 0-255.

Note: RGB alpha fields cannot be partially filled out.


Set an image URL for the KMS app splash screen. Use an image size of 192x131. The URL must be a secured URL (begin with https://).


Enable to allow downloading media for offline viewing.


Chooses the rendition/flavor of the video to be available for users to download for offline playback. High will download the highest quality possible (in terms of dimensions and bitrate) and low the lowest.


Enable smart banner for Android and iOS applications


Don't show login button in my page.


Enable displaying the upload functionality


Enable displaying the list of channels the user is subscribed to, on top of the home screen.


Select whether the playlist entries should play automatically one after the other.


Allow push notifications.


KMS Go App Known Limitations

  1. The 'Sslsettings' field must be set to 'login' or 'all site' (cannot be 'none'). Set Sslsettingsin the KMS admin under Auth/sslsettings. This is due to Apple's requirement.
  2. The app cannot play the following entry types: Interactive Video Quiz.
  3. The player in the app cannot display Chapters and Slides. Please stay tuned for updates.
  4. For iPad users - The app can be used on an iPad, Note: it is an iPhone app (not a Universal app) when you search for it in the store. 
  5. Authentication:
  • All auththentication methods are supported, includeing Multi Auth.
  • For SAML authentication method - In order for the Identity Provider (IP) to clean the session on its side, you will need to configure the following settings on your MediaSpace instance SAML module:
    • logoutRedirectUrl – fill in the IP logout URL.
    • useInternalLogoutPage – Set to 'NO'. This configuration effects whether the users will be redirected to KMS web logout page or to an external one. Note: Currently SAML module configuration is shared between KMS WEB and KMS GO. Therefore, KMS Web will be effected from this setting as well.
      For more information on SAML settings for Kaltura MediaSpace see the Kaltura MediaSpace SAML Integration Guide.
  1. In Android, when configuring SSO via HTTP authentication, the user will not be able to log out after the initial log-in.
    This is due to an Android limitation.
    Work around: To log-out, the end user will either have to clear the app data via device settings, OR uninstall the app and re-install it again.
  2. Document type: 
    Product version: 
    (16071 reads)