From 9cd57b731ab1c666d4a1cb725538fdc137763d12 Mon Sep 17 00:00:00 2001 From: Starla Insigna Date: Sat, 30 Jul 2011 11:19:14 -0400 Subject: Initial commit (version 0.2.1) --- libs/cocoslive/CLScoreServerPost.h | 142 +++++++++++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100755 libs/cocoslive/CLScoreServerPost.h (limited to 'libs/cocoslive/CLScoreServerPost.h') diff --git a/libs/cocoslive/CLScoreServerPost.h b/libs/cocoslive/CLScoreServerPost.h new file mode 100755 index 0000000..e782b90 --- /dev/null +++ b/libs/cocoslive/CLScoreServerPost.h @@ -0,0 +1,142 @@ +/* + * cocos2d for iPhone: http://www.cocos2d-iphone.org + * + * Copyright (c) 2008-2010 Ricardo Quesada + * Copyright (c) 2011 Zynga Inc. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + */ + + + +#import + +// for MD5 signing +#import + +// cocoslive definitions +#import "cocoslive.h" + +// Score Server protocol version +#define SCORE_SERVER_PROTOCOL_VERSION @"1.1" + +// Server URL +#ifdef USE_LOCAL_SERVER +#define SCORE_SERVER_SEND_URL @"http://localhost:8080/api/post-score" +#define SCORE_SERVER_UPDATE_URL @"http://localhost:8080/api/update-score" +#else +#define SCORE_SERVER_SEND_URL @"http://fourislandscores.appspot.com/api/post-score" +#define SCORE_SERVER_UPDATE_URL @"http://fourislandscores.appspot.com/api/update-score" +#endif + +/// Type of errors from the Post Score request +typedef enum { + /// post request successful + kPostStatusOK = 0, + /// post request failed to establish a connection. wi-fi isn't enabled. + /// Don't retry when this option is preset + kPostStatusConnectionFailed = 1, + /// post request failed to post the score. Server might be busy. + /// Retry is suggested + kPostStatusPostFailed = 2, +} tPostStatus; + +enum { + //! Invalid Ranking. Valid rankins are from 1 to ... + kServerPostInvalidRanking = 0, +}; + +/** + * Handles the Score Post to the cocos live server + */ +@interface CLScoreServerPost : NSObject { + /// game key. secret shared with the server. + /// used to sign the values to prevent spoofing. + NSString *gameKey; + + /// game name, used as a login name. + NSString *gameName; + + /// delegate instance of fetch score + id delegate; + + /// ranking + NSUInteger ranking_; + + /// score was updated + BOOL scoreDidUpdate_; + + /// data received + NSMutableData *receivedData; + + /// values to send in the POST + NSMutableArray *bodyValues; + + /// status of the request + tPostStatus postStatus_; + + /// mdt context + CC_MD5_CTX md5Ctx; + + /// the connection + NSURLConnection *connection_; +} + +/** status from the score post */ +@property (nonatomic,readonly) tPostStatus postStatus; + +/** connection to the server */ +@property (nonatomic, retain) NSURLConnection *connection; + +/** ranking of your score + @since v0.7.3 + */ +@property (nonatomic,readonly) NSUInteger ranking; + +/** whether or not the score was updated + @since v0.7.3 + */ +@property (nonatomic,readonly) BOOL scoreDidUpdate; + +/** creates a cocos server with a game name and a game key */ ++(id) serverWithGameName:(NSString*) name gameKey:(NSString*) key delegate:(id)delegate; + +/** initializes a cocos server with a game name and a game key */ +-(id) initWithGameName:(NSString*) name gameKey:(NSString*) key delegate:(id)delegate; + +/** send the scores to the server. A new entre will be created on the server */ +-(BOOL) sendScore: (NSDictionary*) dict; + +/** + * Sends a score dictionary to the server for updating an existing entry by playername and device id, or creating a new one. + * The passed dictionary must contain a cc_playername key, otherwise it will raise and exception. + * @since v0.7.1 + */ +-(BOOL) updateScore: (NSDictionary*) dict; + +@end + +/** CocosLivePost protocol */ +@protocol CLPostDelegate +/** callback method that will be called if the post is successful */ +-(void) scorePostOk:(id) sender; +/** callback method that will be called if the post fails */ +-(void) scorePostFail:(id) sender; +@end -- cgit 1.4.1