本文介紹如何通過Unity Plugin將Unity平臺的移動端游戲App的崩潰數(shù)據(jù)、應(yīng)用數(shù)據(jù)接入到日志服務(wù)移動運維監(jiān)控中。移動運維監(jiān)控用于實時監(jiān)控游戲崩潰、ANR等問題，并且支持智能分析，幫助您低成本、高效率地發(fā)現(xiàn)App中的各類隱患。

前提條件

已創(chuàng)建移動運維監(jiān)控應(yīng)用。具體操作，請參見添加應(yīng)用。

步驟一：集成SDK

1. 下載最新版本Unity Plugin。

2. 雙擊.unitypackge文件，將Plugin相關(guān)文件導(dǎo)入到您的Unity工程中。

   .unitypackage文件中的目錄說明如下表所示。

   文件	說明
   Assets/Plugins/Unity4SLS	Unity插件腳本。
   Assets/Plugins/Unity4SLS/Android/libs	Android平臺依賴的SDK和NDK。
   Assets/Plugins/Unity4SLS/iOS/	iOS平臺依賴的framework和靜態(tài)庫。
   Assets/Scenes/	示例Scenes。實際集成時，可以刪除。
   Assets/Scripts/	示例Scripts。實際集成時，可以刪除。

步驟二：SDK初始化

選擇第一個或主場景（Scene），在任意腳本文件（建議選擇較早加載的腳本）中調(diào)用如下代碼進行初始化。

// 初始化憑證信息。
Credentials credentials = new Credentials();

#if UNITY_IPHONE || UNITY_IOS
credentials.instanceId = "移動運維監(jiān)控應(yīng)用（iOS）ID";
credentials.endpoint = "移動運維監(jiān)控應(yīng)用（iOS）所綁定的Project的訪問域名";
credentials.project = "移動運維監(jiān)控應(yīng)用（iOS）所綁定的Project";
#elif UNITY_ANDROID
credentials.instanceId = "移動運維監(jiān)控應(yīng)用（Android）ID";
credentials.endpoint = "移動運維監(jiān)控應(yīng)用（Android）所綁定的Project的訪問域名";
credentials.project = "移動運維監(jiān)控應(yīng)用（Android）所綁定的Project";
#endif

private void requestAccessKey() {
    // 推薦您先使用移動端日志直傳服務(wù)配置AccessKey信息。
    // ...

    // 獲取AccessKey信息后，完成更新。
    updateAccessKey(accessKeyId, accessKeySecret, new-securityToken);
}

// 更新AccessKey信息。
private void updateAccessKey(String accessKeyId, String accessKeySecret, String securityToken) {
    // 通過STS服務(wù)獲取的AccessKey包含securitToken，需要使用以下方式更新。
    Credentials credentials = new Credentials();
    credentials.accessKeyId = accessKeyID;
    credentials.accessKeySecret = accessKeySecret;
    credentials.securityToken = secretToken;

    Unity4SLS.SetCredentials(credentials);
}
// 初始化Unity Plugin。
Unity4SLS.Initialize(credentials);

API列表

常見問題

1. 如何通過STS方式獲取訪問憑證信息，并動態(tài)更新到SDK？

通過STS方式獲取訪問憑證信息，可以有效避免AccessKey固定寫在代碼中，從而避免造成數(shù)據(jù)泄露。具體操作，請參見采集-搭建移動端日志直傳服務(wù)。

通過STS方式獲取到訪問憑證信息后，還需要把該信息更新到SDK，建議通過如下方式。

// 調(diào)用憑證回調(diào)函數(shù)，該函數(shù)會在數(shù)據(jù)寫入、發(fā)送狀態(tài)發(fā)生變化時，憑證無效、過期時被回調(diào)。
// feature: 插件名稱，一般無需關(guān)注。
// result: 回調(diào)結(jié)果。
public void credentialsCallback(string feature, string result)
{
    // 開發(fā)階段，建議打印日志，便于排查問題。
    Debug.Log("[Unity4SLS] <DEBUG> - credentialsCallback. feature: " + feature + ", result: " +  result);

    if ("LOG_PRODUCER_SEND_UNAUTHORIZED" == result || 
        "LOG_PRODUCER_PARAMETERS_INVALID" == result) {
    	  // LOG_PRODUCER_PARAMETERS_INVALID: 初始化憑證信息不合法。
        // LOG_PRODUCER_SEND_UNAUTHORIZED: 訪問憑證過期或無效。

         // 當出現(xiàn)上面兩個錯誤碼時，建議通過STS重新獲取訪問憑證信息，并按照下面的方式進行更新。
         // 1. 通過STS獲取訪問憑證。
         // 2. 更新SDK的憑證信息。
        Credentials credentials = new Credentials();
        credentials.accessKeyId = accessKeyId;
        credentials.accessKeySecret = accessKeySecret;
        credentials.securityToken = securityToken;
        Unity4SLS.SetCredentials(credentials);
    }

}

// 調(diào)用下面方法注冊SDK的憑證回調(diào)接口。
public void setCredentialsCallback()
{
    callback_delegate callback = new callback_delegate(credentialsCallback);
    Unity4SLS.RegisterCredentialsCallback(callback);
}

2. 如何采集C#、Lua等腳本異常信息？

目前，日志服務(wù)SDK沒有內(nèi)置C#、Lua等腳本異常的自動采集，可參考其他產(chǎn)品的實現(xiàn)。采集到異常數(shù)據(jù)后，通過相關(guān)API進行上報，示例如下：

• 上報C#異常信息

  Unity4SLS.ReportCSharpError("C# message", "C# stacktrace");

• 上報Lua異常信息

  Unity4SLS.ReportLuaError("lua message", "lua stacktrace");

• 上報其他類型的異常信息

  Unity4SLS.ReportError("stacktrace");
  Unity4SLS.ReportError("custom type, 根據(jù)實際業(yè)務(wù)填寫", "stacktrace");
  Unity4SLS.ReportError("custom type, 根據(jù)實際業(yè)務(wù)填寫", "message", "stacktrace");

3. 如何上報業(yè)務(wù)自定義的日志信息？

SDK支持上報業(yè)務(wù)定義日志信息，包含業(yè)務(wù)數(shù)據(jù)、日志信息等，示例如下：

Unity4SLS.ReportCustomLog("custom type, 根據(jù)實際業(yè)務(wù)填寫", "custom log 1");