CommandFusion Wiki

Documentation Resources

User Tools

Site Tools


Sidebar

software:iviewer:settings

This is an old revision of the document!


iViewer Settings

For help finding the settings screen on your iPhone/iPad or iPod Touch , see the How To Access iViewer Settings page.
After you access the iViewer Settings within the Settings.app, here are the options you will see:

Password

To secure the connection to the Control System, a password can be set for the connection.
Note: This password only relates to connection to Control Systems, and not External Systems.
By default, control systems being connected to do not require a password and this setting can be left blank.
See the documentation for integrating with systems using the Viewer Protocol for more information.

File URL

This is the URL to the GUI File that you want to load onto the device. This URL is only accessed when #Reload GUI File is turned on.
iViewer loads its GUI Files over WiFi. The GUI File can be served from any web server, including the one built into guiDesigner's Upload Service.
You can leave out the http:// - it will be automatically prefixed to the URL behind the scenes to save you time typing it out.
Note that when using a web server other than the Upload Service in guiDesigner, you must enter the full path including the full GUI filename.

Reload GUI File

When this option is on, iViewer will attempt to download the GUI File from the File URL when the app is launched.
The file is then cached to the device. When this option is off, iViewer will attempt to load the GUI from cache.
The GUI File can be hosted on any web server (the Upload Service is a basic web server built into guiDesigner).

Remember Last GUI File

Multiple GUI files can be cached on the device (See Buttons for more info). This option will tell iViewer to load the last page it was on if multiple GUI files are cached.
This option has no effect if there is only a single GUI File being used.

Preload Images

This option is only relevant if #Reload GUI File is turned on.
When this option is on, iViewer will attempt to cache all images in the whole project on launch.
Otherwise, the images will only be cached when they are made visible (such as when a page is shown or subpage is shown).
Turning this off allows for faster startup times for cases where the GUI File must be reloaded on each launch (not a common occurrance).
Generally, we advise always leaving this option ON.

Show Preload Status

Turn this option on to show a loading bar each time iViewer reloads the GUI file. The bar represents the GUI file and all images being cached.
You must turn on 'Preload Images' for the loading bar to represent caching of all images within the GUI.

Button Press Sound

When this option is on, every button press in iViewer will play the familiar iPhone 'click' sound.
Turn this option off to prevent the default sound. You can still assign sounds to button presses individually using the Sound Manager in guiDesigner

Auto Lock Delay

This setting overrides the auto lock setting on the device. For example, if the device's general auto lock is set at 5 minutes, and the Auto Lock Delay is set to 30 mins, the device will only Auto Lock after 35 minutes of inactivity.
You can also set it to 'Never' to disable Auto-Lock whilst iViewer is open, or leave it set to the global Auto-Lock value to use the same setting across all apps on the iOS device.
The device auto lock setting can be found under 'General > Auto-Lock' in the device settings.

Proximity Sensor

This option is only relevant to the iPhone because it's the only iOS device that has a built in proximity sensor.
When this setting is on, the screen will be turned off when something is placed near the front of the iPhone. This is handy for turning off the screen (and hence making the battery last longer) when placing the iPhone face down.
It also has the added bonus of stopping the iPhone screen glaring at you in a dark Theatre room for example, whilst leaving it ready for instant control when you pick the iPhone back up.

Multitasking

This option allows you to disable multitasking specifically for iViewer on iOS4 devices. This option is handy to use during development so that you don't have to force iViewer to close using the iOS4 multitasking menus in order to get it to reload the GUI file.
If multitasking is enabled, when you press the home button the app doesn't actually close, but just goes to the background. So next time you open the app it won't attempt to 'Reload GUI File' even if the reload option is on, because reloading only happens on launch.
So if you come across any problems with the GUI File not reloading even if you have 'Reload GUI File' enabled, most likely the app is not being closed between each launch but just running in the background. Disable multitasking to force iViewer to close fully each time you press the home button.

Remote Debugging

For more details, see the Remote Debugging topic.

Enable Logging

Turn this option on to enable remote debugging. In BETA builds, this option is hard coded on.

Remote Host

The IP address or hostname for the computer running the logger application, NSLogger.

Remote Port

The port that the logger application, NSLogger, is set to listen on.

Selecting this will show you information relating to the use of third party software libraries within iViewer.

Version Number

At the very bottom of the settings screen is the currently installed version number.

Saving Settings

You can close the settings app at any time by pressing the home button on your iOS device and the current settings will automatically be saved.

software/iviewer/settings.1346223928.txt.gz · Last modified: 2012/08/29 07:05 by terrylau