Administración de memoria en el SDK unificado de PlayFab

​

Información general

​

Asignación de memoria personalizada

​

Establecimiento de enlaces de memoria 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

• Los enlaces deben establecerse antes de llamar a PFServicesInitialize.
• No se pueden cambiar una vez inicializado el SDK.
• Si no se establecen, el SDK usa de forma predeterminada la asignación estándar (malloc/free).

​

Operaciones asincrónicas

​

Uso seguro de XAsyncBlock

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

• No asigne XAsyncBlock en la pila a menos que pueda garantizar su duración.
• Libere la propiedad si se asigna dinámicamente y realice la limpieza en la devolución de llamada.
• Evite capturar referencias o punteros invalidados en la expresión lambda.

​

Limpieza de recursos

​

Cierre de identificadores y desinicialización

PFEntityCloseHandle(entityHandle);
PFServiceConfigCloseHandle(serviceConfigHandle);

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

• Cierre siempre los identificadores de PlayFab para evitar pérdidas.
• Espere a que PFServicesUninitializeAsync se complete antes de cerrar.

​

Procedimientos recomendados

• Establezca los enlaces de memoria pronto: antes de cualquier otra llamada a la API de PlayFab.
• Evite las pérdidas de memoria: cierre los identificadores y administre los recursos asincrónicos con cuidado.
• Use generadores de perfiles de memoria: especialmente en plataformas con presupuestos de memoria ajustados.
• Use asignadores agrupados: para asignaciones frecuentes o críticas para el rendimiento.

​

Consulte también

• Operaciones asincrónicas
• Administración de memoria
• Seguimiento y diagnóstico