XboxLiveDeviceAddress Classe

Définition

Espace de noms:

Windows.Networking.XboxLive

Représente l’emplacement réseau d’une console ou d’un autre appareil authentifié.

Les objets de cette classe représentent une collection opaque d’informations de connectivité sur un appareil (en particulier, une liste d’adresses IP). Vous passez une XboxLiveDeviceAddress à l’une des méthodes CreateEndpointPairAsync ou CreateEndpointPairForPortsAsync de la classe XboxLiveEndpointPairAsync afin d’instancier une XboxLiveEndpointPairPair entre l’appareil local et l’appareil à l’emplacement XboxLiveDeviceAddress donné.

Important

Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

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

Héritage

Object Platform::Object IInspectable XboxLiveDeviceAddress

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Xbox One System Apps Extensions for the UWP (introduit dans 10.0.0.1) Xbox Live Extension SDK (introduit dans 10.0.10240.0) Xbox One Extensions for the UWP (introduit dans 10.0.10240.0) Windows Desktop Extension SDK (introduit dans 10.0.16299.0)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (introduit dans v1.0)

Propriétés

IsLocal	Obtient une valeur booléenne indiquant si cette XboxLiveDeviceAddress représente l’appareil local. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
IsValid	Obtient une valeur booléenne indiquant si cette XboxLiveDeviceAddress est valide. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
MaxSnapshotBytesSize	Obtient une valeur qui spécifie le nombre maximal d’octets requis pour le tableau d’octets transmis à XboxLiveDeviceAddress.GetSnapshotAsBytes. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
NetworkAccessKind	Obtient une valeur qui décrit le niveau d’accès réseau d’égal à égal observé pour la communication XboxLiveEndpointPair impliquant cette XboxLiveDeviceAddress. L’accès indiqué s’applique uniquement aux communications établies via l’infrastructure de l’API Mise en réseau multijoueur Xbox Live. Si vous établissez votre propre communication non sécurisée ou implémentez votre propre traversée NAT, vous pouvez constater que ce code rencontre un type d’accès différent. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

Méthodes

Compare(XboxLiveDeviceAddress)	Compare un autre objet XboxLiveDeviceAddress à l’objet actuel pour voir s’ils représentent le même appareil. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
CreateFromSnapshotBase64(String)	Crée un objet XboxLiveDeviceAddress à partir d’un instantané stocké dans l’encodage Base64. Utilisez cette méthode pour créer une XboxLiveDeviceAddress à partir du instantané encodé en Base64 retourné à partir d’un appel antérieur à XboxLiveDeviceAddress.GetSnapshotAsBase64. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
CreateFromSnapshotBuffer(IBuffer)	Crée un objet XboxLiveDeviceAddress à partir d’un instantané stocké dans une mémoire tampon. Utilisez cette méthode pour créer une XboxLiveDeviceAddress à partir de la mémoire tampon instantané retournée par un appel antérieur à XboxLiveDeviceAddress.GetSnapshotAsBuffer. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
CreateFromSnapshotBytes(Byte[])	Crée une XboxLiveDeviceAddress à partir d’un instantané stocké sous la forme d’un tableau d’octets. Utilisez cette méthode pour créer un objet XboxLiveDeviceAddress à partir d’un instantané enregistré récupéré avec la méthode XboxLiveDeviceAddress.GetSnapshotAsBytes. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
GetLocal()	Crée une XboxLiveDeviceAddress pour l’appareil local. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
GetSnapshotAsBase64()	Obtient une instantané de la XboxLiveDeviceAddress actuelle sous la forme d’une chaîne encodée en Base64. Vous pouvez enregistrer cette instantané pour l’utiliser ultérieurement comme paramètre base64 dans un appel à XboxLiveDeviceAddress.CreateFromSnapshotBase64. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
GetSnapshotAsBuffer()	Obtient une instantané de la XboxLiveDeviceAddress actuelle et la retourne en tant qu’objet qui implémente IBuffer. Vous pouvez utiliser cette méthode pour enregistrer un instantané pour une utilisation ultérieure avec la méthode XboxLiveDeviceAddress.CreateFromSnapshotBuffer. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
GetSnapshotAsBytes(Byte[], UInt32)	Enregistre une XboxLiveDeviceAddress dans un tableau d’octets. Vous pouvez utiliser cette méthode pour enregistrer un instantané à utiliser avec la méthode XboxLiveDeviceAddress.CreateFromSnapshotBytes. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

Événements

SnapshotChanged

Événement déclenché lorsque le instantané de cette XboxLiveDeviceAddress a changé. Les instantanés sont des formes sérialisées d’objets XboxLiveDeviceAddress qui peuvent être transmis à des appareils distants via des canaux hors bande tels que le matchmaking Xbox Live. Toutefois, ils représentent les informations d’adresse réseau d’un appareil à un moment donné et peuvent changer au fil du temps. Pour éviter les problèmes de connectivité inutiles, vous devez écouter les événements XboxLiveDeviceAddress.SnapshotChanged sur l’adresse de l’appareil local pour savoir quand son contenu instantané a été mis à jour et actualiser les instantané sérialisés partout où vous l’avez transmis ou mis en cache, afin que les appareils distants disposent toujours des informations les plus récentes. Important Cette API n’est pas disponible pour toutes les applications. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.