Skip to content

A Phaser plugin that adds User Login/Sync support trough Amazon Cognito Identity/Sync

License

Notifications You must be signed in to change notification settings

florisdh/phaser-amazon-cognito

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Phaser Amazon Cognito

A Phaser plugin that adds user register/login support trough amazon cognito.

Key Features:

  • Works on mobile and desktop
  • Included TypeScript support
  • Async library with promise calls
  • Easy to use as phaser plugin

Getting Started

First you want to get a fresh copy of the plugin. You can get it from this repo or from npm, ain't that handy.

npm install phaser-amazon-cognito --save-dev

Next up you'd want to add it to your list of js sources you load into your game:

<script src="path/to/phaser-amazon-cognito.js"></script>

After adding the script to the page you can activate it by enabling the plugin:

game.add.plugin(Fabrique.Plugins.Cognito);

Usage

First off you want to set the user pool info using the userPoolId and clientId.

game.cognito.setPoolInfo('<yourPoolId>', '<yourClientId>');

#####Registration Register a new user to the user pool.

game.cognito.register('<username>', '<password>', '<email>', null).then(function(user) {
    console.log('Registration worked!', user);
}).catch(function(error) {
    console.log('Registration failed:', error);
});

#####Confirm Registration An account has to be confirmed after registration. The code will be in the inbox of the users email.

game.cognito.verify('<confirmationCode>').then(function() {
    console.log('Confirmation worked!');
}).catch(function(error) {
    console.log('Confirmation failed:', error);
});

#####Resend Confirmation Resend conformation mail to users email. Will only work if user is not confirmed yet.

game.cognito.resendConfirmation().then(function() {
    console.log('Confirmation resend!');
}).catch(function(error) {
    console.log('Failed to resend confirmation:', error);
});

#####Login Logs in a user from the user pool.

game.cognito.login('<username>', '<password>').then(function(state) {
    console.log('LoggedIn!', state.user, state.sessionToken);
}).catch(function(error) {
    console.log('Login failed:', error);
});

#####Logout Logs out a user from the user pool.

game.cognito.logout();

#####Loading User From LocalStorage Loads the userState from the localStorage on the device.

game.cognito.loadStorageUser();

#####Validate Session Checks if a session has been set. Does not actually check if the user is logged in. Can be used to check if the loadedStorageUser had a session.

game.cognito.validateSession().then(function() {
    console.log('Valid session!');
}).catch(function(error) {
    console.log('Invalid session:', error);
});

#####Setting User Most commands will use the last used user, if you want to call verify on a different user for example you need to call this first. Login or register will automatically set this.

game.cognito.setUser('<username>');

Credits

This library uses the amazon-cognito-identity-js library provided by amazon. (https://github.com/aws/amazon-cognito-identity-js)

Disclaimer

We at OrangeGames just love playing and creating awesome games. We aren't affiliated with Phaser.io. We just needed some awesome login handling in our awesome HTML5 games. Feel free to use it for enhancing your own awesome games!

Phaser Amazon Cognito is distributed under the MIT license. All 3rd party libraries and components are distributed under their respective license terms.

About

A Phaser plugin that adds User Login/Sync support trough Amazon Cognito Identity/Sync

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 54.1%
  • HTML 24.8%
  • JavaScript 21.1%