Android Performance Tuner 總覽 (原生)

本主題說明如何整合 Android Performance Tuner (又稱為 Tuning Fork 程式庫),以記錄及上傳原生 (C 和 C++) 遊戲引擎的影格時間資料。

如需 Unity 遊戲引擎,請參閱 Unity 指南

背景

遊戲體驗的其中一個關鍵是呈現效能。呈現效能是下列兩個輸入的結果:

  • 影格速率:影格的繪製頻率。
  • 圖形品質設定:影格呈現的保真度,包括模擬畫面保真度和圖形。

遊戲的良好呈現效能定義如下:

  • 提供穩定且一致的影格速率 (即以所需頻率呈現影格百分比)。
  • 盡可能以最高頻率呈現影格,同時維持穩定性。通常是 30 或 60 FPS,視遊戲類型而定。
  • 在指定使用者的螢幕大小和 同時達到所需的穩定影格速率

Android Frame Pacing 程式庫會限制影格時間的大部分變化,為遊戲提供穩定影格速率。影格時間的剩餘變化是由於遊戲過程中特定情境顯示的細節等級,以及裝置的圖形功能所致。使用 Android Performance Tuner 時,您可以在遊戲過程中找出影格時間比目標慢或快的時間點,瞭解這些問題和下列可改善項目的關聯:

  • 特定畫質設定
  • 遊戲中的特定情境
  • 特定裝置型號或裝置規格

記錄及上傳資料

Tuning Fork 程式庫依賴的是它的一個刻點函式,在每個影格中由 Android Frame Pacing 程式庫呼叫。在程式庫中,此刻點資訊會彙整為直方圖,然後定期透過 HTTP 端點上傳至 Google Play。每個刻點都會記錄為與檢測金鑰註解相關聯,也就是您在通訊協定緩衝檔中指定的定義。

檢測金鑰

檢測金鑰代表刻點在影格中的位置,是傳遞給每個刻點函式呼叫的整數。Android Frame Pacing 程式庫使用一組在 swappy_common.h 中定義的預定義檢測金鑰。如果您不使用 Frame Pacing 程式庫,也可以定義自己的檢測金鑰。

註解

註解可提供您遊戲當下發生情況的情境資訊。舉例來說,註解可標示下列任一項目:

  • 目前的遊戲等級
  • 螢幕上顯示「大老闆」
  • 任何其他相關遊戲狀態資訊

註解是由 com.google.tuningfork.Annotation 通訊協定緩衝區訊息定義。如要設定目前的註解,您可以傳送您定義至 TuningFork_setCurrentAnnotation() 的訊息序列化。除非您設定了其他註解,否則所有後續的刻點資料都會與這項註解建立關聯。以下是註解的 Proto 定義範例:

import "tuningfork.proto"
enum Level {
  INVALID_LEVEL = 0;
  Level_1 = 1;
  Level_2 = 2;
  Level_3 = 3;
}
message Annotation {
  optional Level level = 1;
}

擬真度參數

擬真度參數會影響遊戲的效能和圖形擬真度,例如網格細緻度、紋理解析度和鋸齒消除方法。與註解一樣,擬真度參數也是使用 com.google.tuningfork.FidelityParams 通訊協定緩衝區訊息來定義。以下是擬真度參數的 Proto 定義範例:

import "tuningfork.proto"
message FidelityParams {
  int32 texture_quality_level = 1;
  int32 shadow_resolution = 2;
  float terrain_details_percent = 3;
  int32 post_processing_effects_level = 4;
}

在 Tuning Fork 初始化時,您可傳遞遊戲使用的參數序列化。例如,就算使用者變更遊戲呈現設定,且後續的上傳資料與新參數相關聯,您也可以變更這些參數。

為了讓 Google Play 瞭解您定義的註解和擬真度參數,含有這些定義的通訊協定緩衝區檔案必須隨附在遊戲 APK 中,並提供初始化設定。此外,您也必須為 APK 中的常見擬真度參數組合提供預設值,才能在 Google Play UI 中依據這些預設值區隔資料。 詳情請參閱定義品質等級

記憶體與 CPU 負擔

為避免在遊戲過程中產生意外,系統會在初始化時分配 Tuning Fork 程式庫使用的所有記憶體。資料大小取決於檢測金鑰的數量、可能的註解數量,以及每個直方圖中的值區數量;它是上述所有數量乘以每個值區的四個位元組的倍數。此外,所有直方圖都有兩個副本,方便以雙緩衝方式提交。

提交內容是在獨立執行緒上,不會阻斷滴答呼叫。如果沒有可用的上傳連線,系統會將提交內容排入佇列,以便稍後上傳。

呼叫刻點函式幾乎不會產生處理負擔,只會將索引計算為直方圖值區陣列,並增加整數計數。

整合 Tuning Fork 程式庫

這份整合指南分為兩個部分。第一部分說明如何使用試用版應用程式和 Google Play 管理中心執行端對端測試。第二部分說明如何將 Tuning Fork 程式庫整合至工具鏈,以及如何使用程式庫提供的函式。點選下方的「下一步」連結即可開始。