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.
    NOTE THE DEFAULT AUTHENTICATION METHOD IS SET TO NONE. 
    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 this 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.

 

Field

Description

enabled

Enable the Kmsapi module.

iOSAppId

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

AndroidAppId

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

Home_Playlists

Define the playlists (custom or pre-configured) for the native home screen. You can add and delete playlists using this field. You can set a different playlist than your web browser view.

DELETE or

+Add Home_Playlists

type

Select the type of playlist from the drop down menu.

Name

Enter the playlist name that will be displayed.

playerAutoPlayOnLoad

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

mobileSessionLifeTime

The length of a mobile KMS user session (in seconds). Each KMS SaaS version deployment will force a new session (on top of the value input here). You can have a 'Persistent Cookie' configuration so that users will not have to log in. Contact your Kaltura represetative for that setup.

appColorR

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.

appColorG

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.

appColorB

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.

splashImageUrl

Set an image URL for the KMS Go App splash screen. Use an image size of 192x131. The URL must be a secured URL (begin with https://). You can set 1 out of 2 Splash screens the app presents when it loads.

Note: you need to input the URL value of an image (size of 192x131) and begin with https://

downloadEnabled

Enable to allow downloading media for offline viewing.

downloadQuality

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.

smartBannerEnabled

Enable smart banner for Android and iOS applications.

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, Webcast, Live.
  3. The iOS app uses the Apple native player and not Kaltura's Player SDK, and customizations are not possible on the Apple player. Please stay tuned for updates on upcoming Kaltura Player implementation.
  4. The player in the app cannot display Chapters,Slides, or Captions. Please stay tuned for updates on upcoming Kaltura Player implementation.
  5. 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. 
  6. Authentication:
  • All auththentication methods are supported.
  • 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: 
    (3980 reads)