Medições de QoS do PlayFab Party - XBOX Game Development Documentation

O PlayFab Party realiza medições de qualidade de serviço (QoS) em segundo plano para fornecer aos títulos acesso de baixa latência a recursos remotos do Azure. Aqui, descreveremos os principais cenários em que os títulos devem esperar encontrar os recursos de QoS do Party.

Entendendo quando a QoS é medida

A biblioteca do Party começa a medir a QoS assim que o Party é inicializado. Depois que o Party mede a QoS com êxito, a única maneira de atualizar essas medições é limpar e reinicializar a biblioteca do Party. Se a medição de QoS falhar, a biblioteca do Party tentará a medição novamente na próxima vez que você chamar PartyManager::CreateNewNetwork.

Selecionando regiões para as redes do Party

O principal motivo pelo qual o PlayFab Party mede a QoS é permitir que os títulos usem dados de latência ao selecionar a região do Azure em que uma rede do Party é hospedada. Sem esperar para inspecionar os resultados das medições de QoS, os títulos podem chamar PartyManager::CreateNewNetwork com uma lista vazia de regiões preferenciais para alocar uma rede na região que atualmente tem a menor latência.

uint32_t regionCount = 0;
const PartyRegion* regionList = nullptr;

PartyError error = PartyManager::GetSingleton().CreateNewNetwork(
    localUser,
    &networkConfiguration,
    regionCount,
    regionList,
    nullptr,
    nullptr,
    nullptr,
    nullptr);

Como alternativa, os títulos podem inspecionar os resultados das medições de QoS da biblioteca do Party e selecionar uma lista de regiões preferenciais com base em critérios específicos do título. Para inspecionar os resultados das medições de QoS, aguarde receber um PartyRegionsChangedStateChange bem-sucedido de PartyManager::StartProcessingStateChanges.

switch (stateChange->stateChangeType)
{
    case PartyStateChangeType::RegionsChanged:
    {
        auto regionsChanged = static_cast<PartyRegionsChangedStateChange*>(stateChange);
        if (regionsChanged.result == PartyStateChangeResult::Succeeded)
        {
            m_qosResultsReady = true;
        }
    }

    // ...
}

Em seguida, chame PartyManager::GetRegions para inspecionar e avaliar a lista atual de regiões e latências.

if (m_qosResultsReady)
{
    uint32_t regionCount;
    const PartyRegion* regionList;

    PartyError error = PartyManager::GetSingleton().GetRegions(
        &regionCount,
        &regionList);
    if (PARTY_FAILED(error))
    {
        DEBUGLOG("PartyManager::GetRegions failed: %s\n", PartyManager::GetErrorMessage(error));
        return;
    }

    // Prevent Party from using Azure regions above some latency threshold.
    // The game is unplayable in those scenarios.
    std::vector<PartyRegion> filteredRegionList = OmitRegionsAboveMaxLatency(regionCount, regionList, maxLatency);

    error = PartyManager::GetSingleton().CreateNewNetwork(
        localUser,
        &networkConfiguration,
        filteredRegionList.size(),
        filteredRegionList.data(),
        nullptr,
        nullptr,
        nullptr,
        nullptr);
    if (PARTY_FAILED(error))
    {
        DEBUGLOG("PartyManager::CreateNewNetwork failed: %s\n", PartyManager::GetErrorMessage(error));
        return;
    }

Diferenças de preço regionais

Lembre-se de que nem todas as regiões do Party são cobradas da mesma forma. Para obter informações sobre as diferenças de preço regionais, confira nossa página de preços.

Usando regiões ideais para recursos de chat acessível

O outro motivo pelo qual o PlayFab Party mede a QoS é permitir recursos de acessibilidade de chat mais responsivos: síntese de texto em fala, transcrição de fala em texto e tradução. Esses recursos de acessibilidade usam recursos regionais dos Serviços Cognitivos do Azure, e a medição de QoS permite o uso ideal das diferentes regiões.

Entendendo as falhas na medição de QoS

Como a criação de redes e os recursos de acessibilidade de chat dependem das medições de QoS, é importante inspecionar o resultado e os detalhes de erro do PartyRegionsChangedStateChange. Falhas nessa alteração de estado podem fornecer um contexto de depuração útil para falhas posteriores.

​Entendendo quando a QoS é medida

​Selecionando regiões para as redes do Party

​Diferenças de preço regionais

​Usando regiões ideais para recursos de chat acessível

​Entendendo as falhas na medição de QoS

Entendendo quando a QoS é medida

Selecionando regiões para as redes do Party

Diferenças de preço regionais

Usando regiões ideais para recursos de chat acessível

Entendendo as falhas na medição de QoS