Indigo Touch URLs

iOS Apps can enable URL schemes so that a URL can launch a specific app. Indigo Touch registers the indigo: handler (as well as the aliases indigodomo: and indigocontrol: in Indigo Touch v2.1.1+) when installed on an iOS device such that when the URL is opened (for instance, in Safari) it will go directly to specific control pages when Indigo Touch launches.

Below is a list of URLs that are supported by Indigo Touch:

URL Comments
  indigodomo://controlpage/_internal_control_pages_ Shows the Control Pages list
  indigodomo://controlpage/master%20bedroom Shows the control page named “master bedroom” (note that spaces are substituted with %20 like in any URL). Any of your custom control pages may be specified.

Viewing Options

hideNavBar

Use the hideNavBar option to hide the navigation bar and status bar on the page being shown. It can be added to the end of the url like this:

  indigodomo://controlpage/master%20bedroom?hideNavBar=1

The default is hideNavBar=0 (don't hide the nav bar) but if you want it hidden you can specify it as above. Note you should only hide the navigation (and status) bar if you have manually added controls/buttons to your control page for navigation – the Control Page editor let's you create control click actions for navigating to different pages and navigating to the previous page.

viewUntilQuit (added in v2.0 with server v6.1+)

By default Control Pages are shown temporarily and switching away from Indigo Touch (to another app or the home screen) and back will restore Indigo Touch to its previous state before the control page URL request was made. Use the viewUntilQuit option to override this behavior and not restore the previous view state. In this mode the only way to restore Indigo Touch to its previous view state is to quit the application (double-touch home, then flick the Indigo Touch app up) and relaunch it.

This option can be added to the end of the url like this:

  indigodomo://controlpage/master%20bedroom?viewUntilQuit=1

The default is viewUntilQuit=0 (restores Indigo Touch state when switched out and back).

Note that both options can be combined together:

  indigodomo://controlpage/master%20bedroom?hideNavBar=1&viewUntilQuit=1

indigo_touch_urls.txt · Last modified: 2017/09/02 05:01 by mattb
 

© Perceptive Automation, LLC. · Privacy