PartyDirectPeerConnectivityOptions

ネットワーク内のデバイス間での直接ピアツーピア接続の使用試行を制御するフラグ。

構文

enum class PartyDirectPeerConnectivityOptions  : int32_t  
{  
    None = 0x0,  
    SamePlatformType = 0x1,  
    DifferentPlatformType = 0x2,  
    AnyPlatformType = SamePlatformType | DifferentPlatformType,  
    SameEntityLoginProvider = 0x4,  
    DifferentEntityLoginProvider = 0x8,  
    AnyEntityLoginProvider = SameEntityLoginProvider | DifferentEntityLoginProvider,  
    OnlyServers = 0x10,  
}  

定数

定数	説明
None	フラグは指定されていません。フラグがないということは、直接ピア接続の試行が許可されていないことを意味します。デバイス間のすべてのエンドポイントメッセージとチャットデータは、常に透過的クラウドリレーサーバー経由で送信され、IP アドレス情報が交換されることはありません。
SamePlatformType	同じプラットフォームタイプのデバイス間で直接ピアツーピア接続が試行されることがあります。一対のデバイスは、それぞれが使用する特定の Party ライブラリに関連付けられているハードウェアや OS プラットフォーム (例: Windows PC、XBOX ゲーム機、iOS ベースのモバイルデバイス) が同じ種類であると識別された場合、直接ピアツーピア接続の確立を試みます。このフラグは単独では直接ピアツーピア接続の試行を許可しないことに注意してください。`SameEntityLoginProvider` フラグと `DifferentEntityLoginProvider` フラグのいずれか、または両方と組み合わせる必要があります。このフラグは PartyNetworkConfiguration 構造体内では `OnlyServers` フラグと組み合わせることはできません。PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 値の一部としては `OnlyServers` と組み合わせられます。
DifferentPlatformType	異なるプラットフォームタイプのデバイス間で直接ピアツーピア接続が試行されることがあります。一対のデバイスは、それぞれが使用する特定の Party ライブラリに関連付けられているハードウェアや OS プラットフォーム (例: Windows PC、XBOX ゲーム機、iOS ベースのモバイルデバイス) が異なる種類であると識別された場合、直接ピアツーピア接続の確立を試みます。このフラグは単独では直接ピアツーピア接続の試行を許可しないことに注意してください。`SameEntityLoginProvider` フラグと `DifferentEntityLoginProvider` フラグのいずれか、または両方と組み合わせる必要があります。このフラグは PartyNetworkConfiguration 構造体内では `OnlyServers` フラグと組み合わせることはできません。PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 値の一部としては `OnlyServers` と組み合わせられます。
AnyPlatformType	プラットフォームタイプに関係なくデバイス間で直接ピアツーピア接続が試行されることがあります。このフラグは ```SamePlatformType	DifferentPlatformType``` と等価です。
SameEntityLoginProvider	同じプロバイダーを使用してログインされた認証済みユーザー PlayFab エンティティ ID を持つデバイス間で直接ピアツーピア接続が試行されることがあります。ローカルユーザーをネットワークに最初に認証しているデバイスは、新たに認証しているユーザーと同じプロバイダー (例: XBOX Live、Facebook、iOS、Google) を使用してログインされた認証済みユーザー PlayFab エンティティ ID を少なくとも 1 つ持つリモートデバイスとの直接ピアツーピア接続の確立を試みます。このフラグは単独では直接ピアツーピア接続の試行を許可しないことに注意してください。`SamePlatformType` フラグと `DifferentPlatformType` フラグのいずれか、または両方と組み合わせる必要があります。このフラグは PartyNetworkConfiguration 構造体内では `OnlyServers` フラグと組み合わせることはできません。PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 値の一部としては `OnlyServers` と組み合わせられます。
DifferentEntityLoginProvider	異なるプロバイダーを使用してログインされた認証済みユーザー PlayFab エンティティ ID を持つデバイス間で直接ピアツーピア接続が試行されることがあります。ローカルユーザーをネットワークに最初に認証しているデバイスは、新たに認証しているユーザーと同じプロバイダー (例: XBOX Live、Facebook、iOS、Google) を使用してログインされた認証済みユーザー PlayFab エンティティ ID を持たないリモートデバイスとの直接ピアツーピア接続の確立を試みます。このフラグは単独では直接ピアツーピア接続の試行を許可しないことに注意してください。`SamePlatformType` フラグと `DifferentPlatformType` フラグのいずれか、または両方と組み合わせる必要があります。このフラグは PartyNetworkConfiguration 構造体内では `OnlyServers` フラグと組み合わせることはできません。PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 値の一部としては `OnlyServers` と組み合わせられます。
AnyEntityLoginProvider	認証済みユーザー PlayFab エンティティ ID のログインに使用されたプロバイダーに関係なく、デバイス間で直接ピアツーピア接続が試行されることがあります。このフラグは ```SameEntityLoginProvider	DifferentEntityLoginProvider``` と等価です。
OnlyServers	いずれかのデバイスに PlayFab エンティティタイプが `game_server` の認証済みユーザーが少なくとも 1 人存在する場合、デバイス間で直接ピアツーピア接続が試行されることがあります。ローカルユーザーをネットワークに最初に認証しているデバイスは、PartyManager::CreateLocalUserWithEntityType() で指定されたように、ローカルユーザーまたはリモートデバイス上のユーザーが `game_server` の PlayFab エンティティタイプである場合、リモートデバイスとの直接ピアツーピア接続の確立を試みます。つまり、プレイヤーのデバイスが互いに直接接続することはなく、サーバーデバイスにのみ接続します。サーバーデバイスは、すべてのプレイヤーおよび他のサーバーデバイスに直接接続を試みます。このフラグは PartyNetworkConfiguration 構造体内では `SamePlatformType`、`DifferentPlatformType`、`SameEntityLoginProvider`、または `DifferentEntityLoginProvider` のいずれのフラグとも組み合わせることはできません。PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 値の一部としてはそれらのフラグと組み合わせられます。

