MMS - Opening the Mirage app programmatically from Crestron

Owned by Michele Masiello
Jul 02, 2020
1 min read

You are able to call the Mirage app via the mirage:// handler. There are a few options you can pass. The port is optional and defaults to 5004. You can also leave the MMS Instance blank as long as you include the "/" before it and the "?callback=" after it. The IP address is required. For the callback url, insert whatever handler is appropriate for the app you'd like to return to.

mirage://<ip address>:<port>/<instance>?callback=<callback url>

Examples:

1.mirage://192.168.1.58:5004/Player_B?callback=


2.mirage://192.168.1.58/Player_B?callback=


3.mirage://192.168.1.58:5004/?callback=


4.mirage://192.168.1.58/?callback=


To switch back to the Crestron app from the Mirage app:

Crestron Mobile now has a registered URL scheme called "Crestron://"  Invoking this url on the iOS device will open Crestron Mobile if it is installed on the device.  For example, you could enter this URL in the Safari browser on the device and Crestron Mobile will open.  Also, any other application can use this URL to launch Crestron Mobile. 

To be able to navigate back to the app that launched Crestron Mobile, there is a Return to Launch App Reserved Join.  The format for the return to app string is as follows:

crestron://

  • ---------------------------------------------------------------------------------------------------------------------------------------------------------

The link below is a builder for the top instructions. You can enter your information and then copy the URL provided to the appropriate place in your integration.

http://autonomic-controls.com/documents/ios/tools/urlbuilder/