PeerFinder.AlternateIdentities プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
他のプラットフォーム上のピア アプリケーションと一致する代替 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)プロパティ値
他のプラットフォーム上のピア アプリケーションと一致する代替 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 クラスはピア アプリを検索できます。