Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

オンライン サービスにログインすると、ユーザーは自分の友達やオンラインで出会った他のユーザーに関する情報 (オンラインであるかどうか、彼らのしていること、ゲームに参加可能かどうかなど) を見ることができます。 Presence インターフェース は、オンライン サブシステムにこれらの機能へのアクセスを提供します。

プレゼンス ステータス

ほとんどのオンライン サービスは、「オンライン」、「オフライン」、「不在」などのような各ユーザーの基本的なプレゼンス (存在) の状態について認識します。また、「ロビー内」や「(マップ上で) 対戦中」などのようなゲーム固有の状態も認識します。 ただし、サービス固有のプライバシー ポリシーとアカウント設定により、これらの設定は常には表示されなかったり、一部のユーザーのみに表示されたりして、それ以外のユーザーには表示されない場合もあります。 オンライン サブシステムはこれらのポリシーや設定とやり取りはしませんが、取得する情報はそれらによって影響を受けます。

プレゼンスを定義する

FOnlineUserPresence クラスには、ユーザーのプレゼンスに関するすべての情報が含まれています。 ユーザーが現在オンラインであるかどうかや、ユーザーがゲームをプレイしているかどうかなどの基本情報に加えて、ユーザーのプレゼンス ( FOnlineUserPresenceStatus クラスの使用) には、より詳細な情報が格納されます。 これには通常、表示用のローカライズされた文字列、ユーザーの基本状態を説明するための列挙型の値 (型 EOnlinePresenceState )、および正確なプレゼンス表示メッセージを作成する際に使用可能な、ゲーム固有のカスタム データを保持する一連のキーと値のペアが含まれます。

他のユーザーに関する情報を取得する

特定のユーザーに関するプレゼンス情報を収集するための基本的なフローは、まず最初に QueryPresence を介してオンラインサービスにリクエストし、そのユーザーを FUniqueNetId で指定します。 その操作が終了すると、提供された FOnPresenceTaskCompleteDelegate が呼び出され、ユーザーと、リクエストの成否を示します。 成功した場合、ローカル プレゼンス情報キャッシュには最新のプレゼンス情報が入ります。この情報は GetCachedPresence 関数を通じて利用できます。

ユーザーのプレゼンスを設定する

SetPresence 関数では、オンライン サービスを介してローカル ユーザーのプレゼンス状態を設定します。 オンライン サービスで新しいステータスを確認する必要があるため、これは非同期呼び出しとなります。完了時には FOnPresenceTaskCompleteDelegate 型のデリゲートが呼び出されます。 プレゼンス ステータス自体は、FOnlineUserPresenceStatus クラスによって記述されます。