XboxLiveDeviceAddress Classe

Definizione

Spazio dei nomi:

Windows.Networking.XboxLive

Rappresenta il percorso di rete di una console o di un altro dispositivo autenticato.

Gli oggetti di questa classe rappresentano una raccolta opaca di informazioni di connettività su un dispositivo (in particolare un elenco di indirizzi IP). Si passa un oggetto XboxLiveDeviceAddress a uno dei metodi CreateEndpointPairTemplate della classe CreateEndpointPairAsync o CreateEndpointPairForPortsAsync per creare un'istanza di XboxLiveEndpointPair tra il dispositivo locale e il dispositivo nella determinata XboxLiveDeviceAddress.

Importante

Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

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

Ereditarietà

Object Platform::Object IInspectable XboxLiveDeviceAddress

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Xbox One System Apps Extensions for the UWP (è stato introdotto in 10.0.0.1) Xbox Live Extension SDK (è stato introdotto in 10.0.10240.0) Xbox One Extensions for the UWP (è stato introdotto in 10.0.10240.0) Windows Desktop Extension SDK (è stato introdotto in 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (è stato introdotto in v1.0)

Proprietà

IsLocal	Ottiene un valore booleano che indica se xboxLiveDeviceAddress rappresenta il dispositivo locale. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
IsValid	Ottiene un valore booleano che indica se xboxLiveDeviceAddress è valido. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
MaxSnapshotBytesSize	Ottiene un valore che specifica il numero massimo di byte necessari per la matrice di byte passati a XboxLiveDeviceAddress.GetSnapshotAsBytes. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
NetworkAccessKind	Ottiene un valore che descrive il livello di accesso alla rete peer-to-peer osservato per la comunicazione XboxLiveEndpointPair che coinvolge questo XboxLiveDeviceAddress. L'accesso indicato è applicabile solo alle comunicazioni stabilite tramite l'infrastruttura DELL'API Di rete multiplayer Xbox Live. Se si stabilisce una comunicazione non sicura o si implementa l'attraversamento NAT personalizzato, è possibile che tale codice verifichi un tipo di accesso diverso. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Metodi

Compare(XboxLiveDeviceAddress)	Confronta un altro oggetto XboxLiveDeviceAddress all'oggetto corrente per verificare se rappresentano lo stesso dispositivo. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
CreateFromSnapshotBase64(String)	Crea un oggetto XboxLiveDeviceAddress da uno snapshot archiviato nella codifica Base64. Usare questo metodo per creare un oggetto XboxLiveDeviceAddress dallo snapshot con codifica Base64 restituito da una chiamata precedente a XboxLiveDeviceAddress.GetSnapshotAsBase64. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
CreateFromSnapshotBuffer(IBuffer)	Crea un oggetto XboxLiveDeviceAddress da uno snapshot archiviato in un buffer. Usare questo metodo per creare un oggetto XboxLiveDeviceAddress dal buffer snapshot restituito da una chiamata precedente a XboxLiveDeviceAddress.GetSnapshotAsBuffer. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
CreateFromSnapshotBytes(Byte[])	Crea un oggetto XboxLiveDeviceAddress da uno snapshot archiviato come matrice di byte. Usare questo metodo per creare un oggetto XboxLiveDeviceAddress da uno snapshot salvato recuperato con il metodo XboxLiveDeviceAddress.GetSnapshotAsBytes . Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetLocal()	Crea un oggetto XboxLiveDeviceAddress per il dispositivo locale. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetSnapshotAsBase64()	Ottiene uno snapshot dell'oggetto XboxLiveDeviceAddress corrente come stringa con codifica Base64. È possibile salvare questo snapshot da usare più avanti come parametro base64 in una chiamata a XboxLiveDeviceAddress.CreateFromSnapshotBase64. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetSnapshotAsBuffer()	Ottiene uno snapshot dell'oggetto XboxLiveDeviceAddress corrente e lo restituisce come oggetto che implementa IBuffer. È possibile usare questo metodo per salvare uno snapshot per un uso successivo con il metodo XboxLiveDeviceAddress.CreateFromSnapshotBuffer . Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetSnapshotAsBytes(Byte[], UInt32)	Salva un oggetto XboxLiveDeviceAddress in una matrice di byte. È possibile usare questo metodo per salvare uno snapshot da usare con il metodo XboxLiveDeviceAddress.CreateFromSnapshotBytes . Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

Eventi

SnapshotChanged

Evento generato quando lo snapshot per xboxLiveDeviceAddress è cambiato. Gli snapshot sono forme serializzate di oggetti XboxLiveDeviceAddress che possono essere trasmessi ai dispositivi remoti tramite canali fuori banda, ad esempio Xbox Live matchmaking. Tuttavia, rappresentano le informazioni sull'indirizzo di rete di un dispositivo in un determinato momento e possono cambiare nel tempo. Per evitare problemi di connettività non necessari, è necessario ascoltare gli eventi XboxLiveDeviceAddress.SnapshotChanged nell'indirizzo del dispositivo locale per sapere quando il contenuto dello snapshot è stato aggiornato e aggiornare lo snapshot serializzato ovunque sia stato trasmesso o memorizzato nella cache, in modo che i dispositivi remoti abbiano sempre le informazioni più recenti. Importante Questa API non è disponibile per tutte le app. A meno che l'account sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.