Difference between revisions of "HSYCO App for iOS Devices"

From HSYCO
Jump to navigation Jump to search
(36 intermediate revisions by 2 users not shown)
Line 1: Line 1:
HSYCO Remote is an iOS application for iPhone, iPad and iPod touch that lets you easily connect to your HSYCO Server, in a more convenient way than traditional Web-based access.
+
{{Two Images on right|tw=340|m=5|w1=150|i1=HSYCO_iOS_Menu.png|l1=Right menu|w2=150|i2=HSYCO_iOS_FavPages.png|l2=Favorite pages}}
  
HSYCO Remote can use Touch ID for authentication, and handles your PIN/PUK credentials automatically in the background.
 
  
HSYCO Remote allows you to define your favourite interfaces and to quickly switch between them. It also supports rotation lock and kiosk mode.
+
HSYCO App is an iOS application for iPhone, iPad and iPod touch that lets you easily connect to your HSYCO Server, in a more convenient way than traditional Web-based access.
  
HSYCO Remote also offers Apple Watch support, so you can send any command to your HSYCO Server using your Apple Watch. And if you have multiple HSYCO Servers, a simple swipe on Apple Watch will immediately switch from one server to another.
+
HSYCO App can use Touch ID for authentication, and handles your PIN/PUK credentials automatically in the background.
 +
 
 +
HSYCO App allows you to define your favourite connections and quickly switch between them. It also supports rotation lock and kiosk mode.
 +
 
 +
HSYCO App also offers Apple Watch support, so you can send any command to your HSYCO Server using your Apple Watch. And if you have multiple HSYCO Servers, a simple swipe on Apple Watch will immediately switch from one server to another.
 +
 
 +
 
 +
{{note|<center>HSYCO App requires iOS 9.3 or later, and HSYCO Server 3.6.0.</center>}}
 +
 
 +
 
 +
{{Clear}}
 +
To download the HSYCO App, go to your Apple App Store and enter HSYCO in the search box, or click the App Store badge below.
 +
 
 +
 
 +
