|
第一部分：说明信息：
XXX: 表示社区的英文缩写字母, 设计到社区中游戏操作的所有函数，都以 XXX 开头
以 CallBack, 结尾的函数表示回调函数
第二部分：游戏部分接口需求, 以下函数都在游戏中需要的函数
1> 宏定义信息
#define XXX_SUCCESS (1) // 成功
#define XXX_FAILURE (0) // 失败
#define XXX_NULL (0) // 表示空
2> 连接和关闭社区资源 (框架的初始化和释放)
/*
* 函数说明： 框架的初始化函数，此函数调用后，会回调 XXXInitCallBack 来返回初始化的结果
* 参数： void
*
* 备注信息：由于整个过程需要联网操作，调用 XXXInit 函数后，可能并不会马上回调 XXXInitCallBack 函数
*/
void XXXInit( void );
/*
* 函数说明：游戏中初始化社区资源的回调函数。
* 参数：result, 表示初始化函数 XXXInit 的调用结果， 数值为 XXX_SUCCESS，表示初始化资源成功， 数值为XXX_FAILURE， 表示初始化失败。
* conn, 为返回的连接句柄信息，如果连接失败，数值为 XXX_NULL
* 备注信息：无
*/
void XXXInitCallBack(int result, int conn);
/*
* 函数说明：关闭框架资源
* 参数：conn，资源句柄
*
* 备注信息：无
*/
void XXXClose(int conn);
/*
* 函数说明：游戏中关闭社区资源的回调函数。
* 参数：result, 表示函数 XXXClose 的调用结果， 数值为 XXX_SUCCESS，表示关闭资源成功， 数值为XXX_FAILURE， 表示关闭资源失败。
*
* 备注信息：无
*/
void XXXCloseCallBack(int result);
3> 游戏积分上传，下载，排行相关函数
void XXXUpUserScore(int conn, int userId, int gameId, int gameScore ); // 用户积分上传
void XXXUpUserScoreCallBack( int result ); // 用户积分上传回调函数
void XXXDownUserScore(int conn, int userId, int gameId); // 用户积分下载
void XXXDownUserScoreCallBack(int result, int gameScore, int sortId ); // 用户积分下载回调函数, sortId 表示在所有分数中的排名
// 分数排行基本信息单元
typedef struct _Leaderboard
{
UserInfo userinfo; // 用户的一些基本信息
TimeInfo socreUpTime; // 此分数的上传时间
int socre; // 分数
XXX otherInfo // 其他信息
}Leaderboard;
// 下载指定游戏的分数排行信息 , sortType 排序类型， 升序还是降序
void XXXDownScoreLeaderboard(int conn, int gameId, int sortType);
// 回调函数
void XXXDownScoreLeaderboardCallBack(int result, Leaderboard leaderboard[], int arrLen);
4> 游戏成就 上传，下载，排行信息 (和分数排行情况基本一致)
// 上传
// achievementLevel 为成就等级，
void XXXUpUserAchievement(int conn, int userId, int gameId, int achievementLevel );
void XXXUpUserAchievementCallBack(int result);
// 下载
void XXXDownUserAchievement(int conn, int userId, int gameId);
void XXXDownUserAchievementCallBack(int result, int achievementLevel, int sortId); // sortId 表示在所有玩家成就中的排名情况
// 成就信息基本信息单元
typedef struct _Achievement
{
UserInfo userinfo; // 用户的一些基本信息
TimeInfo achievementUpTime; // 上传时间
int achievementLevel; // 成就等级
XXX otherInfo // 其他信息
}Achievement;
void XXXDownAchievement(int conn, int gameId, int sortType );
// 回调函数
void XXXDownAchievementCallBack(int result, Achievement achievement[], int arrLen);
5> 联网，数据交互
void XXXSendData(int conn, int sendUserId, int reciveUserId, void* data, int dataLen);
void XXXSendDataCallBack(int result);
// 数据接收函数，如果有数据到来， 系统回调此函数
void XXXReciveDataCallBck(int sendUserId, int reciveUserId, void* data, int dataLen);
6> 游戏推荐给好友
// 得到用户自己的基本信息
void XXXGetUserInfo( void );
void XXXGetuserInfoCallBack(int result, UserInfo info);
void XXXRecommendToFriends(int conn, int userId, int gameId, int freendUserId );
void XXXRecommendToFriendsCallBack(int result);
7> 广告部分
void XXXAdRequest(int conn, int adId ); // 请求一次广告
void XXXADRefresh(int conn, int adId ); // 刷新一次广告
8> 支付模块
XXXBuy(int conn, int userId, int costMoney);
XXXBuyCallBack(int result);
9> 游戏评价
XXXGameComment(int conn, int userId, int gameId, int commLevel, WSTR* commStr);
XXXGameCommentCallBack(int result);
|
