XboxLiveDeviceAddress 클래스

정의

네임스페이스:

Windows.Networking.XboxLive

콘솔 또는 기타 인증된 디바이스의 네트워크 위치를 나타냅니다.

이 클래스의 개체는 디바이스(특히 IP 주소 목록)에 대한 연결 정보의 불투명 컬렉션을 나타냅니다. XboxLiveDeviceAddress를 XboxLiveEndpointPairTemplate 클래스의 CreateEndpointPairAsync 또는 CreateEndpointPairForPortsAsync 메서드 중 하나에 전달하여 로컬 디바이스와 지정된 XboxLiveDeviceAddress의 디바이스 간에 XboxLiveEndpointPair를 인스턴스화합니다.

중요

이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.

public ref class XboxLiveDeviceAddress sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveDeviceAddress final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveDeviceAddress

Public NotInheritable Class XboxLiveDeviceAddress

상속

Object Platform::Object IInspectable XboxLiveDeviceAddress

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Xbox One System Apps Extensions for the UWP (10.0.0.1에서 도입되었습니다.) Xbox Live Extension SDK (10.0.10240.0에서 도입되었습니다.) Xbox One Extensions for the UWP (10.0.10240.0에서 도입되었습니다.) Windows Desktop Extension SDK (10.0.16299.0에서 도입되었습니다.)
API contract	Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (v1.0에서 도입되었습니다.)

속성

IsLocal	이 XboxLiveDeviceAddress 가 로컬 디바이스를 나타내는지 여부를 나타내는 부울 값을 가져옵니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
IsValid	이 XboxLiveDeviceAddress 가 유효한지 여부를 나타내는 부울 값을 가져옵니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
MaxSnapshotBytesSize	XboxLiveDeviceAddress.GetSnapshotAsBytes에 전달된 바이트 배열에 필요한 최대 바이트 수를 지정하는 값을 가져옵니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
NetworkAccessKind	이 XboxLiveDeviceAddress와 관련된 XboxLiveEndpointPair 통신에 대해 관찰된 피어 투 피어 네트워크 액세스 수준을 설명하는 값을 가져옵니다. 표시된 액세스는 Xbox Live 멀티 플레이어 네트워킹 API 인프라를 통해 설정된 통신에만 적용됩니다. 안전하지 않은 고유한 통신을 설정하거나 고유한 NAT 통과를 구현하는 경우 해당 코드가 다른 액세스 종류를 발견할 수 있습니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.

메서드

Compare(XboxLiveDeviceAddress)	다른 XboxLiveDeviceAddress 개체를 현재 개체와 비교하여 동일한 디바이스를 나타내는지 확인합니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
CreateFromSnapshotBase64(String)	Base64 인코딩에 저장된 스냅샷 XboxLiveDeviceAddress 개체를 만듭니다. 이 메서드를 사용하여 이전 XboxLiveDeviceAddress.GetSnapshotAsBase64 호출에서 반환된 Base64로 인코딩된 스냅샷 XboxLiveDeviceAddress를 만듭니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
CreateFromSnapshotBuffer(IBuffer)	버퍼에 저장된 스냅샷 XboxLiveDeviceAddress 개체를 만듭니다. 이 메서드를 사용하여 XboxLiveDeviceAddress.GetSnapshotAsBuffer에 대한 이전 호출에서 반환된 스냅샷 버퍼에서 XboxLiveDeviceAddress를 만듭니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
CreateFromSnapshotBytes(Byte[])	바이트 배열로 저장된 스냅샷 XboxLiveDeviceAddress를 만듭니다. 이 메서드를 사용하여 XboxLiveDeviceAddress.GetSnapshotAsBytes 메서드를 사용하여 검색된 저장된 스냅샷 XboxLiveDeviceAddress 개체를 만듭니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
GetLocal()	로컬 디바이스에 대한 XboxLiveDeviceAddress 를 만듭니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
GetSnapshotAsBase64()	현재 XboxLiveDeviceAddress의 스냅샷 Base64로 인코딩된 문자열로 가져옵니다. 이 스냅샷 저장하여 나중에 XboxLiveDeviceAddress.CreateFromSnapshotBase64 호출에서 base64 매개 변수로 사용할 수 있습니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
GetSnapshotAsBuffer()	현재 XboxLiveDeviceAddress의 스냅샷 가져오고 IBuffer를 구현하는 개체로 반환합니다. 이 메서드를 사용하여 나중에 XboxLiveDeviceAddress.CreateFromSnapshotBuffer 메서드에서 사용할 수 있도록 스냅샷 저장할 수 있습니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
GetSnapshotAsBytes(Byte[], UInt32)	XboxLiveDeviceAddress를 바이트 배열에 저장합니다. 이 메서드를 사용하여 XboxLiveDeviceAddress.CreateFromSnapshotBytes 메서드에 사용할 스냅샷 저장할 수 있습니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.

이벤트

SnapshotChanged

이 XboxLiveDeviceAddress에 대한 스냅샷 변경되었을 때 발생하는 이벤트입니다. 스냅샷은 Xbox Live 매치 메이킹과 같은 대역 외 채널을 통해 원격 디바이스로 전송할 수 있는 XboxLiveDeviceAddress 개체의 직렬화된 형태입니다. 그러나 특정 시간에 디바이스의 네트워크 주소 정보를 나타내며 시간이 지남에 따라 변경 될 수 있습니다. 불필요한 연결 문제를 방지하려면 로컬 디바이스 주소에서 XboxLiveDeviceAddress.SnapshotChanged 이벤트를 수신 대기하여 스냅샷 콘텐츠가 업데이트된 시기를 파악하고 원격 디바이스에 항상 최신 정보를 갖도록 전송하거나 캐시한 모든 위치에서 직렬화된 스냅샷 새로 고쳐야 합니다. 중요 이 API는 모든 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.