There is a blog post about it here:

http://android-developers.blogspot.com/2010/06/making-sense-of-multitouch.html

Basic summary: getActionMasked() returns the action for the entire event. There are two types of down and up. First, ACTION_DOWN and ACTION_UP are for the first and last fingers, respectively. For multitouch, ACTION_POINTER_DOWN and ACTION_POINTER_UP tell you about an additional finger going down or up; for these events you can call getActionIndex() for the *index* of the pointer that has changed.

Pointer indices are only meaningful for the current event (they are the raw packed current data); pointer identifiers are maintained consistently across events. getPointerId(int) maps from an index to an id; getX(int) and getY(int) retrieve the current position of a current index; getPointerCount() returns the number of indices in that event.

If you receive an ACTION_MOVE, there has been no change in the number of active fingers, this is just a report in the change in position of all fingers.

If you only care about the current finger positions at the time of receiving the event, you shouldn’t do anything with getHistoricalXxx(). These allow apps to collect all possible movement data since the last motion event report, if they aren’t keeping up with the hardware reports and actually care about every possible movement. They would be useful, for example, for a handwriting recognizer.

Also useful is this blog post on writing an app that supports multitouch but also works on pre-2.0 versions of the platform:

http://android-developers.blogspot.com/2010/07/how-to-have-your-cupcake-and-eat-it-too.html

Also, I’m really looking forward to this. I’ll buy it for sure.

I would, however, like to request something that I’m not sure if you already include in your game. I’d like to see a turn based mode that can operate over long periods of time. Most people I’d like to play with have short periods of time (lunch hours, breaks, etc) over the course of a day when a full game just might not work. An epic week-long game would be really cool.

Also, does Galcon support gaming with particular individuals? Like if I have a few friends across town, can I choose to connect with only with them in a private game?