Share via

Microsoft.Xna.Framework.GamerServices Namespace

  • Article

Contains classes that implement various services related to gamers. These services communicate directly with the gamer, the gamer's data, or otherwise reflect choices the gamer makes. Gamer services include input device and profile data APIs.

Classes

Name Description
Public Class FriendCollection Represents the complete friends list of a local gamer.
Public Class FriendGamer Provides the presence information of a friend of the local gamer.
Public Class GameDefaults Describes a gamer's preferred settings.
Public Class Gamer Abstract base class for types that represent game players (profiles that have an associated gamertag). The concrete types SignedInGamer and NetworkGamer derive from this.
Public Class GamerCollection Represents a collection of gamers. This collection cannot be modified and is updated automatically during the call to Update.
Public Class GamerPresence Provides properties to set the rich presence state for a locally signed-in gamer profile.
Public Class GamerPrivilegeException Thrown if a gamer services or multiplayer API is called without a valid, signed-in profile.
Public Class GamerPrivileges Describes what operations a gamer is allowed to perform.
Public Class GamerProfile Profile settings describing information about a gamer such as their motto, reputation, and gamer picture. This data is accessible for both locally signed in profiles and remote gamers that you are playing with in a multiplayer session.
Public Class GamerServicesComponent Wraps the functionality of the GamerServicesDispatcher.
Public Class GamerServicesDispatcher Implements the Windows-specific portion of a GamerServicesDispatcher class.
Public Class GamerServicesNotAvailableException Thrown if the gamer services system cannot be successfully initialized.
Public Class Guide Provides access to the Guide user interface.
Public Class GuideAlreadyVisibleException Thrown if an attmept is made to display a component of the Guide user interface when a Guide component is already displayed.
Public Class SignedInEventArgs Represents the arguments passed to a SignedIn event.
Public Class SignedInGamer Represents a gamer (a profile that has an associated gamertag) on the local system.
Public Class SignedInGamerCollection Represents a collection of gamers on the local system.
Public Class SignedOutEventArgs Represents the arguments passed to a SignedOut event.

Structures

Name Description
Public Structure GamerCollection.GamerCollectionEnumerator Provides the ability to iterate through the gamers in an GamerCollection.

Enumerations

Name Description
Public Enumeration ControllerSensitivity Indicates how sensitive this gamer prefers controller input to be.
Public Enumeration GameDifficulty Indicates how difficult this gamer likes things to be.
Public Enumeration GamerPresenceMode Settings defining the status string that will appear when you view a friend through the Xbox LIVE Guide or on Xbox.com. This option is set using the PresenceMode property.
Public Enumeration GamerPrivilegeSetting Describes the conditions in which a privilege is available.
Public Enumeration GamerZone This style of social gaming preferred by this Xbox Live member.
Public Enumeration MessageBoxIcon Defines the different icons for a message box.
Public Enumeration NotificationPosition Determines where notifications appear on the screen.
Public Enumeration RacingCameraAngle Indicates which camera angle this gamer prefers to use in racing games.

Remarks

Important

Games for Windows - LIVE is not available to finished games. This functionality is not included in the redistributable version of the XNA Framework, and a game that attempts to use these components without XNA Game Studio installed will result in a GamerServicesNotAvailableException.

See Also

Concepts

Gamer Services Overview