Unreal Engine のアクタロールとリモートロール | Unreal Engine 5.8 ドキュメンテーション

ネットワーク対応ゲームプレイで、アクタの ロール と リモートロール では、アクタの状態を変更したり、リモートプロシージャ呼び出しを実行したりするための権限を持つマシンを決定します。これらのプロパティを使用すると、マルチプレイヤーゲームでアクタに関して以下の質問に答えることができます。

このアクタはレプリケートされますか？
誰がこのアクタに対して権限がありますか？
このアクタに対するレプリケーションロールは何ですか？

アクタロールとリモートロールは所有権と同じではありません！詳細については、アクタとアクタの所有接続を参照してください。

アクタのロールとリモートロールを表示する

Unreal Editor の [Details (詳細)] パネルでアクタの現在のロールとリモートロールを確認できます。

アクタのロールとリモートロールは、C++ またはブループリントで取得することもできます。

アクタのロールを取得する

ローカルマシンがこのアクタに対してどの程度制御できるかを決定するには、AActor::GetLocalRole を呼び出します。

C++

AMyActor* MyActor;
...
// Once you have a valid Actor pointer...
const ENetRole LocalRole = MyActor->GetLocalRole();
// LocalRole contains the Actor's Role
...

AMyActor* MyActor;
...
// Once you have a valid Actor pointer...
const ENetRole LocalRole = MyActor->GetLocalRole();
// LocalRole contains the Actor's Role
...

アクタのリモートロールを取得する

リモートマシンがこのアクタに対してどの程度制御できるかを決定するには、AActor::GetRemoteRole を呼び出します。

C++

AMyActor* MyActor;
...
// Once you have a valid Actor pointer...
const ENetRole RemoteRole = MyActor->GetRemoteRole();
// RemoteRole contains the Actor's RemoteRole
...

AMyActor* MyActor;
...
// Once you have a valid Actor pointer...
const ENetRole RemoteRole = MyActor->GetRemoteRole();
// RemoteRole contains the Actor's RemoteRole
...

アクタロールの状態

アクタロールとリモートロールは、ENetRole 列挙型クラスの状態によって表されます (EngineTypes.h で定義されます)。以下の表では、これらの状態を示し、説明しています。

ネットロールの状態	説明
`ROLE_None`	ロールがありません。このアクタはレプリケートされません。
`ROLE_SimulatedProxy`	このアクタのシミュレートされたプロキシ。このアクタは true 状態をシミュレートしますが、状態を変更したりリモート関数を呼び出したりする権限がありません。
`ROLE_AutonomousProxy`	このアクタの自動プロキシ。このアクタは true 状態をシミュレートし、状態を変更したりリモート関数を呼び出したりする権限があります。
`ROLE_Authority`	このアクタの正式な制御。このアクタはネットワーキングお true 状態を保持していて、状態を変更したり関数を呼び出したりする権限があります。このアクタは、プロパティの変更を追跡追跡し、これらを接続されたクライアントにレプリケートします。

クライアントサーバーのロールのマトリックス

Unreal Engine では、ネットワーキング用のクライアントサーバーモデルを使用します。そのため、サーバーは常にレプリケートされたアクタに対する権限があります。これは、レプリケートしたアクタに対して、サーバーのみが ROLE_Authority を確認できることを意味します。レプリケートされていないアクタには、クライアント上に ROLE_Authority のローカルロールと ROLE_None のリモートロールがあります。

以下の表では、ローカルロールとリモートロールのマトリックス (このロールの組み合わせを監視するのがサーバーなのかクライアントか、およびこの組み合わせの意味) を示しています。

ローカルロール	リモートロール	サーバーまたはクライアント	説明
`ROLE_Authority`	`ROLE_AutonomousProxy`	サーバー	このアクタのポーンは接続されたクライアントのいずれかによって制御されます。
`ROLE_AutonomousProxy`	`ROLE_Authority`	クライアント	このアクタのポーンはこの接続されたクライアントによって制御されます。
`ROLE_SimulatedProxy`	`ROLE_Authority`	クライアント	このアクタのポーンは他の接続されたクライアントのいずれかによって制御されます。クライアントによって制御されないレプリケートされたアクタには、このロールの組み合わせもあります。
`ROLE_Authority`	`ROLE_None`	クライアント	これは、レプリケートされていないアクタです。

アクタのレプリケーションのシミュレーション

帯域幅と CPU リソースが過度に使用されるため、サーバーは更新ごとにすべてのアクタをレプリケートしません。代わりに、サーバーは AActor::NetUpdateFrequency プロパティで指定された頻度でアクタをレプリケートします。つまり、アクタの更新間でクライアントで一定の時間が経過します。これにより、アクタでキャラクター移動コンポーネントが途切れ途切れで散発的に見えるようになる場合があります。これを補正するには、クライアントは更新間でキャラクター移動をシミュレートします。

レプリケーションのシミュレーションとキャラクター移動の詳細については、キャラクター移動コンポーネントにおけるネットワーク移動のドキュメントを参照してください。

ロールとリモートロールのリファレンス

関数

名前	説明
CopyRemoteRoleFrom	別のアクタからリモートロールをコピーし、必要に応じて、このアクタをネットワークアクタのリストに追加します。
ExchangeNetRoles	クライアント上にある場合、ロールとリモートロールを交換します。
GetLocalRole	ローカルマシンがこのアクタに対してどの程度制御できるかを返します。
GetRemoteRole	このアクタに対してリモートマシンがどの程度制御できるかを返します。
GetRolePropertyName	ロールのプロパティの名前を取得します。
GetTearOff	true の場合、このアクタは新しいクライアントにレプリケートされなくなり、レプリケートされていたクライアントで「torn off (除去)」されます (`ENetRole::ROLE_Authority` になります)。
PostNetReceiveRole	新しいロールがリモートマシンから受信された後、すぐに呼び出されます。
SetRemoteRoleForBackwardsCompat	リモートロールを下位互換性のために設定する必要があるクラスのコンストラクタで使用されます。
SetRole	このインスタンスで他の副次的エフェクトが発生することなくロールの値を設定します。
SwapRoles	このアクタロールとリモートロールを交換します。注意が必要です。副次的なエフェクトを理解している場合にのみ、この関数を呼び出します。

プロパティ

名前	説明
bExchangedRoles	ロールとリモートロールがクライアント上で交換されているかどうか。

アクタのロールとリモート ロールを表示する