DWC_CreateExchangeToken

構文

#include <dwc.h>
void DWC_CreateExchangeToken(const DWCUserData *userdata,
                             DWCFriendData *token);

引数

userdata ユーザデータが格納されたDWCUserData構造体へのポインタ
token DSワイヤレス通信で送信するための友達情報を格納するバッファへのポインタ

返り値

なし

説明

userdataで指定された自分のユーザデータから、DSワイヤレス通信で交換するための友達情報を作成します。この関数で作成されたtokenをDSワイヤレス通信で送信し、tokenを受信した側はこれを友達情報として友達リストに登録します。

DWC_CreateUserData関数で異なるgamecodeを指定したタイトル間で交換した友達情報は、DWC_InitFriendsMatch関数で同じgameName等の引数を指定していても友達関係が成立しないことに注意してください。
異なるgamecodeを指定したタイトル間でDSワイヤレス通信を使って友達情報を交換する場合(または、その可能性がある場合)、DWC_CreateUserData関数に指定したgamecodeが同じであることをアプリケーション側で確認してから友達リストに追加することを推奨します。

友達情報を友達リストに登録するときは、なるべく重複データを登録しないようにするために、友達リスト中の全友達情報に対してDWC_IsEqualFriendData関数で同じものでないことを確認した後、DWC_IsValidFriendDataで有効なデータが入っていないところを探して、取得した友達情報を友達リストへ直接コピーしてください。

友達情報を友達リストから削除したいときは、DWC_DeleteBuddyFriendData関数を呼び出して下さい。オフライン中であれば単純に友達情報が0でクリアされ、次回DWC_UpdateServersAsync関数呼び出し時にGameSpyサーバ上の友達関係も削除されます。オンライン中であれば、友達情報が0でクリアされ、即座にGameSpyサーバ上の友達関係も削除されます。

友達リストは、GameSpyサーバからのリクエストにより、オンライン中に自動的に変更される場合があります。そのため、オンライン中に友達リストを編集する場合は、DWC_CanChangeFriendList関数で、編集可能かどうかを確認してください。

オンライン中に友達リストを編集し、友達関係設立処理を行いたい場合は、DWC_UpdateServersAsync関数を呼び出してください。

参照

DWC_CreateFriendKeyToken DWC_IsEqualFriendData DWC_IsValidFriendData DWC_DeleteBuddyFriendData DWC_CanChangeFriendList DWC_UpdateServersAsync DWC_CreateUserData DWC_InitFriendsMatch

履歴

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