#include <dwc.h>
BOOL DWC_ConnectToAnybodyAsync(
u8 numEntry,
const char* addFilter,
DWCMatchedCallback matchedCallback,
void* matchedParam,
DWCEvalPlayerCallback evalCallback,
void* evalParam );
This function creates a mesh-type network for the specified number of people without specifying friends. This is known as "connect-to-anybody peer matchmaking."
The addFilter
argument can be used to configure the conditions for the searched-for player as a matchmaking candidate. The matchmaking index key used in this filter character string must be registered in advance using the DWC_AddMatchKeyInt or DWC_AddMatchKeyString function.
Also, if the argument evalCallback
is specified, each time a matchmaking candidate player is found, the designated evaluation callback function is called. The matchmaking index key can be referenced by using the DWC_GetMatchIntValue
or DWC_GetMatchStringValue
function inside the evaluation callback function. Be sure to evaluate the player based on that value, and return the evaluation value as the return value. Players with an evaluation value of 0 or less are excluded from matchmaking. The higher a player's evaluation value is, the more likely that player will be selected as a matchmaking partner.
If the DWC_ProcessFriendsMatch function is continually called after calling this function, the matchmaking process will continue. The matchmaking completion callback will be called if the matchmaking results in a success, an error, or a cancellation.
numEntry |
The number of people to request (including oneself) to make up the network. A value from 2 to 32 can be set in this argument. |
addFilter |
Character string for the matchmaking condition to be added to the game. If condition is not added, NULL gets passed. Conditions can be written in standard SQL format. The maximum string length that can be set is 127 characters. In a debug build, the number of characters is checked to see if it exceeds this maximum. The character string is copied and maintained in the library. |
matchedCallback |
The pointer to the matchmaking completion callback function. |
matchedParam |
The parameter for the matchmaking completion callback. |
evalCallback |
The pointer to the player evaluation callback function. |
evalParam |
Parameter for player evaluation callback. |
TRUE |
The process starts. The results are indicated via the callback function. |
FALSE |
Not a good state for calling this function. |
DWC_ConnectToFriendsAsync, DWC_AddMatchKey*, DWC_GetMatch*Value, DWCMatchedCallback, DWCEvalPlayerCallback, DWC_ProcessFriendsMatch
12/16/2005 Added a detailed function description.
07/22/2005 Initial version.