Launcher¶
com.connectsdk.service.capability.Launcher
extends CapabilityMethods
The Launcher capability protocol serves to define the methods required for normalizing the launching of apps. It allows for in-built support for certain common launch types (deep-linking to YouTube, Netflix, Hulu, browser, etc) as well as by (platform-specific) app id.
Properties¶
final String Any = “Launcher.Any”
final String Application = “Launcher.App”
final String Application_Params = “Launcher.App.Params”
final String Application_Close = “Launcher.App.Close”
final String Application_List = “Launcher.App.List”
final String Browser = “Launcher.Browser”
final String Browser_Params = “Launcher.Browser.Params”
final String Hulu = “Launcher.Hulu”
final String Hulu_Params = “Launcher.Hulu.Params”
final String Netflix = “Launcher.Netflix”
final String Netflix_Params = “Launcher.Netflix.Params”
final String YouTube = “Launcher.YouTube”
final String YouTube_Params = “Launcher.YouTube.Params”
final String AppStore = “Launcher.AppStore”
final String AppStore_Params = “Launcher.AppStore.Params”
final String AppState = “Launcher.AppState”
final String AppState_Subscribe = “Launcher.AppState.Subscribe”
final String RunningApp = “Launcher.RunningApp”
final String RunningApp_Subscribe = “Launcher.RunningApp.Subscribe”
final String[] Capabilities = { Application, Application_Params, Application_Close, Application_List, Browser, Browser_Params, Hulu, Hulu_Params, Netflix, Netflix_Params, YouTube, YouTube_Params, AppStore, AppStore_Params, AppState, AppState_Subscribe, RunningApp, RunningApp_Subscribe }
Inner Classes¶
Methods¶
Launcher getLauncher ()
CapabilityPriorityLevel getLauncherCapabilityLevel ()
- void launchAppWithInfo (AppInfo appInfo, AppLaunchListener listener)
Launch an application on the device.
Related capabilities:
Launcher.App
Launcher.App.Params
– if launching with params
Parameters:
- appInfo – AppInfo object for the application
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchAppWithInfo (AppInfo appInfo, Object params, AppLaunchListener listener)
Launch an application on the device.
Related capabilities:
Launcher.App
Launcher.App.Params
– if launching with params
Parameters:
- appInfo – AppInfo object for the application
- params
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchApp (String appId, AppLaunchListener listener)
Launch an application on the device.
Related capabilities:
Launcher.App
Parameters:
- appId – ID of the application
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void closeApp (LaunchSession launchSession, ResponseListener <Object> listener)
Close an application on the device.
Related capabilities:
Launcher.App.Close
Parameters:
- launchSession – LaunchSession of the target app
- listener – (optional) ResponseListener< Object > with methods to be called on success or failure
- void getAppList (AppListListener listener)
Gets a list of all apps installed on the device.
Related capabilities:
Launcher.App.List
Parameters:
- listener – (optional) AppListListener with methods to be called on success or failure
- void getRunningApp (AppInfoListener listener)
Gets an AppInfo object for the current running app on the device.
Related capabilities:
Launcher.RunningApp
Parameters:
- listener – (optional) AppInfoListener with methods to be called on success or failure
- ServiceSubscription <AppInfoListener> subscribeRunningApp (AppInfoListener listener)
Subscribes to changes of the current running app. Every time the running app changes, the success block will be called with an AppInfo object for the current running app.
Related capabilities:
Launcher.RunningApp.Subscribe
Parameters:
- listener – (optional) AppInfoListener with methods to be called on success or failure
- void getAppState (LaunchSession launchSession, AppStateListener listener)
Gets the target app’s running status and on-screen visibility.
Related capabilities:
Launcher.AppState
Parameters:
- launchSession – LaunchSession of the target app
- listener – (optional) AppStateListener with methods to be called on success or failure
- ServiceSubscription <AppStateListener> subscribeAppState (LaunchSession launchSession, AppStateListener listener)
Subscribes to changes of the state of the target app. Every time the app’s state changes, the success block will be called with info on the app’s running status and on-screen visibility.
Related capabilities:
Launcher.AppState.Subscribe
Parameters:
- launchSession - LaunchSession of the target app
- listener – (optional) AppStateListener with methods to be called on success or failure
- void launchBrowser (String url, AppLaunchListener listener)
Launch the web browser. Will launch deep-linked to provided URL, if supported on the target platform.
Related capabilities:
Launcher.Browser
Launcher.Browser.Params
– if launching with url
Parameters:
- url
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchYouTube (String contentId, AppLaunchListener listener)
Launch YouTube app. Will launch deep-linked to provided contentId, if supported on the target platform.
Related capabilities:
Launcher.YouTube
Launcher.YouTube.Params
– if launching with contentId
Parameters:
- contentId – Video id to open
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchYouTube (String contentId, float startTime, AppLaunchListener listener)
Launch YouTube app. Will launch deep-linked to provided contentId, if supported on the target platform.
Related capabilities:
Launcher.YouTube
Launcher.YouTube.Params
– if launching with contentId
Parameters:
- contentId – Video id to open
- startTime
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchNetflix (String contentId, AppLaunchListener listener)
Launch Netflix app. Will launch deep-linked to provided contentId, if supported on the target platform.
Related capabilities:
Launcher.Netflix
Launcher.Netflix.Params
– if launching with contentId
Parameters:
- contentId – Video id to open
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchHulu (String contentId, AppLaunchListener listener)
Launch Hulu app. Will launch deep-linked to provided contentId, if supported on the target platform.
Related capabilities:
Launcher.Hulu
Launcher.Hulu.Params
– if launching with contentId
Parameters:
- contentId – Video id to open
- listener – (optional) AppLaunchListener with methods to be called on success or failure
- void launchAppStore (String appId, AppLaunchListener listener)
Launch the device’s app store app, optionally deep-linked to a specific app’s page.
Related capabilities:
Launcher.AppStore
Launcher.AppStore.Params
Parameters:
- appId – (optional) ID of the application to show in the app store
- listener – (optional) AppLaunchListener with methods to be called on success or failure