跳转到主要内容

注册及管理

设置或变更玩家的昵称。

URL确认

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

API信息

  • URL: https://service-account.playnanoo.com/api/v20240401/nickname/put
  • Method: PUT
  • 需要认证: 是

请求参数

参数类型必填说明
change_nicknamestring必填要设置的昵称
check_existsstring必填是否检查重复 ("Y": 检查, "N": 不检查)
platformstring必填平台 (例如: "aos", "ios")
device_idstring必填设备唯一ID
device_modelstring必填设备型号
device_osstring必填设备OS
device_languagestring必填设备语言 (例如: "KO", "EN")

响应数据

Res结构体

字段类型说明
NicknameFString已设置的昵称

代码示例

void UMyGame::SetNickname(const FString& AccessToken, const FString& NewNickname, bool bCheckExists)
{
// 플레이어 정보가 포함된 요청 바디 생성
TSharedPtr<FJsonObject> Body = FPlayNANOOHelper::CreateRequestBody();
Body->SetStringField(TEXT("change_nickname"), NewNickname);
Body->SetStringField(TEXT("check_exists"), bCheckExists ? TEXT("Y") : TEXT("N"));

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

// HTTP 요청
TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
Request->SetURL(TEXT("https://service-account.playnanoo.com/api/v20240401/nickname/put"));
Request->SetVerb(TEXT("PUT"));
FPlayNANOOHelper::SetCommonHeaders(Request, true); // 인증 토큰 포함
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))
{
FString Nickname;
JsonObject->TryGetStringField(TEXT("Nickname"), Nickname);
UE_LOG(LogTemp, Log, TEXT("닉네임 설정 완료: %s"), *Nickname);
}
}
});

Request->ProcessRequest();
}
check_exists 参数

设置为"Y"可防止重复昵称。通常建议使用"Y"。