Skip to content
QiTASC.com / intaQt Setup and Configuration /
intaQt Phone Service
/ .. /
intaQt Phone Service










intaQt Phone Service

The intaQt Phone Service is a standalone application that is responsible for managing remote phones, allowing them to communicate with intaQt. When intaQt tries to acquire a remote phone, the intaQt Phone Service will search its database of registered remote phones and select one.

Using the intaQt Phone Service requires two separate configurations:

  • The RemoteServiceConf is responsible for configuring the standalone intaQt Phone Service

    • The standalone intaQt Phone Service must have its own configuration (.conf) file

  • The RemotePhoneServices

    • It may be configured in any intaQt-specific configuration file

RemoteServiceConf Configuration - Configure the intaQt Phone Service

The following configuration is for the standalone intaQt Phone Service standalone application. Because it has its own set of configuration files, which are separate from intaQt, the RemoteServiceConf should be contained in a dedicated configuration file. For example, if Appium is started on the intaQt Phone Service, an additional Appium configuration must be defined separately in the RemoteServiceConf configuration file.

Syntax 

1
2
3
4
5
6
7
8
RemoteServiceConf = {
    port                          : <Number>
    phoneValidityDurationMilliSec : <Number>
    requireAuthentication         : <Boolean>
    identitiesDirectory           : <String>
    propertyUpdateInterval        : <Number>
    fileCacheSizeMb               : <Number>
}

Parameters

  • port - The port number that the remote phone service listens on

    • Default value is set to 6000

  • phoneValidityDurationMilliSec - Time in milliseconds for which the phone is reserved on the intaQt Phone Service

    • Default value is set to 10000

  • requireAuthentication (optional)

    • true if an authentication key is required to connect to the intaQt Phone Service
    • false (default) otherwise

  • identitiesDirectory (optional) - Points to a valid directory that contains the authentication key required to connect to an intaQt Phone Service requiring authentication

    • Must be used if requireAuthentication is set to true

  • propertyUpdateInterval (optional) - The interval in seconds by which the phone properties are updated

    • Default value is set to 10

  • fileCacheSizeMb (optional) - The size of the cache for files sent through the RemoteTemporaryFolder

    • Default value is set to 1024
    • If this field is changed, the Remote Phone Service must be restarted

Example 

1
2
3
4
5
6
RemoteServiceConf = {
    port                   : 6000
    durationInMilliSeconds : 10000
    propertyUpdateInterval : 10
    fileCacheSizeMb        : 2048
}

Appium Configuration for intaQt Phone Service

If Appium is started on the intaQt Phone Service, an additional Appium configuration must be set separately in the intaQt Phone Service configuration file. This configuration file must only specify isActive, as well as libraryPath if the default installation location is not being used.

Syntax 

1
2
3
4
Appium {
    isActive    = <Boolean>
    libraryPath = <String>
}

Parameters

  • isActive

    • true enables the Appium plugin
    • false otherwise
      • Note: When set to true, it will disable Selendroid

  • libraryPath (Optional) - Path to the Appium library

    • By default this will point to the Appium library created by the Installer

Example 

1
2
3
4
Appium {
    isActive = true
    libraryPath = "../../appium"
}

RemotePhoneServices - Connect the intaQt Phone Service to IntaQt

By configuring the RemotePhoneServices section in an intaQt .conf file, intaQt accesses remote phone(s) by sending a message to the standalone intaQt Phone Service, which relays it to the phone(s).

Configuration requires the IP address of the machine that is running the intaQt Phone Service. It also requires the Socket, which is addressed by the Port number that it is assigned to.

Syntax 

1
2
3
RemotePhoneServices {
    <serviceAddress String> : <serviceName String>
}

Parameters

  • serviceAddress - This consists of two components:

    • The IP address of the machine that is running the service, or its Host name
    • The Port number of the socket that the service is running on, and must be separated by a colon (:)

  • serviceName - the user-assigned name for the RemotePhoneServices

Example 

1
2
3
4
5
RemotePhoneServices = {

    "192.168.1.1:6000" : "VIE"
    "192.168.0.1" : "DUS1"
}
Note: Snom phones can also be used via the intaQt Phone Service.