Configure Rich Presence Strings (Service Configuration)

This topic provides procedures for adding and changing Rich Presence strings in the service configuration for a title.

For an overall introduction to the various elements of the service configuration, see Introducing Service Configuration.

Sections in this topic:

What is a Rich Presence string?

By displaying Rich Presence strings, your title can advertise what a player is doing right now. For example, your title can use Rich Presence strings to show user statistics (such as Away from console) for each gamer. Rich Presence information is visible to gamers who are connected to Xbox Live. Ideally, a Rich Presence string tells other Xbox Live gamers what a player is doing, and where in your title the player is doing it.

For example, a Rich Presence string might inform Mary’s friends that Mary is currently fighting a Blue Troll in the Pink Forest.

Create a Rich Presence string

To create a new Rich Presence string

  1. On the Service Configuration Tasks page for the product instance, or from the left hand menu, click Rich Presence Strings.
  2. On the Rich Presence Strings page, if the New String dialog box is not already displayed, click New.
  3. In the New String dialog box, specify values in the following fields.
    • String Name - Enter a name that characterizes the Rich Presence string, and that you will easily remember and recognize.
      String names can only contain alphanumeric characters or underscores.
      Don’t begin string names with numerals.
      Use underscores instead of spaces.

    • Build your presence string - Enter plain text into the text box for everything except the statistic instances you want to insert. After you’ve typed in the plain text portion, you’ll be ready to insert the tokens that represent a statistic instance value. For example, a presence string might be “Defeated goblin(s)!
    • Insert token - If your presence string contains a statistic instance value, click in the position in the string where you will insert a token. In the previous example, you would place the cursor between “Defeated” and “goblin(s)” in the string “You have defeated goblin(s).”
      Now, click Insert token. This will launch the New Token picker dialog.
      In the New Token dialog, you will see a Token ID of the form {#}, where # starts at 0 for the first token, and increments for each token inserted into the string.
      Click on Select an instance to launch the Add Stat Instance picker. You can use the drop-down list to select the statistic instance whose value will replace the token {#} when shown to the user. Click Add Stat Instance after you’ve selected the statistic instance.
      If you are directly inserting the value of the statistic into your Rich Presence string, click New Token. If you want to use values from a set in the token (and take advantage of being able to localize the strings in the set), select a set by using the drop-down list. When you are finished, click New Token. In the previous example, you would see a string like “Defeated {0} goblin(s)!”
      For info about selecting a statistic instance, see Selecting a Statistic Instance (Service Configuration).
      For more information, please contact your developer account manager (DAM) or refer to the XDK documentation.

      Note dateTime statistics can’t be included in Rich Presence strings.
      Note Rich Presence strings may be up to 44 characters in length.

  4. When you have all of the fields and values for your new string the way that you want them, click Add String to create the string and close the dialog box.

Your new string is now listed on the Rich Presence Strings page.

Note These strings are just your defaults. Any localization that you require will take place in the Localized Strings page.

Change a Rich Presence string

Important

After a title passes Final Certification, existing Rich Presence strings in that title can no longer be changed or deleted.

To make changes to an existing Rich Presence string:

  1. On the Rich Presence Strings page, under Rich Presence Strings, click the Edit icon for the Rich Presence string that you want to make changes to.
  2. In the Edit String dialog box, make the changes that you want.
  3. When all of the options are the way that you want them, click Save String, and then click the Close button in the upper-right corner of the dialog box.

Delete a Rich Presence string

Important

After a title passes Final Certification, existing Rich Presence strings in that title can no longer be changed or deleted.

To delete an existing Rich Presence string:

  1. On the Rich Presence Strings page, under Rich Presence Strings, click the Delete icon for the Rich Presence string that you want to delete.
  2. In the Delete String dialog box, confirm the deletion by clicking Delete.

    Important Deletion of a Rich Presence string is a permanent action and can’t be undone or reversed.