其他 Xamarin Api

調整記錄層級

您可以在主控台中控制從 App Center 顯示的記錄訊息數量。 使用 LogLevel -API 可在進行調試時啟用額外的記錄功能。 根據預設,它會設定為 App Store 環境的,否則會設為 ASSERT WARN

若要盡可能有最多的記錄訊息,請使用 LogLevel.Verbose

AppCenter.LogLevel = LogLevel.Verbose;

識別安裝

App Center SDK 會在安裝應用程式之後,為每個裝置建立一個 UUID。 更新應用程式時,裝置的這個識別碼會保持不變,而且只有在重新安裝應用程式時才會產生新的識別碼。 下列 API 適用于偵錯工具用途。

System.Guid? installId = await AppCenter.GetInstallIdAsync();

注意

在 Android 上,這個方法只能在啟動之後使用 AppCenter ,它一律會 null 在開始之前傳回。

識別使用者

App Center SDK 支援設定用來增強損毀報告的 使用者識別碼 。 若要使用這項功能:

  1. AppCenter.Start(...)APP Center sdk 快速入門手冊中所述,呼叫以設定 App center sdk。
  2. userID使用下列程式碼在 SDK 中設定:
AppCenter.SetUserId("your-user-id");

設定使用者識別碼之後,您可以使用 App Center 的搜尋功能來搜尋識別碼的特定損毀報表。 深入瞭解 App Center 的 搜尋檔

注意

使用者識別碼的值限制為256個字元。 它會與您的損毀報告一起顯示,但不會用於匯總或受影響之使用者的計數。 如果您設定使用者識別碼多次,則只會使用最後一個使用者識別碼。 您必須在每個應用程式啟動前自行設定使用者識別碼,因為此值不是由 SDK 在啟動之間儲存的。

在執行時間停用所有服務

如果您想要一次停用所有 App Center 服務,請使用 Enabled 屬性。 停用時,SDK 不會將任何資訊轉寄至 App Center。

AppCenter.SetEnabledAsync(false);

若要再次啟用所有服務,請使用相同的 API,但以 true 參數形式傳遞。

AppCenter.SetEnabledAsync(true);

您不需要等候此呼叫來進行其他 API 呼叫, (例如 IsEnabledAsync) 一致。

狀態會保存在應用程式啟動之間的裝置儲存區中。

注意

只有在啟動之後,才必須使用這個方法 AppCenter

不允許網路要求

在 App Center SDK 中,預設允許網路要求。 如果您想要傳送由使用者考慮的 App Center SDK 所收集的資料,您可以不允許自動傳送資料。

AppCenter.IsNetworkRequestsAllowed = false;

在此情況下,App Center SDK 會繼續收集資料,但只會在允許網路要求時傳送。

AppCenter.IsNetworkRequestsAllowed = true;

注意

此值會在開始時保留。

您可以隨時檢查是否允許在 App Center SDK 中傳送資料。

AppCenter.IsNetworkRequestsAllowed;

注意

先前儲存在中的值 SharedPreferences 會被忽略,直到 AppCenter 在 Android 平臺上啟動為止。 它會傳回使用或所設定的最後一個值( AppCenter.IsNetworkRequestsAllowed = allowed true 如果值在 AppCenter 開始之前未變更)。

變更執行時間中的服務狀態

您可以使用下列程式碼,在執行時間啟用或停用服務:

Analytics.SetEnabledAsync(true);

注意

只有在啟動之後,才必須使用這個方法 Analytics

檢查是否已啟用 App Center

您也可以檢查是否已啟用 App Center。

bool enabled = await AppCenter.IsEnabledAsync();

注意

只有在啟動之後,才會使用這個方法 AppCenter ,在開始之前,它一定會傳回 false

在執行時間檢查 App Center SDK 版本

您可以取得目前正在使用的 App Center SDK 版本。

AppCenter.SdkVersion;

您可以藉由呼叫 API 來設定自訂屬性 SetCustomProperties() 。 自訂屬性的有效索引鍵應符合正則運算式模式 ^[a-zA-Z][a-zA-Z0-9]*$ 。 自訂屬性的值可以是下列其中一個 c # 類型: stringintlongdoublefloatdecimal boolDateTime

CustomProperties properties = new CustomProperties();
properties.Set("color", "blue").Set("score", 10).Set("now", DateTime.UtcNow);
AppCenter.SetCustomProperties(properties);

注意

如果您多次設定相同的自訂屬性,最後一個值將會覆寫先前的值。

您可以藉由呼叫 API 來移除任何自訂屬性 Clear() 。 這只會移除裝置的屬性值。 它不會從 App Center 入口網站移除屬性名稱。

CustomProperties properties = new CustomProperties();
properties.Clear("score");
AppCenter.SetCustomProperties(properties);