GetPlayerInfoByDisplayName

public BackndOtherPlayerReturnObject GetPlayerInfoByDisplayName(string nickName);

BackndOtherPlayerReturnObject

GetReturnValueByPlayerItem

If an error occurred, null is returned.

BackndOtherPlayerReturnObject bro = Backnd.Player.GetPlayerInfoByDisplayName("nickName");
string gamerIndate = bro.GetReturnValueByPlayerItem().inDate;

BackndPlayerItem

public class BackndPlayerItem
{
    public string nickname = string.Empty;
    public string inDate = string.Empty;
    public string lastLogin = string.Empty;
    public string guildName = string.Empty;
}

Parameter

Value	Type	Description
nickName	string	Nickname of the user whose information is to be looked up

Description

Retrieves the user information of the user with the corresponding nickname.
The following information can be looked up:

• User's nickname
• User's gamerIndate
• Last accessed time
• Name of the guild the user belongs to

Example

Synchronous

BackndOtherPlayerReturnObject bro = Backnd.Player.GetPlayerInfoByDisplayName("nickName");

//example
string gamerIndate = bro.GetReturnValueByPlayerItem().inDate;
if(string.IsNullOrEmpty(bro.GetReturnValueByPlayerItem().guildName)) // null is returned when no guild name is registered
{
      string guildName = bro.GetReturnValueByPlayerItem().guildName;
}

Asynchronous

Backnd.Player.GetPlayerInfoByDisplayName("ImATestUser", (callback) => 
{
        string gamerIndate = callback.GetReturnValueByPlayerItem().inDate;
        if(string.IsNullOrEmpty(callback.GetReturnValueByPlayerItem().guildName)) // null is returned when no guild name is registered
        {
              string guildName = callback.GetReturnValueByPlayerItem().guildName;
        }
});

Return cases

Success cases

When a user with the corresponding nickname exists
statusCode : 200
message : Success returnValue : refer to GetReturnValuetoJSON

When a user with the corresponding nickname does not exist
statusCode : 404
errorCode : NotFoundException
message : gamer does not exist.

GetReturnValuetoJSON

{
    "row":
    {
        "nickname": "ImATestUser", // User's nickname
        "inDate":"2021-00-00T00:00:00.000Z", // User inDate
        "lastLogin":"2021-06-23T02:08:56.235Z", // Last time of login
        "guildName":"testGuild" // Name of the user's guild(null if non-existent)
    }
}

Sample code

 public class SearchUserItem
 {
     public string nickname;
     public string inDate;
     public string lastLogin;
     public string guildName;

     public override string ToString()
     {
         return $"nickname : {nickname}\ninDate : {inDate}\nlastLogin : {lastLogin}\nguildName : {guildName}\n";
     }
 };

public void GetPlayerInfoByDisplayNameTest()
{
    string userNickname = "Nickname";

    var bro = Backnd.Player.GetPlayerInfoByDisplayName(userNickname);

    if(!bro.IsSuccess())
        return;

    BACKND.LitJson.JsonData json = bro.GetReturnValuetoJSON();

    SearchUserItem userInfo = new SearchUserItem();

    userInfo.nickname = json["row"]["nickname"].ToString();
    userInfo.inDate = json["row"]["inDate"].ToString();
    userInfo.lastLogin = json["row"]["lastLogin"].ToString();
    if(json["row"]["guildName"] != null)
    {
        userInfo.guildName = json["row"]["guildName"].ToString();
    }

    Debug.Log(userInfo.ToString());
}