Microsoft.Xna.Framework.GamerServices Namespace

XNA Game Studio 3.1

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
	AvatarAnimation	Provides methods and properties for animating an avatar using standard animations (for example, celebrate).
	AvatarDescription	Provides access to the methods and properties of the description data for an avatar.
	AvatarRenderer	Provides properties and methods for rendering a standard avatar.
	FriendCollection	Represents the complete friends list of a local gamer.
	FriendGamer	Provides the presence information of a friend of the local gamer.
	GameDefaults	Describes a gamer's preferred settings.
	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.
	GamerCollection	Represents a collection of gamers. This collection cannot be modified and is updated automatically during the call to Update.
	GamerPresence	Provides properties to set the rich presence state for a locally signed-in gamer profile.
	GamerPrivilegeException	Thrown if a gamer services or multiplayer API is called without a valid, signed-in profile.
	GamerPrivileges	Describes what operations a gamer is allowed to perform.
	GamerProfile	Profile settings describing information about a gamer such as the gamer's 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.
	GamerServicesComponent	Wraps the functionality of the GamerServicesDispatcher.
	GamerServicesDispatcher	Implements the Windows-specific portion of a GamerServicesDispatcher class.
	GamerServicesNotAvailableException	Thrown if the gamer services system cannot be successfully initialized.
	Guide	Provides access to the Guide user interface.
	GuideAlreadyVisibleException	Thrown if an attmept is made to display a component of the Guide user interface when a Guide component is already displayed.
	SignedInEventArgs	Represents the arguments passed to a SignedIn event.
	SignedInGamer	Represents a gamer (a profile that has an associated gamertag) on the local system.
	SignedInGamerCollection	Represents a collection of gamers on the local system.
	SignedOutEventArgs	Represents the arguments passed to a SignedOut event.

Structures

	Name	Description
	AvatarExpression	Contains the various components of the avatar's face, such as the left and right eyebrows.
	GamerCollection.GamerCollectionEnumerator	Provides the ability to iterate through the gamers in an GamerCollection.

Enumerations

	Name	Description
	AvatarAnimationPreset	Defines standard animations for avatars.
	AvatarBodyType	Defines the body type of the avatar.
	AvatarBone	Defines a list of the useful bones of the avatar model.
	AvatarEye	Defines the standard animation textures for an avatar's eyes.
	AvatarEyebrow	Defines the standard animation textures for an avatar's eyebrows.
	AvatarMouth	Defines the standard animation textures for an avatar's mouth.
	ControllerSensitivity	Indicates how sensitive this gamer prefers controller input to be.
	GameDifficulty	Indicates how difficult this gamer likes things to be.
	GamerPresenceMode	Settings defining the status string that will appear when you view a friend through the Xbox LIVE Guide or on Xbox.com. Use the PresenceMode property to set this option.
	GamerPrivilegeSetting	Describes the conditions in which a privilege is available.
	GamerZone	This style of social gaming preferred by this Xbox LIVE member.
	MessageBoxIcon	Defines the different icons for a message box.
	NotificationPosition	Determines where notifications appear on the screen.
	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. A game that attempts to use these components without XNA Game Studio installed will result in a GamerServicesNotAvailableException.

Concepts

Gamer Services Overview