Guide.ShowGameInvite Method

Displays the game invitation user interface.

Namespace: Microsoft.Xna.Framework.GamerServices
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public static void ShowGameInvite (
         PlayerIndex player,
         IEnumerable<Gamer> recipients
)

Parameters

• player
  Index of the player initiating the invitation.
• recipients
  List of gamers who receive the invitation. If null, the Guide will prompt the player to specify a recipient.

Remarks

Best Practice
You can check GamerPrivileges.AllowCommunication to determine if a player is allowed to send and receive communications prior to displaying a menu option that would call this method.

Note

When someone accepts an invitation for Xbox LIVE Community Games, but the game is not installed already on his or her computer, the invited player will be taken to the game offer. The offer enables the invited player to download the game and accept the invitation to start the game.

For creator games still waiting to pass peer review, the game invitation will be sent over the Xbox LIVE service to the other player. If the game is not installed the invited player will be prompted with a message indicating that he or she can get the game from the game creator.

See Also

Reference

NetworkSession.InviteAccepted Event
NetworkSession.JoinInvited Method
NetworkSession.BeginJoinInvited Method
NetworkSession.EndJoinInvited Method
GamerPrivileges.AllowCommunication Property
Guide Class
Guide Members
Microsoft.Xna.Framework.GamerServices Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista