PeerFinder.AlternateIdentities プロパティ

定義

他のプラットフォーム上のピア アプリケーションと一致する代替 appId 値の一覧を取得します。

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)

プロパティ値

IMap<String,String>

IDictionary<String,String>

IMap<Platform::String,Platform::String>

IMap<winrt::hstring,winrt::hstring>

他のプラットフォーム上のピア アプリケーションと一致する代替 appId 値の一覧。

Windows の要件

アプリの機能
ID_CAP_NETWORKING [Windows Phone] proximity ID_CAP_PROXIMITY [Windows Phone]

注釈

AlternateIdentities プロパティは、他のプラットフォームで実行されているピア アプリの近接アプリ ID と一致する代替近接アプリ ID を追加するために使用されます。 PeerFinder クラスは、代替アプリ ID を使用して、Windows 8 コンピューターで実行されているピア アプリと、別のプラットフォームで実行されているピア アプリを照合します。 たとえば、Windows 8 用のアプリを作成し、Windows Phone用に同じアプリを作成した場合、アプリは両方のプラットフォームで同じ一意のアプリ ID を持つことになります。 PeerFinder クラスを使用してピア アプリを照合するには、Windows Phoneのアプリ ID を Windows アプリの AlternateIdentities プロパティに追加し、Windows アプリのアプリ ID をWindows Phoneの代替 ID に追加します。

もう 1 つのプラットフォームでは、そのプラットフォームで近接アプリ ID を指定できるように、代替 ID の追加もサポートする必要があります。 PeerFinder クラスが Windows デバイスでタップするときにアプリを接続するには、他のプラットフォームに近接アプリ ID を含める必要があります。 特定のプラットフォームの代替 ID 文字列の形式は、他のプラットフォームの実装によって決まります。 たとえば、Windows Phoneの正しい代替 ID 文字列を取得するには、Windows Phone近接 API のドキュメントを参照してください。

近接アプリ ID の形式はパッケージ< ファミリ名>です。<アプリ ID>。 パッケージ ファミリ名は 、Windows.ApplicationModel.Package.Current.Id.FamilyName プロパティから取得できます。 アプリのパッケージ マニフェストの Application 要素の Id 属性からアプリ ID の値をコピーする必要があります。 たとえば、 PeerFinder.Add("WindowsPhone", "{1c6379c1-9d5e-4254-8f4c-be7ea24057d1}") Windows 8 アプリの代替 ID として、Windows Phone 8 アプリ ID を追加します。 PeerFinder.Add("Windows", "b3c3e7ef-371a-464f-a75e-95ddbdcaf974_7fed2v891h66p!App")は、Windows Phone 8 アプリの代替 ID として Windows 8 アプリ ID を追加します。

ワイヤレス範囲内での参照 (FindAllPeersAsync)

FindAllPeersAsync メソッドを使用してワイヤレス範囲内のデバイスを参照してピア アプリを接続する場合、一度に一致できるアプリ ID は 1 つだけです。 参照時の既定のピア マッチングでは、Windows 8 近接アプリ ID が使用されます。 別のプラットフォームで実行されているピア アプリを参照して接続するには、一意の "参照" アプリ ID を AlternateIdentities プロパティに追加します。 その後、同じ "参照" アプリ ID を他のプラットフォームのピア アプリに追加できます。 "browse" 代替 ID 文字列が一致する場合、FindAllPeersAsync メソッドを呼び出すと、PeerFinder クラスはピア アプリを検索できます。

適用対象

こちらもご覧ください