Gerenciamento de memória no SDK unificado do PlayFab

​

Visão geral

​

Alocação de memória personalizada

​

Definindo hooks de memória personalizados

void* MyCustomAlloc(size_t size, uint32_t memoryTypeId);
void MyCustomFree(void* ptr, uint32_t memoryTypeId);

PFMemoryHooks memoryHooks = { MyCustomAlloc, MyCustomFree };
PFMemSetFunctions(&memoryHooks);
PFServicesInitialize(nullptr); // Must be called after setting memory hooks

• Os hooks precisam ser definidos antes de chamar PFServicesInitialize.
• Eles não podem ser alterados depois que o SDK é inicializado.
• Se não forem definidos, o SDK usará a alocação padrão (malloc/free).

​

Operações assíncronas

​

Usando o XAsyncBlock com segurança

auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->callback = [](XAsyncBlock* block)
{
    // Retrieve result, then delete asyncBlock if needed
};
StartAsyncPlayFabCall(asyncBlock.get());
asyncBlock.release(); // Ownership passed; handle lifetime carefully

• Não aloque o XAsyncBlock na pilha, a menos que possa garantir seu tempo de vida.
• Libere a propriedade se ele for alocado dinamicamente e faça a limpeza no callback.
• Evite capturar referências ou ponteiros invalidados na lambda.

​

Limpeza de recursos

​

Fechando identificadores e desinicializando

PFEntityCloseHandle(entityHandle);
PFServiceConfigCloseHandle(serviceConfigHandle);

// Gracefully uninitialize the SDK
XAsyncBlock async{};
PFServicesUninitializeAsync(&async);
XAsyncGetStatus(&async, true); // Blocks until cleanup completes

• Sempre feche os identificadores do PlayFab para evitar vazamentos.
• Aguarde a conclusão de PFServicesUninitializeAsync antes de encerrar.

​

Práticas recomendadas

• Defina os hooks de memória cedo: antes de qualquer outra chamada à API do PlayFab.
• Evite vazamentos de memória: feche os identificadores e gerencie os recursos assíncronos com cuidado.
• Use criadores de perfil de memória: especialmente em plataformas com orçamentos de memória apertados.
• Use alocadores em pool: para alocações frequentes ou críticas para o desempenho.

​

Confira também

• Operações assíncronas
• Gerenciamento de memória
• Rastreamento e diagnóstico