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 (基本的なタイトル レベルの情報を取得) と同等です。
- オフラインまたはブロードキャストしているユーザーをフィルターで除外しません。
引数として使用する関数
XblPresenceGetPresenceForMultipleUsersAsyncXblPresenceGetPresenceForSocialGroupAsync
