<mx:TrialLicense> Element

Controls suspension behavior of a title with a trial license.

Syntax

<mx:TrialLicense
  SuspendOptOut = string />  

Attributes

SuspendOptOut
Settting this value to “true” causes a title with a trial license to opt out of immediate suspension when the title is hidden and instead have the same 10 minute grace period as titles with non-trial licenses.

Element information

Parent elements <mx:XboxStore>

Remarks

While running using a non-trial license, active titles can be hidden from view and remain running in the background (constrained mode). This is what happens when a user is playing a game and decides to open another app over top of the currently running game. Opening the People app full screen to invite friends to play, for instance, hides the game and puts it in constrained mode. Under normal PLM rules, this game will remain in a constrained state (loaded in memory and running with limited system resources) for up to 10 minutes without user input. At the end of the 10 minutes, if it has still not received input, the app will be suspended (loaded in memory but no longer running).

For trials, this PLM behavior is different to help protect users from accidentally losing time from their trial. For games running on a trial license, whenever the game is hidden from view, the title will be suspended—effectively eliminating the 10 minute grace period for constrained mode. Take note that titles can be considered in constrained mode while still being visible—the immediate suspend behavior for trial licenses only affects titles which are not visible. Snapping an app technically constrains the game, but because the game is still visible, it is not affected by the trial-specific PLM behavior. Hitting the nexus button to return to Home constrains the app but as long as it is visible, it remains active and continues ticking down the trial timer.

This immediate suspension may be perfectly fine for some games. For others, such as those maintaining multiplayer sessions, immediate suspension of the game is likely to kick the user from their match or may be frustrating to the user in some other way.

Example

<Extensions>
  <mx:PackageExtension Category="xbox.store">
    <mx:XboxStore>
      <mx:RelatedProducts>
        <mx:RelatedProduct Id="0eafd21d-2911-4be5-95fb-6dc0b50b6152" />
        <mx:RelatedProduct Id="00000000-0000-0000-0000-000000000000" />
        <mx:TrialLicense SuspendOptOut=true"/>
      </mx:RelatedProducts>
    </mx:XboxStore>
  </mx:PackageExtension>
</Extensions>