La API de Memory Advice está en versión beta.

Cómo comenzar a usar la API de Memory Advice (Unity)

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta guía, se describe cómo usar el complemento de Memory Advice para Unity a fin de integrar la API de Memory Advice en tu juego de Unity.

Requisitos

El complemento es compatible con lo siguiente:

  • Unity 2019 con el NDK de Android r19

  • Unity 2020 con el NDK de Android r19

  • Unity 2021 con el NDK de Android r21

Es posible que experimentes problemas inesperados si usas otras versiones de Unity y el NDK de Android. Para encontrar la versión del NDK que usa tu instalación de Unity, consulta la guía de configuración del entorno de Android para Unity.

Cómo descargar el complemento

Descarga el complemento.

Cómo importar el complemento

El complemento es un paquete de Unity que puedes importar a tu proyecto. Para importar el complemento, haz clic en Assets > Import Package > Custom Package y selecciona el archivo .unitypackage que descargaste. También puedes hacer doble clic en el archivo .unitypackage después de abrir el proyecto de Unity.

Cómo usar la biblioteca

En esta sección, se describe cómo usar la biblioteca.

Cómo inicializar la biblioteca

Deberás inicializar la biblioteca una vez cuando se inicie la app. Para ello, agrega este código a tu proyecto:

void Start()
{
    MemoryAdviceErrorCode errorCode = MemoryAdvice.Init();
    if(errorCode == MemoryAdviceErrorCode.Ok)
    {
        Debug.Log("Memory advice init successfully");
    }
}

Cómo hacer un sondeo para el estado de la memoria

Para recuperar el estado de la memoria de tu app, sondea la biblioteca en el intervalo que elijas. Usa la función MemoryAdvice_getMemoryState siempre que necesites sondear la biblioteca:

MemoryState memoryState = MemoryAdvice.GetMemoryState();
switch (memoryState)
{
    case MemoryState.Ok:
        //The application can safely allocate memory.
        break;
    case MemoryState.ApproachingLimit:
        // The application should minimize memory allocation.
        break;
    case  MemoryState.Critical:
        // The application should free memory as soon as possible
        // until the memory state changes.
        break;
}

Cómo configurar un observador

También puedes configurar un observador y registrar la API de Memory Advice. Se llamará a tu función de observador cuando el estado se acerque al límite o al estado crítico de la memoria (pero no para el estado correcto). Por ejemplo, el siguiente código crea un observador y solicita una notificación de la API de Memory Advice cada 2 segundos:

MemoryAdviceErrorCode = errorCode = MemoryAdvice.RegisterWatcher(2000,
        new MemoryWatcherDelegateListener((MemoryState state) =>
    {
        switch (memoryState)
        {
            case MemoryState.ApproachingLimit:
                // The application should minimize memory allocation.
                break;
            case  MemoryState.Critical:
                // The application should free memory as soon as possible
                // until the memory state changes.
                break;
        }
    })
);

if(errorCode == MemoryAdviceErrorCode.Ok)
{
    Debug.Log("Memory advice watcher resgiter successfully");
}

Próximos pasos

Puedes descargar nuestro proyecto de muestra de Unity, que proporciona una IU simple para asignar y liberar memoria, y usa la API de Memory Advice para supervisar el estado de la memoria.

Consulta la descripción general para obtener más recursos y reportar problemas.