Telephony, Audio, and Video preferences

The following table lists the telephony, audio, and video preferences for the IBM® Sametime® Connect Client and Sametime Embedded Client for Notes®.

Table 1 lists the global preferences.

Table 1. Global Preferences in com.ibm.collaboration.realtime , available in V8.5.1 and later
Attribute Variable type Description Release
enableSUT Boolean. Default is false. Applies to Sametime Unified Telephony subscribers only. When the value is set to true, the Sametime Unified Telephony plug-ins installed with the client become active. Subscribers see telephony status icons in the contact list and features such as call history and the phone book are enabled. Restart the client for the change to take effect.
Note: For information about integrating Notes Contacts with the Sametime phonebook, see the topic Integrating Notes Contacts with the Sametime phonebook.
8.5.1 and later
enableTelephonyStatus Boolean. Default is false. Set the value to true to enable the display of telephony presence status icons for livenames on the contact list or elsewhere. This is used for telephony presence published using the Sametime Telephony Presence Adapter, which is used by both Sametime Unified Telephony and some third-party telephony presence solutions. If you set enableSUT to true, it is not necessary to also set enableTelephonyStatus to true. When Sametime Unified Telephony is enabled, telephony status shows regardless of this preference value. However, in environments with both Sametime Unified Telephony users and nonusers, you can set enableTelephonyStatus to true so nonusers can see telephony presence for Sametime Unified Telephony users. 8.5.1 and later
enableExtendedStatus Boolean. Default is false. Set the value to true to enable the use of extended status icons for live names on the contact list or elsewhere. Extended status icons are most often used for telephony presence status, however some third-party applications use extended status icons for other types of status. To display telephony status icons for applications that use the Sametime Telephony Presence Adadpter, use enableTelephonyStatus rather than enableExtendedStatus. It is only necessary to set enableExtendedStatus when not using telephony presence from the Sametime Telephony Presence Adapter. As with enableTelephonyStatus, enableExtendedStatus is ignored when you set enableSUT to true, since Sametime Unified Telephony always shows telephony status icons. 8.5.1 and later

Table 2 lists the telephony, audio, and video preferences.

