Difference between revisions of "HSYCO App for iOS Devices"

From HSYCO
Jump to navigation Jump to search
Line 40: Line 40:
  
 
The first time the app is opened, it will automatically add a new connection and show its configuration page.
 
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.
+
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, or change the connections' order by dragging vertically the right-most icon.
  
 
{{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}}
 
{{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.
+
A connection has the following fields:
 
+
* '''Name''': the name that will be displayed.
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.
+
* '''URL''': 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.
 
+
* '''Remember PIN/PUK''': if on, it will store the connection's PIN and PUK the first time they're correctly entered. It will then show a "Forget PIN/PUK" option. It has to be enabled to use the Apple Watch interface.
At the moment, to enable HTML5 cache the certificate needs to be downloaded and installed on the device.
+
* '''Kiosk Mode''': enables the [[Project#Kiosk|Kiosk Mode]], which removes some elements in the project's interface
 
+
* '''Favorite''': if enabled, it will show the connection in the left menu of the app, or in the Home Screen Quick Actions popup that appears when you long-press the app icon.
Enable the '''Remember PIN/PUK''' option to automatically save your PIN and PUK after the initial validation.
+
* '''Lock Rotation''': lock the interface in portrait or landscape mode, ignoring the device's orientation
This is required to use the Apple Watch interface.
+
* '''Scale''': set the interface [[Project#Scale|scale mode]].
 
+
* '''Speech Recognition''': enables speech input on the connection. A specific language has to be selected. A button will appear in the top right corner when opening the connection. Speech is recognized and sent as a command to the HSYCO server. Speech recognition is available from iOS 10.
The '''Kiosk Mode''' option enables HSYCO’s kiosk mode.
+
* '''Monitor Beacons''': if enabled it will monitor beacons and send data to the HSYCO server.
 
+
* '''Bar/QR Code Scanner''': if enabled, it will show a button in the top right corner when opening the connection. Pressing the button opens up the device's camera, to scan and process a barcode or QR code.
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).
+
* '''Download Certificate''': to enable HTML5 cache the certificate needs to be downloaded and installed on the device.
 
+
* '''App Link Tool''': opens the [[#App Link Tool|App Link Tool]]
'''Lock Rotation''' prevents changes in the screen's orientation when rotating the device, locking it in the selected value.
+
* '''Delete Connection''': permanently deletes the connection
 
 
 
{{Clear}}
 
{{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}}
 
{{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.
 
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.

Revision as of 10:10, 2 July 2020

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.

Its many features enrich and expand the HSYCO experience in many ways:

  • Multiple connections: you can easily setup connections and set your favourite ones to quickly switch between them.
  • Connection setup: customize your connection to your needs with kiosk mode, lock rotation, scale, speech recognition and bar scanner tool. Manage the certificate and saved pin/puk.
  • Export/Import connections: save and restore all your connections with a password-protected file.
  • Authentication: if you wish so, the app handles the PIN/PUK credentials of all your connections automatically, adding a layer of protection with a global password and integrating Touch and Face ID.
  • App Links: share and import connections and send custom user commands with Universal Links that can also be embedded in QR Codes and NFC Tags.
  • Speech Recognition: send vocal commands to the server.
  • QR and Bar code scanning: scan QR and bar codes from your connection, to process app links or send the data directly to the server.
  • Beacons: enable beacon monitoring, to gather data on the device's location.
  • Apple Watch: each connection with a specific Apple Watch interface will be ready for you, on your wrist.


HSYCO App requires iOS 9.3 or later, and HSYCO Server 3.6. The latest features are only available on iOS 13.0 and HSYCO Server 3.7


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, or change the connections' order by dragging vertically the right-most icon.

Connection settings
Connection settings
More settings
More settings

A connection has the following fields:

  • Name: the name that will be displayed.
  • URL: 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.
  • Remember PIN/PUK: if on, it will store the connection's PIN and PUK the first time they're correctly entered. It will then show a "Forget PIN/PUK" option. It has to be enabled to use the Apple Watch interface.
  • Kiosk Mode: enables the Kiosk Mode, which removes some elements in the project's interface
  • Favorite: if enabled, it will show the connection in the left menu of the app, or in the Home Screen Quick Actions popup that appears when you long-press the app icon.
  • Lock Rotation: lock the interface in portrait or landscape mode, ignoring the device's orientation
  • Scale: set the interface scale mode.
  • Speech Recognition: enables speech input on the connection. A specific language has to be selected. A button will appear in the top right corner when opening the connection. Speech is recognized and sent as a command to the HSYCO server. Speech recognition is available from iOS 10.
  • Monitor Beacons: if enabled it will monitor beacons and send data to the HSYCO server.
  • Bar/QR Code Scanner: if enabled, it will show a button in the top right corner when opening the connection. Pressing the button opens up the device's camera, to scan and process a barcode or QR code.
  • Download Certificate: to enable HTML5 cache the certificate needs to be downloaded and installed on the device.
  • App Link Tool: opens the App Link Tool
  • Delete Connection: permanently deletes the connection
Edit Connection list
Edit Connection list
Certificate pinning
Certificate pinning

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: