null values. */
12 | public function execute(func:Function, ...args):void
13 | {
14 | if (func != null)
15 | {
16 | var i:int;
17 | var maxNumArgs:int = func.length;
18 |
19 | for (i=args.length; iWhen you pass a seed, the String is instead based on the SHA-256 hash of the seed. 19 | * Each seed will always produce the same result. The maximum length of a seeded UID is 20 | * 43 characters (the full SHA-256 length).
21 | * 22 | *Note: do not use this function for security-critical hashing; to limit the result to 23 | * an alphanumeric String, it uses the SHA-256 algorithm in a special way. If you need 24 | * perfect security, use the SHA256 class directly.
25 | */ 26 | public function createUID(length:int=16, seed:String=null):String 27 | { 28 | var bytes:ByteArray; 29 | var b64:String = null; 30 | 31 | if (length == 0) return ""; 32 | else if (seed) 33 | { 34 | if (length > 43) 35 | throw new Error("Maximum length of seeded UID is 43 characters"); 36 | 37 | while (b64 == null || b64.indexOf("/") != -1 || b64.indexOf("+") != -1) 38 | { 39 | b64 = SHA256.hashString(seed).replace("=", "").substr(0, length); 40 | seed += b64.charAt(0); 41 | } 42 | } 43 | else 44 | { 45 | bytes = flash.crypto.generateRandomBytes(length); 46 | b64 = Base64.encodeByteArray(bytes).substr(0, length); 47 | 48 | while (b64.indexOf("/") != -1) b64 = b64.replace("/", getRandomChar()); 49 | while (b64.indexOf("+") != -1) b64 = b64.replace("+", getRandomChar()); 50 | } 51 | 52 | return b64; 53 | } 54 | } 55 | 56 | const ALLOWED_CHARS:String = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"; 57 | const NUM_ALLOWED_CHARS:int = 62; 58 | 59 | function getRandomChar():String 60 | { 61 | return ALLOWED_CHARS.charAt(int(Math.random() * NUM_ALLOWED_CHARS)); 62 | } -------------------------------------------------------------------------------- /flox/src/com/gamua/flox/Score.as: -------------------------------------------------------------------------------- 1 | // ================================================================================================= 2 | // 3 | // Flox AS3 4 | // Copyright 2013 Gamua OG. All Rights Reserved. 5 | // 6 | // ================================================================================================= 7 | 8 | package com.gamua.flox 9 | { 10 | import com.gamua.flox.utils.DateUtil; 11 | import com.gamua.flox.utils.formatString; 12 | 13 | /** Provides information about the value and origin of one posted score entry. */ 14 | public class Score 15 | { 16 | private var mPlayerId:String; 17 | private var mPlayerName:String; 18 | private var mValue:int; 19 | private var mDate:Date; 20 | private var mCountry:String; 21 | 22 | /** Create a new score instance with the given values. */ 23 | public function Score(playerId:String=null, playerName:String=null, 24 | value:int=0, date:Date=null, country:String=null) 25 | { 26 | mPlayerId = playerId ? playerId : "unknown"; 27 | mPlayerName = playerName ? playerName : "unknown"; 28 | mCountry = country ? country : "us"; 29 | mValue = value; 30 | mDate = date ? date : new Date(); 31 | } 32 | 33 | /** The ID of the player who posted the score. Note that this could be a guest player 34 | * unknown to the server. */ 35 | public function get playerId():String { return mPlayerId; } 36 | public function set playerId(value:String):void { mPlayerId = value; } 37 | 38 | /** The name of the player who posted the score. */ 39 | public function get playerName():String { return mPlayerName; } 40 | public function set playerName(value:String):void { mPlayerName = value; } 41 | 42 | /** The actual value/score. */ 43 | public function get value():int { return mValue; } 44 | public function set value(value:int):void { mValue = value; } 45 | 46 | /** The date at which the score was posted. */ 47 | public function get date():Date { return mDate; } 48 | public function set date(value:Date):void { mDate = value; } 49 | 50 | /** The country from which the score originated, in a two-letter country code. */ 51 | public function get country():String { return mCountry; } 52 | public function set country(value:String):void { mCountry = value; } 53 | 54 | /** Returns a description of the score. */ 55 | public function toString():String 56 | { 57 | return formatString('[Score playerName="{0}" value="{1}" country="{2}" date="{3}"]', 58 | mPlayerName, mValue, mCountry, DateUtil.toString(mDate)); 59 | } 60 | } 61 | } -------------------------------------------------------------------------------- /tests/src/starling/unit/TestGui.as: -------------------------------------------------------------------------------- 1 | package starling.unit 2 | { 3 | import flash.utils.getTimer; 4 | 5 | import starling.display.Sprite; 6 | import starling.events.Event; 7 | import starling.utils.Color; 8 | 9 | public class TestGui extends Sprite 10 | { 11 | private var mTestRunner:TestRunner; 12 | private var mLoop:Boolean; 13 | private var mTestCount:int; 14 | private var mSuccessCount:int; 15 | private var mStartMoment:Number; 16 | private var mIsPaused:Boolean; 17 | 18 | public function TestGui(testRunner:TestRunner) 19 | { 20 | mTestRunner = testRunner; 21 | mTestRunner.logFunction = log; 22 | mTestRunner.assertFunction = assert; 23 | } 24 | 25 | public function start(loop:Boolean=false):void 26 | { 27 | mLoop = loop; 28 | mStartMoment = getTimer() / 1000; 29 | mIsPaused = false; 30 | addEventListener(Event.ENTER_FRAME, onEnterFrame); 31 | } 32 | 33 | public function stop():void 34 | { 35 | removeEventListener(Event.ENTER_FRAME, onEnterFrame); 36 | mTestRunner.resetRun(); 37 | } 38 | 39 | private function onEnterFrame(event:Event):void 40 | { 41 | if (mIsPaused) return; 42 | 43 | var status:String = mTestRunner.runNext(); 44 | 45 | if (status == TestRunner.STATUS_FINISHED) 46 | { 47 | var duration:int = getTimer() / 1000 - mStartMoment; 48 | stop(); 49 | 50 | log("Finished all tests!", Color.AQUA); 51 | log("Duration: " + duration + " seconds.", Color.AQUA); 52 | 53 | if (mLoop) start(true); 54 | else onFinished(); 55 | } 56 | } 57 | 58 | public function onFinished():void 59 | { 60 | // override in subclass 61 | } 62 | 63 | public function log(message:String, color:uint=0xffffff):void 64 | { 65 | trace(message); 66 | } 67 | 68 | public function assert(success:Boolean, message:String=null):void 69 | { 70 | mTestCount++; 71 | 72 | if (success) 73 | { 74 | mSuccessCount++; 75 | } 76 | else 77 | { 78 | message = message ? message : "Assertion failed."; 79 | log(" " + message, Color.RED); 80 | } 81 | } 82 | 83 | public function get testCount():int { return mTestCount; } 84 | public function get successCount():int { return mSuccessCount; } 85 | public function get isStarted():Boolean { return mStartMoment >= 0; } 86 | 87 | public function get isPaused():Boolean { return mIsPaused; } 88 | public function set isPaused(value:Boolean):void { mIsPaused = value; } 89 | } 90 | } -------------------------------------------------------------------------------- /tests/src/com/gamua/flox/HeroTest.as: -------------------------------------------------------------------------------- 1 | package com.gamua.flox 2 | { 3 | import com.gamua.flox.utils.CustomEntity; 4 | import com.gamua.flox.utils.HttpStatus; 5 | 6 | import starling.unit.UnitTest; 7 | 8 | public class HeroTest extends UnitTest 9 | { 10 | public override function setUp():void 11 | { 12 | Constants.initFlox(); 13 | Player.logout(); // create a new guest player for each test 14 | } 15 | 16 | public override function tearDown():void 17 | { 18 | Flox.shutdown(); 19 | } 20 | 21 | public function testHero(onComplete:Function):void 22 | { 23 | var guestID:String = Player.current.id; 24 | var entity:CustomEntity = new CustomEntity("top secret", 20); 25 | entity.publicAccess = Access.NONE; 26 | entity.save(onSaveComplete, onError); 27 | 28 | function onSaveComplete(savedEntity:Entity):void 29 | { 30 | Player.loginWithKey(Constants.ENABLED_HERO_KEY, onLoginComplete, onError); 31 | } 32 | 33 | function onLoginComplete(hero:Player):void 34 | { 35 | assert(hero.id != Constants.ENABLED_HERO_KEY); 36 | Entity.load(CustomEntity, entity.id, onLoadComplete, onError); 37 | } 38 | 39 | function onLoadComplete(loadedEntity:CustomEntity):void 40 | { 41 | assertEqual(loadedEntity.id, entity.id, "wrong entity returned"); 42 | assertEqual(loadedEntity.name, entity.name, "wrong name returned"); 43 | assertEqual(loadedEntity.age, entity.age, "wrong age returned"), 44 | 45 | loadedEntity.age = 100; 46 | loadedEntity.save(onUpdateComplete, onError); 47 | } 48 | 49 | function onUpdateComplete(savedEntity:CustomEntity):void 50 | { 51 | assertEqual(savedEntity.ownerId, guestID, "owner of entity changed"); 52 | assertEqual(savedEntity.age, 100, "wrong age saved"); 53 | entity.destroy(onDestroyComplete, onError); 54 | } 55 | 56 | function onDestroyComplete():void 57 | { 58 | onComplete(); 59 | } 60 | 61 | function onError(error:String):void 62 | { 63 | fail(error); 64 | onComplete(); 65 | } 66 | } 67 | 68 | public function testDisabledHero(onComplete:Function):void 69 | { 70 | Player.loginWithKey(Constants.DISABLED_HERO_KEY, onLoginComplete, onLoginError); 71 | 72 | function onLoginComplete():void 73 | { 74 | fail("disabled hero could log in!"); 75 | onComplete(); 76 | } 77 | 78 | function onLoginError(error:String, httpStatus:int):void 79 | { 80 | assertEqual(httpStatus, HttpStatus.BAD_REQUEST, "wrong http status"); 81 | onComplete(); 82 | } 83 | } 84 | } 85 | } -------------------------------------------------------------------------------- /tests/src/starling/unit/TestGuiEx.as: -------------------------------------------------------------------------------- 1 | package starling.unit 2 | { 3 | import com.gamua.flox.utils.formatString; 4 | 5 | import flash.external.ExternalInterface; 6 | 7 | import starling.core.Starling; 8 | import starling.events.Touch; 9 | import starling.events.TouchEvent; 10 | import starling.events.TouchPhase; 11 | import starling.text.TextField; 12 | import starling.utils.Color; 13 | 14 | public class TestGuiEx extends TestGui 15 | { 16 | private static const LINE_HEIGHT:int = 20; 17 | private static const FONT_NAME:String = "mini"; 18 | private static const FONT_SIZE:int = -2; 19 | 20 | private var mHeader:TextField; 21 | private var mStatus:TextField; 22 | private var mFooter:TextField; 23 | 24 | public function TestGuiEx(testRunner:TestRunner, width:int, header:String) 25 | { 26 | super(testRunner); 27 | 28 | mHeader = new TextField(width, LINE_HEIGHT, header); 29 | mHeader.format.setTo(FONT_NAME, FONT_SIZE, Color.WHITE); 30 | addChild(mHeader); 31 | 32 | mStatus = new TextField(width, LINE_HEIGHT, "0 / 0"); 33 | mStatus.format.setTo(FONT_NAME, FONT_SIZE, Color.WHITE); 34 | mStatus.y = LINE_HEIGHT; 35 | addChild(mStatus); 36 | 37 | mFooter = new TextField(width, LINE_HEIGHT, ""); 38 | mFooter.format.setTo(FONT_NAME, FONT_SIZE, Color.WHITE); 39 | mFooter.y = 2 * LINE_HEIGHT; 40 | addChild(mFooter); 41 | 42 | addEventListener(TouchEvent.TOUCH, onTouch); 43 | } 44 | 45 | override public function onFinished():void 46 | { 47 | mFooter.text = "Done"; 48 | callExternalInterface("startNextTest"); 49 | } 50 | 51 | private function onTouch(event:TouchEvent):void 52 | { 53 | var touch:Touch = event.getTouch(this, TouchPhase.ENDED); 54 | if (touch && isStarted) 55 | { 56 | isPaused = !isPaused; 57 | mFooter.text = isPaused ? "paused" : ""; 58 | } 59 | } 60 | 61 | override public function log(message:String, color:uint=0xffffff):void 62 | { 63 | super.log(message, color); 64 | callExternalInterface("addLog", message, color); 65 | } 66 | 67 | override public function assert(success:Boolean, message:String=null):void 68 | { 69 | super.assert(success, message); 70 | 71 | mStatus.text = formatString("{0} / {1}", successCount, testCount); 72 | mStatus.format.color = (successCount == testCount) ? Color.GREEN : Color.RED; 73 | } 74 | 75 | private function callExternalInterface(method, ...args):void 76 | { 77 | if (ExternalInterface.available) 78 | { 79 | var url:String = Starling.current.nativeStage.loaderInfo.url; 80 | var swfName:String = url.split("/").pop().replace(/\?.*$/, "").slice(0, -4); 81 | args.unshift(method, swfName); 82 | ExternalInterface.call.apply(null, args); 83 | } 84 | } 85 | } 86 | } 87 | -------------------------------------------------------------------------------- /flox/src/com/gamua/flox/utils/cloneObject.as: -------------------------------------------------------------------------------- 1 | // ================================================================================================= 2 | // 3 | // Flox AS3 4 | // Copyright 2012 Gamua OG. All Rights Reserved. 5 | // 6 | // ================================================================================================= 7 | 8 | package com.gamua.flox.utils 9 | { 10 | import flash.utils.getQualifiedClassName; 11 | 12 | /** Creates a deep copy of the object. 13 | * Beware: all complex data types will become mere 'Object' instances. Supported are only 14 | * primitive data types, arrays and objects. Any properties marked with "NonSerialized" 15 | * meta data will be ignored by this method. 16 | * 17 | *Optionally, you can pass a 'filter' function. It will be called on any child object. 18 | * You can use this filter to create custom serializations. The following sample exchanges 19 | * every 'Date' instance with a custom string.
20 | * 21 | *
22 | * clone:Object = cloneObject(original, function(object:Object):Object
23 | * {
24 | * if (object is Date) return DateUtil.toString(object as Date);
25 | * else return null; // 'null' causes default behaviour
26 | * });
27 | */
28 | public function cloneObject(object:Object, filter:Function=null):Object
29 | {
30 | if (filter != null)
31 | {
32 | var filteredClone:Object = filter(object);
33 | if (filteredClone) return filteredClone;
34 | }
35 |
36 | if (object is Number || object is String || object is Boolean || object == null)
37 | return object;
38 | else if (object is Array)
39 | {
40 | var array:Array = object as Array;
41 | var arrayClone:Array = [];
42 | var length:int = array.length;
43 | for (var i:int=0; iHere is an example of how you can execute a Query with Flox. This query requires 24 | * an index containing both "level" and "score" properties.
25 | *
26 | * var query:Query = new Query(Player);
27 | * query.where("level == ? AND score > ?", "tutorial", 500);
28 | * query.find(function onComplete(players:Array):void
29 | * {
30 | * // the 'players' array contains all players in the 'tutorial' level
31 | * // with a score higher than 500.
32 | * },
33 | * function onError(error:String):void
34 | * {
35 | * trace("something went wrong: " + error);
36 | * });
37 | */
38 | public class Query
39 | {
40 | private var mClass:Class;
41 | private var mOffset:int;
42 | private var mLimit:int;
43 | private var mConstraints:String;
44 | private var mOrderBy:String;
45 |
46 | /** Create a new query that will search within the given Entity type. Optionally, you
47 | * pass the constraints in the same way as in the "where" method. */
48 | public function Query(entityClass:Class, constraints:String=null, ...args)
49 | {
50 | mClass = entityClass;
51 | mOffset = 0;
52 | mLimit = 50;
53 |
54 | if (constraints)
55 | {
56 | args.unshift(constraints);
57 | where.apply(this, args);
58 | }
59 | }
60 |
61 | /** You can narrow down the results of the query with an SQL like where-clause. The
62 | * constraints string supports the following comparison operators:
63 | * "==, >, >=, <, <=, !=".
64 | * You can combine constraints using "AND" and "OR"; construct logical groups with
65 | * round brackets.
66 | *
67 | * To simplify creation of the constraints string, you can use questions marks ("?") 68 | * as placeholders. They will be replaced one by one with the additional parameters you 69 | * pass to the method, while making sure their format is correct (e.g. it surrounds 70 | * Strings with quotations marks). Here is an example:
71 | *
72 | * query.where("name == ? AND score > ?", "thomas", 500);
73 | * // -> name == "thomas" AND score > 500
74 | *
75 | * Use the 'IN'-operator to check for inclusion within a list of possible values:
76 | *
77 | * query.where("name IN ?", ["alfa", "bravo", "charlie"]);
78 | * // -> name IN ["alfa", "bravo", "charlie"]
79 | *
80 | * Note that subsequent calls to this method will replace preceding constraints.
81 | * 82 | * @returns the final constraints-string that will be passed to the server. 83 | */ 84 | public function where(constraints:String, ...args):String 85 | { 86 | var regEx:RegExp = /\?/g; 87 | var match:Object; 88 | var lastIndex:int = -1; 89 | mConstraints = ""; 90 | 91 | while ((match = regEx.exec(constraints)) != null) 92 | { 93 | if (args.length == 0) throw new ArgumentError("Incorrect number of placeholders"); 94 | 95 | var arg:* = args.shift(); 96 | if (arg is Date) arg = DateUtil.toString(arg); 97 | 98 | mConstraints += constraints.substr(lastIndex + 1, match.index - lastIndex - 1); 99 | mConstraints += JSON.stringify(arg); 100 | lastIndex = match.index; 101 | } 102 | 103 | mConstraints += constraints.substr(lastIndex + 1); 104 | return mConstraints; 105 | } 106 | 107 | /** Executes the query and passes the list of results to the "onComplete" callback. 108 | * Don't forget to create appropriate indices for your queries! 109 | * 110 | * @param onComplete a callback with the form: 111 | *onComplete(entities:Array):void;112 | * @param onError a callback with the form: 113 | *
onError(error:String, httpStatus:int):void;114 | */ 115 | public function find(onComplete:Function, onError:Function):void 116 | { 117 | var entities:Array = []; 118 | var numResults:int = -1; 119 | var numLoaded:int = 0; 120 | var abort:Boolean = false; 121 | 122 | var path:String = createURL("entities", type); 123 | var data:Object = { where: mConstraints, offset: mOffset, limit: mLimit }; 124 | 125 | if (mOrderBy) data.orderBy = mOrderBy; 126 | 127 | Flox.service.request(HttpMethod.POST, path, data, onRequestComplete, onError); 128 | 129 | function onRequestComplete(body:Object, httpStatus:int):void 130 | { 131 | var results:Array = body as Array; 132 | numResults = results ? results.length : 0; 133 | 134 | for (var i:int=0; i
onError(error:String, httpStatus:int):void;210 | */ 211 | public function findIDs(onComplete:Function, onError:Function):void 212 | { 213 | var numResults:int = -1; 214 | var path:String = createURL("entities", type); 215 | var data:Object = { where: mConstraints, offset: mOffset, limit: mLimit }; 216 | 217 | if (mOrderBy) data.orderBy = mOrderBy; 218 | 219 | Flox.service.request(HttpMethod.POST, path, data, onRequestComplete, onError); 220 | 221 | function onRequestComplete(body:Object):void 222 | { 223 | var entityIDs:Array = []; 224 | var results:Array = body as Array; 225 | numResults = results ? results.length : 0; 226 | 227 | for (var i:int=0; i
The current player is automatically persisted, i.e. when you close and restart your game, 24 | * the same player will be logged in automatically.
25 | * 26 | *In many games, you'll want to use a custom player subclass, so that you can add custom 27 | * properties. To do that, register your player class before starting Flox.
28 | *29 | * Flox.playerClass = CustomPlayer;30 | * 31 | *
When you've done that, you can get your player anytime with this code:
32 | *33 | * var player:CustomPlayer = Player.current as CustomPlayer;34 | */ 35 | [Type(".player")] 36 | public class Player extends Entity 37 | { 38 | private var mAuthType:String; 39 | 40 | /** Don't call this method directly; use the 'Player.login' methods instead. */ 41 | public function Player() 42 | { 43 | super.ownerId = this.id; 44 | super.publicAccess = Access.READ; 45 | } 46 | 47 | /** Log in a player with the given authentication information. If you pass no 48 | * parameters, a new guest will be logged in; the 'Flox.currentPlayer' parameter will 49 | * immediately reference that player. 50 | * 51 | *
Flox requires that there's always a player logged in. Thus, there is no 'logout' 52 | * method. If you want to remove the reference to the current player, just call 53 | * 'login' again (without arguments). The previous player will then be replaced 54 | * by a new guest.
55 | * 56 | * @param authType The type of authentication you want to use. 57 | * @param authId The id of the player in its authentication system. 58 | * @param authToken The token you received from the player's authentication system. 59 | * @param onComplete function onComplete(currentPlayer:Player):void; 60 | * @param onError function onError(error:String, httpStatus:int):void; 61 | */ 62 | public static function login( 63 | authType:String="guest", authId:String=null, authToken:String=null, 64 | onComplete:Function=null, onError:Function=null):void 65 | { 66 | var authData:Object = { authType: authType, authId: authId, authToken: authToken }; 67 | loginWithAuthData(authData, onComplete, onError); 68 | } 69 | 70 | private static function loginWithAuthData(authData:Object, onComplete:Function=null, 71 | onError:Function=null):void 72 | { 73 | Flox.checkInitialized(); 74 | var previousAuthentication:Authentication = Flox.authentication; 75 | 76 | if (authData.authType == AuthenticationType.GUEST) 77 | { 78 | var player:Player = new Flox.playerClass(); 79 | player.authType = AuthenticationType.GUEST; 80 | 81 | onAuthenticated(player); 82 | } 83 | else 84 | { 85 | if (current.authType == AuthenticationType.GUEST) 86 | authData.id = current.id; 87 | 88 | Flox.service.request(HttpMethod.POST, "authenticate", authData, 89 | onRequestComplete, onRequestError); 90 | 91 | Flox.authentication = null; // prevent any new requests while login is in process! 92 | } 93 | 94 | function onRequestComplete(body:Object, httpStatus:int):void 95 | { 96 | // authToken may be overridden (e.g. so that password is not stored locally) 97 | if (body.authToken) authData.authToken = body.authToken; 98 | 99 | var id:String = body.id; 100 | var type:String = getType(Flox.playerClass); 101 | var player:Player = Entity.fromObject(type, id, body.entity) as Player; 102 | onAuthenticated(player); 103 | } 104 | 105 | function onRequestError(error:String, httpStatus:int):void 106 | { 107 | Flox.authentication = previousAuthentication; 108 | execute(onError, error, httpStatus); 109 | } 110 | 111 | function onAuthenticated(player:Player):void 112 | { 113 | Flox.clearCache(); 114 | Flox.currentPlayer = player; 115 | Flox.authentication = new Authentication(player.id, 116 | authData.authType, authData.authId, authData.authToken); 117 | 118 | execute(onComplete, player); 119 | } 120 | } 121 | 122 | /** Logs the current player out and immediately creates a new guest player. 123 | * (In Flox, 'Player.current' will always return a player object.) */ 124 | public static function logout():void 125 | { 126 | // we always need an active player! The login method, called without arguments, 127 | // will create a new one for us. 128 | 129 | login(); 130 | } 131 | 132 | /** Log in a player with just a single 'key' string. The typical use-case of this 133 | * authentication is to combine Flox with other APIs that have their own user database 134 | * (e.g. Mochi, Kongregate, GameCenter, etc). */ 135 | public static function loginWithKey(key:String, onComplete:Function, onError:Function):void 136 | { 137 | login(AuthenticationType.KEY, key, null, onComplete, onError); 138 | } 139 | 140 | /** Log in a player with his e-mail address. 141 | * 142 | *In case of an error, the HTTP status tells you if a confirmation mail was sent: 149 | * "HttpStatus.FORBIDDEN" means that the mail was sent; "HttpStatus.TOO_MANY_REQUESTS" 150 | * means that a mail has already been sent within the last 15 minutes.
151 | * 152 | * @param email The e-mail address of the player trying to log in. 153 | * @param onComplete function onComplete(currentPlayer:Player):void; 154 | * @param onError function onError(error:String, httpStatus:int, confirmationMailSent:Boolean):void;*/ 155 | public static function loginWithEmail(email:String, 156 | onComplete:Function, onError:Function):void 157 | { 158 | login(AuthenticationType.EMAIL, email, Flox.installationID, onComplete, onLoginError); 159 | 160 | function onLoginError(error:String, httpStatus:int):void 161 | { 162 | execute(onError, error, httpStatus, httpStatus == HttpStatus.FORBIDDEN); 163 | } 164 | } 165 | 166 | /** Log in a player with his e-mail address and a password. 167 | * 168 | *Depending on the 'loginOnly' parameter, this method can also be used to sign up 169 | * a previously unknown player. Once an e-mail address is confirmed, a login will only 170 | * work with the correct password.
171 | * 172 | *If the player forgets the password, you can let him acquire a new one with the 186 | * 'resetEmailPassword' method.
187 | * 188 | * @param email The e-mail address of the player trying to log in or sign up. 189 | * @param password The password of the player trying to log in or sign up. 190 | * @param loginOnly If true, the email/password combination must already exist. 191 | * If false, an e-mail address that was used for the first time will 192 | * trigger a confirmation e-mail. 193 | * @param onComplete function onComplete(currentPlayer:Player):void; 194 | * @param onError function onError(error:String, httpStatus:int, confirmationMailSent:Boolean):void; 195 | */ 196 | public static function loginWithEmailAndPassword( 197 | email:String, password:String, loginOnly:Boolean, 198 | onComplete:Function, onError:Function):void 199 | { 200 | var authData:Object = 201 | { 202 | authType: AuthenticationType.EMAIL_AND_PASSWORD, 203 | authId: email, 204 | authToken: password, 205 | loginOnly: loginOnly 206 | }; 207 | 208 | loginWithAuthData(authData, onComplete, onLoginError); 209 | 210 | function onLoginError(error:String, httpStatus:int):void 211 | { 212 | execute(onError, error, httpStatus, httpStatus == HttpStatus.UNAUTHORIZED); 213 | } 214 | } 215 | 216 | /** Causes the server to send a password-reset e-mail to the player's e-mail address. If 217 | * that address is unknown to the server, it will yield an error with HttpStatus.NOT_FOUND. 218 | * 219 | * @param onComplete function onComplete():void; 220 | * @param onError function onError(error:String, httpStatus:int):void; 221 | */ 222 | public static function resetEmailPassword(email:String, onComplete:Function, 223 | onError:Function):void 224 | { 225 | Flox.service.request(HttpMethod.POST, "resetPassword", { email: email }, 226 | onComplete, onError); 227 | } 228 | 229 | /** The current local player. */ 230 | public static function get current():Player 231 | { 232 | return Flox.currentPlayer; 233 | } 234 | 235 | /** The type of authentication the player used to log in. */ 236 | public function get authType():String { return mAuthType; } 237 | public function set authType(value:String):void 238 | { 239 | if (mAuthType != null && mAuthType != value) 240 | throw new IllegalOperationError("Cannot change the authentication type of a Player entity."); 241 | else 242 | mAuthType = value; 243 | } 244 | 245 | /** @private */ 246 | public override function set publicAccess(value:String):void 247 | { 248 | if (value != Access.READ) 249 | throw new IllegalOperationError("Cannot change access rights of a Player entity."); 250 | else 251 | super.publicAccess = value; 252 | } 253 | } 254 | } --------------------------------------------------------------------------------