掛機成果統計

本指南說明如何讓 FloatPilot.App 回報遊戲帳號的掛機成果，並在會員網站查看「即時摘要」與「每小時歷史」。

網站入口是我的遊戲帳號；App 的開關位於該遊戲帳號頁籤上方，名稱是「啟用網頁統計」。

重要：統計是依「遊戲登入帳號」綁定，不是依角色名稱綁定。App 實際登入的帳號，必須和網站新增的登入帳號完全相同。統計週期與查詢資料的原始時間都以 UTC 為準。

快速開始

先在網站新增遊戲帳號

1. 登入會員網站，開啟我的遊戲帳號。
2. 按「新增遊戲帳號」。
3. 輸入 App 會使用的遊戲登入帳號；不要填角色名稱。顯示名稱只是方便辨識的名稱。
4. 儲存後，確認列表中已經出現這個帳號。
5. App 必須使用相同的 LoginUsername 登入。拼字或帳號內容不同，都會被視為不同帳號。

遊戲登入帳號需要是 4～10 碼英數字，顯示名稱需要是 1～10 個字元。每個有效的遊戲登入帳號只能綁定一個會員；同一會員可以依目前方案的帳號配額新增多個遊戲帳號。若帳號已經被其他會員綁定，不能重複新增。

在 App 開啟網頁統計

1. 在 App 選到要統計的遊戲帳號頁籤。
2. 按帳號上方的「啟用網頁統計」。
3. 保持遊戲帳號連線，並等待角色完成載入。
4. 等待下一個 UTC 整點回報。
5. 回到網站的「我的遊戲帳號」，使用「即時摘要」查看最新回報，或切換到「每小時歷史」查詢各時段。

這個開關是每個遊戲帳號獨立設定，預設為關閉；設定會保存到該帳號的 INI。關閉統計不會停止授權 heartbeat，也不會因此把 App 登出；它只控制遊戲統計是否送到網站。

會統計什麼

網站分成兩種查看方式，資料用途不同。

即時摘要

即時摘要是一個遊戲帳號目前最後一次成功回報的狀態，包含：

「人物 HP/SP」與「出戰寵物 HP/SP」是最後一次成功回報的快照，不是每秒即時讀取。若 App 尚未成功回報，網站不會用 0 假裝成有資料。

每小時歷史

每小時歷史是一個統計期間的差異資料，包含：

• 戰鬥次數、殺敵數、死亡數。
• 斷線次數與重連次數。
• 人物本期間的淨經驗增加量。
• 回報當下的人物等級與人物經驗進度。
• 回報當下的出戰寵物等級、出戰寵物經驗進度與出戰寵物 HP/SP。
• 出戰寵物經驗明細，以及各戰利品物品的數量明細。

人物與寵物的經驗增加量是淨增加量；如果遊戲中的死亡扣除了經驗，扣除會反映在淨結果中。每小時歷史中的「人物經驗進度」與「出戰寵物經驗進度」同樣是「當前等級經驗／到下個等級還需要的經驗」。

多久統計與統計時間

App 的回報頻率

App 不是每分鐘上傳一次，而是每個 UTC 整點執行一次統計回報，例如 11:00 UTC、12:00 UTC。回報的統計期間通常是前一個完整的 UTC 小時，格式是 [起始時間, 結束時間)；第一次回報可能從啟用或建立基準的時間開始，因此可能是未滿一小時的期間。

剛打開開關不會立刻產生一筆資料。App 會先建立統計基準，等到下一個符合條件的 UTC 整點再回報；因此開啟後至少要等到下一個整點，才有機會在網站看到資料。

重新連線、切換角色或重新啟用統計，可能會開始新的統計 session。停用期間不會在重新啟用後補送，也不會把停用期間的戰鬥或經驗倒算回來。

網站的時間欄位

網站每小時歷史的查詢欄位標示為「UTC 起始」與「UTC 結束」，查詢範圍最多七天，結束時間不能晚於現在。結果欄位可能依會員設定的時區顯示，欄位旁會標示目前使用的時區偏移；但資料切割本身仍是 UTC 整點。

例如一筆資料的統計期間是 10:00 UTC～11:00 UTC，它會在 11:00 UTC 的回報中送出，而不是在 10:00 一開始就先產生。

什麼情況會統計

