DWCFriendStatusCallback

構文

#include <dwc.h>
typedef void(*) DWCFriendStatusCallback(int index,
             u8 status,
             const char *statusString,
             void *param);

引数

index 状態が変化した友達の友達リストインデックス
status 友達の状態。DWC_STATUS_*の列挙子
statusString ゲームで定義したGameSpystatus文字列。文字列は最大255文字+NULL終端。
param 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
本コールバックをセットできる関数について追記

5.1pr2より前の変更履歴はこちら