XboxLiveDeviceAddress Класс

Определение

Пространство имен:

Windows.Networking.XboxLive

Представляет сетевое расположение консоли или другого устройства, прошедшего проверку подлинности.

Объекты этого класса представляют непрозрачную коллекцию сведений о подключении к устройству (в частности, список IP-адресов). Вы передаете xboxLiveDeviceAddress в один из методов CreateEndpointPairAsync класса XboxLiveEndpointPairAsync или CreateEndpointPairForPortsAsync, чтобы создать экземпляр XboxLiveEndpointPair между локальным устройством и устройством на заданном xboxLiveDeviceAddress.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих 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 доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
IsValid	Возвращает логическое значение, указывающее, является ли данный объект XboxLiveDeviceAddress допустимым . Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
MaxSnapshotBytesSize	Возвращает значение, указывающее максимальное количество байтов, необходимое для массива байтов, переданного в XboxLiveDeviceAddress.GetSnapshotAsBytes. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
NetworkAccessKind	Возвращает значение, описывающее уровень однорангового доступа к сети, наблюдаемый для связи XboxLiveEndpointPair с этим xboxLiveDeviceAddress. Указанный доступ применяется только к обмену данными, установленными через инфраструктуру API многопользовательских сетей Xbox Live. Если вы устанавливаете собственный небезопасный обмен данными или реализуете собственный обход NAT, вы можете обнаружить, что этот код сталкивается с другим типом доступа. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.

Методы

Compare(XboxLiveDeviceAddress)	Сравнивает другой объект XboxLiveDeviceAddress с текущим объектом, чтобы увидеть, представляют ли они одно и то же устройство. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
CreateFromSnapshotBase64(String)	Создает объект XboxLiveDeviceAddress из snapshot, хранящегося в кодировке Base64. Используйте этот метод для создания xboxLiveDeviceAddress из snapshot в кодировке Base64, возвращенного из предыдущего вызова XboxLiveDeviceAddress.GetSnapshotAsBase64. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
CreateFromSnapshotBuffer(IBuffer)	Создает объект XboxLiveDeviceAddress из snapshot, хранящегося в буфере. Используйте этот метод для создания xboxLiveDeviceAddress из буфера snapshot, возвращенного из предыдущего вызова XboxLiveDeviceAddress.GetSnapshotAsBuffer. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
CreateFromSnapshotBytes(Byte[])	Создает xboxLiveDeviceAddress из snapshot, хранящегося в виде массива байтов. Используйте этот метод для создания объекта XboxLiveDeviceAddress из сохраненного snapshot, полученного с помощью метода XboxLiveDeviceAddress.GetSnapshotAsBytes. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
GetLocal()	Создает xboxLiveDeviceAddress для локального устройства. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
GetSnapshotAsBase64()	Возвращает snapshot текущего объекта XboxLiveDeviceAddress в виде строки в кодировке Base64. Вы можете сохранить эту snapshot для последующего использования в качестве параметра base64 в вызове XboxLiveDeviceAddress.CreateFromSnapshotBase64. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
GetSnapshotAsBuffer()	Получает snapshot текущего объекта XboxLiveDeviceAddress и возвращает его в виде объекта, реализующего IBuffer. Этот метод можно использовать для сохранения snapshot для последующего использования с методом XboxLiveDeviceAddress.CreateFromSnapshotBuffer. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.
GetSnapshotAsBytes(Byte[], UInt32)	Сохраняет xboxLiveDeviceAddress в массив байтов. Этот метод можно использовать для сохранения snapshot для использования с методом XboxLiveDeviceAddress.CreateFromSnapshotBytes. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.

События

SnapshotChanged

Событие, возникающее при изменении snapshot для этого объекта XboxLiveDeviceAddress. Моментальные снимки — это сериализованные формы объектов XboxLiveDeviceAddress , которые можно передавать на удаленные устройства по внештатным каналам, таким как xbox Live matchmaking. Однако они представляют сведения о сетевом адресе устройства в определенное время и могут меняться со временем. Чтобы избежать ненужных проблем с подключением, следует прослушивать события XboxLiveDeviceAddress.SnapshotChanged по адресу локального устройства, чтобы узнать, когда было обновлено содержимое snapshot, и обновлять сериализованный snapshot в любом месте, где вы его передали или кэшировали, чтобы удаленные устройства всегда имели последнюю информацию. Важно! Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API будут завершаться ошибкой во время выполнения.