XNetworkingConnectivityHint
定义当前设备级别的网络状态,包括网络连接级别、数据限制、接口类型和网络初始化状态。语法
成员
connectivityLevel类型:XNetworkingConnectivityLevelHint 设备当前的尽力而为的连接级别。 connectivityCost
类型:XNetworkingConnectivityCostHint 对设备当前数据限制的尽力而为的分类。 ianaInterfaceType
类型:uint32_t WinSock 和 WinHTTP 到达 internet 时可能使用的当前接口类型。是 IANA NDIS 接口类型之一。 networkInitialized
类型:bool 指示网络当前是否已初始化。有关详细信息,请参阅检索网络信息中的网络初始化一节。 approachingDataLimit
类型:bool 指示设备是否接近超出其数据限制。 overDataLimit
类型:bool 指示设备是否已超出其数据限制。 roaming
类型:bool 指示设备是否处于漫游状态。
备注
在尝试使用任何网络或安全 API 之前,请确保 networkInitialized 成员返回 true。尝试使用尚未初始化的网络的 XNetworking API 将导致调用失败和不可预测的行为。
XNetworkingConnectivityHint 结构体中的字段(XNetworkingConnectivityHint::networkInitialized 字段除外)都是提示。它们是设备基于对设备网络流量的汇总所做出的、关于当前网络状态的尽力而为的推断。重要的是,这些字段并不代表是否能够连接到你的特定游戏端点。我们建议:在等待网络初始化完成后,无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何,都使用 WinSock 和/或 WinHTTP 尝试与端点建立连接。如果这些 API 随后失败,我们建议再使用 XNetworkingGetConnectivityHint API 来提供额外的 UI 与诊断报告信息。然后你应等待网络连接级别发生变化后再重试。
