Configuration File Settings
The following settings are defined for inclusion in configuration files. Use this section when creating and modifying configuration files for custom or MDM installations.
Feature / SettingIdentifies the associated setting on the client.
Values:Defines the type of value recognized by the setting.
Example:
Provides examples of the required syntax.
applicationAutoLaunch
Feature / Setting:
Mobile: For Android only, on rebooting the device, the ICE mobile client will auto-launch.
Values: true, false (Boolean)Example:
"applicationAutoLaunch": false
audioSettingsAudioDevice
Feature / Setting:Mobile: Settings > Audio > Default Audio Device > Device
Values: earpiece, speaker (String)Example:
"audioSettingsAudioDevice": "speaker"
audioSettingsToneEnabled
Feature/Setting | Values |
Desktop: Settings > General >Error Sounds > Network Channel ErrorOther Sounds > Alert ReceivedChannel AddedIncoming Text MessageOutgoing Text MessageTelephony Incoming CallTelephony Outgoing CallPush To Talk Sounds >Push to Talk DeniedPush to Talk EndedPush to Talk GrantedPush to Talk ReceivedMobile: Audio >Error Sounds > Network ErrorOther Sounds > Alert Received Channel Added Incoming Text Message Outgoing Text Message Telephone Call Push To Talk Sounds >Push to Talk DeniedPush to Talk EndedPush to Talk Granted | desktopIncomingCall: true, false (Desktop, Boolean) desktopIncomingTextMessage: true, false (Desktop, Boolean) desktopOutgoingCall: true, false (Desktop, Boolean) desktopOutgoingTextMessage: true, false (Desktop, Boolean) desktopPttReceived: true, false (Desktop, Boolean) errorChannel: true, false (Both, Boolean) otherAlert: true, false (Both, Boolean) otherChannelAdded: true, false (Both, Boolean) otherIncomingTextMessage: true, false (Mobile, Boolean) otherOutgoingTextMessage: true, false (Mobile, Boolean) otherPrivateCall: true, false (Mobile, Boolean) pttDenied: true, false (Both, Boolean) pttEnded: true, false (Both, Boolean) pttGranted: true, false (Both, Boolean) |
Example:
"audioSettingsToneEnabled": {
"desktopIncomingCall": true,
"desktopIncomingTextMessage": false,
"desktopOutgoingCall": false,
"desktopOutgoingTextMessage": false,
"desktopPttReceived": false,
"errorChannel": false,
"otherAlert": false,
"otherChannelAdded": true,
"otherIncomingTextMessage": false,
"otherOutgoingTextMessage": false,
"otherPrivateCall": true,
"pttDenied": false,
"pttEnded": false,
"pttGranted": false
}
audioSettingsToneLevels
Feature / Setting:Desktop: Settings > General >Error Sounds (Volume)Other Sounds (Volume)Push To Talk Sounds (Volume)Mobile: Audio >Error Sounds > Tone volumeOther Sounds > Tone volumePush To Talk Sounds > Tone volumeValues:error: Range from 0 to 1 using decimals: 0, 0.1, 0.2, 0.3 etc (Number)other: Range from 0 to 1 using decimals: 0, 0.1, 0.2, 0.3 etc (Number)ptt: Range from 0 to 1 using decimals: 0, 0.1, 0.2, 0.3 etc (Number)Example:
"audioSettingsToneLevels": {
"error": 0.9,
"other": 0.1,
"ptt": 0.75
}
audioSettingsVibration
Feature / Setting:Mobile: Audio > Haptic Feedback > Enable vibrationsValues: true, false (Boolean)Example:
"audioSettingsVibration": false
audioSettingsWiredHeadsetType
Feature / Setting:Mobile: For Android only, specify the allowed brand/model of wired accessory for PTT.Values: milicomUHA, normal, savoxRSM30, savoxSH01 (String)Example:
"audioSettingsWiredHeadsetType": normal
channelMode
Feature / Setting:Mobile: Settings > History > Channel mode > Radio modeValues: radio, regular (String)Example:
"channelMode": regular
connectivitySettingsCheckInterval
Feature / Setting:Mobile: Settings > Network Connection > Network CheckValues: Range is from 1 to any number, but recommend: 30, 60, 90, 120Example:
"connectivitySettingsCheckInterval": 60
connectivitySettingsNetworkInterface
Feature / Setting:Desktop: Settings > General > Network InterfaceMobile: Settings > Network Connection > Network InterfaceValues: Values loaded from server (String)Example:
"connectivitySettingsNetworkInterface": "en0"
connectivitySettingsTrellisware
Feature / Setting:Mobile: Settings > Asset Discovery > Discover TrelliswareValuesenabled: true, false (Boolean)Example:
"connectivitySettingsTrellisware": {
"enabled": false
}
desktopLocation
Feature / Setting:Desktop: Settings > Location > Share my location with others
AutomaticallyUsing a location I specifyNeverValuessharing: AUTO, MANUAL, OFF (String)Example:
"desktopLocation": {
"sharing": "AUTO"
}
Feature / Setting:Mobile: Menu > Audio > Stereo AudioValues: Left, Both, Right (string)
logBufferSizeInDays
Feature / Setting:Mobile: Settings > Analytics > Maximum Logs Limit DaysValues: Range is from 1 to any number, but recommend: 1-10Example:
"logBufferSizeInDays": 4
loginUsername
Feature / Setting: The value is used for login to both the desktop and mobile client. The 'Username' field on the client login UI displays the value and cannot be edited by the user.Values: Any string, e.g., andrii@test4.comExample:
"loginUsername": "andrii@test4.com"
monitoringSettingsCrashes
Feature / Setting:Mobile: Settings > Analytics > Report CrashesValues: true, false (Boolean)Example:
"monitoringSettingsCrashes": false
monitoringSettingsLocation
Note: Client configuration files must include this parameter, see the 'File specifications' section above.
Feature / Setting:Mobile: Settings > Location TrackingValuesaccuracy: balanced, high, low, powersave (String)changeMeters: Range is from 1 to any number, but recommend: 0, 5, 20, 36, 50, 100shareLocation: background, foreground, none (String)updateIntervalSeconds: Range is from 1 to any number, but recommend: 15, 30, 60, 120, 300Example:
"monitoringSettingsLocation": {
"accuracy": "high",
"changeMeters": 0,
"shareLocation": true,
"updateIntervalSeconds": 60
}
operatingModes
Feature / Setting:Mobile: Settings > Location Tracking > Operating ModesValuesemergencyAlertButton: true, false (Boolean)onScreenPttButton: true, false (Boolean)persistentRxDisplay: true, false (Boolean)radioMode: true, false (Boolean)silentModeEnabled: true, false (Boolean)tacticalEnabled: true, false (Boolean)telephonyAsAChannel: true, false (Boolean)Example:
"operatingModes": {
"emergencyAlertButton": false,
"onScreenPttButton": false,
"persistentRxDisplay": false,
"radioMode": true,
"silentModeEnabled": false,
"tacticalEnabled": false
"telephonyAsAChannel": true,
}
serverKey
Feature / Setting: The value is used for login to both the desktop and mobile client. The 'Address' field on the client login UI displays the value and cannot be edited by the user.Values: Any string, e.g., test.icnow.appExample:
"serverKey": "develop.icnow.app"
telephonyAsAChannel
Feature / Setting:Mobile: Settings > History > Channel mode > Telephony As a ChannelValues: true, false (Boolean)Example:
"telephonyAsAChannel": false
timelines
Feature / Setting:Desktop: Settings > General > Instant ReplayEnable ReplayOldest ReplayMax Stored ReplaysMobile: Settings > HistoryInstant ReplayOldest ReplayMaximum History LimitValuesenabled: true, false (Boolean)historyAgeHours: Range is from 1 to any number, but recommend: 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24 (Number)
historyLimit: 25, 50, 75, 100 (Number)Example:
"timelines": {
"enabled": false,
"historyAgeHours": 4,
"historyLimit": 50
}
verboseLogging
Feature / Setting:Desktop: Settings > General > Crash Reporting > Verbose LoggingMobile: Settings > Analytics > Verbose LoggingValues: true, false (Boolean)Example:
"verboseLogging": false