次の方法で共有

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()

Base64 でエンコードされた文字列として現在の XboxLiveDeviceAddress のスナップショットを取得します。

このスナップショットを保存して、後で 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 の呼び出しは実行時に失敗します。

適用対象