Skip to main content

XblPresenceQueryFilters

返されるプレゼンス レコードをフィルターするためにプレゼンス API に渡される構造体。

構文

メンバー

deviceTypes
型: const XblPresenceDeviceType*
デバイスの種類の配列。このフィールドが null の場合、可能なすべての deviceTypes が既定になります。 deviceTypesCount
型: size_t
deviceTypes 配列のサイズ。 titleIds
型: const uint32_t*
結果をフィルターするための titleId のリスト。入力が空のベクターの場合、可能なすべてのタイトルが既定になります。 titleIdsCount
型: size_t
titleIds 配列のサイズ。 detailLevel
型: XblPresenceDetailLevel
結果の詳細レベル。既定は XblPresenceDetailLevel::Title で、基本的なタイトル レベルの情報を取得します。リッチ プレゼンス情報を取得するには、XblPresenceDetailLevel::All を設定してください。 onlineOnly
型: bool
true の場合、API はオフラインのユーザーのレコードをフィルターで除外します。 broadcastingOnly
型: bool
true の場合、API はブロードキャストしていないユーザーのレコードをフィルターで除外します。

解説

フィルターが指定されていない場合、既定値が使用されます:
- すべてのデバイス上の可能なすべてのタイトルのレコードを返します。
- 既定は XblPresenceDetailLevel::Default で、XblPresenceDetailLevel::Title (基本的なタイトル レベルの情報を取得) と同等です。
- オフラインまたはブロードキャストしているユーザーをフィルターで除外しません。

引数として使用する関数

XblPresenceGetPresenceForMultipleUsersAsync
XblPresenceGetPresenceForSocialGroupAsync

要件

ヘッダー: presence_c.h

関連項目

presence_c
最終更新日 2026年8月13日