Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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

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

Anotaciones

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

Anotaciones predeterminadas

El complemento define dos anotaciones predeterminadas para ti:

  • scene: contiene el identificador de la escena que se está reproduciendo en el momento. Es útil cuando la mayoría de los niveles se asignan a una sola escena del proyecto.
  • loading_state: identifica cuando se está cargando una escena. De forma predeterminada, se establece en NOT_LOADING.

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

  1. Selecciona Google > Android Performance Tuner.
  2. Selecciona la pestaña Annotation parameters y, luego, haz clic en Use custom parameters.

    Figura 1: La pestaña Annotation parameters del complemento

Cómo definir y usar una anotación personalizada

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

  1. En la pestaña Annotation parameters, haz clic en el botón + a fin de crear una anotación nueva.
  2. En la fila nueva, haz clic en la columna Type y selecciona Add or update enum. Por ejemplo, puedes crear 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: Cómo crear una enumeración nueva

  4. Selecciona el tipo nuevo en la columna Type. Ingresa un nombre para el parámetro en la columna Parameter name.

    Figura 3: Cómo seleccionar la nueva enumeración

  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,
    LoadingState = LoadingState.Loading
    GameDifficulty = Difficulty.Medium
});

Cómo definir anotaciones de carga

Las anotaciones de carga marcan los fotogramas que forman parte del proceso de carga de los niveles. Usa anotaciones de carga de modo que los fotogramas más lentos que ocurran mientras el juego se esté cargando no afecten las métricas generales.

Antes de que comience la carga, configura su anotación:

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = Scene.AssetsScenesMainmenu,
    LoadingState = LoadingState.Loading
    // And any other annotation
});

Una vez que finalice la carga, configura la anotación para anularla:

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = Scene.AssetsScenesMainmenu,
    LoadingState = LoadingState.NotLoading
    // And any other annotation
});

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 del juego. Los niveles de calidad se usan para anotar las sesiones, de modo que puedas determinar si los dispositivos se están ejecutando en un nivel de calidad demasiado alto (lo cual disminuye el rendimiento) o demasiado bajo (lo cual reduce la fidelidad de manera innecesaria).

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

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

Se puede reagrupar estos parámetros en niveles de calidad (por ejemplo, "baja", "media" y "alta"). A fin de que Android Performance Tuner detecte correctamente estos parámetros que, luego, se analizarán y visualizarán en Google Play Console, debes exponerlos en el complemento. Agrega los parámetros de fidelidad en la pestaña Fidelity parameters.

Figura 4: La pestaña Fidelity parameters en el complemento

Selecciona Use custom parameters 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 diferentes niveles de calidad que se usarán para agrupar los datos en Google Play Console y ofrecerte mejores estadísticas. Agrega tus niveles de calidad en la pestaña Quality levels.

Haz clic en el botón Add Level para agregar el primer nivel. Define varios niveles que sigan una tendencia. Por ejemplo, define niveles para aquellos de calidad más bajos hasta los más altos.

Figure 5: Pestaña Quality levels en el complemento