Guide.SimulateTrialMode Property

Allows titles to simulate trial mode restrictions when testing using the Development configuration. Setting this property to true in the game constructor will artificially force IsTrialMode to return true.

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

Syntax

public static bool SimulateTrialMode { get; set; }

Property Value

true to simulate trial mode restrictions in a Development configuration; false otherwise.

Remarks

You can set SimulateTrialMode to false at some later point (perhaps calling the ShowMarketplace API at the same time) to simulate purchasing the full game.

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

Reference

Guide.ShowMarketplace Method
Guide.IsTrialMode Property
NetworkGamer.IsGuest Property
Guide Class
Guide Members
Microsoft.Xna.Framework.GamerServices Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista, Zune