Online Services User Info インターフェース には、ユーザー情報をゲーム内に表示するために、それらの情報を Steam や Epic Online Services といったオンライン サービスから取得するためのツールが用意されています。これには次のユーザー情報が含まれます。
- プラットフォーム プロファイル。
- 表示名。
- アバター。
API の概要
関数
次の表には、User Info インターフェースによって提供される関数の概要が示されています。
| 関数 | 説明 |
|---|---|
| ユーザー情報 | |
QueryUserInfo |
アカウント ID のリストに含まれるユーザーの情報をクエリします。 |
GetUserInfo |
QueryUserInfo によって以前にキャッシュされたアカウント ID のユーザー情報を取得します。 |
| ユーザー アバター | |
QueryUserAvatar |
アカウント ID のリストに含まれるユーザーのアバターをクエリします。 |
GetUserAvatar |
QueryUserAvatar によって以前にキャッシュされたアカウント ID のユーザー アバターを取得します。 |
| プラットフォーム UI | |
ShowUserProfile |
提供されたアカウント ID のプロファイル UI を表示します。 |
User Info へのアクセス
User Info インターフェースを使ったユーザー情報へのアクセスは、他の Online Services インターフェース と同じように行われます。
QueryUserInfo によって、当該のインターフェースに対応するアカウント ID に関連付けられているユーザーの表示名のリストをキャッシュします。QueryUserInfo には、パラメータとしてアクセスする表示名のユーザー アカウント ID のリストを提供する必要があります。ユーザーの表示名にアクセスするには、そのアカウント ID を使って GetUserInfo を呼び出します。
ユーザー アバターへのアクセス
「User Info へのアクセス」セクションで示されているワークフローは、ユーザーのアバターにアクセスする場合にも適用されます。QueryUserAvatar でインターフェースで情報をキャッシュし、GetUserAvatar でそれぞれのアバターを個別に取得します。
プラットフォーム ユーザー プロファイル
ShowUserProfile では、指定したユーザーの、プラットフォーム サービスのユーザー インターフェースを表示します。プラットフォーム サービス プロファイルは、ユーザーが現在ゲームをプレイ中のプラットフォームに特有なものです。プロファイル ユーザー インターフェースの詳細については、お使いのプラットフォーム サービスのドキュメントを参照してください。
追加資料
ヘッダ ファイル
詳細については、必要に応じて「UserInfo.h」ヘッダ ファイルを直接確認してください。User Info インタフェースのヘッダ ファイル「UserInfo.h」は次の場所にあります。
<UNREAL_ENGINE_ROOT>\Engine\Plugins\Online\OnlineServices\Source\OnlineServicesInterface\Public\Online
UE のソース コードの入手方法については、「Unreal Engine のソース コードをダウンロードする」を参照してください。
関数パラメータおよび戻り型
パラメータをパスする方法や、関数から返された結果を処理する方法などを含む、関数のパラメータと戻り型の詳細については、「Online Services の概要」ページの「関数」セクションを参照してください。