社交登录

使用社交账户（Google、Facebook、Apple 等）登录的 API。

URL 确认

此 API 使用 service-account.playnanoo.com 域名。

API 信息

• URL: https://service-account.playnanoo.com/api/v20240101/social/signin
• Method: PUT
• 需要认证: 否

请求参数

参数	类型	必需	说明
request_uuid	string	必需	请求唯一 ID（UUID）
account_type	string	必需	社交账户类型（例如："google"、"facebook"、"apple"）
account_token	string	必需	社交账户访问令牌
platform	string	必需	平台（例如："aos"、"ios"）
device_id	string	必需	设备唯一 ID
device_model	string	必需	设备型号
device_os	string	必需	设备 OS
device_language	string	必需	设备语言（例如："KO"、"EN"）

DeviceInfo 继承

此 API 的 Req 类继承自 DeviceInfo。DeviceInfo 的所有属性将自动包含。

响应数据

Res 类

字段	类型	说明
Token	SerializeTokenData	令牌信息
Player	SerializePlayerData	玩家信息

SerializeTokenData 结构

字段	类型	说明
AccessToken	string	访问令牌
RefreshToken	string	刷新令牌

SerializePlayerData 结构

字段	类型	说明
UserUniqueID	string	用户唯一 ID
OpenID	string	开放 ID
Nickname	string	昵称
LinkedID	string	关联 ID
LinkedType	string	关联类型
PurchaseCount	int	购买次数
PurchaseCurrencyCode	string	购买货币代码
PurchaseTotalPrice	double	购买总金额
PurchaseVoidedCount	int	退款次数
PurchaseVoidedCurrencyCode	string	退款货币代码
PurchaseVoidedTotalPrice	double	退款总金额
Country	string	国家
Timezone	string	时区
Offset	int	时间偏移量
JoinPeriod	int	注册时长

Unity C# 实现

BaseResponse 类

所有 API 响应的基类。

public class BaseResponse
{
    public string ErrorCode;
    public string Message;
    public string WithdrawalKey;
    public string BlockKey;
}

字段说明：

• ErrorCode：错误代码
• Message：错误信息
• WithdrawalKey：处于注销宽限期时恢复所需的密钥（仅在注销宽限期内的账户提供）
• BlockKey：被封禁账户时提供的密钥（仅在被封禁的账户提供）

社交登录类

using System;
using System.Collections;
using UnityEngine.Networking;

public class SocialSignin
{
    static string path = "https://service-account.playnanoo.com/api/v20240101/social/signin";

    [Serializable]
    public class Req : DeviceInfo
    {
        public string request_uuid;
        public string account_type;
        public string account_token;

        public IEnumerator Send(
            string request_uuid,
            string account_type,
            string account_token,
            Action<Res> onSuccess,
            Action<BaseResponse> onError)
        {
            if (!string.IsNullOrEmpty(request_uuid)) this.request_uuid = request_uuid;
            if (!string.IsNullOrEmpty(account_type)) this.account_type = account_type;
            if (!string.IsNullOrEmpty(account_token)) this.account_token = account_token;

            yield return HttpClient.Send<Req, Res>(
                UnityWebRequest.kHttpVerbPUT,
                path,
                requireToken: false,
                body: this,
                onSuccess: onSuccess,
                onError: onError
            );
        }
    }

    [Serializable]
    public class Res : BaseResponse
    {
        public SerializeTokenData Token;
        public SerializePlayerData Player;
    }

    [Serializable]
    public class SerializeTokenData
    {
        public string AccessToken;
        public string RefreshToken;
    }

    [Serializable]
    public class SerializePlayerData
    {
        public string UserUniqueID;
        public string OpenID;
        public string Nickname;
        public string LinkedID;
        public string LinkedType;
        public int PurchaseCount;
        public string PurchaseCurrencyCode;
        public double PurchaseTotalPrice;
        public int PurchaseVoidedCount;
        public string PurchaseVoidedCurrencyCode;
        public double PurchaseVoidedTotalPrice;
        public string Country;
        public string Timezone;
        public int Offset;
        public int JoinPeriod;
    }
}

使用示例

Google 登录

public void GoogleSignIn(string googleAccessToken)
{
    SocialSignin.Req req = new SocialSignin.Req();

    StartCoroutine(req.Send(
        request_uuid: Guid.NewGuid().ToString(),
        account_type: "google",
        account_token: googleAccessToken,
        onSuccess: res =>
        {
            // 令牌
            Debug.Log($"AccessToken: {res.Token.AccessToken}");
            Debug.Log($"RefreshToken: {res.Token.RefreshToken}");

            // 玩家信息
            Debug.Log($"UserUniqueID: {res.Player.UserUniqueID}");
            Debug.Log($"OpenID: {res.Player.OpenID}");
            Debug.Log($"Nickname: {res.Player.Nickname}");
            Debug.Log($"LinkedID: {res.Player.LinkedID}");
            Debug.Log($"LinkedType: {res.Player.LinkedType}");
        },
        onError: (error) =>
        {
            Debug.LogError($"Google 로그인 실패: [{error.ErrorCode}] [{error.Message}]");
        }
    ));
}

Facebook 登录

public void FacebookSignIn(string facebookAccessToken)
{
    SocialSignin.Req req = new SocialSignin.Req();

    StartCoroutine(req.Send(
        request_uuid: Guid.NewGuid().ToString(),
        account_type: "facebook",
        account_token: facebookAccessToken,
        onSuccess: res =>
        {
            Debug.Log("Facebook 로그인 성공!");
            Debug.Log($"UserUniqueID: {res.Player.UserUniqueID}");
        },
        onError: (error) =>
        {
            Debug.LogError($"Facebook 로그인 실패: [{error.ErrorCode}] [{error.Message}]");
        }
    ));
}

Apple 登录

public void AppleSignIn(string appleIdToken)
{
    SocialSignin.Req req = new SocialSignin.Req();

    StartCoroutine(req.Send(
        request_uuid: Guid.NewGuid().ToString(),
        account_type: "apple",
        account_token: appleIdToken,
        onSuccess: res =>
        {
            Debug.Log("Apple 로그인 성공!");
            Debug.Log($"UserUniqueID: {res.Player.UserUniqueID}");
        },
        onError: (error) =>
        {
            Debug.LogError($"Apple 로그인 실패: [{error.ErrorCode}] [{error.Message}]");
        }
    ));
}

支持的社交账户类型

account_type	说明	所需令牌
google	Google 账户	Google OAuth2 Access Token
facebook	Facebook 账户	Facebook Access Token
apple	Apple 账户	Apple ID Token

社交登录 SDK

要实现各社交平台的登录，需要对应平台的 SDK：

• Google：Google Sign-In for Unity
• Facebook：Facebook SDK for Unity
• Apple：Sign in with Apple（iOS 13+）

request_uuid

request_uuid 是用于唯一标识每个登录请求的 UUID。可以使用 Guid.NewGuid().ToString() 来生成。