AlternateIdentities | alternateIdentities - Eigenschaft

PeerFinder.AlternateIdentities | alternateIdentities Property

Ruft eine Liste alternativer appId-Werte ab, die den Peer-Anwendungen auf anderen Plattformen zugeordnet werden sollen.

Syntax


var alternateIdentities = Windows.Networking.Proximity.PeerFinder.alternateIdentities;

Eigenschaftswert

Typ: IMap<String, String> [JavaScript/C++] | System.Collections.Generic.IDictionary<String, String> [.NET]

Eine Liste der alternativen appId-Werte, die den Peer-Anwendungen auf anderen Plattformen zugeordnet werden sollen.

Hinweise

Die AlternateIdentities-Eigenschaft wird verwendet, um alternative Näherungs-App ID hinzuzufügen, die mit den Nähe-App ID von Peer-Apps übereinstimmen, 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, die auf einer anderen Plattform ausgeführt wird zu vergleichen. Wenn Sie eine App für Windows 8 erstellen und die gleiche App auch für Windows Phone erstellen, verfügen die Apps nicht auf beiden Plattformen über dieselbe eindeutige App-ID. Sie können die PeerFinder-Klasse zum Anpassen der Peer-Apps verwenden, indem Sie die App-ID von Windows Phone zur AlternateIdentities-Eigenschaft der Windows-App sowie die App-ID für die Windows-App zu den alternativen Identitäten von Windows Phone hinzufügen.

Die andere Plattform muss das Hinzufügen von alternativen Identitäten auch 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 einschließen, damit die PeerFinder-Klasse die Apps beim Tippen auf einem Windows-Gerät verbindet. Das Format der alternativen Identitätszeichenfolge für eine bestimmte Plattform wird durch die Implementierung der anderen Plattform bestimmt. Informationen zum Abrufen der richtigen alternativen Identitätszeichenfolge für Windows Phone finden Sie in der Dokumentation zur Proximity-API von Windows Phone.

Das Format der Näherungs-App-ID ist <package family name>!<app Id>. Sie können den Namen der Paketfamilie aus der Windows.ApplicationModel.Package.Current.Id.FamilyName-Eigenschaft abrufen. Sie müssen den Wert der App-ID vom Id-Attribut des Application-Elements im Paketmanifest für die App kopieren. Beispielsweise fügt PeerFinder.Add("WindowsPhone", "{1c6379c1-9d5e-4254-8f4c-be7ea24057d1}") eine Windows Phone 8-App-ID als alternative Identität in der Windows 8-App hinzu. PeerFinder.Add("Windows", "b3c3e7ef-371a-464f-a75e-95ddbdcaf974_7fed2v891h66p!App") fügt einer Windows Phone 8-App eine Windows 8-App-ID als alternative Identität hinzu.

Navigieren innerhalb des Funkbereichs (FindAllPeersAsync)

Wenn Sie Peer-Apps verbinden, indem Sie mit der FindAllPeersAsync-Methode nach Geräten innerhalb des Funkbereichs suchen, können Sie jeweils nur eine App-ID zuordnen. Standardmäßig wird für das Peer Matching beim Durchsuchen die Proximity-App-ID von Windows 8 verwendet. Sie können Suchen durchführen, um eine Verbindung mit Peer-Apps auf unterschiedlichen Plattformen herzustellen, indem Sie eine eindeutige "browse"-App-ID an die AlternateIdentities-Eigenschaft anhängen. Sie können die gleiche "browse"-App-ID zur Peer-App auf den anderen Plattformen hinzufügen. Wenn die alternative „Browse“-Identitätszeichenfolge übereinstimmt, findet die PeerFinder-Klasse die Peer-Apps, wenn Sie die FindAllPeersAsync-Methode aufrufen.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

Windows.Networking.Proximity
Windows::Networking::Proximity [C++]

Metadaten

Windows.winmd

Capabilities

proximity
ID_CAP_PROXIMITY [Windows Phone]
ID_CAP_NETWORKING [Windows Phone]

Siehe auch

PeerFinder
Nähe und Tippen (JavaScript)
Nähe und Tippen (C#/VB/C++)
Beispiele
Nähebeispiel

 

 

Anzeigen:
© 2018 Microsoft