Cómo definir anotaciones, parámetros de fidelidad y niveles de calidad

En este documento, se describe cómo establecer anotaciones, parámetros de fidelidad y niveles de calidad en tu proyecto de Unity.

Anotaciones

Las anotaciones proporcionan información contextual sobre lo que está haciendo tu juego cuando se registra una marca.

Anotaciones predeterminadas

El complemento define una anotación predeterminada para ti:

• Scene: Contiene el identificador de la escena actual que se reproduce; es útil en los casos en los que la mayoría de los niveles se asignan a una sola escena del proyecto

A fin de ver estas anotaciones en la IU, haz lo siguiente:

1. Selecciona Google > Android Performance Tuner.

2. Selecciona la pestaña Parámetros de anotación y haz clic en Usar parámetros personalizados.

   Figura 1: La pestaña Parámetros de anotación en el complemento

Cómo definir y usar una anotación personalizada

Para crear una anotación personalizada, haz lo siguiente:

1. En la pestaña Parámetros de anotación, haz clic en el botón + para crear una anotación nueva.

2. En la fila nueva, haz clic en la columna Tipo y selecciona Agregar o actualizar enum. A modo de ejemplo, puedes hacer una enumeración para la dificultad del juego.

3. Haz clic en el botón Add New Enum después de especificar los valores de enumeración.

   Figura 2: Agregar una enum nueva

4. Selecciona el nuevo tipo en la columna Tipo. Ingresa un nombre para el parámetro en la columna Nombre del parámetro.

   Figura 3: Selecciona la enum nueva

5. Haz clic en el botón Apply para que el complemento vuelva a generar los archivos y las clases del búfer de protocolo.

Para configurar esta anotación en tu juego, llama a SetCurrentAnnotation():

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = Scene.AssetsScenesMainmenu,
    Difficulty = Difficulty.Medium
});

Cómo definir parámetros de fidelidad y niveles de calidad

Los parámetros de fidelidad reflejan el rendimiento y la configuración gráfica de tu juego. Los niveles de calidad se usan para anotar sesiones de modo que puedas determinar si los dispositivos se están ejecutando en un nivel de calidad demasiado alto (lo que disminuye el rendimiento) o demasiado bajo (lo que genera una fidelidad innecesariamente reducida).

Es posible que tu juego ya tenga diferentes parámetros de fidelidad, como los siguientes:

• Calidad de la sombra
• Resolución de textura
• Calidad de los efectos de las partículas

Estos parámetros se pueden reagrupar en niveles de calidad (por ejemplo, "bajo", "medio" y "alto"). Para que Android Performance Tuner informe correctamente estos parámetros y, luego, los analice y visualice en Google Play Console, debes exponer los parámetros al complemento. Agrega los parámetros de fidelidad en la pestaña Parámetros de fidelidad.

Figura 4: Pestaña Parámetros de fidelidad del complemento

Selecciona Utilizar parámetros personalizados y, luego, define un conjunto de parámetros. Cada parámetro tiene un tipo, como las anotaciones.

Usa la función SetFidelityParameters() para establecer los parámetros de fidelidad según corresponda en tu juego:

tuner.SetFidelityParameters(new FidelityParams
{
    ParticleDetails = 1.0f,
    ShadowQuality = ShadowQuality.High,
    TextureResolution = 2048,
});

A continuación, define los diferentes niveles de calidad que se usarán para agrupar los datos en Google Play Console y brindarte mejores estadísticas. Agrega los niveles de calidad en la pestaña Niveles de calidad.

Haz clic en el botón Agregar nivel para agregar el primer nivel. Define varios niveles que sigan una tendencia. Por ejemplo, define los niveles del nivel de calidad más bajo al más alto.

Figura 5: La pestaña Niveles de calidad en el complemento