Google.Android.PerformanceTuner.AndroidPerformanceTuner< TFidelity, TAnnotation >

Class utama yang dibuat instance-nya untuk menyiapkan dan menjalankan Android Performance Tuner.

Ringkasan

Detail
Parameter template
TFidelity
Class pesan FidelityParams yang dihasilkan oleh plugin.
TAnnotation
Class pesan anotasi yang dihasilkan oleh plugin.

Atribut publik

onReceiveFidelityParameters
Action< TFidelity >
Tindakan yang dipanggil setiap kali parameter fidelitas yang baru disetel.
onReceiveUploadLog
Action< UploadTelemetryRequest >
Tindakan yang dipanggil setiap kali log diupload.

Fungsi publik

EnableLocalEndpoint()
Aktifkan endpoint lokal.
FindFidelityParametersInApk(string filename)
Result< TFidelity >
Memuat parameter fidelitas dari folder "assets/tuningfork/" APK.
Flush()
Paksa upload histogram saat ini.
FrameTick(InstrumentationKeys key)
Rekam titik skala frame yang akan dikaitkan dengan kunci instrumentasi dan anotasi saat ini.
GetFidelityParameters(TFidelity defaultFidelity, uint initialTimeoutMs)
Result< TFidelity >
Panggilan pemblokiran untuk mendapatkan parameter fidelitas dari server.
SetCurrentAnnotation(TAnnotation annotation)
Setel anotasi saat ini.
SetFidelityParameters(TFidelity fidelityParams)
Menyetel parameter fidelitas yang saat ini aktif.
SetLoadingState(MessageUtil.LoadingState state)
Menyetel status pemuatan.
Start()
Mulai AndroidPerformanceTuner.
Stop()
Hentikan Android Performance Tuner.
SwappyIsEnabled()
bool
Tampilkan jika swappy diaktifkan atau tidak.

Atribut publik

onReceiveFidelityParameters

Action< TFidelity > onReceiveFidelityParameters

Tindakan yang dipanggil setiap kali parameter fidelitas yang baru disetel.

onReceiveUploadLog

Action< UploadTelemetryRequest > onReceiveUploadLog

Tindakan yang dipanggil setiap kali log diupload.

Fungsi publik

EnableLocalEndpoint

ErrorCode EnableLocalEndpoint()

Aktifkan endpoint lokal.

Tersedia khusus untuk build debug. Lihat README atau panduan integrasi untuk detail selengkapnya tentang cara mengaktifkan titik akhir lokal.

Detail
Hasil
ErrorCode.InvalidMode jika digunakan dalam build non-debug.

FindFidelityParametersInApk

Result< TFidelity > FindFidelityParametersInApk(
  string filename
)

Memuat parameter fidelitas dari folder "assets/tuningfork/" APK.

Detail
Parameter
filename
nama file
Hasil
Parameter fidelitas, jika berhasil dimuat.

Flush

ErrorCode Flush()

Paksa upload histogram saat ini.

Detail
Hasil
ErrorCode.Ok jika upload dapat dimulai.
ErrorCode.PreviousUploadPending jika ada upload sebelumnya yang memblokirnya.
ErrorCode.UploadTooFrequent jika telah berlalu kurang dari satu menit sejak upload sebelumnya.

FrameTick

ErrorCode FrameTick(
  InstrumentationKeys key
)

Rekam titik skala frame yang akan dikaitkan dengan kunci instrumentasi dan anotasi saat ini.

Untuk mode lanjutan dan mode default, FrameTick dipanggil secara otomatis.

Detail
Parameter
key
Kunci instrumen.
Hasil
ErrorCode.InvalidInstrumentKey jika kunci instrumen tidak valid. ErrorCode.Ok saat berhasil.

GetFidelityParameters

Result< TFidelity > GetFidelityParameters(
  TFidelity defaultFidelity,
  uint initialTimeoutMs
)

Panggilan pemblokiran untuk mendapatkan parameter fidelitas dari server.

