PeerFinder.AlternateIdentities 屬性

  • 參考

定義

命名空間:
Windows.Networking.Proximity
編輯

取得要與其他平臺上對等應用程式相符的替代 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 屬性可用來新增替代鄰近應用程式識別碼，以符合在其他平臺上執行的對等應用程式鄰近應用程式識別碼。 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類別可以尋找對等應用程式。

適用於

另請參閱