注釈

最初のユーザーをネットワークに正常に認証する過程で、ネットワークの PartyNetworkConfiguration 構造体で宣言されたこれらのフラグによって許可されている場合、デバイスは既にネットワークに参加している他のデバイスと直接ピアツーピア接続を確立しようとする場合があります。試行が成功した場合、これらの直接接続を使用してデバイス間でエンドポイントメッセージとチャットデータが送信されます。デバイス間の環境的な非互換性のために試行が失敗した場合、それらのデバイス間のすべての通信は代わりに透過的クラウドリレーサーバー経由で送信されます。これらのフラグによってデバイスが直接ピア接続を試行することが許可されていない場合、IP アドレス情報を交換することはなく、エンドポイントメッセージとチャットデータは常に透過的クラウドリレーサーバー経由で送信されます。

ローカルデバイスが特定のリモートデバイスに対して実際に直接ピアツーピア接続を確立したかどうかは、PartyNetwork::GetDeviceConnectionType() を呼び出して判別できます。

直接ピア接続が成功すると、一部のデバイス間でより低いレイテンシーが得られる可能性がありますが、それを確立するにはユーザーがデバイスの IP アドレスを他者に開示する必要があります。これはプライバシー上の懸念や、悪意のあるユーザーがタイトルの外部でピアのデバイスやインターネット接続を攻撃する可能性を有効化するといった懸念があります。また、ポリシー上の理由により特定のプラットフォームでは許可されない場合もあります。パフォーマンスおよびセキュリティ目標に応じて適切なフラグを使用してください。

特定のネットワークの PartyNetworkConfiguration::directPeerConnectivityOptions 値に加えて、PartyManager::SetOption() を使用して PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask を設定することにより、認証するすべてのネットワークに対して、デバイスによってこれらのフラグをさらに制約することが任意で可能です。すべてのフラグはビット単位 AND 操作を使用して評価されます。つまり、特定のフラグが特定のネットワークのデバイスのペアに対して有効になるのは、それが 3 つの場所で有効になっている場合のみです。すなわち、ネットワークの PartyNetworkConfiguration 構造体、および両方のデバイスのそれぞれのローカルマスクオプションです。Party ネットワークが該当する形式の直接ピア接続を許可していても、いずれかのデバイスがフラグを有効にしないことで、IP アドレスの開示およびその間の直接接続の試行を一方的にオプトアウトできます。PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 値は、ネットワークによって有効化されたすべての直接ピア接続を許可する既定に設定されているため、デバイス固有の要件でその関与する直接ピア接続の一部またはすべてを防止する必要がある場合のみ、これを構成すればよいということになります。

過剰なリソース消費を回避するため、Party ライブラリは、これらのフラグによって許可されている場合でも、現在参加しているすべてのネットワーク全体で、あるデバイスが構成された最大数を超える直接ピア接続を確立しようとしないよう、内部的に防止します。これは、より多くのリモートデバイスを持つ大規模または複数のネットワークにデバイスが参加する機能には影響しません。追加のデバイスとの通信は、単に透過的クラウドリレーサーバー経由で送信されるだけです。この直接ピア接続の最大数を変更するには、PartyManager::SetOption() を使用して PartyOption::LocalDeviceMaxDirectPeerConnections を設定します。

使用中の特定の基盤となる送信方法が全体的な論理的な通信能力を変更するわけではないため、特定のデバイスのペアに対して直接ピアツーピア接続の可用性を積極的に強制しないこと (つまり、PartyNetwork::GetDeviceConnectionType() が PartyDeviceConnectionType::DirectPeerConnection 以外の値を報告する場合に PartyNetwork::LeaveNetwork() を呼び出さないこと) をお勧めします。ゲームデザインに直接ピア接続を奨励する最大メッセージレイテンシーに関する厳格な要件がある場合は、送信メカニズムに基づく抽象的な仮定を行うのではなく、PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds 統計によって報告されるそのレイテンシーの現在の具体的な観察に対して行動することをお勧めします。そうでない場合、環境要因が制御外にあるために近くの透過的クラウドリレーサーバーを常に使用する必要がある同じフレンドグループとプレイしようとしているユーザーを、継続的に妨げる可能性があります。

要件

ヘッダー: Party.h

XBOX Services

PlayFab

構文

定数

注釈

要件

関連項目

​構文

​定数

​注釈

​要件

​関連項目

構文

定数

注釈

要件

関連項目