Mitch Walker : XNA Game Studio

Finish the...

mitchw — Sat, 29 Nov 2008 01:48:00 GMT

When we shipped XNA Game Studio 3.0 last month, and then turned on Xbox LIVE Community Games this month, that, to me, really completed our initial vision for XNA Game Studio, the changes in the way games are made, and creating opportunities for a new class of game developers. While there will always be a list of things to be added or improved to XNA Game Studio and the XNA Framework, I was having trouble finding tough, interesting problems to solve, which is what motivates me.

So I’ve taken my love of games, of creating platforms and tools, and of a particular game series and found my next big challenge to tackle. A couple of weeks ago, I started as a Program Manager on the Microsoft Halo Studio team. I’m joining a(nother) team filled with very talented people and I’m excited about the possibilities.

Unfortunately, what I’ll be working on won’t lend itself to public blogging much anymore…not that I’ve been a regular blogger anyway. And I usually don’t post (or twitter) about day to day stuff. Me getting another Diet Dew from the fridge just doesn’t seem that interesting. J I’ll keep this blog around for a bit and see how it goes.

I’ll still be involved in the XNA Game Studio community, but now from the “other” side…a creator…as I continue to learn, create, and wait to see what the team comes up with next.

-Mitch

The One About Storage

mitchw — Thu, 16 Oct 2008 06:31:00 GMT

So I’ve played quite a few XNAGS games, and quite a few that have been released to Xbox LIVE Marketplace as part of the Xbox LIVE Community Games beta. Based on the types of issues we’ve seen and feedback in general about good development practices, we set out to create the “best practices” for creating Community Games document. This will be a living document that is continuously updated and expanded upon as we find out what works, what doesn’t work, what is difficult, and what are some things most games should attempt to do. There is one issue, however, that I’ve seen crop up quite often and I figure it’s worth discussing in more depth what it is, what causes it, and how to prevent it.

Let’s call it the “Storage API Hang of Fun”. You’ve probably run across it. You build your game, add save game or high score support and being a good XNAGS citizen, use the Storage APIs to get a hold of a proper StorageContainer so you can read and write the files to the correct place. Everything seems to be working well; it’s time to beta test! So you package up your game and hand it out to a few people to try.

“Your game freezes my Xbox 360”

What? How can this be? It was working perfectly on my machine! I thought the purpose of a console was that it is a fixed hardware platform that is easy to develop against since everyone will have the same hardware!

Except there is one area that each console can be slightly different: Storage devices, or more specifically, the number of devices available. Ask the person who is having trouble if they have a HDD and a Memory Unit plugged in. Most likely they do. Have them remove the Memory Unit and I bet the game starts to function properly. Problem solved! But why did it happen? Let’s take a look into a couple of areas that have led you down this path.

The Guide

In XNA Game Studio 2.0 we provided access to Gamer Profiles and the Guide functionality of the Xbox 360. The Guide is a system service that is running in the background of your game. This is the UI that is displayed when the user hits the silver Xbox 360 button on their controllers, want to create a Friend request, view their messages, etc. The system “hooks” our call to GraphicsDevice.Present (which gets called for you inside of Game.EndDraw). Inside of this, it performs any input processing and drawing, which is how it can draw on top of your game without you needing to do anything.

The only thing you need to do is to make sure your game is running, i.e. having Update and Draw called into (and you allowing them to return) at least 15 times a second (the recommended minimum). As long as your game isn’t blocked on the main thread, the Guide will be able to come and go as it pleases and everyone is happy.

Unless you block the main thread. This is why we designed many of the Guide APIs to use the .NET asynchronous call pattern. If the particular Guide API you are calling requires user input and expects data to return, then you have to call the Guide API such that it occurs on a background thread…this allows your main thread to continue to run, which will eventually call GraphicsDevice.Present.

Storage APIs

Guide.BeginShowStorageDeviceSelector is one such API. The purpose of this API is to allow the user to choose what storage device they would like the game to read and write from. Since the Xbox 360 can have any combination of a HDD and up to two Memory Units, a “well behaved” game will allow the user to choose whichever device that is present.

When we released XNA Game Studio Express, we provided a non-asynchronous Guide.ShowStorageDeviceSelector API, knowing that on the Xbox 360, calling this on the main thread would instantly lock your console. We provided for those that would like to call this blocking version from a background thread. In XNAGS 2.0 we introduced many more Guide APIs and we wanted to clean things up a bit and make them more consistent. We realized that the correct way to call this API was to call it asynchronously, so we removed the blocking version and helped those unfamiliar with the pattern to move their code. The native APIs that we call by default won’t display the selection UI if there is only one storage device available. Instead it will return instantly with the “default” device. In our first release, we passed in a flag that basically says “always show the UI”. In another effort to help make this easier, we stopped passing this flag in XNAGS 2.0 so that if only one device is available, the call will return immediately. Unfortunately the combination of these two changes (requiring you to call it asynchronously and not display the UI if there is only one device), led many people to write the following code:

IAsyncResult result = Guide.BeginShowStorageDeviceSelector(...);