Table 2. Telephony, Audio, and Video Preferences in com.ibm.collaboration.realtime.telephony.ui, avialable in V8.5 and later
Attribute Variable type Description Release
deviceIn A valid string value for the device. The default value is "Default device". For computer sound devices, specifies which device is selected for Microphone. 8.5 and later
deviceOut A valid string value for the device. The default value is "Default device". For computer sound devices, specifies which device is selected for Speakers. 8.5 and later
deviceRing A valid string value for the device. The default value is "Default device". For computer sound devices, specifies which device is selected for Ringing. 8.5 and later
mic_boost_disabled Boolean. For computer sound devices, specifies whether or not to disable microphone boost. 8.5 and later
always_show_my_video Boolean Specifies whether or not to show my video automatically when I participate in a video-enabled session. 8.5 and later
closeWindow2 Boolean Specifies whether or not to close the call window automatically when user disconnect. 8.5 and later
warnCallAway Boolean Specifies whether or not to warn me if user is Away before starting new calls. 8.5 and later
warnCallInTheMeeting Boolean Specifies whether or not to warn me if user is Away before starting new calls. 8.5 and later
warnCallDND Boolean Specifies whether or not to warn me if user is on Do Not Disturb before starting new calls. 8.5 and later
warnCallOnThePhone Boolean Specifies whether or not to warn me if user is On the Phone before starting new calls. For Sametime Unified Telephony only. 8.5 and later
participantView Integer. 0 for "Image View" or 1 for "List View" Specifies the default participant view for 3-6 participants. 8.5 and later
callwindowAlwaysOnTop Boolean Specifies whether or not to the call window stays visible. For Windows™ only. 8.5 and later
enableSoundAlerts Boolean Specifies whether or not to enable sound alerts. 8.5 and later
soundCalleeRing A valid absolute sound file path. The sound file that will play for incoming voice or video chats, if sound alerts is enabled. 8.5 and later
soundHangUp A valid absolute sound file path. The sound file that will play when connection ended, if sound alerts is enabled. 8.5 and later
soundPause A valid absolute sound file path. The sound file that will play when pause audio, if sound alerts is enabled. 8.5 and later
soundResume A valid absolute sound file path. The sound file that will play when resume audio, if sound alerts is enabled. 8.5 and later
soundAlert A valid absolute sound file path. The sound file that will play for incoming call alerts, if sound alerts is enabled. 8.5 and later
muteSoundEnabled Boolean Specifies whether or not to mute other Sametime alerts during calls. 8.5 and later
preferredConferencingSolution "ext_avc" or "st_avc". If set to "st_avc", Sametime Audio/Video Conferencing will be used instead. For Connection and Conference Settings, specifies whether or not to use the external service for user's video calls. 8.5 and later
auto_vc_non_sut Boolean Specifies whether or not to always establish a computer-to-computer (Voice Chat) session when callee does not have Sametime Unified Telephony. 8.5 and later
hideTelephonyUI Boolean Specifies whether or not to hide all telephony and audio/video user interface elements, include menu items, toolbar actions, and preference pages. This can be used in environments that either do not use any telephony or audio/video features, or use third-party telephony or audio/video solutions that provide their own user interface. 8.5 and later
showCallComputer Boolean. Call Computer starts a computer voice chat call using Sametime audio/video conferencing, regardless of the selected preferred device and service provider preference. This setting is primarily intended for Sametime Unified Telephony users, but can be enabled for any user. 8.5 and later
callActionProviderId String. For Multiple TCSPI service providers, this value specifies the audio service provider ID selected by user to initiate calls. 8.5.2 and later
videoCallActionProviderId String. For Multiple TCSPI service providers, this value specifies the video service provider ID selected by user to initiate video calls. 8.5.2 and later
extensionDelimiters String. Default is ext. Comma-delimited list of delimiter used when a phone number contains an extension. 8.5.2 and later
nationalPrefixes String. Default is (0). Comma-delimited list of national prefixes. 8.5.2 and later
internationalPrefixes String. Default is empty. Comma-delimited list of international prefixes. 8.5.2 and later

Table 3 lists the integration preferences for Notes contacts.

Table 3. Notes contacts integration preferences in com.collaboration.realtime.contact.notes

Attribute Variable type Description Release
enableAutoSynch Boolean Set to false to disable automatic synchronization. When automatic synchronization is disabled, quick find still works by reading Notes Contacts, but caller ID does not work. 8.5.2 IFR1
enableDeleteOnSynch Boolean

Set to true to enable deleting during synchronization. When enabled, Sametime phone book entries, not in Notes Contacts, are deleted during the synchronization. By default, contacts that are not in Notes Contacts are automatically deleted if the phone book is hidden.

8.5.2 IFR1
InitialSynchDelay Long Specify the number of seconds to wait before initial synchronization after the telephony service is received. The default value is 120 seconds. 8.5.2 IFR1
IntervalSynchDelay Long Specify the number of seconds to wait between synchronization operations. Setting this value to -1 disables the interval synchronization. Customers may want to do this if they only want the Notes Contacts to be synchronized once per log in to Sametime. The default value is 3600 seconds. 8.5.2 IFR1
postDialDelimeters String Specify a space-delimited list of strings which indicate post dial sequences, for example, a conference passcode. If the number contains a post dial sequence, for example, "+1884266840;postd=11111" then the number is split when it is imported into Sametime contacts. This allows support of automatic dialling of conference passcodes. The default delimiters are ";postd=", "x".
Note: Entering a number such as "+1884266840x11111" breaks LiveText support because one extra space is required. For example, "+1884266840 x11111"
8.5.2 IFR1