PeerFinder.AlternateIdentities Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Liste alternativer appId-Werte ab, die mit Peeranwendungen auf anderen Plattformen übereinstimmen.
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)Eigenschaftswert
Eine Liste alternativer appId-Werte, die mit Peeranwendungen auf anderen Plattformen übereinstimmen sollen.
Windows-Anforderungen
| App-Funktionen |
ID_CAP_NETWORKING [Windows Phone]
proximity
ID_CAP_PROXIMITY [Windows Phone]
|
Hinweise
Die AlternateIdentities-Eigenschaft wird verwendet, um alternative Näherungs-App-IDs hinzuzufügen, die den Näherungs-App-IDs von Peer-Apps entsprechen, die auf anderen Plattformen ausgeführt werden. Die PeerFinder-Klasse verwendet die alternativen App-IDs, um eine Peer-App, die auf einem Windows 8-Computer ausgeführt wird, mit einer Peer-App abzugleichen, die auf einer anderen Plattform ausgeführt wird. Wenn Sie beispielsweise eine App für Windows 8 erstellen und dieselbe App auch für Windows Phone erstellen, verfügen die Apps nicht über dieselbe eindeutige App-ID auf beiden Plattformen. Sie können die PeerFinder-Klasse verwenden, um die Peer-Apps abzugleichen, indem Sie die App-ID aus dem Windows Phone der AlternateIdentities-Eigenschaft Ihrer Windows-App hinzufügen und die App-ID für Ihre Windows-App den alternativen Identitäten des Windows Phone hinzufügen.
Die andere Plattform muss auch das Hinzufügen alternativer Identitäten unterstützen, damit die Näherungs-App-ID auf dieser Plattform angegeben werden kann. Sie müssen die Näherungs-App-ID auf der anderen Plattform für die PeerFinder-Klasse einschließen, um Ihre Apps zu verbinden, wenn Sie mit einem Windows-Gerät tippen. Das Format der alternativen Identitätszeichenfolge für eine bestimmte Plattform wird durch die Implementierung der anderen Plattform bestimmt. Wenn Sie beispielsweise die richtige alternative Identitätszeichenfolge für Windows Phone abrufen möchten, lesen Sie die Dokumentation zur Windows Phone Näherungs-API.
Das Format der Näherungs-App-ID ist <der Paketfamilienname>!<App-ID>. Sie können den Paketfamiliennamen aus der Windows.ApplicationModel.Package.Current.Id.FamilyName-Eigenschaft abrufen. Sie müssen den App-ID-Wert aus dem Id-Attribut des Application-Elements im Paketmanifest für Ihre App kopieren. Fügen Sie beispielsweise PeerFinder.Add("WindowsPhone", "{1c6379c1-9d5e-4254-8f4c-be7ea24057d1}") eine Windows Phone 8-App-ID als alternative Identität in Ihrer Windows 8-App hinzu. PeerFinder.Add("Windows", "b3c3e7ef-371a-464f-a75e-95ddbdcaf974_7fed2v891h66p!App")fügt eine Windows 8-App-ID als alternative Identität in einer Windows Phone 8-App hinzu.
Durchsuchen innerhalb des drahtlosen Bereichs (FindAllPeersAsync)
Wenn Sie Peer-Apps verbinden, indem Sie mithilfe der FindAllPeersAsync-Methode nach Geräten innerhalb des drahtlosen Bereichs suchen, können Sie jeweils nur eine App-ID abgleichen. Standardmäßig wird beim Durchsuchen der Peerabgleich die Windows 8-Näherungs-App-ID verwendet. Sie können peer-Apps verbinden, die auf verschiedenen Plattformen ausgeführt werden, indem Sie der AlternateIdentities-Eigenschaft eine eindeutige App-ID hinzufügen. Sie können dann die gleiche App-ID für "Durchsuchen" ihrer Peer-App auf den anderen Plattformen hinzufügen. Wenn die alternativen Identitätszeichenfolgen "durchsuchen" übereinstimmen, kann die PeerFinder-Klasse die Peer-Apps finden, wenn Sie die FindAllPeersAsync-Methode aufrufen.