XboxLiveDeviceAddress Classe

Definição

Namespace:

Windows.Networking.XboxLive

Representa o local de rede de um console ou outro dispositivo autenticado.

Os objetos dessa classe representam uma coleção opaca de informações de conectividade sobre um dispositivo (em particular, uma lista de endereços IP). Você passa um XboxLiveDeviceAddress para um dos métodos CreateEndpointPairTemplate da classe CreateEndpointPairAsync ou CreateEndpointPairForPortsAsync da classe XboxLiveEndirTemplate, a fim de instanciar um XboxLiveEndpointPair entre o dispositivo local e o dispositivo no XboxLiveDeviceAddress especificado.

Importante

Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

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

Herança

Object Platform::Object IInspectable XboxLiveDeviceAddress

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Xbox One System Apps Extensions for the UWP (introduzida na 10.0.0.1) Xbox Live Extension SDK (introduzida na 10.0.10240.0) Xbox One Extensions for the UWP (introduzida na 10.0.10240.0) Windows Desktop Extension SDK (introduzida na 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (introduzida na v1.0)

Propriedades

IsLocal	Obtém um valor booliano que indica se este XboxLiveDeviceAddress representa o dispositivo local. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
IsValid	Obtém um valor booliano que indica se este XboxLiveDeviceAddress é válido. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
MaxSnapshotBytesSize	Obtém um valor que especifica o número máximo de Bytes necessários para a matriz de Bytes passada para XboxLiveDeviceAddress.GetSnapshotAsBytes. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
NetworkAccessKind	Obtém um valor que descreve o nível de acesso à rede ponto a ponto observado para a comunicação xboxLiveEndpointPair envolvendo este XboxLiveDeviceAddress. O acesso indicado é aplicável somente à comunicação estabelecida por meio da infraestrutura da API de Rede Multijogador do Xbox Live. Se você estabelecer sua própria comunicação insegura ou implementar sua própria passagem NAT, poderá descobrir que esse código encontra um tipo de acesso diferente. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

Métodos

Compare(XboxLiveDeviceAddress)	Compara outro objeto XboxLiveDeviceAddress com o objeto atual para ver se eles representam o mesmo dispositivo. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
CreateFromSnapshotBase64(String)	Cria um objeto XboxLiveDeviceAddress de um instantâneo armazenado na codificação Base64. Use esse método para criar um XboxLiveDeviceAddress do instantâneo codificado em Base64 retornado de uma chamada anterior para XboxLiveDeviceAddress.GetSnapshotAsBase64. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
CreateFromSnapshotBuffer(IBuffer)	Cria um objeto XboxLiveDeviceAddress de um instantâneo armazenado em um buffer. Use esse método para criar um XboxLiveDeviceAddress do buffer instantâneo retornado de uma chamada anterior para XboxLiveDeviceAddress.GetSnapshotAsBuffer. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
CreateFromSnapshotBytes(Byte[])	Cria um XboxLiveDeviceAddress de um instantâneo armazenado como uma matriz de bytes. Use esse método para criar um objeto XboxLiveDeviceAddress de um instantâneo salvo recuperado com o método XboxLiveDeviceAddress.GetSnapshotAsBytes. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetLocal()	Cria um XboxLiveDeviceAddress para o dispositivo local. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetSnapshotAsBase64()	Obtém um instantâneo do XboxLiveDeviceAddress atual como uma cadeia de caracteres codificada em Base64. Você pode salvar essa instantâneo para usar posteriormente como o parâmetro base64 em uma chamada para XboxLiveDeviceAddress.CreateFromSnapshotBase64. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetSnapshotAsBuffer()	Obtém um instantâneo do XboxLiveDeviceAddress atual e o retorna como um objeto que implementa o IBuffer. Você pode usar esse método para salvar um instantâneo para uso posterior com o método XboxLiveDeviceAddress.CreateFromSnapshotBuffer. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetSnapshotAsBytes(Byte[], UInt32)	Salva um XboxLiveDeviceAddress em uma matriz de bytes. Você pode usar esse método para salvar um instantâneo para uso com o método XboxLiveDeviceAddress.CreateFromSnapshotBytes. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

Eventos

SnapshotChanged

Evento gerado quando o instantâneo para este XboxLiveDeviceAddress foi alterado. Instantâneos são formas serializadas de objetos XboxLiveDeviceAddress que podem ser transmitidos para dispositivos remotos por meio de canais fora de banda, como a realização de correspondências do Xbox Live. No entanto, eles representam as informações de endereço de rede de um dispositivo em um determinado momento e podem ser alterados ao longo do tempo. Para evitar problemas de conectividade desnecessários, você deve escutar os eventos XboxLiveDeviceAddress.SnapshotChanged no endereço do dispositivo local para saber quando seu conteúdo instantâneo foi atualizado e atualizar o instantâneo serializado em qualquer lugar em que você o tenha transmitido ou armazenado em cache, para que os dispositivos remotos sempre tenham as informações mais recentes. Importante Essa API não está disponível para todos os aplicativos. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.