Google. Android. PerformanceTuner. AndroidPerformanceTuner< TFidelity, TAnnotation >
Es la clase principal para crear una instancia de configuración y ejecución de Android Performance Tuner.
Resumen
Detalles | |||||
---|---|---|---|---|---|
Parámetros de la plantilla |
|
Atributos públicos |
|
---|---|
onReceiveFidelityParameters
|
Action< TFidelity >
Es la acción a la que se llama cada vez que se establecen parámetros de fidelidad nuevos.
|
onReceiveUploadLog
|
Action< UploadTelemetryRequest >
Es la acción a la que se llama cada vez que se sube un registro.
|
Funciones públicas |
|
---|---|
EnableLocalEndpoint()
|
Habilita el extremo local.
|
FindFidelityParametersInApk(string filename)
|
Result< TFidelity >
Carga los parámetros de fidelidad desde la carpeta "assets/tuningfork/" del APK.
|
Flush()
|
Fuerza la carga de los histogramas actuales.
|
FrameTick(InstrumentationKeys key)
|
Graba una marca de fotograma que se asociará a la etiqueta de marca y a la anotación actual.
|
GetFidelityParameters(TFidelity defaultFidelity, uint initialTimeoutMs)
|
Result< TFidelity >
Es una llamada de bloqueo para obtener los parámetros de fidelidad del servidor.
|
SetCurrentAnnotation(TAnnotation annotation)
|
Establece la anotación actual.
|
SetFidelityParameters(TFidelity fidelityParams)
|
Establece los parámetros de fidelidad actualmente activos.
|
SetLoadingState(MessageUtil.LoadingState state)
|
Configura el estado de carga.
|
Start()
|
Inicia AndroidPerformanceTuner.
|
Stop()
|
Detiene Android Performance Tuner.
|
SwappyIsEnabled()
|
bool
Muestra si la opción de Swappy está habilitada o no.
|
Atributos públicos
onReceiveFidelityParameters
Action< TFidelity > onReceiveFidelityParameters
Es la acción a la que se llama cada vez que se establecen parámetros de fidelidad nuevos.
onReceiveUploadLog
Action< UploadTelemetryRequest > onReceiveUploadLog
Es la acción a la que se llama cada vez que se sube un registro.
Funciones públicas
EnableLocalEndpoint
ErrorCode EnableLocalEndpoint()
Habilita el extremo local.
Disponible solo para compilaciones de depuración. Consulta el archivo README o la guía de integración a fin de obtener más información para habilitar el extremo local.
Detalles | |
---|---|
Resultado que se muestra |
Se muestra ErrorCode.InvalidMode si se usa en una compilación no depurable.
|
FindFidelityParametersInApk
Result< TFidelity > FindFidelityParametersInApk( string filename )
Carga los parámetros de fidelidad desde la carpeta "assets/tuningfork/" del APK.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Resultado que se muestra |
Se muestran los parámetros de fidelidad si se cargaron correctamente.
|
Flush
ErrorCode Flush()
Fuerza la carga de los histogramas actuales.
Detalles | |
---|---|
Resultado que se muestra |
Se muestra ErrorCode.Ok si se inició la carga.
Se muestra ErrorCode.PreviousUploadPending si hay una carga anterior que bloquea esta.
ErrorCode.UploadTooFrequent si ha transcurrido menos de un minuto desde la carga anterior.
|
FrameTick
ErrorCode FrameTick( InstrumentationKeys key )
Graba una marca de fotograma que se asociará a la etiqueta de marca y a la anotación actual.
Tanto para el modo avanzado como para el predeterminado, FrameTick se llama automáticamente.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Resultado que se muestra |
Se muestra ErrorCode.InvalidInstrumentKey si la etiqueta de marca no es válida. Se muestra ErrorCode.Ok si la operación fue exitosa.
|
GetFidelityParameters
Result< TFidelity > GetFidelityParameters( TFidelity defaultFidelity, uint initialTimeoutMs )
Es una llamada de bloqueo para obtener los parámetros de fidelidad del servidor.
No es necesario que la llames si pasas un método fidelity_params_callback como parte de la configuración a TuningFork_init. Ten en cuenta que, una vez que se descarguen los parámetros de fidelidad, la información de latencia se grabará como la asociada con esos parámetros. Si luego llamas a GetFidelityParameters y se descarga un nuevo conjunto de parámetros, los datos que ya se hayan recopilado se enviarán al backend. La solicitud de parámetro se envía a url_base + "applications/" + package_name + "/apks/" + version_number + ":generateTuningParameters".
Detalles | |||||
---|---|---|---|---|---|
Parámetros |
|
||||
Resultado que se muestra |
Se muestra ErrorCode.Timeout si se agotó el tiempo de espera antes de que se descargaran los parámetros. Se muestra ErrorCode.Ok si la operación fue exitosa.
|
SetCurrentAnnotation
ErrorCode SetCurrentAnnotation( TAnnotation annotation )
Establece la anotación actual.
Úsala solo para anotaciones personalizadas.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Resultado que se muestra |
Se muestra ErrorCode.TuningforkNotInitialized si no se inicializa el complemento. Se muestra ErrorCode.InvalidMode si se usa con el modo de anotación predeterminado. Se muestra ErrorCode.InvalidAnnotation si la anotación no se condice con la configuración o si su valor establecido no es válido. Se muestra ErrorCode.Ok si la operación fue exitosa.
|
SetFidelityParameters
ErrorCode SetFidelityParameters( TFidelity fidelityParams )
Establece los parámetros de fidelidad actualmente activos.
Esta función anula los parámetros que se descargaron si se está en el modo experimental. Úsala cuando, por ejemplo, el jugador haya cambiado manualmente la configuración de calidad del juego. Esto vacía (es decir, sube) todos los datos asociados con parámetros anteriores.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Resultado que se muestra |
Se muestra ErrorCode.Ok si se pudieron establecer los parámetros. Se muestra ErrorCode.InvalidFidelity si el mensaje tiene valores no válidos. Se muestra ErrorCode.TuningforkNotInitialized si no se inicializa el complemento. Se muestra ErrorCode.InvalidMode si se usa con el modo de fidelidad predeterminado.
|
SetLoadingState
ErrorCode SetLoadingState( MessageUtil.LoadingState state )
Configura el estado de carga.
Úsala solo para anotaciones predeterminadas. Establece MessageUtil.LoadingState.Loading cuando se inicie la carga.
Importante:
- No olvides establecer MessageUtil.LoadingState.NotLoading cuando finalice la carga.
- No se grabará la información de los fotogramas durante la carga.
Detalles | |||
---|---|---|---|
Parámetros |
|
||
Resultado que se muestra |
Se muestra ErrorCode.TuningforkNotInitialized si no se inicializa el complemento. Se muestra ErrorCode.InvalidMode si se usa con el modo de anotación personalizada. Se muestra ErrorCode.Ok si la operación fue exitosa.
|
Inicio
ErrorCode Start()
Inicia AndroidPerformanceTuner.
Detalles | |
---|---|
Resultado que se muestra |
Código que muestra la biblioteca de Android Performance Tuner.
|
Detener
ErrorCode Stop()
SwappyIsEnabled
bool SwappyIsEnabled()
Muestra si la opción de Swappy está habilitada o no.
Para habilitar Swappy en Editor, ve a Project Settings -> Player -> Resolution and Presentation y activa Optimized Frame Pacing. Te recomendamos que actives Swappy a fin de alcanzar una mejor velocidad de fotogramas.
Detalles | |
---|---|
Resultado que se muestra |
Se muestra verdadero si Swappy está habilitado.
|