QuickConnect for Simple Users
If all you want is an easy way for your users to be able to register and login to your game, with usernames and passwords that are unique to your game, QuickConnect for Simple Users is for you.
You can view a list of all users that have registered using this method in your game, and you can export this list at any time. This means that even if you start using Player.IO as a user database, you can move those users to your own database at any time - you own your users completely.
Setup on Player.IO
In the admin panel for your game you can find the QuickConnect settings. Here, you can enable the service and configure its options: Whether registration should require a valid email or not, and which of your game's connections it should use.
Note that unlike when you use the regular Connect method where you specify which connection to use in the method call, QuickConnect requires you to specify this in the setup.
Registering a User
To register a user your game should present a registration form that contains at least username and password input fields. When the user clicks register you should then call the simpleRegister() method with the registration data. You can also collect additional information such as email, birthdate, gender or similar and pass that into the registration method. Note that this data cannot be changed after registration, and cannot be accessed through the client libraries. However, viewing or exporting your users will allow you to see everything you gathered.
When you use the client libraries you will note that both simpleRegister() and simpleConnect() return a connection object, so you don't need to make your users first register, and then log in.
Captcha
If your game requires increased security, you can use the Captcha feature to ensure that actual humans are signing up for your game.
A Captcha is a challenge-response test used with registrations to ensure that the response is not generated by a computer. The idea is that an image is generated with some text that only a true human can read. The human is asked to enter the text in the image as part of the registration, thus ensuring that only humans are able to register.
In the admin panel, you can select which style to use when generating captcha images. Here are some example captcha images generated with various styles:
Requiring Captcha in your game is very simple:
- Change QuickConnect settings to require captcha in the admin panel for your game.
- Before showing a registration form, get a captcha key and captcha image from Player.IO via the simpleGetCaptcha() method.
- When showing the registration form, also show the captcha image to the user.
- When calling the simpleRegister() method, send in both the captcha key and the text version of the image from the user.
Logging in
When a registered user returns to your game you should ask for the users username and password and then call the simpleConnect() method to authenticate him. If the username and password matches, you will get back an open connection.
Password Recovery
Finally, we provide a very simple service to allow users to recover their passwords if they've forgotten them.
If a user has registered with a valid email address, and you call the simpleRecoverPassword() method, Player.IO will send an unbranded email with a link for the user to click, which will take him to a very simple page where he can change his password for your game.
If the user does not click the link, nothing will happen and the password will not be changed, so one user can't change the another users password.
For more information, just check out our AS3 client reference documentation.
