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 屬性可用來新增替代鄰近應用程式識別碼，以符合在其他平臺上執行的對等應用程式鄰近應用程式識別碼。 PeerFinder類別會使用替代應用程式識別碼來比對在 Windows 8 電腦上執行的對等應用程式，以及在另一個平臺上執行的對等應用程式。 例如，如果您為 Windows 8 建立應用程式，同時為Windows Phone建立相同的應用程式，則應用程式在兩個平臺上都不會有相同的唯一應用程式識別碼。 您可以使用PeerFinder類別，將應用程式識別碼從 Windows Phone 新增至 Windows 應用程式的 AlternateIdentities 屬性，以及將 Windows 應用程式的應用程式識別碼新增至Windows Phone的替代身分識別，來比對對等應用程式。
其他平臺也必須支援新增替代身分識別，以便在該平臺上指定鄰近應用程式識別碼。 您必須在其他平臺上包含 PeerFinder 類別的鄰近應用程式識別碼，才能在點選 Windows 裝置時連接您的應用程式。 特定平臺的替代識別字串格式取決於其他平臺的實作。 例如，若要取得Windows Phone的正確替代識別字串，請參閱Windows Phone鄰近 API 檔。
鄰近應用程式識別碼的格式為< 套件系列名稱 > ！ <應用程式識別碼 >。 您可以從 Windows.ApplicationModel.Package.Current.Id.FamilyName 屬性取得套件系列名稱。 您必須從應用程式套件資訊清單中Application元素的Id 屬性複製應用程式識別碼值。 例如， PeerFinder.Add("WindowsPhone", "{1c6379c1-9d5e-4254-8f4c-be7ea24057d1}") 將 Windows Phone 8 個應用程式識別碼新增為 Windows 8 應用程式中的替代身分識別。 PeerFinder.Add("Windows", "b3c3e7ef-371a-464f-a75e-95ddbdcaf974_7fed2v891h66p!App")在 Windows Phone 8 應用程式中，新增 Windows 8 應用程式識別碼作為替代身分識別。
在無線範圍內流覽 (FindAllPeersAsync)
當您使用 FindAllPeersAsync 方法流覽無線範圍內的裝置來連線對等應用程式時，一次只能比對一個應用程式識別碼。 根據預設，流覽時對等比對使用 Windows 8 鄰近應用程式識別碼 。 您可以將唯一的「流覽」應用程式識別碼新增至 AlternateIdentities 屬性，以流覽以連接在不同平臺上執行的對等應用程式。 然後，您可以將相同的「流覽」應用程式識別碼新增至其他平臺上的對等應用程式。 如果 「browse」 替代識別字串相符，當您呼叫FindAllPeersAsync方法時，PeerFinder類別可以尋找對等應用程式。