Overview - API | NetworkInfo | NetworkInfo-IPInfo
#include <alproxies/networkinfo.h>
Describes the status of a network service. Many information are available for the service like the state of a service or its signal strength.
Returns: | The identifier for the network service. |
---|
Return the name for the network service, for ethernet service the name is “Wired”, for WiFi services the name is the SSID name of the network, if the network service is hidden hte name is not set.,
Returns: | the network name |
---|
Return the type of the network this can be:
Returns: | the type of the service |
---|
Return the state of the service possible values are :
(Only one service can be online at the same time)
Returns: | the state of the service |
---|
Will be true if a cable is plugged in or the user selected and successfully connected to this service.
This value is automatically changed and to revert it back to false, the method ALConnectionManagerProxy::forget() needs to be used.
Returns: | true if the service is marked as favorite false instead |
---|
If set to true, this service will auto-connect when no other connection is available. This can be be set to false to prevent automatic connection without calling forget() method of ALConnectionManager.
Returns: | true if the service is marked as autoconnect false instead |
---|
For WiFi service type, this method will return a list of security methods or key management settings. For other network type this method will return an empty list.
Possible values are:
Returns: | The available securities for the network. |
---|
Return the list of currently used search domains. Can also be manual configured domains using ALConnectionMamanager::setServiceConfiguration.
Returns: | The list of domains for this service |
---|
Return the list of currently activate or manually configured domain name servers. The first one have a higher priority.
Returns: | The activate or configured name servers |
---|
Return a IPInfo which represents the actual system configuration or the manually configured IP address using ALConnectionMamanager::setServiceConfiguration.
Returns: | The IPv4 configuration for this service. |
---|
Experimental The IPv6 is not supported in the current version.
Return a IPInfo for the actual system configuration or the manually configured IP address using ALConnectionMamanager::setServiceConfiguration.
Returns: | The IPv6 configuration for this service. |
---|
When error occur during connection or disconnection the detailed information is represented in this property.
This property is only valid when the service is in the “failure” state. Otherwise it might be empty.
Returns: | The connection error |
---|
Converts the NetworkInfo object as an ALValue. ALValue NetworkInfo
Returns: | The ALValue representation of the NetworkInfo object. |
---|
The ALValue NetworkInfo is an array of n-pair (key, value).
To exchange this object with other modules the NetworkInfo object can be represented as ALValue with the following structure.
key | value type |
---|---|
“ServiceId” | string |
“Name” | string |
“Type” | string |
“State” | string |
“Favorite” | bool |
“Autoconnect” | bool |
“Security” | array of string |
“Domains” | array of string |
“Nameserver” | array of string |
“IPv4” | ALValue ALValue IPInfo |
“IPv6” | ALValue ALValue IPInfo |
“Strength” | int |
“Error” | string |
The empties values will not be present.