タイトルで管理されるランキングを取得する

目次

• ランキング全体を取得する
• 指定したランクの前後のランキングを取得する
• 指定したプレイヤーの前後のランキングを取得する

このトピックでは、タイトル管理されたリーダーボードの値を取得する方法について説明します。

ランキング全体を取得する

XblLeaderboardGetLeaderboardAsync を使用して、特定のリーダーボードのリーダーボード値を返します。 結果は、リーダーボードの先頭からランクの高い順に返されます。 タイトル管理統計に基づくリーダーボードをクエリするときは、必ず queryType フィールドを XblLeaderboardQueryType::TitleManagedStatBackedGlobal または XblLeaderboardQueryType::TitleManagedStatBackedSocial に設定してください。

C API

auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->queue = queue;
asyncBlock->context = nullptr;
asyncBlock->callback = [](XAsyncBlock* asyncBlock)
{
    std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock }; // Take over ownership of the XAsyncBlock*
    size_t resultSize;
    HRESULT hr = XblLeaderboardGetLeaderboardResultSize(asyncBlock, &resultSize);

    if (SUCCEEDED(hr))
    {
        leaderboardBuffer.resize(resultSize);
        XblLeaderboardResult* leaderboard{};

        hr = XblLeaderboardGetLeaderboardResult(asyncBlock, resultSize, leaderboardBuffer.data(), &leaderboard, nullptr);

        if (SUCCEEDED(hr))
        {
            // Use XblLeaderboardResult in result
            for (auto row = 0u; row < leaderboard->rowsCount; ++row)
            {
                std::stringstream rowText;
                rowText << leaderboard->rows[row].xboxUserId << "\t";

                for (auto column = 0u; column < leaderboard->rows[row].columnValuesCount; ++column)
                {
                    rowText << leaderboard->rows[row].columnValues[column] << "\t";
                }
            }
        }
    }
};

// XblLeaderboardQuery is set up to query for all leaderboard items here
// see example code in sections below showing how to run other queries
XblLeaderboardQuery leaderboardQuery = {}; 
pal::strcpy(leaderboardQuery.scid, sizeof(leaderboardQuery.scid), scid.c_str()) 
leaderboardQuery.statName = statName.c_str(); 
leaderboardQuery.queryType = XblLeaderboardQueryType::TitleManagedStatBackedGlobal;


HRESULT hr = XblLeaderboardGetLeaderboardAsync(
    xboxLiveContext,
    leaderboardQuery,
    asyncBlock.get());
if (SUCCEEDED(hr))
{
    // The call succeeded, so release the std::unique_ptr ownership of XAsyncBlock* since the callback will take over ownership.
    // If the call fails, the std::unique_ptr will keep ownership and delete the XAsyncBlock*
    asyncBlock.release();
}

リファレンス

• XAsyncBlock
• XblLeaderboardGetLeaderboardAsync
• XblLeaderboardGetLeaderboardResult
• XblLeaderboardGetLeaderboardResultSize
• XblLeaderboardQuery
• XblLeaderboardResult
• XblLeaderboardQueryType

指定したランクの前後のランキングを取得する

XblLeaderboardQuery を作成するときにクエリ条件を指定することにより、リーダーボード クエリからフィルタリングされた結果を取得できます。 指定されたランクのリーダーボード値を取得するには、上記の例のコードを使用しますが、XblLeaderboardQuery を作成する行を次のコードに置き換えます。

C API

XblLeaderboardQuery leaderboardQuery = {};
pal::strcpy(leaderboardQuery.scid, sizeof(leaderboardQuery.scid), scid.c_str());
leaderboardQuery.statName = statName.c_str();
leaderboardQuery.skipResultToRank = 100;
leaderboardQuery.maxItems = 100;
leaderboardQuery.queryType = XblLeaderboardQueryType::TitleManagedStatBackedGlobal;

リファレンス

• XblLeaderboardQuery

指定したプレイヤーの前後のランキングを取得する

指定されたプレイヤーのリーダーボード値を取得するには、上記の例のコードを使用しますが、XblLeaderboardQuery を作成する行を次のコードに置き換えます。

C API

XblLeaderboardQuery leaderboardQuery = {};
pal::strcpy(leaderboardQuery.scid, sizeof(leaderboardQuery.scid), scid.c_str());
leaderboardQuery.statName = statName.c_str();
leaderboardQuery.skipToXboxUserId = xboxUserId;
leaderboardQuery.maxItems = 100;
leaderboardQuery.queryType = XblLeaderboardQueryType::TitleManagedStatBackedGlobal;

リファレンス

• XblLeaderboardQuery