<center>[[File:Download_on_the_App_Store_Badge_US-UK_135x40.png|135x40px|link=https://itunes.apple.com/app/hsyco/id1038105480]]</center>
  
  
Line 11: Line 24:
 
==Configuring a connection==
 
==Configuring a connection==
  
In the Connections page, press Edit, then + at the bottom, or select an existing connection to edit.
+
{{Two Images on right|tw=340|m=5|w1=150|i1=HSYCO_iOS_Connections_edit.png|l1=Connection list|w2=150|i2=HSYCO_iOS_Connections.png|l2=Editing the connection list}}
  
Enter a name for the connection (connections are listed in alphabetical order by name) and the URL to access your project on your HSYCO server.
+
The first time the app is opened, it will automatically add a new connection and show its configuration page.
 +
The connection can be edited from the Connections page, by pressing the Edit button and selecting the connection. From the edit mode it's also possible to add more connections, clicking on Add Connection or the + icon on the bottom.
 +
 
 +
{{Two Images on right|tw=340|m=5|w1=150|i1=HSYCO_iOS_Connection_edit_1.png|l1=Connection settings|w2=150|i2=HSYCO_iOS_Connection_edit_2.png|l2=More settings}}
 +
 
 +
Enter a name for the connection and the URL to access your project on your HSYCO server.
  
 
If you have a default project on your server, and use a standard port for the HTTPS connection, you can simply enter the DNS name for your server, without the URL key and project name.
 
If you have a default project on your server, and use a standard port for the HTTPS connection, you can simply enter the DNS name for your server, without the URL key and project name.
  
Enable the Remember PIN option to automatically save your PIN and PUK after the initial validation.
+
At the moment, to enable HTML5 cache the certificate needs to be downloaded and installed on the device.
  
The Kiosk Mode option enables HSYCO’s kiosk mode, while Lock Rotation prevents rotation and switch between portrait and landscape pages in the project.
+
Enable the '''Remember PIN/PUK''' option to automatically save your PIN and PUK after the initial validation.
 +
This is required to use the Apple Watch interface.
  
Enable the Favorite option if you want to have this connection in the Favorites list of the main Menu page.
+
The '''Kiosk Mode''' option enables HSYCO’s kiosk mode.
  
If your server has a self-generated SSL certificate for HTTPS encryption, you should download and install the server’s certificate in your iOS device profiles, otherwise HSYCO Remote will not be able to establish the connection with the server. Press Download Certificate at the bottom of the page. Safari will open and let you download, accept and install the server’s certificate. Only after the certificate is installed you will be able to use the connection you have configured in HSYCO Remote.
+
Enable the '''Favorite''' option if you want to have this connection directly accessible from the left menu and from iOS home when using force touch (if your device supports it).
  
 +
'''Lock Rotation''' prevents changes in the screen's orientation when rotating the device, locking it in the selected value.
  
[[File:Hsyco_remote_ios_connections.png|200px|border]]  [[File:Hsyco_remote_ios_connection_edit.png|200px| border]]
+
{{Clear}}
 +
 
 +
 
 +
{{Two Images on right|tw=340|m=5|w1=150|i1=HSYCO_iOS_Connection_scale.png|l1=Edit Connection list|w2=150|i2=HSYCO_iOS_Connection_certificate.png|l2=Certificate pinning}}
 +
 
 +
Selecting a language for the '''Speech''' option, enables speech input on the connection. Speech is recognized and sent as a command to the server.
 +
Speech recognition is available from iOS 10.
 +
 
 +
 
 +
The '''Scale''' option resizes the interface to fill the screen.
 +
 
 +
If your server has an SSL certificate for HTTPS encryption, the first time you open the connection a prompt will be shown to allow you to accept the certificate and save it within the app. This prompt will appear again if the certificate changes, serving as a protection against “Man in the Middle” (MiTM) attacks.
 +
 
 +
{{Clear}}
  
 
==Settings==
 
==Settings==
  
In Settings you can enable the Ask Password option to set a password, and optionally use Touch ID, to protect access to HSYCO Remote.
+
{{Two Images on right|tw=340|m=5|w1=150|i1=HSYCO_App_Settings_1.png|l1=Settings list|w2=150|i2=HSYCO_App_Settings_2.png|l2=Ask password}}
 +
 
 +
In Settings you can enable the Ask Password option to set a password, and optionally use Touch ID, to protect access to the HSYCO App.
  
Once a password has been set, you can enable Touch ID, and set the Lock on Exit and Auto-Lock options.
+
Once a password has been set, you can enable '''Touch ID''', and set the '''Lock on Exit''' and '''Auto-Lock''' options.
  
When in landscape mode, you can hide the header by disabling the Header in Landscape Mode option. This option is disabled by default on the iPhone, and enabled on iPad.
+
Press '''Clear Cache''' if you want to clear the cache for all the connections.
  
Press Clear Cache if you want to clear all connections cache.
+
Reset Settings is used to reset all settings of HSYCO app, wiping out also the connections.
  
Reset Settings is used to reset all settings of HSYCO Remote.
+
If '''Hide Status Bar in Portrait''' is enabled, the app's top status bar (displaying time, battery and signal indicators) will be hidden in portrait mode (it's always hidden in landscape mode).
  
 +
When in landscape orientation, you can hide the header by enabling the '''Hide Navigation Bar in Landscape''' option.
  
[[File:Hsyco_remote_ios_settings1.png|200px|border]]  [[File:Hsyco_remote_ios_settings2.png|200px|border]]
+
If an Apple Watch is paired, two additional options will be available: one to reduce button feedback (sound and vibration when pressing buttons) and one to reset its configuration. Once Reset Apple Watch is pressed, to see the connection page you need to open the connection again from the app.
 +
{{Clear}}
  
 
==Apple Watch==
 
==Apple Watch==
 +
{{Two Images on right|tw=340|m=5|w1=150|i1=HSYCO_iOS_Watch_1.png|l1=Watch Page|w2=150|i2=HSYCO_iOS_Watch_2.png|l2=Camera example}}
  
 
If one or more of your connections are associated with HSYCO projects configured with Apple Watch menus, you will automatically have them configured in the Apple Watch.
 
If one or more of your connections are associated with HSYCO projects configured with Apple Watch menus, you will automatically have them configured in the Apple Watch.
  
 
If you change the Apple Watch menu in any project on HSYCO Server, simply open the corresponding connection in HSYCO Remote to load the new version. After this, next time you open HSYCO Remote on your Apple Watch, it will automatically show the updated command menu.
 
If you change the Apple Watch menu in any project on HSYCO Server, simply open the corresponding connection in HSYCO Remote to load the new version. After this, next time you open HSYCO Remote on your Apple Watch, it will automatically show the updated command menu.
 +
 +
You can create an Apple Watch page for a project:
 +
* visually, with the [[Project_Editor#Page_Types|Project Editor]], creating a page of type "watch page". For more information about it, see the [[Apple_Watch_Interface|Apple Watch Interface documentation]]
 +
* through a project's UISet to set the [[Project#Apple_Watch_support.2C_the_app_watch_attribute|app_watch]] attribute

Revision as of 17:49, 10 May 2018

Right menu
Right menu
Favorite pages
Favorite pages


HSYCO App is an iOS application for iPhone, iPad and iPod touch that lets you easily connect to your HSYCO Server, in a more convenient way than traditional Web-based access.

HSYCO App can use Touch ID for authentication, and handles your PIN/PUK credentials automatically in the background.

HSYCO App allows you to define your favourite connections and quickly switch between them. It also supports rotation lock and kiosk mode.

HSYCO App also offers Apple Watch support, so you can send any command to your HSYCO Server using your Apple Watch. And if you have multiple HSYCO Servers, a simple swipe on Apple Watch will immediately switch from one server to another.


HSYCO App requires iOS 9.3 or later, and HSYCO Server 3.6.0.


To download the HSYCO App, go to your Apple App Store and enter HSYCO in the search box, or click the App Store badge below.


Download on the App Store Badge US-UK 135x40.png


Configuring a connection

Connection list
Connection list
Editing the connection list
Editing the connection list

The first time the app is opened, it will automatically add a new connection and show its configuration page. The connection can be edited from the Connections page, by pressing the Edit button and selecting the connection. From the edit mode it's also possible to add more connections, clicking on Add Connection or the + icon on the bottom.

Connection settings
Connection settings
More settings
More settings

Enter a name for the connection and the URL to access your project on your HSYCO server.

If you have a default project on your server, and use a standard port for the HTTPS connection, you can simply enter the DNS name for your server, without the URL key and project name.

At the moment, to enable HTML5 cache the certificate needs to be downloaded and installed on the device.

Enable the Remember PIN/PUK option to automatically save your PIN and PUK after the initial validation. This is required to use the Apple Watch interface.

The Kiosk Mode option enables HSYCO’s kiosk mode.

Enable the Favorite option if you want to have this connection directly accessible from the left menu and from iOS home when using force touch (if your device supports it).

Lock Rotation prevents changes in the screen's orientation when rotating the device, locking it in the selected value.


Edit Connection list
Edit Connection list
Certificate pinning
Certificate pinning

Selecting a language for the Speech option, enables speech input on the connection. Speech is recognized and sent as a command to the server. Speech recognition is available from iOS 10.


The Scale option resizes the interface to fill the screen.

If your server has an SSL certificate for HTTPS encryption, the first time you open the connection a prompt will be shown to allow you to accept the certificate and save it within the app. This prompt will appear again if the certificate changes, serving as a protection against “Man in the Middle” (MiTM) attacks.

Settings

Settings list
Settings list
Ask password
Ask password

In Settings you can enable the Ask Password option to set a password, and optionally use Touch ID, to protect access to the HSYCO App.

Once a password has been set, you can enable Touch ID, and set the Lock on Exit and Auto-Lock options.

Press Clear Cache if you want to clear the cache for all the connections.

Reset Settings is used to reset all settings of HSYCO app, wiping out also the connections.

If Hide Status Bar in Portrait is enabled, the app's top status bar (displaying time, battery and signal indicators) will be hidden in portrait mode (it's always hidden in landscape mode).

When in landscape orientation, you can hide the header by enabling the Hide Navigation Bar in Landscape option.

If an Apple Watch is paired, two additional options will be available: one to reduce button feedback (sound and vibration when pressing buttons) and one to reset its configuration. Once Reset Apple Watch is pressed, to see the connection page you need to open the connection again from the app.

Apple Watch

Watch Page
Watch Page
Camera example
Camera example

If one or more of your connections are associated with HSYCO projects configured with Apple Watch menus, you will automatically have them configured in the Apple Watch.

If you change the Apple Watch menu in any project on HSYCO Server, simply open the corresponding connection in HSYCO Remote to load the new version. After this, next time you open HSYCO Remote on your Apple Watch, it will automatically show the updated command menu.

You can create an Apple Watch page for a project: