Complete Account with Database Asset

• 1 - Get the username of the person to be registered (Complete void bellow)

  public void GetUserName(string value) { AccountController.controller.GET_USER_USERNAME(value); }

• 2 - Get the email address of the user to connect/register (Complete void bellow)

  public void GetUserEmail(string value) { AccountController.controller.GET_USER_EMAIL(value); }

• 3 - Get the password of the user to log in/register (Complete void bellow)

  public void GetUserPassword(string value) { AccountController.controller.GET_USER_PASSWORD(value); }

• 4 - Send a connection request (line 176 in demo script)

  AccountController.controller.LOGIN_ACTION();

• 5 - Send an account creation request (line 178 in demo script)

  AccountController.controller.ON_CLIC_CREATE_ACCOUNT();

• 6 - Send a Logout Request (line 182 in demo script)

  AccountController.controller.LOG_OUT();

Step 2: All right, now, save and go back to unity to link these new functions to your buttons.

The first 3 functions listed above must be added to InputFields, in the “On Value Changed” section.


CAUTION choose the Dynamic string, otherwise your function will not work.


ATTENTION be careful, it's not necessary, but you can select the true option in Content type, Email Address for email, Password for the password, and standard for username.

Now, you just have to put the login or connect function to your button in the on Click function.

Step 1: Write the new functions in your script

• 1 - This first command is simply used to open your connect recovery panel.

  public void OpenCloseRecoverySection() { AccountController.controller.OPEN_RECOVERY_PANEL(); }

• 2 - Now, this function is used to request a recovery connection, like on a login button

  public void CreateRecoveryAccount() { AccountController.controller.ON_CLIC_ADD_RECOVERY(); }

• 1 - Configure your PlayFab Cloud Script (Js)

  First, if you are using the backup method from the previous section, go back to the PlayFab settings, and uncheck the “Allow client To post player statistics” box in API Features.
  (made the opposite of the step 2 in the configuration section)
  
  Next, configure your cloud script.
  
  On your project dashboard, go to “Automation” and then choose “Revisions” in the “Cloud Script” section:
  
  Once this is done, you can start writing.
  
  If you have never touched your revisions, you can delete all its content, and write:
  

  handlers.UpdatePlayerStats = function (args, context) {  var request = {   PlayFabId: currentPlayerId, Statistics: [{    StatisticName: STATISTIC NAME SHOWED IN USER PROFILE,    Value: args.STATISTICS ARGUMENT TO PUT IN YOUR UNITY SCRIPT   }]  };  var playerStatResult = server.UpdatePlayerStatistics(request);  return{messageValue: "Updated Statistics"} };

  EXEMPLE
  
  This is the function used for the demo script.

• 2 - Implementation in your script
  
  

  Note:
  It is recommended that the NAME OF THE VALUE SAVED be identical to the STATISTIC NAME SHOWED IN USER PROFILE defined earlier.

  AccountController.playerData.TryGetValue(NAME OF THE VALUE SAVED, out VALUE TO UPDATE)
  You can see this template in the demo script, line 64.
  
  How to save new data or update one:

  public int userLevel; // user data variable public void UpdateLevel(int value) {  userLevel += value // update the variable  StartUpdatePlayerStatsSecure(); // call the cloud script update function } private void StartUpdatePlayerStatsSecure() {  if (AccountController.controller.secureDataSave)  {   PlayFabClientAPI.ExecuteCloudScript(new ExecuteCloudScriptRequest()   {    FunctionName = "UpdatePlayerStats", // cloud function name    FunctionParameter = new { CLOUD SCRIPT ARGS NAME = userLevel },    GeneratePlayStreamEvent = true, // Optional - Shows this event in PlayStream   }, AccountController.OnCloudUpdate, AccountController.OnErrorShared);  } }

  You can see this template in the demo script, line 205.

  Note:
  With the use of the Cloud Script, your CLOUD SCRIPT ARGS NAME need to be identical to the STATISTICS ARGUMENT TO PUT IN YOUR UNITY SCRIPT defined earlier.

6 - Friends

Letting players connect with their friends is a great engagement tool for your game! PlayFab offers you the ability to manage your own custom friends lists within your game.

Any player in your title may be friends with any other player in your title. Notably, friendship on PlayFab is a one-way street.

If Julie adds Bob as a friend, there is no approval process for Bob. In fact, Bob may be unaware.

Bob must separately add Julie for the friendship to be mutual.

If you wish to have reciprocity rules, it is your title's responsibility to enforce these conditions with a custom game server or CloudScript logic, if necessary, but this is not yet integrated into this asset.

Note:
This friendship system is also compatible with some services like Photon. A new update should soon be available, this asset will incorporate direct compatibility with these services, so friend systems will no longer be one-way, and you can easily integrate an approval system.

But for now, You must develop this method alone.
If you need help, don’t hesitate to join us on discord.

To start, you need to make your friend panel, you can recover the one from the demo scene. Then, in the asset settings window, go to the “Friends” section and fill all the fields.
For the “Friend listing prefab”, you can use the demo one.


Then click “Apply” to save the selection.

Once that is done, it is time to code. Rest assured, you will only have one or two minutes.
First, you need to choose a method of adding friends.

Four methods are pre-built: Add by Play Fab ID, add by email, add by account username, and add by user name displayed in game.
The calls are respectively:
FriendsController.SubmitFriendRequestWithID();
FriendsController.SubmitFriendRequestWithEmail();
FriendsController.SubmitFriendRequestWithUsername();
FriendsController.SubmitFriendRequestWithDisplayName();
These functions require a parameter, a string that will contain either the user’s ID, or his email, etc.

For example:

using DatabaseAPI.Multiplayer; public string friendsID; public void UpdateFriendSearchID(string FriendID) {  friendsID = FriendID; } public void AddFriend() {  FriendsController.SubmitFrienRequestWithID(friendsID); } public void OpenCloseFriends() {  FriendsController.OpenCloseFriendsPanel(); }

UpdateFriendSearchID is a feature to integrate into the “OnValueChange” of an Input Field, as done previously to connect a user.
Find this model line 218 to 231 of the demo script.

• 1 - Global leaderboard

  Before you start, make sure you have prepared your scene and fill in the corresponding section in the asset settings window:
  
  For the leaderboard listing prefab, you can use the one integrated in the asset, in the Prefabs folder.
  
  Once this is done, you can start coding, everything is already ready, you only have two functions to call:

  using DatabaseAPI.Multiplayer; public void OpenLeaderboard() {  LeaderboardController.OpenLeaderboard(STAT NAME, MAX USER TO DISPLAY); } public void CloseLeaderboard() {  LeaderboardController.CloseLeaderboard(); }

  Find this model line 185 to 193 of the demo script.

• 2 - Friends leaderboard

  Again, configure the settings in the editor window
  
  For the leaderboard listing prefab, you can use the one integrated in the asset, in the Prefabs folder.
  
  Once this is done, you can start coding, everything is already ready, you only have two functions to call:

  using DatabaseAPI.Multiplayer; public void OpenFriendsLeaderboard() {  LeaderboardController.OpenFriendsLeaderboard(STAT NAME, MAX USER TO DISPLAY); } public void CloseFriendsLeaderboard() {  LeaderboardController.CloseFriendsLeaderboard(); }

  Find this model line 195 to 203 of the demo script.

8 - Virtual Currency

You can use up to 10 virtual currencies per project.

Currencies can be used to purchase Items from the Catalog or a Store, can represent soft currency converted from In App Purchases, or can be used as a mechanic to drive gameplay.
Most games support at least two virtual currencies. Many use a “soft” currency that can be earned in-game through play, and a “hard” currency that can be bought. Having dual currencies gives you more control over your economy, since you can determine which items can be bought.
See official PlayFab tutorial on Currencies.

Step 1: Create your virtual currency in PlayFab Dashboard

Then, follow the instructions.

Step 2: Update your Cloud Script

On your project dashboard, go to “Automation” and then choose “Revisions” in the “Cloud Script” section:


Once this is done, you can start writing:

handlers.AddCurency = function (args, context) {  server.AddUserVirtualCurrency({PlayFabId: currentPlayerId, VirtualCurrency: args.money, Amount: args.amount});  return{messageValue: "+" + args.money + " currency"}; }; handlers.SubCurency = function (args, context) {  server.SubtractUserVirtualCurrency({PlayFabId: currentPlayerId, VirtualCurrency: args.money, Amount: args.amount});  return{messageValue: "-" + args.money + " currency"}; };

Step 3: Implementation in Unity

To get started, you need to enable the use of virtual currencies in the editor window.
Go to: Database Controller > Settings > Virtual Currency > Enable virtual currency > Apply

• How to recover the value from playfab

  You should know that your virtual currencies are then stored in a 'virtualcurrency' dictionary, so you can access it at any time, this dictionary is updated each time you log in, or you change one of these values, which will also change it in PlayFab.
  
  So, to get your currency, you just need to type:
  AccountController.controller.virtualCurrency.TryGetValue(CURRENCY CODE, out VARIABLE TO PUT THE VALUE);
  Find this model line 83 of the demo script.

• How to update the currency

  Only one method, everything is ready for you:
  AccountController.UpdateCurrency(CURRENCY CODE, AMOUNT, ADD OR SUBTRACT);
  Find this model line 122 of the demo script.
  
  

  Note:
  The AMOUNT to add need to be greater than 0.
  
  If you want to add the value, turn the third parameter (ADD OR SUBTRACT) to true, or if you want to subtract the amount to the player, turn it to False.