#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より前の変更履歴はこちら