#include <dwc.h>
typedef void(*) DWCFriendStatusCallback(int index,
u8 status,
const char *statusString,
void *param);| 状態が変化した友達の友達リストインデックス | |
| 友達の状態。DWC_STATUS_*の列挙子 | |
| ゲームで定義したGameSpystatus文字列。文字列は最大255文字+NULL終端。 | |
| DWC_UpdateServersAsync関数/DWC_SetFriendStatusCallback関数で指定したコールバック用パラメータ |
なし
友達の状態が変化したときに呼び出されます。
プレイヤーの通信状態は、statusで表されるstatusフラグと、statusStringで表されるstatus文字列から成っており、GameSpyサーバ上で管理されています。statusフラグはDWCライブラリが自動的にセットしますが、status文字列はDWC_SetOwnStatusString/DWC_SetOwnStatusData関数を用いてアプリケーションが設定することができます。
本コールバック関数はDWC_UpdateServersAsync関数/DWC_SetFriendStatusCallback関数によって設定することができます。
statusの値は、以下のいずれかになります。
| DWC_STATUS_OFFLINE | オフライン 自分がオフラインの時、または相手と友達関係が成立していないとき |
| DWC_STATUS_ONLINE | オンライン(Wi-Fiコネクションサーバにログイン済み) |
| DWC_STATUS_PLAYING | ・クライアントとしてゲームプレイ中(マッチメイクタイプの種類によらない) ・友達指定マッチメイク又はサーバクライアントマッチメイクで、一度でもサーバ交代が起こった後のサーバとしてゲームプレイ中 上記2状態は共通して、この相手に対して接続に行くことは出来ない事を示している。(PLAYING状態は受付可能な状態では無い) |
| DWC_STATUS_MATCH_ANYBODY | ・友達無指定ピアマッチメイク中で接続相手を検索中 ・友達無指定ピアマッチメイク中でサーバとしてゲームプレイ中 |
| DWC_STATUS_MATCH_FRIEND | ・友達指定ピアマッチメイク中で接続相手を検索中 ・友達指定ピアマッチメイク中でサーバとしてゲームプレイ中 |
| DWC_STATUS_MATCH_SC_CL | ・サーバクライアントマッチメイク中のクライアントホストとして、サーバと接続処理中 ・グループID接続のクライアントホストとして、サーバと接続処理中 |
| DWC_STATUS_MATCH_SC_SV | ・サーバクライアントマッチメイク中のサーバホストとしてゲームプレイ中 |
5.1pr2より前の変更履歴はこちら