玩家数据批量查询

一次加载其他玩家的多个公开数据。

URL确认

API service-storage-api.playnanoo.com 域名 使用。

API信息

• URL: https://service-storage-api.playnanoo.com/storage/v20221001/playerDataLoad/multi
• Method: PUT
• 需要认证: 是

请求参数

参数	类型	必填	说明
storage_keys	string	必填	查询 数据 列表 (JSON 字符串)

storage_keys JSON 结构 (MultiLoadParam)

字段	类型	必填	说明
Items	MultiLoadParamValue[]	必填	查询 数据 列表

MultiLoadParamValue 结构

字段	类型	必填	说明
PlayerId	string	必填	查询 玩家 ID
StorageKey	string	必填	要加载的数据的密钥

响应数据

字段	类型	说明
Items	array	已加载的数据列表

Items 数组元素

字段	类型	说明
PlayerId	string	玩家 ID
StorageKey	string	数据的Key
StorageValue	string	数据的值

代码示例

// MultiLoadParamValue 구조체
struct FMultiLoadParamValue
{
    FString PlayerId;
    FString StorageKey;

    TSharedPtr<FJsonObject> ToJsonObject() const
    {
        TSharedPtr<FJsonObject> JsonObject = MakeShareable(new FJsonObject());
        JsonObject->SetStringField(TEXT("PlayerId"), PlayerId);
        JsonObject->SetStringField(TEXT("StorageKey"), StorageKey);
        return JsonObject;
    }
};

void UMyGame::LoadMultiPlayerData(const TArray<FMultiLoadParamValue>& Items)
{
    // Items 배열을 JSON으로 변환
    TArray<TSharedPtr<FJsonValue>> ItemsArray;
    for (const FMultiLoadParamValue& Item : Items)
    {
        ItemsArray.Add(MakeShareable(new FJsonValueObject(Item.ToJsonObject())));
    }

    // storage_keys용 JSON 객체 생성 (MultiLoadParam)
    TSharedPtr<FJsonObject> StorageKeysObj = MakeShareable(new FJsonObject());
    StorageKeysObj->SetArrayField(TEXT("Items"), ItemsArray);

    // storage_keys를 JSON 문자열로 변환
    FString StorageKeysJson;
    TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&StorageKeysJson);
    FJsonSerializer::Serialize(StorageKeysObj.ToSharedRef(), Writer);

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

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

    // HTTP 요청
    TSharedRef<IHttpRequest> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://service-storage-api.playnanoo.com/storage/v20221001/playerDataLoad/multi"));
    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))
            {
                const TArray<TSharedPtr<FJsonValue>>* Items;
                if (JsonObject->TryGetArrayField(TEXT("Items"), Items))
                {
                    for (const auto& Item : *Items)
                    {
                        TSharedPtr<FJsonObject> ItemObj = Item->AsObject();
                        FString PlayerId = ItemObj->GetStringField(TEXT("PlayerId"));
                        FString Key = ItemObj->GetStringField(TEXT("StorageKey"));
                        FString Value = ItemObj->GetStringField(TEXT("StorageValue"));
                        UE_LOG(LogTemp, Log, TEXT("플레이어 %s: %s = %s"), *PlayerId, *Key, *Value);
                    }
                }
            }
        }
    });

    Request->ProcessRequest();
}

使用示例

void UMyGame::Example()
{
    // 조회할 플레이어와 데이터 목록 생성
    TArray<FMultiLoadParamValue> Items;
    Items.Add({TEXT("PLAYER_ID_1"), TEXT("public_profile")});
    Items.Add({TEXT("PLAYER_ID_2"), TEXT("ranking_info")});
    Items.Add({TEXT("PLAYER_ID_1"), TEXT("achievement_list")});

    // API 호출
    LoadMultiPlayerData(Items);
}

高效查询

查询其他玩家的多个公开数据时使用此API可以减少网络请求次数。

安全 注意

此API查询其他玩家的数据，因此应仅保存可公开的数据。