PeerFinder.AlternateIdentities Propriété

public:
 static property IMap<Platform::String ^, Platform::String ^> ^ AlternateIdentities { IMap<Platform::String ^, Platform::String ^> ^ get(); };

static IMap<winrt::hstring, winrt::hstring const&> AlternateIdentities();

public static IDictionary<string,string> AlternateIdentities { get; }

var iMap = PeerFinder.alternateIdentities;

Public Shared ReadOnly Property AlternateIdentities As IDictionary(Of String, String)

Valeur de propriété

Liste des valeurs appId alternatives à mettre en correspondance avec les applications homologues sur d’autres plateformes.

Configuration requise pour Windows

Remarques

La propriété AlternateIdentities est utilisée pour ajouter d’autres ID d’application de proximité qui correspondent aux ID d’application de proximité des applications homologues exécutées sur d’autres plateformes. La classe PeerFinder utilise les AUTRES ID d’application pour faire correspondre une application homologue s’exécutant sur un ordinateur Windows 8 avec une application homologue s’exécutant sur une autre plateforme. Par exemple, si vous créez une application pour Windows 8 et que vous créez également la même application pour Windows Phone, les applications n’auront pas le même ID d’application unique sur les deux plateformes. Vous pouvez utiliser la classe PeerFinder pour faire correspondre les applications homologues en ajoutant l’ID d’application à partir de l’Windows Phone à la propriété AlternateIdentities de votre application Windows et en ajoutant l’ID d’application pour votre application Windows aux autres identités du Windows Phone.

L’autre plateforme doit également prendre en charge l’ajout d’autres identités afin que l’ID d’application de proximité puisse être spécifié sur cette plateforme. Vous devez inclure l’ID d’application de proximité sur l’autre plateforme pour que la classe PeerFinder connecte vos applications lorsque vous appuyez sur un appareil Windows. Le format de la chaîne d’identité alternative pour une plateforme spécifique est déterminé par l’implémentation de l’autre plateforme. Par exemple, pour obtenir la chaîne d’identité alternative appropriée pour Windows Phone, reportez-vous à la documentation de l’API de proximité Windows Phone.

Le format de l’ID d’application de proximité est <le nom de> la famille de package !<ID d’application>. Vous pouvez obtenir le nom de la famille de package à partir de la propriété Windows.ApplicationModel.Package.Current.Id.FamilyName . Vous devez copier la valeur ID de l’application à partir de l’attribut Id de l’élément Application dans le manifeste du package de votre application. Par exemple, PeerFinder.Add("WindowsPhone", "{1c6379c1-9d5e-4254-8f4c-be7ea24057d1}") ajoute un ID d’application Windows Phone 8 en tant qu’identité alternative dans votre application Windows 8. PeerFinder.Add("Windows", "b3c3e7ef-371a-464f-a75e-95ddbdcaf974_7fed2v891h66p!App")ajoute un ID d’application Windows 8 en tant qu’identité alternative dans une application Windows Phone 8.

Navigation dans la plage sans fil (FindAllPeersAsync)

Lorsque vous connectez des applications homologues en recherchant des appareils dans la plage sans fil à l’aide de la méthode FindAllPeersAsync , vous ne pouvez faire correspondre qu’un ID d’application à la fois. Par défaut, la correspondance d’homologues lors de la navigation utilise l’ID d’application de proximité Windows 8 . Vous pouvez rechercher pour connecter des applications homologues s’exécutant sur différentes plateformes en ajoutant un ID d’application « parcourir » unique à la propriété AlternateIdentities. Vous pouvez ensuite ajouter ce même ID d’application « parcourir » à votre application homologue sur les autres plateformes. Si les chaînes d’identité alternatives « parcourir » correspondent, la classe PeerFinder peut trouver les applications homologues lorsque vous appelez la méthode FindAllPeersAsync .

S’applique à

Voir aussi

• Proximité et tapotement (C#/VB/C++)
• Exemple de proximité