Regions

Photon Cloud 通過在多個地區託管服務器，在全球範圍內提供低延遲遊戲體驗。

客戶端從我們的 Photon 名稱服務器獲取區域列表。在項目的生命周期內，可能會添加新區域，也可能會放棄和移除舊區域。

每個區域都是完全獨立的，由主服務器（用於匹配）和遊戲服務器（託管房間）組成。

以下是客戶端工作流程的概述：

(1) 客戶端從 Photon 名稱服務器檢索可用區域列表。

(2) 客戶端選擇一個可用區域 —— 要麼根據最低延遲自動選擇，要麼通過手動選擇 —— 然後連接到該區域的主服務器。主服務器負責匹配以及在該區域內的遊戲服務器上創建或加入房間。

(3) 最後，客戶端連接到指定的遊戲服務器以加入房間。該遊戲服務器與步驟 (2) 中客戶端連接的主服務器位於同一區域。

通過區域允許列表，您可以為每個 AppId 定義哪些哪些區域可用（見下文）。

可用區域

Photon Cloud 由分佈在全球多個託管中心的服務器組成。

每個 Photon Cloud 區域都由一個 “區域代碼” 標識，這是一個不區分大小寫的短字符串。
例如，“EU” 或 “eu” 都會被接受，並且指代同一個歐洲區域。

以下列表標明了每個區域的託管中心位置和區域代碼。

遊戲用 Photon Cloud

Photon 產品 Quantum、Fusion、Voice、Realtime 和 PUN 在 遊戲用 Photon Cloud 的以下區域可用。

Photon Chat 在以下區域可用：

Photon Industries Premium Cloud

Photon 產品 Quantum、Fusion、Voice、Realtime 和 PUN 在 Photon Industries Premium Cloud 的以下區域可用。

Photon Chat 在以下區域可用：

遊戲 / 行業用中國區域

使用 Photon Cloud 中國大陸區域有特殊條件：

• 必須解鎖訪問權限（見下文）
• Photon Voice 在中國不可用
• 開發用 20CCU 免費（非商業用途）
• Photon Cloud 上僅提供 500CCU 訂閱
• 大規模設置需要自定義協議

Photon 產品 Quantum、Fusion、Realtime、PUN 和 Chat 在 Photon Cloud 的以下區域可用：

區域允許列表

區域允許列表使您能夠直接從儀表板為每個應用程序自定義可用區域。使用最佳區域功能的客戶端將自動適應。

通過使用更多或更少的區域，您可以平衡服務質量（當有靠近玩家的區域時，往返時間會更好）與匹配體驗（更少的區域意味著每個區域有更多的玩家）。

要為每個應用程序定義區域，打開儀表板，單擊所選應用程序的 “管理”，然後單擊 “編輯允許列表”。
您會發現一個輸入字段，用於輸入允許的區域列表，如下所示：

• 每個 SDK 的可用區域在上面列出，有時針對行業圈單獨列出。
• 允許列表必須是由分號分隔的區域代碼字符串。例如，“eu;us”。
• 區域代碼不區分大小寫。
• 未定義或無法識別的區域代碼將從列表中忽略。
• 空字符串（""）或格式錯誤的字符串（例如 “;;;”）意味著所有可用區域都被允許。

更改（確認並保存）後的 10 分鐘內，名稱服務器將把過濾後的列表發送給連接的客戶端。
為避免客戶端出現衝突，請通過延遲連接到 “最佳區域”，或者確保選擇從區域列表中收到的區域。

如何選擇區域

美國的用戶如果連接到 Photon Cloud 的美國區域，延遲最低。這很簡單。

但是如果您的用戶來自 世界各地 呢？

選項有...

• a) 讓遊戲客戶端對不同的 Photon Cloud 區域進行延遲測試，然後預選延遲最低的那個，閱讀我們的方法。
• b) 分發與特定區域綁定的客戶端構建版本，以便不同地區的用戶連接到不同的 Photon Cloud 區域，或者
• c) 讓用戶從遊戲的 UI 中選擇合適的區域。
• d) 如果更高的延遲對您的遊戲體驗來說是可接受的，讓所有用戶連接到同一個區域。

所有 Photon Cloud 應用程序在所有可用區域都能運行，無需額外收費。

查看定價。

Photon Cloud 的儀表板允許您監控遊戲在每個區域的使用情況，並輕鬆升級或降級您的訂閱計劃。

前往您的儀表板。

C# Realtime API

Photon Realtime（大多數 Photon SDK 都會使用）可以檢測連接的最佳區域，並使您能夠堅持使用該區域。

為此，客戶端在連接時總是從名稱服務器獲取可用區域列表。
服務器的響應用於設置LoadBalancingClient.RegionHandler，該處理程序也通過IConnectionCallbacks中定義的回調OnRegionListReceived(RegionHandler regionHandler)提供。

通常，下一步是調用regionHandler.PingMinimumOfRegions()來檢測每個區域的當前延遲。您需要傳入一個完成時調用的方法，最好還能傳入上一次運行的 “最佳區域摘要”（如下所述）。