下列條件都符合時，App 才會建立並送出該小時的統計：

1. 網站已在我的遊戲帳號新增這個遊戲登入帳號。
2. 這個帳號屬於目前登入的同一會員，且 App LoginUsername 完全相同。
3. App 該帳號的「啟用網頁統計」已開啟。
4. 遊戲帳號目前已連線，且角色已完成載入。
5. 已到達可回報的 UTC 整點。
6. 網站授權 session、簽章、授權方案與回報內容都通過驗證。

什麼情況不會統計

以下任一情況，都可能造成網站查無資料、資料停留在舊時間，或每小時歷史沒有該時段：

• 尚未在網站新增帳號，或帳號綁在另一個會員名下。
• 網站新增的登入帳號和 App 實際登入的帳號不同；角色名稱相同也不能取代登入帳號比對。
• App 統計開關仍是關閉狀態；開關缺少設定時預設也是關閉。
• 遊戲未連線、角色尚未載入，或在整點回報前就斷線。
• 只開啟開關但還沒等到下一個 UTC 整點。
• 授權已過期、統計 session 或簽章驗證失敗。
• 回報送出時網路或網站發生錯誤。該統計期間會被視為已嘗試回報，不會在下一分鐘或重新連線時自動補送。
• 查詢的日期超過最近七天，或輸入的起訖時間不是有效的 UTC 範圍。

統計開關只控制網頁統計，不等於授權 heartbeat。即使授權 heartbeat 仍正常，若統計開關關閉，網站也不會收到這個帳號的統計資料。

怎樣在網站查詢

1. 開啟我的遊戲帳號。
2. 先用「即時摘要」確認帳號是否已有最後一次成功回報。
3. 要看各小時成果時，將「資料類型」改成「每小時歷史」。
4. 輸入「UTC 起始」與「UTC 結束」，範圍不可超過七天。
5. 按「查詢」；每小時歷史的「查看明細」可以看到寵物經驗與戰利品明細。

如果畫面顯示「查無資料」，建議依序確認：網站帳號是否新增成功、會員是否正確、LoginUsername 是否完全相同、App 開關是否開啟、角色是否已載入，以及是否已跨過下一個 UTC 整點。

資料保留與清理

每小時歷史目前保留七天。網站的維護服務會依排程每天執行一次清理；目前設定為伺服器當地時間 03:30。清理時會刪除統計期間結束時間早於「目前 UTC 時間往前七天」的歷史資料，並先清理寵物與戰利品明細，再清理每小時統計主資料。

因此，資料剛超過七天時，可能要等下一次每日清理排程後才會從每小時歷史中消失。即時摘要與帳號累計欄位是目前狀態投影，不等同於七天的每小時歷史，不要用歷史保留天數推論即時摘要的清理時間。

常見問題

為什麼明明在線，網站卻顯示離線？

網站的在線狀態來自最後一次成功接受的統計回報，不是直接讀取 App 的授權 heartbeat。若剛上線、尚未跨過 UTC 整點、帳號名稱不一致，或上一筆回報失敗，網站可能仍顯示舊的離線狀態。先確認帳號綁定與統計開關，再等待下一個 UTC 整點。

為什麼每小時歷史沒有資料？

最常見原因是還沒到下一個 UTC 整點、角色未完成載入、網站綁定到不同會員，或查詢時間超過七天。若該次 POST 失敗，這個期間不會自動重試。

重新打開統計後，為什麼停用期間沒有補回來？

這是預期行為。重新啟用時會建立新的統計基準，避免把停用期間的資料補送到網站。

為什麼人物經驗不是總經驗？

網站的經驗進度欄位刻意顯示目前等級內的進度，格式是「當前等級的經驗值／到下個等級還需要的經驗」。人物本期間增加量與帳號累計增加量則是另外的統計欄位。

最後檢查清單

• 已在我的遊戲帳號新增遊戲登入帳號。
• App LoginUsername 與網站登入帳號完全相同。
• 帳號綁定在目前登入的會員，且沒有被其他會員占用。
• App 該帳號已開啟「啟用網頁統計」。
• 遊戲已連線，角色已完成載入。
• 已等待下一個 UTC 整點。
• 查詢每小時歷史時使用 UTC 起訖時間，且範圍不超過七天。
• 已了解每小時歷史只保留七天，停用期間不會補送。