REST Resource: vitals.slowrenderingrate

資源：SlowRenderingRateMetricSet

代表一組「緩慢算繪」指標的單例資源。

這組指標包含 SurfaceFlinger 擷取的低層級算繪資料。系統會根據應用程式擁有的任何 SurfaceFlinger 層所處理影格的呈現時間直方圖，評估工作階段。

緩慢工作階段是指工作階段中超過 25% 的影格未達到指標的目標影格速率 (20 或 30 FPS)。

注意：這組指標僅適用於遊戲。

支援的匯總期間：

  • DAILY：指標會以日曆日期間隔匯總。由於歷史限制，目前僅支援 America/Los_Angeles 時區。

支援的指標：

  • slowRenderingRate20Fps (google.type.Decimal)：匯總期間內，發生緩慢算繪問題的不重複使用者百分比。
  • slowRenderingRate20Fps7dUserWeighted (google.type.Decimal)：過去 7 天的slowRenderingRate20Fps累計平均值。每日值會根據當天不重複使用者人數加權計算。
  • slowRenderingRate20Fps28dUserWeighted (google.type.Decimal)：過去 28 天的slowRenderingRate20Fps累計平均值。每日值會根據當天不重複使用者人數加權計算。
  • slowRenderingRate30Fps (google.type.Decimal)：匯總期間內，發生緩慢算繪問題的不重複使用者百分比。
  • slowRenderingRate30Fps7dUserWeighted (google.type.Decimal)：過去 7 天的slowRenderingRate30Fps累計平均值。每日值會根據當天不重複使用者人數加權計算。
  • slowRenderingRate30Fps28dUserWeighted (google.type.Decimal)：過去 28 天的slowRenderingRate30Fps累計平均值。每日值會根據當天不重複使用者人數加權計算。
  • distinctUsers (google.type.Decimal)：彙整期間內不重複的使用者人數，用來做為 slowRenderingRate20Fps/slowRenderingRate30Fps 指標的正規化值。如果應用程式轉譯了任何影格，系統就會將使用者計入這項指標。請務必不要進一步匯總這項計數，否則可能會導致系統重複計算使用者。系統會根據值的大小，將值四捨五入至最接近的 10、100、1,000 或 1,000,000 倍數。

支援的尺寸：

  • apiLevel (string)：使用者裝置上執行的 Android API 級別，例如 26.
  • versionCode (int64)：使用者裝置上執行的應用程式版本。
  • deviceModel (string)：使用者裝置型號的專屬 ID。識別碼格式為「deviceBrand/device」，其中 deviceBrand 對應於 Build.BRAND，device 則對應於 Build.DEVICE，例如「google/coral」。
  • deviceBrand (string)：使用者裝置品牌的專屬 ID，例如 google。
  • deviceType (string)：使用者裝置的類型 (也稱為板型規格)，例如PHONE.
  • countryCode (string)：根據使用者 IP 位址判斷的裝置國家/地區，以 2 個字母的 ISO-3166 代碼表示 (例如美國為「US」)。
  • deviceRamBucket (int64)：裝置的 RAM (以 MB 為單位)，以儲存區的形式 (3 GB、4 GB 等)。
  • deviceSocMake (string)：裝置主要系統單晶片的製造商，例如 Samsung。參考資料
  • deviceSocModel (string)：裝置主要系統單晶片的型號，例如 「Exynos 2100」。參考資料
  • deviceCpuMake (string)：裝置 CPU 的製造商，例如 Qualcomm。
  • deviceCpuModel (string)：裝置 CPU 型號，例如 「Kryo 240」。
  • deviceGpuMake (string)：裝置 GPU 的製造商，例如 ARM。
  • deviceGpuModel (string)：裝置 GPU 的型號，例如 馬利。
  • deviceGpuVersion (string)：裝置 GPU 的版本，例如 T750。
  • deviceVulkanVersion (string)：裝置的 Vulkan 版本，例如 「4198400」。
  • deviceGlEsVersion (string)：裝置的 OpenGL ES 版本，例如 「196610」。
  • deviceScreenSize (string)：裝置的螢幕大小，例如 NORMAL、LARGE。
  • deviceScreenDpi (string)：裝置的螢幕密度，例如 mdpi、hdpi。

必要權限：如要存取這項資源，呼叫使用者必須具備應用程式的「查看應用程式資訊 (唯讀)」權限。

JSON 表示法 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
欄位
name

string

ID。資源名稱。

格式：apps/{app}/slowRenderingRateMetricSet
freshnessInfo

object (FreshnessInfo)

這項資源的資料更新間隔摘要。

方法

get

 說明指標集的屬性。

query

 查詢指標集中的指標。