Anda tidak perlu memanggil ini jika meneruskan fidelity_params_callback sebagai bagian dari setelan ke TuningFork_init. Perhatikan bahwa setelah parameter fidelitas didownload, informasi pengaturan waktu direkam sebagai terkait dengan parameter tersebut. Jika memanggil GetFidelityParameters dan sekumpulan parameter baru telah didownload, setiap data yang telah dikumpulkan akan dikirimkan ke backend. Permintaan parameter dikirim ke: url_base + 'applications/' + package_name + '/apks/' + version_number + ':generateTuningParameters'

Detail
Parameter
defaultFidelity
Ini akan diasumsikan saat ini jika tidak ada parameter yang dapat didownload
initialTimeoutMs
untuk menunggu sebelum kembali dari panggilan ini saat tidak ada koneksi yang dapat dilakukan
Hasil
ErrorCode.Timeout jika ada waktu tunggu sebelum parameter dapat didownload. ErrorCode.Ok saat berhasil.

SetCurrentAnnotation

ErrorCode SetCurrentAnnotation(
  TAnnotation annotation
)

Setel anotasi saat ini.

Gunakan hanya untuk anotasi khusus.

Detail
Parameter
annotation
anotasi saat ini.
Hasil
ErrorCode.TuningforkNotInitialized jika plugin tidak diinisialisasi. ErrorCode.InvalidMode jika menggunakan dengan mode anotasi default. ErrorCode.InvalidAnnotation jika anotasi tidak konsisten dengan setelan atau nilai yang disetel tidak valid. ErrorCode.Ok saat berhasil.

SetFidelityParameters

ErrorCode SetFidelityParameters(
  TFidelity fidelityParams
)

Menyetel parameter fidelitas yang saat ini aktif.

Fungsi ini mengganti parameter apa pun yang telah didownload jika dalam mode eksperimen. Gunakan parameter ini jika, misalnya, pemain telah mengubah setelan kualitas game secara manual. Tindakan ini akan menghapus (yaitu mengupload) data apa pun yang terkait dengan parameter sebelumnya.

Detail
Parameter
fidelityParams
Parameter fidelitas baru
Hasil
ErrorCode.Ok jika parameter dapat disetel. ErrorCode.InvalidFidelity jika pesan memiliki nilai yang tidak valid. ErrorCode.TuningforkNotInitialized jika plugin tidak diinisialisasi. ErrorCode.InvalidMode jika menggunakan dengan mode default.

SetLoadingState

ErrorCode SetLoadingState(
  MessageUtil.LoadingState state
)

Menyetel status pemuatan.

Gunakan khusus untuk anotasi default. Setel MessageUtil.LoadingState.Loading saat pemuatan dimulai.
Penting:

  • Jangan lupa untuk menyetel MessageUtil.LoadingState.NotLoading saat pemuatan selesai.
  • Informasi frame tidak akan direkam selama pemuatan.

Detail
Parameter
state
status pemuatan
Hasil
ErrorCode.TuningforkNotInitialized jika plugin tidak diinisialisasi. ErrorCode.InvalidMode jika digunakan dengan mode anotasi khusus. ErrorCode.Ok saat berhasil.

Mulai

ErrorCode Start()

Mulai AndroidPerformanceTuner.

Detail
Hasil
Kode yang ditampilkan oleh library Android Performance Tuner.

Stop

ErrorCode Stop()

Hentikan Android Performance Tuner.

Detail
Hasil
Kode yang ditampilkan oleh library Android Performance Tuner.

SwappyIsEnabled

bool SwappyIsEnabled()

Tampilkan jika swappy diaktifkan atau tidak.

Untuk mengaktifkan swappy di Editor, buka: Project Settings -> Player -> Resolution and Presentation dan aktifkan Optimized Frame Pacing. Sebaiknya aktifkan fitur swappy untuk mengarsipkan frekuensi gambar yang lebih baik.

Detail
Hasil
True jika swappy diaktifkan