測試服務器延遲後，（新的）結果會匯總在regionHandler.SummaryToCache中，該摘要應保存到設備上供以後使用。

如果沒有上一個會話的SummaryToCache，將會對所有區域進行延遲測試，這需要更長的時間。
如果有上一個結果可用，客戶端將檢查：

a. 區域列表是否已更改（包括 “上一個最佳區域” 是否仍然可用的情況）
b. 延遲是否不再可接受（>= 比之前保存的參考值慢 1.5 倍）

如果任一情況適用，將對所有區域進行延遲測試，並選擇新的結果。

使用最佳區域與儀表板中的服務器端區域過濾器配合良好。
它使您能夠根據需要更改玩家可用的區域列表。

要訪問區域列表或覆蓋以前的結果，請參閱有關區域的 API 參考。

PUN

當您使用PhotonNetwork.ConnectUsingSettings()時，默認會進行 “最佳區域” 選擇。

除了自動將結果保存到玩家偏好設置中，其工作流程與即時 API 相同。

最佳區域是 “粘性的”。
這意味著客戶端通常會在較長時間內使用一個區域。
在隨後的啟動中，它會再次測試該區域的延遲。
PUN 自動使用 Unity 的 PlayerPrefs 存儲最佳區域摘要。

為方便和調試，當前的 “最佳區域” 及其延遲在 Unity 編輯器的 PhotonServerSettings 中公開。
但是，這僅在 Unity 編輯器的播放模式下有效。
與 Unity 編輯器在同一台機器上運行的構建版本可能有不同的最佳區域。

最佳區域注意事項

「最佳區域」選項並非確定性的。
有時由於微小差異或完全相同的延遲計算，它可能會是「隨機」的。

理論上，可能會出現以下情況：

• 同一設備 對多個區域的延遲相同。即使是連接到同一網路的用戶端，最終也可能連接到不同的區域。
• 連接到同一網路的不同設備（或同一設備的不同重試） 對同一區域 的延遲值不同。

例如，對於「us」和「usw」，您可以使用區域允許列表來選擇您想要的區域，或者讓用戶端連接到特定區域。

若要進行除錯，請將日誌等級設定為「Info」，並清除「當前最佳區域」（在 PUN 中：PhotonNetwork.BestRegionSummaryInPreferences = null）。查看詳細資訊，或透過郵件傳送日誌給我們。

Development Region

Starting from PUN v2.17, we added a new feature called "Dev Region".
It's a new setting available in PhotonServerSettings.
With this setting, all development builds will use the same region, avoiding initial matchmaking problems with the "Best Region" selection.
"Development build" is enabled automatically when the PhotonServerSettings gets created and the "Dev Region" is set during the first run (PlayMode) in Unity Editor.

The "Dev Region" is only used in Unity Editor and in "Development" builds, when you use PhotonNetwork.ConnectUsingSettings() to connect.
You can also disable the "Dev Region" in Unity Editor and "Development Build" by simply deleting the value.

So to avoid Best Region selection issues during the development phase, make sure to update to the latest PUN 2 version.
Run once in Unity Editor (enter PlayMode and connect).
You can do so from any of the demo scenes.
This first connection from Unity Editor will set the "Dev Region" which can be seen from the PhotonServerSettings inspector.
Once this is done, you can build and test from devices or do new build if you already did before.
You will notice that "Development Build" is enabled now from Build Settings and should remain this way during the development period.
This way, all clients (Unity Editor and builds) will connect to the same "Dev Region".

Before going into production, do not forget to disable development build.

Note: if a client is connected from a development build or from Unity Editor and the other is connected from a non-development build, they could be connected to two different regions.

使用中國大陸區域

Photon 名稱服務器必須位於中國本地，否則防火牆可能會阻止流量。
中國的 Photon 名稱服務器是 “ns.photonengine.cn”。

從中國大陸以外的客戶端進行連接很可能不會產生良好的結果。
此外，從 Photon 服務器連接到中國大陸以外的服務器（例如，用於自定義身份驗證、WebHooks、WebRPCs）可能不可靠。

出於法律原因，您需要為中國單獨構建版本，我們建議與其一起使用單獨的 AppId。
例如，使用編譯條件（您選擇的）根據構建版本更改 AppId 和 Photon 名稱服務器。

按照與您的客戶端 SDK 相對應的說明，為中國市場製作特殊的構建版本。

PUN 2

Using PhotonServerSettings

Using Code

C#

void ConnectToChina()
{
    AppSettings chinaSettings = new AppSettings();
    chinaSettings.UseNameServer = true;
    chinaSettings.ServerAddress = "ns.photonengine.cn";
    chinaSettings.AppIdRealtime = "ChinaPUNAppId"; // TODO: replace with your own PUN AppId unlocked for China region
    chinaSettings.AppVersion = "ChinaAppVersion"; // optional
    PhotonNetwork.ConnectUsingSettings(chinaSettings);
}