一、描述
QNetworkConfiguration 封装了单个接入点或服务网络。
单个接入点配置可以映射到一个网络接口。然而,单个网络接口可能并不总是只映射到一个接入点配置。同一网络设备的多种配置可以启用多个接入点。如智能手机允许用户管理多个 WLAN 配置,而设备本身只有一个 WLAN 网络设备。
QNetworkConfiguration 也支持服务网络的概念。这一概念允许将多个接入点配置分组为一个实体。这样的组称为服务网络,在需要到特定目标网络(例如公司网络)的网络会话的情况下可能是有益的。使用服务网络时,用户通常不关心选择了哪一种连接选项(例如,企业 WLAN 或通过 GPRS 的 VPN),只要他可以访问公司的目标服务器即可。此外,可以启用自动接入点漫游,使设备能够动态更改网络接口配置,同时保持应用程序与目标网络的连接。它允许适应不断变化的环境,并可以优化成本、速度或其他网络参数。
二、类型成员
1、enum QNetworkConfiguration::BearerType:指定配置使用的承载类型。
- BearerUnknown:承载类型未知或未指定。
- BearerEthernet:该配置用于以太网接口。
- BearerWLAN:该配置用于无线 LAN 接口。
- Bearer2G:该配置适用于 CSD、GPRS、HSCSD、EDGE 或 cdmaOne 接口。
- Bearer3G:配置为3G接口。
- Bearer4G:配置为4G接口。
- BearerCDMA2000:配置为CDMA接口。
- BearerWCDMA:该配置适用于 W-CDMA/UMTS 接口。
- BearerHSPA:该配置用于高速分组接入 (HSPA) 接口。
- BearerBluetooth:该配置用于蓝牙接口。
- BearerWiMAX:该配置适用于 WiMAX 接口。
- BearerEVDO:该配置用于 EVDO (3G) 接口。
- BearerLTE:该配置用于 LTE (4G) 接口。
2、enum QNetworkConfiguration::Purpose:指定配置的目的。
- UnknownPurpose:该配置没有指定任何目的。这是默认值。
- PublicPurpose:该配置可用于通用互联网访问。
- PrivatePurpose:该配置适用于访问办公室内网等私有网络。
- ServiceSpecificPurpose:该配置可用于运营商特定服务(例如接收彩信或内容流)。
3、enum QNetworkConfiguration::StateFlag:指定配置状态。
- Undefined:此状态用于临时配置,例如用户尚未实际为其创建配置的新发现的 WLAN。
- Defined:定义的配置对系统来说是已知的,但不能立即使用(例如,配置的 WLAN 不在范围内或以太网电缆当前未插入机器)。
- Discovered:发现的配置可以立即用于创建新的 QNetworkSession。 如果配置是服务网络,则如果至少一个底层接入点配置具有已发现状态,则设置此标志。
- Active:该配置当前由开放网络会话使用(QNetworkSession::isOpen())。
4、enum QNetworkConfiguration::Type:此枚举描述配置的类型。
- InternetAccessPoint:该配置指定单个接入点的详细信息。
- ServiceNetwork:该配置基于一组 InternetAccessPoint 类型的 QNetworkConfiguration。 所有组成员都可以到达同一个目标网络。
- UserChoice:配置是一个占位符,当会话打开时,它将被平台解析为实际配置。根据平台,选择可能会生成一个弹出对话框,询问用户他的首选选择。
- Invalid:配置无效。
三、成员函数
1、QList<QNetworkConfiguration> children()
按优先级顺序返回此网络配置的所有子配置。列表中的第一个子配置具有最高优先级。
只有 ServiceNetwork 类型的网络配置可以有子级。
2、QString identifier()
返回此网络配置的唯一且特定于平台的标识符。
3、bool isRoamingAvailable()
配置是否支持漫游。
4、bool isValid()
此 QNetworkConfiguration 对象是否有效。如果用户删除配置或配置是默认构建的,则配置可能会失效。可以通过 QNetworkConfigurationManager 监控配置的添加和删除。
5、QString name()
返回此配置的用户可见名称。该名称可以是底层接入点的名称,也可以是此配置所代表的服务网络的名称。
6、bool setConnectTimeout(int timeout)
设置此配置的连接超时时间(毫秒)。