游客关联

使用游客账号登录。

URL确认

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

API信息

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

请求参数

参数	类型	必填	说明
linked_id	string	必填	关联ID（设备唯一ID）
platform	string	必填	平台 (例如: "aos", "ios")
device_id	string	必填	设备唯一ID
device_model	string	必填	设备型号
device_os	string	必填	设备OS
device_language	string	必填	设备语言 (例如: "KO", "EN")

响应数据

Res类

字段	类型	说明
Token	FSerializeTokenData	Token信息
Player	FSerializePlayerData	玩家信息

FSerializeTokenData 结构

字段	类型	说明
AccessToken	FString	访问Token
RefreshToken	FString	刷新Token

FSerializePlayerData 结构

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

代码示例

void UMyGame::GuestSignin()
{
    FString DeviceId = FPlatformMisc::GetDeviceId();

    // 플레이어 정보가 포함된 요청 바디 생성
    TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
    Body->SetStringField(TEXT("linked_id"), DeviceId);

    // JSON 문자열 변환
    FString JsonBody = FPlayNANOOHelper::ToJsonString(Body);

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-account.playnanoo.com/api/v20240401/guest/signin"));
    Request->SetVerb(TEXT("PUT"));
    FPlayNANOOHelper::SetCommonHeaders(Request, false);  // 인증 토큰 불필요
    Request->SetContentAsString(JsonBody);

    Request->OnProcessRequestComplete().BindLambda(
        [](FHttpRequestPtr Req, FHttpResponsePtr Res, bool bSuccess)
    {
        if (bSuccess && Res.IsValid())
        {
            TSharedPtr<FJsonObject> JsonObject;
            TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(Res->GetContentAsString());

            if (FJsonSerializer::Deserialize(Reader, JsonObject))
            {
                // 토큰 정보
                const TSharedPtr<FJsonObject>* TokenObject;
                if (JsonObject->TryGetObjectField(TEXT("Token"), TokenObject))
                {
                    FString AccessToken;
                    (*TokenObject)->TryGetStringField(TEXT("AccessToken"), AccessToken);
                    UE_LOG(LogTemp, Log, TEXT("게스트 로그인 성공"));
                }

                // 플레이어 정보
                const TSharedPtr<FJsonObject>* PlayerObject;
                if (JsonObject->TryGetObjectField(TEXT("Player"), PlayerObject))
                {
                    FString UserUniqueID;
                    (*PlayerObject)->TryGetStringField(TEXT("UserUniqueID"), UserUniqueID);
                    UE_LOG(LogTemp, Log, TEXT("UserUniqueID: %s"), *UserUniqueID);
                }
            }
        }
    });

    Request->ProcessRequest();
}

获取设备信息

可以使用FPlatformMisc类来获取设备信息。