Guide.IsTrialMode Property

Determines whether the game is running currently in limited trial mode.

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

Syntax

public static bool IsTrialMode { get; set; }

Property Value

true if the game is running currently in limited trial mode; false otherwise.

Remarks

Best Practice
When a trial game is exiting, you can present a marketplace offer using the Guide.ShowMarketplace method. You can write code that is performed on game exit in the Game.Exit method.

Limited Trial Mode

While in trial mode, games will be unable to use the Xbox LIVE servers to connect to other machines over the Internet for player match or ranked network sessions. Note that this does not affect system link sessions, which are always available.

The Guide.IsTrialMode property always returns true when a game begins. Guide.IsTrialMode may change to false shortly after game launch if a license is detected when a player signs in, or it could change at any time after game launch if a license is acquired.

XNA Creators Club games can be launched in simulated trial mode by setting the Guide.SimulateTrialMode property to true when the game starts. During development, when XNA Creators Club games are running on an Xbox 360 console, there is also an option in the dash to launch a game in simulated trial mode.

XNA Community games downloaded from the Xbox LIVE Marketplace will run in limited trial mode until one of the signed-in gamers acquires a license for the game. Detection of a game license could occur as part of game startup, in response to an in-game purchase, or as part of user signing in.

For XNA Community games running in trial mode, gameplay will be limited to a short trial period. At the end of the gameplay period, the player will see an expiration screen. The player can then either exit the game via the B or Back button or use the X button to unlock the game. If the player chooses to unlock the game, a Marketplace screen will be displayed. The player can then buy the full version of the game.

While the expiration screen shows, Game.IsActive will return false, and all input to the game will be blocked. Rendering can continue. However, the expiration screen obscures most of the rendering process, and any controller vibration will be stopped.

Best Practice
It is generally a good idea to pause the game when Game.IsActive is false.

For XNA Creators Club games running in simulated trial mode there will be no time limitation applied to gameplay.

See Also

Tasks

How To: Detect or Simulate Trial Mode and Present a Marketplace Offer
How To: Pause a Game

Reference

Guide.ShowMarketplace Method
Guide.SimulateTrialMode Property
SignedInGamer.GameDefaults Property
Guide Class
Guide Members
Microsoft.Xna.Framework.GamerServices Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista, Zune