====== Web Apps: Assist App ======

<WRAP center round info 80%>
**Note**\\  Assist App requires at least one [[https://dhd.audio/product/528512/|52-8512 Assist App license]] in your core device. See [[licensing:start|Licensing]] for details on how to enter licenses to the device.
</WRAP>

<WRAP center round important 80%>
**Important**\\  Assist App in the Web requires a recent browser. DHD recommends using one of the recommended browsers with at least the tested version as listed in [[#recommended_browsers|Recommended Browsers]]. 
</WRAP>

<WRAP center round info 80%>
**Note**\\  Assist App supports RX2, SX2 and 52/TX surfaces.
</WRAP>

<WRAP center round tip 80%>
**Tip**\\  Assist App is fully optimized for multi touch and mobile devices.
</WRAP>


===== Toolbox configuration =====

See [[webapps:toolbox|]].

===== Using Assist App =====

When the configuration is done, you can visit the Web Apps page of the DHD core.

  - Open your web browser. See [[installation:system_requirements#dhd_web_apps_aes67_ravenna_interface_web_frontend|System Requirements for DHD Software]] for a list of recommended browsers.
  - Enter the IP address of your core: <code>http://[IP of core deivce]</code> Example: <code>http://10.5.12.123/</code> The Web Apps interface starts.
  - Click ''Assist'' app icon. If:
    - You have only one console configured for using it with assist app in the web, the console will open directly
    - You have more than one console configured for using it with assist app in the web, a list of available consoles will show up
    - You have password protection / authentification enabled, log in first. See [[#user_authentication|user authentication]].

<WRAP center round info 80%>
**Note**\\   If the screen remains blank or you see ''No License Available (use system app to check license)'', check if you have a valid license and it's not already taken. 
</WRAP>

<WRAP center round info 80%>
**Note**\\  One open connection via web browser requires one 52-8512 Assist App license.
</WRAP>

[{{ :webapps:assist-tx.png?1000&nolink |//A 52/TX console in Assist App//}}]

==== Scaling Buttons ====

The scaling buttons can help fitting the console to individual screens for better overview or control.

Use left {{:webapps:assist-shrink.png?50&nolink|}} button to display the whole console width on your screen and get a better overview of the whole console.

[{{ :webapps:assist-screenshot-shrink.png?1000&nolink |//Assist App, shrinked display for better overview//}}]

Use right {{:webapps:assist-expand.png?50&nolink|}} button to expand the console to the maximum available height on your screen and make control of elements more easy and accessible. 

<WRAP center round tip 80%>
**Tip**\\  Horizontal scrolling is available on most computers while pressing and holding ''Shift'' key while scrolling with the mouse wheel.
</WRAP>

[{{ :webapps:assist-screenshot-expand.png?1000&nolink |//Assist App, expanded display for easy control//}}]


<WRAP center round tip 80%>
**Tip**\\  You can use the browser's integrated zoom. This will inactivate the scaling buttons and result in ''Broser zoom is active, Console-Zoom deactivated'' message. Use them to restore correct fit again.
</WRAP>

===== Basic URL parameters =====

<WRAP center round important 80%>
**Important**\\  URL parameters are in ongoing development and may be subject to change in later versions without notice.
</WRAP>

==== Open a View directly ====

View URLs follow always the same scheme:

<code>http://[Core-IP]/#/views/[ModuleID]</code>

Example:

<code>http://10.5.12.123/#/views/5</code>

You can use this URL scheme to call a view directly.

==== Stand-alone Mode ====

You can open a view without the menu frame for stand-alone solutions, e.g. an info display or door panel. Usage:

<code>http://[Core-IP]/#/views/[ModuleID]?standalone=1</code>

**Use this call only in an empty tab or browser window.**

==== Automatic login with user token ====

You can login a user directly, e.g. for stand-alone solutions using his user token. See [[webapps:toolbox#user_authentication|Toolbox setup & user management]].


==== Combining multiple arguments ====

You can combine multiple arguments. Use ''&'' to separate them. Example:

<code>http://[Core-IP]/#/views/[ModuleID]?standalone=1&token=1234-1234-1234</code>

===== Recommended Browsers =====

Assist App requires a recent Browser. Please see [[installation:system_requirements#dhd_web_apps_aes67_ravenna_interface_web_frontend|System Requirements for DHD Software]] for a list of tested browsers.