Share via

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 속성은 다른 플랫폼에서 실행되는 피어 앱의 근접 앱 ID와 일치하는 대체 근접 앱 ID를 추가하는 데 사용됩니다. PeerFinder 클래스는 대체 앱 ID를 사용하여 Windows 8 컴퓨터에서 실행되는 피어 앱과 다른 플랫폼에서 실행되는 피어 앱을 일치합니다. 예를 들어 Windows 8용 앱을 만들고 Windows Phone 동일한 앱을 만드는 경우 앱은 두 플랫폼에서 동일한 고유 앱 ID를 갖지 않습니다. PeerFinder 클래스를 사용하면 Windows Phone 앱의 앱 ID를 Windows 앱의 AlternateIdentities 속성에 추가하고 Windows 앱의 앱 ID를 Windows Phone 대체 ID에 추가하여 피어 앱을 일치시킬 수 있습니다.

다른 플랫폼은 해당 플랫폼에서 근접 앱 ID를 지정할 수 있도록 대체 ID 추가도 지원해야 합니다. Windows 디바이스를 탭할 때 앱을 연결하려면 PeerFinder 클래스에 대한 근접 앱 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만 일치시킬 수 있습니다. 검색할 때 기본적으로 피어 일치는 Windows 8 근접 앱 ID 를 사용합니다. AlternateIdentities 속성에 고유한 "찾아보기" 앱 ID를 추가하여 다른 플랫폼에서 실행되는 피어 앱을 연결할 수 있습니다. 그런 다음 다른 플랫폼의 피어 앱에 동일한 "찾아보기" 앱 ID를 추가할 수 있습니다. "찾아보기" 대체 ID 문자열이 일치하는 경우 FindAllPeersAsync 메서드를 호출할 때 PeerFinder 클래스가 피어 앱을 찾을 수 있습니다.

적용 대상

추가 정보