注册及管理
设置或变更玩家的昵称。
URL确认
此API使用 service-account.playnanoo.com 域名。
API信息
- URL:
https://service-account.playnanoo.com/api/v20240401/nickname/put - Method:
PUT - 需要认证: 是
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| change_nickname | string | 必填 | 要设置的昵称 |
| check_exists | string | 必填 | 是否检查重复 ("Y": 检查, "N": 不检查) |
| platform | string | 必填 | 平台 (例如: "aos", "ios") |
| device_id | string | 必填 | 设备唯一ID |
| device_model | string | 必填 | 设备型号 |
| device_os | string | 必填 | 设备OS |
| device_language | string | 必填 | 设备语言 (例如: "KO", "EN") |
响应数据
Res结构体
| 字段 | 类型 | 说明 |
|---|---|---|
| Nickname | FString | 已设置的昵称 |
代码示例
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"。