XboxLiveDeviceAddress 类

定义

命名空间:

Windows.Networking.XboxLive

表示主机或其他经过身份验证的设备的网络位置。

此类的对象表示有关设备的连接信息的不透明集合， (特别是) IP 地址列表。 将 XboxLiveDeviceAddress 传递给 XboxLiveEndpointPairTemplate 类的 CreateEndpointPairAsync 或 CreateEndpointPairForPortsAsync 方法之一，以便在本地设备和给定 XboxLiveDeviceAddress 的设备之间实例化 XboxLiveEndpointPair。

重要

此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

public ref class XboxLiveDeviceAddress sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveDeviceAddress final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveDeviceAddress

Public NotInheritable Class XboxLiveDeviceAddress

继承

Object Platform::Object IInspectable XboxLiveDeviceAddress

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Xbox One System Apps Extensions for the UWP (在 10.0.0.1 中引入) Xbox Live Extension SDK (在 10.0.10240.0 中引入) Xbox One Extensions for the UWP (在 10.0.10240.0 中引入) Windows Desktop Extension SDK (在 10.0.16299.0 中引入)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (在 v1.0 中引入)

属性

IsLocal	获取一个布尔值，该值指示此 XboxLiveDeviceAddress 是否表示本地设备。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
IsValid	获取一个布尔值，该值指示此 XboxLiveDeviceAddress 是否有效。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
MaxSnapshotBytesSize	获取一个值，该值指定传递给 XboxLiveDeviceAddress.GetSnapshotAsBytes 的字节数组所需的最大字节数。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
NetworkAccessKind	获取一个值，该值描述针对涉及此 XboxLiveDeviceAddress 的 XboxLiveEndpointPair 通信观察到的对等网络访问级别。 指示的访问权限仅适用于通过 Xbox Live 多人游戏网络 API 基础结构建立的通信。 如果建立自己的不安全通信，或实现自己的 NAT 遍历，你可能会发现该代码遇到不同的访问类型。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

方法

Compare(XboxLiveDeviceAddress)	将另一个 XboxLiveDeviceAddress 对象与当前对象进行比较，以查看它们是否表示同一设备。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
CreateFromSnapshotBase64(String)	从 Base64 编码中存储的快照创建 XboxLiveDeviceAddress 对象。 使用此方法从先前调用 XboxLiveDeviceAddress.GetSnapshotAsBase64 返回的 Base64 编码快照创建 XboxLiveDeviceAddress。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
CreateFromSnapshotBuffer(IBuffer)	从存储在缓冲区中的快照创建 XboxLiveDeviceAddress 对象。 使用此方法从先前调用 XboxLiveDeviceAddress.GetSnapshotAsBuffer 返回的快照缓冲区创建 XboxLiveDeviceAddress。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
CreateFromSnapshotBytes(Byte[])	从存储为字节数组的快照创建 XboxLiveDeviceAddress。 使用此方法可以从使用 XboxLiveDeviceAddress.GetSnapshotAsBytes 方法检索的已保存快照创建 XboxLiveDeviceAddress 对象。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetLocal()	为本地设备创建 XboxLiveDeviceAddress 。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetSnapshotAsBase64()	获取当前 XboxLiveDeviceAddress 作为 Base64 编码字符串的快照。 可以保存此快照，以便稍后在调用 XboxLiveDeviceAddress.CreateFromSnapshotBase64 时用作 base64 参数。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetSnapshotAsBuffer()	获取当前 XboxLiveDeviceAddress 的快照，并将其作为实现 IBuffer 的对象返回。 可以使用此方法保存快照，以便以后与 XboxLiveDeviceAddress.CreateFromSnapshotBuffer 方法一起使用。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。
GetSnapshotAsBytes(Byte[], UInt32)	将 XboxLiveDeviceAddress 保存到字节数组。 可以使用此方法保存快照，以便与 XboxLiveDeviceAddress.CreateFromSnapshotBytes 方法一起使用。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。

事件

SnapshotChanged

此 XboxLiveDeviceAddress 的快照发生更改时引发的事件。 快照是 XboxLiveDeviceAddress 对象的序列化形式，可通过带外通道（如 Xbox Live 匹配）传输到远程设备。 但是，它们表示设备在特定时间的网络地址信息，并且可能会随时间而更改。 为了避免不必要的连接问题，应侦听本地设备地址上的 XboxLiveDeviceAddress.SnapshotChanged 事件，以了解其快照内容何时更新，并刷新已序列化快照传输或缓存它的任何位置，以便远程设备始终具有最新信息。 重要 此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。