XboxLiveDeviceAddress Clase

Definición

Espacio de nombres:

Windows.Networking.XboxLive

Representa la ubicación de red de una consola u otro dispositivo autenticado.

Los objetos de esta clase representan una colección opaca de información de conectividad sobre un dispositivo (en particular, una lista de direcciones IP). Pasas un XboxLiveDeviceAddress a uno de los métodos CreateEndpointPairTemplate de la clase CreateEndpointPairAsync o CreateEndpointPairForPortsAsync para crear una instancia de xboxLiveEndpointPair entre el dispositivo local y el dispositivo en la xboxLiveDeviceAddress dada.

Importante

Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

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

Herencia

Object Platform::Object IInspectable XboxLiveDeviceAddress

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Xbox One System Apps Extensions for the UWP (se introdujo en la versión 10.0.0.1) Xbox Live Extension SDK (se introdujo en la versión 10.0.10240.0) Xbox One Extensions for the UWP (se introdujo en la versión 10.0.10240.0) Windows Desktop Extension SDK (se introdujo en la versión 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (se introdujo en la versión v1.0)

Propiedades

IsLocal	Obtiene un valor booleano que indica si este XboxLiveDeviceAddress representa el dispositivo local. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
IsValid	Obtiene un valor booleano que indica si este XboxLiveDeviceAddress es válido. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
MaxSnapshotBytesSize	Obtiene un valor que especifica el número máximo de bytes necesarios para la matriz de bytes pasados a XboxLiveDeviceAddress.GetSnapshotAsBytes. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
NetworkAccessKind	Obtiene un valor que describe el nivel de acceso de red punto a punto observado para la comunicación XboxLiveEndpointPair que implica esta XboxLiveDeviceAddress. El acceso indicado solo se aplica a la comunicación establecida a través de la infraestructura de la API de redes multijugador de Xbox Live. Si establece su propia comunicación no segura o implementa su propio recorrido NAT, es posible que encuentre que ese código encuentra un tipo de acceso diferente. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

Métodos

Compare(XboxLiveDeviceAddress)	Compara otro objeto XboxLiveDeviceAddress con el objeto actual para ver si representan el mismo dispositivo. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
CreateFromSnapshotBase64(String)	Crea un objeto XboxLiveDeviceAddress a partir de una instantánea almacenada en la codificación Base64. Usa este método para crear una XboxLiveDeviceAddress a partir de la instantánea codificada en Base64 devuelta desde una llamada anterior a XboxLiveDeviceAddress.GetSnapshotAsBase64. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
CreateFromSnapshotBuffer(IBuffer)	Crea un objeto XboxLiveDeviceAddress a partir de una instantánea almacenada en un búfer. Usa este método para crear una XboxLiveDeviceAddress a partir del búfer de instantáneas devuelto desde una llamada anterior a XboxLiveDeviceAddress.GetSnapshotAsBuffer. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
CreateFromSnapshotBytes(Byte[])	Crea una XboxLiveDeviceAddress a partir de una instantánea almacenada como una matriz de bytes. Usa este método para crear un objeto XboxLiveDeviceAddress a partir de una instantánea guardada recuperada con el método XboxLiveDeviceAddress.GetSnapshotAsBytes . Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
GetLocal()	Crea un XboxLiveDeviceAddress para el dispositivo local. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
GetSnapshotAsBase64()	Obtiene una instantánea de xboxLiveDeviceAddress actual como una cadena codificada en Base64. Puedes guardar esta instantánea para usarla más adelante como parámetro base64 en una llamada a XboxLiveDeviceAddress.CreateFromSnapshotBase64. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
GetSnapshotAsBuffer()	Obtiene una instantánea de xboxLiveDeviceAddress actual y la devuelve como un objeto que implementa IBuffer. Puedes usar este método para guardar una instantánea para usarla más adelante con el método XboxLiveDeviceAddress.CreateFromSnapshotBuffer . Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.
GetSnapshotAsBytes(Byte[], UInt32)	Guarda un XboxLiveDeviceAddress en una matriz de bytes. Puedes usar este método para guardar una instantánea para usarla con el método XboxLiveDeviceAddress.CreateFromSnapshotBytes . Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

Eventos

SnapshotChanged

Evento generado cuando la instantánea de este XboxLiveDeviceAddress ha cambiado. Las instantáneas son formas serializadas de objetos XboxLiveDeviceAddress que se pueden transmitir a dispositivos remotos a través de canales fuera de banda, como el emparejamiento de Xbox Live. Sin embargo, representan la información de dirección de red de un dispositivo en un momento determinado y pueden cambiar con el tiempo. Para evitar problemas de conectividad innecesarios, debes escuchar eventos XboxLiveDeviceAddress.SnapshotChanged en la dirección del dispositivo local para saber cuándo se ha actualizado su contenido de instantáneas y actualizar la instantánea serializada en cualquier lugar en el que hayas transmitido o almacenado en caché, de modo que los dispositivos remotos siempre tengan la información más reciente. Importante Esta API no está disponible para todas las aplicaciones. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.