攝影機與實體追蹤
本頁面記錄了 速度計 (Speedometer) 在攝影機視角或玩家狀態改變時如何安全解析目標實體。
📊 實體追蹤資訊框
| 視角上下文 | 計算評估目標 | 速度資料來源 |
|---|---|---|
| 一般第一/第三人稱 | 玩家實體 (client.player) | entity.getKnownSpeed() |
| 旁觀模式（自由飛行） | 旁觀相機實體 | entity.getKnownSpeed() |
| 旁觀模式（騎乘/附身生物） | 目標生物/玩家 | entity.getKnownSpeed() |
| 騎乘船/馬/礦車 | 載具實體 | entity.getKnownSpeed() |
| 實體空指標安全 | 回退零值字串 | Speed: 0.00 b/s (H: 0.00, V: 0.00) |
🔄 實體解析邏輯
java
Entity entity = client.getCameraEntity();
if (entity == null) {
entity = client.player;
}
if (entity == null) {
displayer.addLine("Speed: 0.00 b/s (H: 0.00, V: 0.00)");
return;
}client.getCameraEntity()：檢查目前作用中渲染視角的主查找。entity == null回退：若相機實體傳回 null，程式碼回退至client.player。- 空指標安全防護：若相機實體與玩家皆為空，Speedometer 安全輸出零速度而不引發當機。