Contents

queryPlayerGroupActivity(_:withCompletionHandler:)

Finds the number of players in a player group who recently requested a match.

Declaration

func queryPlayerGroupActivity(_ playerGroup: Int, withCompletionHandler completionHandler: (@Sendable (Int, (any Error)?) -> Void)? = nil)
func queryPlayerGroupActivity(_ playerGroup: Int) async throws -> Int

Parameters

  • playerGroup:

    A number that uniquely identifies a subset of players in your game.

  • completionHandler:

    The block that GameKit calls when it completes the request.

    This block receives the following parameters:

    activity

    The number of match requests for the player group during the previous 60 seconds.

    error

    Describes an error if it occurs, or nil if the operation completes.

Discussion

Use this method to update your interface. For example, show players the relative activity in each player group. If one group is less active than others, you might display a warning so players are aware that finding a match in that group may take longer.

See Also

Finding players who request matches