while(result.IsCompleted == false)

{

}

StorageDevice device = Guide.EndShowStorageDeviceSelector(result);

If you call this piece of code on the main thread…what will happen? The Begin call will succeed, we’ll then sit there and spin until the user has selected the device they want to use and the operation is “complete”. We’ll then call the End method and get the device. But if we’re spinning on IsCompleted, then that means GraphicsDevice.Present is not getting called, which means the user won’t be able to select a device, so that while condition will never complete.

The game is now deadlocked. The user will have to reboot their Xbox 360.

Unless…they only have one storage device available. In which case, IsCompleted will immediately be true, you’ll get down to the End call and everything will return normally!

So, a long description of a relatively simple problem and one that is easy to get yourself into. How do we fix it? By handling the async pattern correctly. You have two choices and they are both valid. One is to store the IAsyncResult as a member variable in your game and check IsCompleted inside of your Update call. The other is to pass in a callback method to BeginShowStorageDeviceSelector. Once the operation is completed, your method will get called, the IAsyncResult will get passed to you, and you can use it to complete the operation. I generally prefer the callback method, but again, either pattern is equally correct.

Here’s a simple example of how you can call this API so that it behaves correctly regardless of the number of storage devices the user has.

public class MyGameState

{

public StorageDevice Device;

}

public class MyGame : Game

{

protected override void LoadContent()

{

// Some object you want to have passed into the callback

MyGameState myGameState = new MyGameState();

Guide.BeginShowStorageDeviceSelector(StorageCompletedCallback, myGameState);

}

void StorageCompletedCallback(IAsyncResult result)

{

// Retrieve the state you passed in

MyGameState myGameState = (MyGameState)result.AsyncState;

// Complete the call and retrieve the selected StorageDevice

myGameState.Device = Guide.EndShowStorageDeviceSelector(result);

}

Hopefully if you’ve run into this problem with your games, you now have a better understanding of what is occurring, and how to fix it.

Audio Compression using XACT

mitchw — Sat, 28 Apr 2007 03:25:00 GMT

There are two pieces of feedback that I hear quite a bit related to the audio support in XNA Game Studio Express.

It only supports WAV files. All of my sounds are in a different format, such as WMA.
Audio binaries are too large. WAV isn't compressed, so my music tracks are huge!

We're investigating what we can do for the first issue, which would obviously help the second issue at the same time. But there is some support for compressing your audio files in the current product, using the XACT tool; it's just not easy to discover. XACT supports ADPCM compression on Windows and XMA compression on the Xbox 360. You can get about 4:1 compression with ADPCM and even better with XMA. So while perhaps not as high as some other encodings, such as WMA, it does offer quite a substantial savings.

So how do you enable compression for your Wavebanks? Let's take a look:

Create an XACT project and a Wave Bank
Start the XACT editor by using the Start menu shortcut Microsoft XNA Game Studio Express -> Tools -> Microsoft Cross-Platform Audio Creation Tool (XACT). Create a new project and add a new Wave Bank to the project.

Add some WAV files to the Wave Bank
While we won't be playing any sounds during this, we do want to see the results of the compression. Once your done with this, you should see something like the below screenshot.

Create a new Compression Preset
You can create a group of compression settings via a Compression Preset. This allows you to reuse the settings across multiple Wave Banks. This is also why it's a bit hidden. Rather than adjusting the compression settings on the sounds themselves or the Wave Bank, we do it here. You can create a new Compression Preset easily by right-clicking on the Compression Presets item in the explorer.

Tweak Settings
After you've created it, you can see the default compression settings for ADPCM and XMA. You do have the ability to change some of these settings, although we'll just leave the defaults for this exercise.

Apply the Compression Preset to the Wave Bank.
This is as easy as selecting the Wave Bank we created earlier, and then selecting the Compression Preset we just created in the Properties window for the Wave Bank. This tells the XACT compiler that we would like it to compress the WAV files using the preset settings when it builds the Wave Bank binaries.

Done!
If we look at the details for the WAV files that are in the Wave Bank, we see that they now indicate they are compressed and how much space is saved.

I hope this was helpful for those that didn't know about the ability to compress your audio binaries using XACT. While not as compressed as some other formats, it should provide for smaller game sizes, especially when including audio assets for background music.

XNA Happenings

mitchw — Thu, 26 Oct 2006 19:52:00 GMT

You've probably seen the post announcing we're releasing a Beta 2 of XNA Game Studio Express. This release contains lots of fixes and tweaks based on feedback and it includes the much anticipated Content Pipeline! As we get closer to release, I'll have a post that explains some of the changes.

If you want to get a sneak peak at what's coming in the beta, then you should stop by the Seattle Code Camp v2.0 that is happening this weekend. There are a lot of great sessions, including 3 XNA related sessions:

Making an XNA Game for the Xbox 360
Introduction to the Programmable Pipeline in XNA
Exploring the XNA Framework

I'm giving the last session where we'll be looking at new features and changes in the XNA Framework, a little peak into the Content Pipeline and our support for the Xbox 360!