Overview
概述
自訂外掛程式 SDK 讓開發者能夠創建一個自訂的 Quantum 伺服器，在本機測試並上傳至 Photon 企業雲端。
創建 Photon 企業雲端會產生額外費用。如需更多資訊及外掛程式 SDK 的下載權限，請聯繫我們。
自訂 Quantum 外掛程式的常見功能包括：
- 在 Photon 伺服器雲端上運行模擬，以獲得可信的遊戲結果
- 向延遲加入或重新連接的客戶端發送伺服器快照
本機 Photon 伺服器僅支援在 Windows 上啟動。
下載
| 版本 | 發布日期 | 下載 | |
|---|---|---|---|
| 3.0.3 | 2025年4月28日 | Quantum Plugin SDK 3.0.3 版本 55 | 版本資訊 |
| 3.0.2 | 2025年3月4日 | Quantum Plugin SDK 3.0.2 版本 52 | 版本資訊 |
| 3.0.1 | 2024年12月13日 | Quantum Plugin SDK 3.0.1 版本 49 | 版本資訊 |
| 3.0.0 | 2024年12月9日 | Quantum Plugin SDK 3.0.0 版本 44 | 版本資訊 |
更新日誌
3.0.3
版本 55 (2025年4月28日)
- 新增了一個 Powershell 指令碼用於升級外掛程式 SDK
- 新增
WebHookBaseUrlAllowList儀表板和RoomProperties.WebHookBaseUrl，以支援用戶使用伺服器上的鍵值允許列表選擇 Webhook URL - 新增自訂 Webhook 超時參數和可自訂的預設 Webhook 超時時間，使用儀表板鍵
WebHookDefaultTimeout（單位：毫秒） - 將本機 Photon 伺服器升級至版本
6.0.14.33515
3.0.2
版本 50 (2025年3月3日)
- 客戶端引起的輸入反序列化錯誤現在會被忽略，設定
ClientInputExceptionTolerance（預設為 2）以定義在斷開客戶端連接前忽略的錯誤數量 - 在雲端運行的自訂外掛程式現在使用更高效的原生記憶體分配器
- 將排程的外掛程式纖維計時器替換為增量計時器，從更新結束時開始，有助於提升伺服器穩定性
- 修復了一個問題，該問題導致在 Webhook 中選擇
-1（無限制）時無法正確設定MaxPlayerSlots - 大廳限制現在更寬鬆，最大數量從
3調整為20，最大字串長度從64調整為128，違規現在會導致遊戲創建失敗，而非靜默地移除屬性 - 新增了從
PlayerRef到客戶端物件的映射，使用DeterministicServer.GetClientForPlayer(PlayerRef)
3.0.1
版本 49 (2024年12月13日)
- 修復了一個問題，該問題可能導致外掛程式在替換斷開連接的客戶端時缺少斷開信號
- 修復了一個問題，該問題會導致快速重新連接的客戶端在遊戲階段開始前被斷開
- 從
Create和JoinWebhook 中移除ActorNr屬性，因為此時 ID 尚未知曉
版本 39 (2024年12月2日)
- 為所有與玩家相關的 Webhook 新增了
ActorNr和AuthCookie屬性 - 在
CreateGameResponseWebhook 中新增了UserData - 在
LeaveGameRequestWebhook 中新增了IsInactive - 在
DeterministicServer類別中新增了DeterministicPluginClient物件的Getter - 在 CreateGame Webhook 回應中新增了
RunServerSimulation標誌，以控制特定遊戲的伺服器模擬運行 - 新增了一個示範專案，展示如何攔截和重寫命令
- 更改了伺服器模擬包裝器
DotNetSessionRunner，並將職責移至另一個由DotNetSessionContext實現的介面，該介面負責讓資源管理器或命令序列化，可供不運行模擬的自訂外掛程式使用 - 將
DeterministicServer.ServerSimulation更名為SessionRunner - 棄用了
DeterministicServer.ClientCount屬性 - 修復了一個問題，該問題導致在使用 RoomTTL 的單一客戶端線上遊戲重新連接後停滯
- 修復了一個與伺服器快照相關的問題，該問題會導致斷開連接並顯示
Error #13: Snapshot request failed to start
3.0.0
版本 44 (2024年12月9日)
- 修復了一個問題，該問題可能導致外掛程式在替換斷開連接的客戶端時缺少斷開信號
版本 38 (2024年10月16日)
- 修復了一個問題，該問題導致伺服器命令翻轉斷開連接玩家的玩家連接標誌，從而產生不需要的 PlayerConnected 信號
版本 37 (2024年10月1日)
- 修復了一個問題，該問題導致 GZip 壓縮的重播塊比必要的大小更大
版本 28 (2024年7月16日)
- 修復了一個缺少依賴項的問題
版本 26 (2024年6月19日)
- 移除了啟動 Windows 性能計數器，將被新功能替代
版本 24 (2024年6月11日)
- 新增了
DeterministicServer.OnDeterministicSessionCanStart回調，以在外掛程式上延遲遊戲階段啟動
版本 21 (2024年6月4日)
- 初始版本