地区

Photon Cloud光子云为您提供全球连接，让全球各地的低延迟游戏成为可能。

可用区域

Photon Cloud光子云在多个地区都有服务器，分布在全球多个托管中心。

每个Photon Cloud光子云区域由“区域标记”标识。

可用区域和令牌清单：

地区	托管在	令牌
亚洲	新加坡	asia
澳大利亚	墨尔本	au
加拿大，东部	蒙特利尔	cae
中国大陆（ 请见本文末）	上海BGP	cn
欧洲	阿姆斯特丹	eu
印度	钦奈	in
日本	东京	jp
南美洲	圣保罗	sa
韩国	汉城	kr
美国，东部	华盛顿	us
美国，西部	圣荷西	usw

仪表板区域过滤

您可以直接从仪表板过滤每个应用程序的可用Photon Cloud光子云区域列表。

转到仪表板，然后单击所选应用程序的“管理”，然后单击“编辑”。 您将找到一个输入字段，您可以在其中输入列入白名单的区域，如下所示：

• 允许的列表应该是用分号分隔的区域标记字符串。 例如“eu; us”。
• 区域令牌不区分大小写，并在此定义。
• 未定义或无法识别的区域令牌将从列表中忽略。
• 空（“”）或格式不正确的字符串（例如“;;”）表示空列表。
• 空列表表示允许所有可用区域。

确认并保存后， GetRegions操作将只返回过滤的区域列表。 因此，客户端应该从该列表中选择任何可用的区域，但请考虑到仪表盘的更新可能需要10分钟左右的时间（根据网络情况而定）。

使用中国大陆地区

首先，您需要申请访问中国大陆地区的Photon应用程序。 向我们发送电子邮件，以便我们可以为您的AppID解锁它。

为了稳定和可靠的链接，光子NameServer架设在本地，否则连接很可能无法稳定。 中国的NameServer是“ns.photonengine.cn”。

与来自中国大陆以外的客户端通讯很可能不会产生好的结果。 此外，从光子服务器连接到中国大陆以外的服务器（例如，自定义身份验证，WebHooks，WebRPC）可能并不可靠。

重要提示 ：在目前阶段，您通过信息中心对应用进行的更改不会自动反映在中国的应用缓存中。 如果您有更新请求，请通过电子邮件通知我们。

同样出于法律原因，您需要为中国单独构建AppId，我们建议使用单独的AppId。 例如，使用条件编译（您选择的）来根据根据条件更改AppId和Photon NameServer。

按照这些说明为中国市场打造特别版本：

光子语音 Photon Voice

1. 将AppId设置为已解锁中国区域的应用程序。 如果你想使用相同的项目，并有不同的Build，可以这样设置：

void Awake()
{
// TODO: replace compile condition with your own
#if CHINA
    PhotonNetwork.PhotonServerSettings.VoiceAppID = "ChinaVoiceAppId"; // TODO: replace with your own AppId
#else
    PhotonNetwork.PhotonServerSettings.VoiceAppID = "nonChinaVoiceAppId"; // TODO: replace with your own AppId
#endif
}

2. 打开 “LoadBalancingClient.cs “文件，设置NameServerHost为 “ns.photonengine.cn”。

// TODO: replace compile condition with your own
    #if CHINA
        public const string NameServerHost = "ns.photonengine.cn";
    #else
        public const string NameServerHost = "ns.exitgames.com";
    #endif

由于光子语音中包含光子PUN，因此我们还需要遵循PUN所需的步骤。 光子语音将自动连接到相同的服务器。

PUN

1. 将AppId设置为已解锁中国区域的应用程序。 如果你想使用相同的项目，并有不同的Build，可以这样设置：

void Awake()
{
// TODO: replace compile condition with your own
#if CHINA
    PhotonNetwork.PhotonServerSettings.AppID = "ChinaPUNAppId"; // TODO: replace with your own AppId
#else
    PhotonNetwork.PhotonServerSettings.AppID = "nonChinaPUNAppId"; // TODO: replace with your own AppId
#endif
}

2. 打开“NetworkingPeer.cs”文件并将NameServerHost设置为“ns.photonengine.cn”：

// TODO: replace compile condition with your own
    #if CHINA
        public const string NameServerHost = "ns.photonengine.cn";
    #else
        public const string NameServerHost = "ns.exitgames.com";
    #endif

3. 更新CloudRegionCode和CloudRegionFlag枚举以添加新的“CN”（或“cn”）区域标记，如下所示：

public enum CloudRegionCode
{
    // ...
// TODO: replace compile condition with your own
#if CHINA
    ///<summary>Chinese Mainland, Guang Dong area, cn</summary>
    cn = 11,
#endif
};
[Flags]
public enum CloudRegionFlag
{
    // ...
// TODO: replace compile condition with your own
#if CHINA
    cn = 1 << 10,
#endif
};

4. 使用PhotonNetwork.ConnectToRegion(CloudRegionCode.cn, gameVersion)连接到中国大陆地区。

// TODO: replace compile condition with your own
#if CHINA
    PhotonNetwork.ConnectToRegion(CloudRegionCode.cn, gameVersion);
#else
    // TODO: connect to any other region
#endif

Photon Server是一个您自己运行和维护的本地服务器应用程序，您可以在您选择的机器（包括各类云服务器和虚拟机）上运行和托管。 所以其是您完全可定制的，且完整的用户认证机制能让你的自由配置和设置你自己的多人游戏服务器端。

Photon Cloud是在运行在Photon Server上的。

光子云(Photon Cloud)运行在光子服务器(Photon Server)上。
Photon Realtime，Photon Chat都是在光子云(Photon Cloud)中运行的应用程序。
Photon Unity Networking（又名PUN）是Unity 3D客户端插件，与Unity Networking兼容的API，连接Photon Realtime。

光子服务器PhotonServer v5

光子服务器PhotonServer v4

自V4.0.29.11263起的重要更改

Photon Cloud会不断更新，包括修补程序，增强功能或新功能。尽管我们尝试发布Photon Server SDK的新版本以赶上Photon Cloud，但两者无法始终保持同步。

在这里，我们列出了自Photon Server SDK的最新公共版本v4.0.29.11263以来Photon Cloud中的重要更改。此外，如果您同时定位在Photon Cloud和Photon Server环境同时开发，或者准备从一个环境切换到另一个环境，此列表将列出一些功能之不同，其在另外的环境中无法正常运行。同时，您可能还会找到响应的解决方法或建议。

V4.0.29.11263中缺少的光子云功能

• 创建房间后，便无法更改PlayerTTL和EmptyRoomTTL。它们后来被添加为众所周知的房间属性。
• “Delete Null Properties”选项不可用. (RoomOptions.DeleteNullProperties).具有空值的属性将不会被服务器删除。
• “Broadcast Properties Change”选项不可用（RoomOptions.BroadcastPropsChangeToAll）。除非使用CAS，否则调用SetProperties的客户端将不会收到PropertiesChange事件。CAS是可以在Photon Cloud和Photon Server之间具有一致的行为一种解决方案。
• SQL Lobby中的GetGameList操作（也称为“ GetCustomRoomList”或“ GetRoomList”，不要与GetGameList WebRPC或PUN Classic的GetRoomList混淆）不可用。

V4.0.29.11263中的已知问题

• 如果客户端或身份验证未设置，则服务器不会返回UserId。该值将是在服务器上生成的GUID。这可能导致玩家无法加入房间，并产生错误代码-2（错误消息：”Join failed: UserId is not set, checkUserIdOnJoin=true expects a UserId.”）。作为解决方法，如果用户未明确设置，客户端C＃SDK现在会将GUID发送为UserId。
• 另外，在身份验证期间，如果身份验证提供方未设置昵称，则服务器将返回空昵称，该昵称将覆盖客户端上以前设置的任意值。作为解决方法，您可以在连接后设置一个昵称。此值将在房间内使用，且以后可以更改（包括同步）。
• 服务器不支持序列化协议版本1.8。如果尝试从客户端SDK的相对较新版本（其默认为1.8）连接到自托管的Photon Server，则连接将失败。在C＃SDK中，客户端将与断开连接DisconnectByServerReasonUnknown。一种解决方案是在连接之前将版本设置为1.6。设置loadBalancingClient.LoadBalancingPeer.SerializationProtocolType到SerializationProtocol.GpBinaryV16。在PUN2中，它应该是PhotonNetwork.NetworkingClient.LoadBalancingPeer.SerializationProtocolType。除非您使用不同于PhotonNetwork.ConnectUsingSettings()的方法进行连接，否则在PUN2中不需要。
• 服务器允许将同一actor添加到同一interest group多次，从而导致同一事件被actor多次发送到同一interest gruop。
• 此服务器未完全支持快速重新加入功能（ReconnectAndRejoin），因为其未实现会话令牌。

Photon Cloud为您提供全球连接，以便在全球范围内实现低延迟游戏。

客户端的初始连接转到Photon Nameserver，它为客户端提供可用区域列表。 通常，客户端连接启用“最佳区域”选择，这将帮助客户端检测具有最低ping的区域并连接到它（见下文）。

每个区域与其他区域完全分开，由主服务器（用于配对）和游戏服务器（用于托管房间）组成。

可用区域的完整列表如下。 在仪表板中，您可以定义哪些区域应该可供客户端使用。

最佳区域的考虑

“最佳区域”选项不具有确定性。 有时它可能是“随机的”，因为有时候/某种情况下会得到几乎没有变化或完全相同的ping计算。

从理论上讲，你可以发现：

• 同一设备对您可选择的多个区域具有相同的完全ping值。所以您最终连接到同一个网络的客户端上设置了不同区域，造成区域选择会是随机的。
• 不同的设备连接到同一个区域，有不同的Ping值（或者同一个设备的多次不同尝试)。

例如，在“us”和“usw”（或“ru”和“rue”）的设置下，您可以使用在线区域白名单来选择您想要连接或者排除的区域。

可用区域

Photon Cloud在全球多个地区拥有服务器，并分布在世界各地有多个托管中心。

每个光子云区域由“区域令牌”标识。

要通过客户端的“Connect”方法传递”region token”区域令牌，请调用

loadBalancingClient.ConnectToRegionMaster(regionString);

可用区域和令牌清单：

控制面板区域过滤

您可以直接从您账户的控制面板（仪表盘）过滤每个应用程序可用的Photon Cloud区域列表。

转到仪表板，然后单击所选应用程序的“管理”，然后单击“编辑”。 您将找到一个输入字段，您可以在其中输入列入白名单的区域，如下所示：

• 允许的列表应该是用分号分隔的区域标记字符串。 例如“eu; us”。
• 区域令牌不区分大小写，并在此定义。
• 未定义或无法识别的区域令牌将从列表中忽略。
• 空（“”）或格式不正确的字符串（例如“;;”）表示空列表。
• 空列表表示允许所有可用区域。

确认并保存后， GetRegions操作将只返回过滤的区域列表。 因此，客户端应该从该列表中选择任何可用的区域，但请考虑到仪表盘的更新可能需要10分钟左右的时间（根据网络情况而定）。

如何选择一个地区

如果连接到Photon Cloud CN地区，国内区域用户的延迟最低，非常简单的逻辑。

但是如果你有来自世界各地的用户呢？

您可以

• a）让游戏客户端ping不同的Photon Cloud区域，并预先选择最好的ping，阅读我们在文章下方提供的操作方法
• b）使用固定了区域的客户端版本，因此来自不同地区的用户连接到不同的Photon Cloud区域
• c）让用户从游戏菜单中选择一个匹配区域。

或者，您可以d）让所有用户连接到相同的地区，如果您的游戏玩家可以接受更高的延迟时间，例如任何“不那么实时”的游戏。

所有Photon Cloud应用程序都可在所有可用区域工作，无需任何额外费用。 查看价格。

Photon Cloud的仪表板可让您监控每个地区的游戏使用情况，轻松升级或降级您的订阅计划。 转到您的仪表盘。

如何以最低延迟开始游戏

连接到最近的主服务器

光子不建议使用通用的区域主服务器地址与主服务器的直接连接方法。 而是使用SDK提供的方法连接到您正在使用的区域主机！

如果您知道您的客户端连接到的最接近的区域，则可以只连接到该区域。

loadBalancingClient.ConnectToRegionMaster("us");

对于其他平台，请从SDK列表中链接到相应的SDK和API 。

SDK将从名称服务器（NameServer)获取所请求区域的主服务器地址（上图“连接到Photon Cloud地区”中的数字1），然后自动将您连接到所选区域中的主服务器（上图“连接到Photon Cloud地区”中的数字2）。

如何在运行时选择一个区域

如果要在运行时选择区域 – 例如，通过向玩家显示可用区域列表并让其选择，则需要先连接到名称服务器。 然后，您可以向名称服务器查询当前可用的区域主服务器地址列表（上面代码范例中的“ConnectToRegionMaster”）。

当我们写“名称服务器”时，名称服务器实际上是在可用区域之间的地理位置负载平衡。 这样可以尽可能快地请求主服务器的地址。

C#客户端SDK

loadBalancingClient.ConnectToNameServer()

连接成功后，您可以获得可用区域的列表。

loadBalancingClient.OpGetRegions()

使用主服务器列表，您现在可以ping所有来可用区域查找最佳连接时间，以达到最低延迟的游戏时间，或者让玩家选择一个区域。

当您的客户端确定该区域时，连接到该区域的主服务器（图“连接到Photon Cloud地区”中的数字2）。

loadBalancingClient.ConnectToRegionMaster("us")

最后，加入或创建一个游戏的空间（图“连接到Photon Cloud地区”中的数字3）。

C++客户端SDK

1.确保您连接到Photon Cloud。 Photon Server不支持云区域。

2.类Client的构造方法有两个可选参数。 最后一个，称为regionSelectionMode ，其中一个值来自LoadBalancing::RegionSelectionMode ，默认值为RegionSelectionMode::DEFAULT 。 请明确地传递RegionSelectionMode::SELECT 的参数。

3.在通过调用Client::connect()触发的连接流程中，客户端从名称服务器接收可用区域的列表。 Listener声明一个可选的回调Listener::onAvailableRegions() 。 如果您已经为regionSelectionModei传递了RegionSelectionMode::SELECT ，那么Client将不会自动选择该可用区域列表中的一个项目，而是将列表传递给该回调。 因此在您的Listener实现中，您应该使用有意义的实现来覆盖该回调的空默认实现，根据您可以提出的任何条件选择一个区域。

4.连接流程完全停止，直到选择了一个区域。

5.将所选区域传递给Client::selectRegion()以继续连接流程。

注意：只有在收到对Listener::onAvailableRegions()调用之后， selectRegion()调用selectRegion()Listener::onAvailableRegions() （直接从此回调期间或之后的回调selectRegion()返回后直接调用selectRegion() ）。 否则，客户端不会处于连接流程的正确阶段，进行区域选择。

Listener::onAvailableRegions()的示例实现可以在Client SDK中的demo_loadBalancing的源代码中找到：

void NetworkLogic::onAvailableRegions(const ExitGames::Common::JVector<ExitGames::Common::JString>& availableRegions, const ExitGames::Common::JVector<ExitGames::Common::JString>& availableRegionServers)
{
    EGLOG(ExitGames::Common::DebugLevel::INFO, L"%ls / %ls", availableRegions.toString().cstr(), availableRegionServers.toString().cstr());
    mpOutputListener->writeLine(L"onAvailableRegions: " + availableRegions.toString() + L" / " + availableRegionServers.toString());
    // select first region from list
    mpOutputListener->writeLine(L"selecting region: " + availableRegions[0]);
    mLoadBalancingClient.selectRegion(availableRegions[0]);
}

请注意，在接收到onAvailableRegions()的调用后， selectRegion()仅在连接流期间被调用。 在任何其他时间或状态下调用它，或者多次调用它来单次调用onAvailableRegions()并且不产生未定义的行为。

Objective-C客户端SDK

1.确保您连接到Photon Cloud。 Photon Server不支持云区域。

2. EGLoadBalancingClient类的EGLoadBalancingClient有两个可选参数。 最后一个，称为regionSelectionMode ，其中一个值来自EGRegionSelectionMode.h ，默认为EGRegionSelectionMode_DEFAULT 。 请明确地传递该参数的EGRegionSelectionMode_SELECT 。

3.在您通过调用EGLoadBalancingClient::connect()触发的连接流程中，客户端从名称服务器接收可用区域的列表。EGLoadBalancingListener声明一个可选的回调EGLoadBalancingListener::onAvailableRegions() 。 如果您已经通过了EGRegionSelectionMode_SELECT的regionSelectionMode ，那么EGLoadBalancingClient将不会自动选择该可用区域列表中的一个项目，而是将列表传递给该回调。 因此在您的EGLoadBalancingListener实现中，您应该使用有意义的实现来覆盖该回调的空默认实现，根据您可以提出的任何条件选择一个区域。

4.连接流程完全停止，直到选择了一个区域。

5.将所选区域传递给EGLoadBalancingClient::selectRegion()以继续连接流。

注意： EGLoadBalancingClient::selectRegion()只有在您收到EGLoadBalancingListener::onAvailableRegions() （直接从此回调之后调用selectRegion()之后（在回调已返回）之后selectRegion()调用。 否则，客户端不会处于连接流程的正确阶段，供区域选择。

EGLoadBalancingListener::onAvailableRegions()的示例实现可以在Client SDK中的demo_loadBalancing_objc的源代码中找到：

- (void) onAvailableRegions:(EGArray*)availableRegions :(EGArray*)availableRegionServers
{
    NSString* r = [availableRegions componentsJoinedByString:@", "];
    NSString* s = [availableRegionServers componentsJoinedByString:@", "];
    EGLOG(EGDbgLvl::INFO, L"onAvailableRegions: %ls / %ls", [r UTF32String], [s UTF32String]);
    [mOutputListener writeLine:@"onAvailableRegions: %@ / %@", r, s];
    // select first region from list
    [mOutputListener writeLine:@"selecting region: %@", availableRegions[0]];
    [mLoadBalancingClient selectRegion:availableRegions[0]];
}

请注意，在接收到onAvailableRegions()的调用后， selectRegion()仅在连接流期间被调用。 在任何其他时间或状态下调用它，或者多次调用它来单次调用onAvailableRegions()并且不产生未定义的行为。

使用中国大陆地区

光子名称服务器必须在中国本地，否则访问延迟可能会非常高。 中国光子的名称服务地址是“ns.photonengine.cn”。

与中国大陆以外的客户联系很可能不会取得好成绩。 此外，从Photon服务器连接到中国大陆以外的服务器（例如，用于自定义认证，WebHooks，WebRPC）可能不可靠。

重要提示 ：在当前阶段，您通过信息中心对您的应用进行的更改不会自动反映在中国的应用高速缓存中。 如果您有更新请求，请通过电子邮件通知我们。

同样出于法律原因，您需要为中国独立构建独立的Appid，所以我们建议您使用单独的AppId。 例如，使用编译条件（您选择的）根据构建来更改AppId和Photon NameServer。

请注意，如果您连接中国区，请按照以下说明为中国区做出专门设置：

C#客户端SDK

1.将AppId设置为中国区域解锁的应用程序。 如果你想使用相同的项目并且有不同的构建，你可以这样做:

// TODO: replace compile condition with your own
#if CHINA
    loadBalancingClient.AppID = "ChinaRealtimeAppId"; // TODO: replace with your own AppId
#else
    loadBalancingClient.AppID = "nonChinaRealtimeAppId"; // TODO: replace with your own AppId
#endif

2.打开“LoadBalancingClient.cs”文件，并将NameServerHost设置为“ns.photonengine.cn”：

// TODO: replace compile condition with your own
#if CHINA
    public const string NameServerHost = "ns.photonengine.cn";
#else
    public const string NameServerHost = "ns.exitgames.com";
#endif

3.使用LoadBalancingClient.ConnectToRegionMaster(“CN”)连接中国大陆地区。

// TODO: replace compile condition with your own
#if CHINA
    loadBalancingClient.ConnectToRegionMaster("cn");
#else
    // TODO: connect to any other region
#endif

C ++客户端SDK

• 将参数serverAdress “ns.photonengine.cn”传递给Client::connect() 。
• 请确保将参数serverType保留在其默认值ServerType::NAME_SERVER 。

Objective-C客户端SDK

• 将参数serverAdress “ns.photonengine.cn”传递给EGLoadBalancingClient::connect()
• 请确保将参数serverType保持在默认值EGServerType_NAME_SERVER 。

在您默认开始使用PhotonCloud光子云的时候，区域会被默认为海外区域，这可能会严重影响您游戏的连接速度和网络品质。在您通过中国区邮件申请发送到您的账号名，联络方式和appid给我们之后，1-2个工作日内，我们将为您免费开通中国区的PhotonCloud光子云服务（初始限定为20CCU）。

快速开始

在这篇文章中，您将掌握迅速部署PhotonCloud光子云，并着手于我们的Demo“粒子演示”。 我们的SDK附带的演示向您展示了如何在一般的应用环境中如何添加多人功能。 我们将看看基本的Photon操作，并且有什么您马上安装就能使用的便捷功能。

虽然下面的C＃代码示例是有点专门针对于Photon Unity3D SDK（ 下载 ）的，但是下面的基本工作流程（1） 连接 ，（2） 创建房间和（3） 发送事件在各平台的应用之间是通用的。

核心内容

• 1）连接到主服务器
• 2）创建房间/加入房间
• 3）发送活动

连接到主服务器

您需要做的第一件事是将您的客户端连接到云端（光子云）。 我们将此过程称为连接到主服务器。 从那里，主服务器将负责所有客户端到游戏服务器的传输，云中的负载平衡功能负责协调所有可用的房间。

让我们直接进入我们的演示代码：

// From GameLogic.cs                        
public GameLogic(string masterAddress, string appId, string gameVersion) : base(masterAddress, appId, gameVersion)
{
    this.LocalPlayer.Name = "usr" + SupportClass.ThreadSafeRandom.Next() % 99;
 
    this.AutoJoinLobby = false;
    this.UseInterestGroups = true;
    this.JoinRandomGame = true;
 
    this.DispatchInterval = new TimeKeeper(10);
    this.SendInterval = new TimeKeeper(100);
    this.MoveInterval = new TimeKeeper(500);
    this.UpdateOthersInterval = new TimeKeeper(this.MoveInterval.Interval);
}

GameLogic类继承了LoadBalancingClient ，它保持一个状态并自动执行主服务器和游戏服务器之间的转换。 让我们仔细看看GameLogic构造函数中使用的参数：

1. string masterAddress ：要连接的（主）服务器的URL。 请参阅Photon云区域列表 。
2. string appId ：在我们的云系统中标识您的应用程序。 如果您还没有AppId，您可以在Photon Cloud信息中心 创建。 您需要插入有效的AppId才能使大多数演示工作。
3. string gameVersion ：一个字符串，你可以选择曲隔你的游戏的不同版本。 只有具有相同版本号的客户端可以匹配，并且可以相互通信。 这使得添加功能更容易，不会破坏旧客户端。

连接后，Photon云已准备好遵照你的吩咐。 你不必去做所有细微的调整，因为一切都已经为你处理好了！ 在下面的图表中，您可以看到，灰色方块中的所有内容都是由Photon Cloud组织的。 客户端只需要发送简单的操作，如箭头旁边的那些。

现在我们连接到主服务器，我们可以列出，创建和加入房间。 在这一点上，玩家不能相互通信或交互。 这是房间的概念发挥作用。 仔细想一想，看看你需要做什么来连接玩家彼此。

大厅，创建房间和加入房间

默认情况下，当你连接时，LoadBalancing API会让你进入游戏的“Lobby”。 在大厅中，主服务器向客户端提供房间列表。 为了保持例如移动环境中的低流量，客户端不能在大厅中互相交互。

一个房间可以被认为是一个单独的区域，玩家互动（玩他们的游戏）。 当他们在同一个房间，玩家可以发送和接收来自其他人的事件，更改/更新房间的属性等。

在下面的示例中，我们使用“OpCreateRoom”操作来创建和打开房间。 一起创建一个：

RoomOptions options = new RoomOptions();
options.options.maxPlayers = 4;
peer.OpCreateRoom("Room 42", options, TypedLobby.Default);

最需要留意的参数和RoomOptions是：

• string roomName房间的名称，用于标识和加入房间。
• bool.RoomOptionsisVisible此变量确定房间是否在可在大厅可见的房间列表中（即连接到主服务器但还没注册但还没有进入房间中的玩家可见）。 重要的是，这些房间仍然可以加入，只要客户端知道房间的确切名称。
• bool RoomOptions.isOpen确定客户端是否可以加入房间。 当此变量改变时，已经在房间中的客户端不受影响。 然而，他们不能在离开后重新加入房间，只要isOpen是False的。
• byte RoomOptions.maxPlayers决定此房间中的最大玩家数。 如果设置为0，则上限是无限的。 请注意，如果你计划在一个房间里放入大量的用户，你应该看看我们的Photon服务器MMO应用程序！
• Hashtable RoomOptions.customRoomProperties是一组可选的键和值，您可以定义它们来描述房间。 一个可选的示例是：key“level”，值为“de_dust”。（^_^）。 属性将同步到房间中的所有客户端，并在配对中发挥作用。 更多关于这个选项，见下面。
• string [] RoomOptions.customRoomPropertiesForLobby将在Lobby中显示的属性。

使用Photon，您可以在运行时更改房间或玩家的属性，因此通过customGameProperties设置属性，在设计服务器逻辑时你将不会有任何限制 。 在房间中使用room.SetCustomProperties（props）设置新值或覆盖现有值。 所做的更改将被合并，因此您只需要传入您想要更改的属性即可。

一个房间可以有许多属性，但通常只有几个是玩家配对所需要的，所以Photon会希望你在大厅里面定义一个房间的属性关键列表。 即使在RoomOptions.customRoomProperties中尚未定义的键也可以在string [] customRoomPropertiesForLobby中使用，并在稍后填充。

就像是房间的属性一样，您可以为每个玩家设置自定义属性。 每个客户端可以设置玩家属性LoadBalancingClient.localPlayer.SetCustomProperties() ，即使在加入房间之前。 他们一直保留客户端，并与客户端加入或创建的任何房间时保持同步。

现在我们成功创建了一个房间，是让其他客户加入的时候了！ 加入房间是非常快速和容易的，不需要任何进一步的解释，看看下面的操作：

// From LoadBalancingClient.cs                        
public void OnOperationResponse(OperationResponse operationResponse)
{
    ...
    this.OpJoinRoom(name);
}

接下来让我们看看玩家现在可以如何互动。

发送事件

对于客户端彼此交互，我们使用一个简单的事件系统。 使用事件是向给指定房间内的玩家发送和接收快速可靠信息的主要方式。 所有你游戏逻辑中的重要活动都可以通过这种方式进行传递。您的游戏逻辑的所有必要的数据可以在客户端之间发送。 您甚至可以通过使用简单的参数指定协议（UDP与TCP或可靠的(UDPreliable UDP)与不可靠的UDP(unreliable UDP)）来自定义交换信息的方式，具体取决于您的需要。

活动将在房间的参与者之间分发。 您可以决定是否要将活动发送到特定的玩家，团体或个人的列表。

让我们来看看我们在粒子演示中使用的事件，例如在更改颜色时：

public void ChangeLocalPlayercolor()
{
    if (this.LocalPlayer != null)
    {
        this.LocalPlayer.RandomizeColor();
        this.loadBalancingPeer.OpRaiseEvent(DemoConstants.EvColor, this.LocalPlayer.WriteEvColor(), this.SendReliable, new RaiseEventOptions() { CachingOption = EventCaching.AddToRoomCache });
    }
}

OpRaiseEvent参数包括：

• byte eventCode事件代码指定要提出的实际事件。 有从由255开始向下计算的Photon的预定义事件。而从1开始到199，你可以定义在游戏逻辑中使用自己的事件。
• Hashtable evData您可以填写此哈希表来传输您需要的所有数据。 这是您将用于在客户端之间交换信息的中央数据结构。 但是，您游戏逻辑的标准的循环和标准化步骤应该作为事件发送（例如回合结束）。
• bool sendReliable当将此标志设置为“true”时，将从UDP切换到可靠的UDP(reliable UDP)。 这意味着在传输期间丢失的任何包将被重新发送，并且客户端将确保包将按照它们被发送的顺序被解释。 这可能会以负面的方式影响性能，因为这些额外的步骤将增加额外的消息量并增加整体通讯的数据负担。
• byte RaiseEventOptions.channelId您可以使用不同的通道对发送的事件进行分组和优先级排序。 我们将在一个小例子中说明此功能：假设您使用渠道1发送有关玩家位置的相关信息。 你在你的游戏中启用了可靠的UDP，因为你需要在你的游戏类型获得额外的可靠性。在某些时候，通道1会由于许多消息而拥挤，因为一些玩家有延迟，因为网络连接不好而产生了一定数量的通讯包丢失，因此必须重新发送许多消息。 而这时需要入列发送另一个重要事件（如本轮结束），可能需要一些时间才能确认，因为客户端仍然忙于接收来自通道1的所有位置更新。因此，如果您现在分派一个事件到channelId 0，它将优先于所有其他排队的消息处理。 通过合理的使用此功能，您可以获得设计预期的反应性，并确保游戏逻辑的正确执行，即使在一个平庸的的连接条件下。
• int [] RaiseEventOptions.targetActors要发送事件的房间中的ActorNumbers的列表。
• EventCaching RaiseEventOptions.CachingOption影响服务器如何处理事件缓存。 可以缓存玩家稍后加入的事件或删除以前缓存的事件。

最后但并非最终的方法，Photon还有额外的重载(Overload)，你可以用来指定接收器组。

想进一步了解PhotonCloud光子云？

我们推荐您学习Exit Games的官方实例教学马可波罗，您可以在光子实践资源找到被翻译为中文的教程实践连接。

请留意，如果您有自己的服务器（VPS，阿里云等)，那么PhotonServer光子服务器同样可以担负PhotonCloud光子云的服务器连接功能，请参照这篇文章和光子服务器的详细介绍。

下载并提取

Photon服务器SDK可在光子网站的下载页面上获得。

服务器SDK自带的可执行文件。 这保持包括.dll文件被标记为“untrustworthy”一些解压缩工具（从互联网=>下载）。

您可以将服务器包解压缩到任何位置 – 最好是您事先准备好的空文件夹。 提取创建几个文件夹。

“deploy”文件夹包含二进制文件。 这是你需要至少运行Photon。 文件夹doc ， lib和src-server （应用程序）用于开发。

启动Photon

在“deploy”文件夹中，每个应用程序都会找到一个文件夹（ 请参阅：基本概念 ）和一些以“bin”开头的文件夹。 打开以下两个：

• bin_Win32 ：Windows Vista及以上
• bin_Win64 ：64位Windows Vista及以上

在任一文件夹中，您将找到实际的Photon可执行文件。 你可以用命令行参数启动它，或者你可以使用PhotonControl 。

启动PhotonControl.exe并确认此应用程序的管理员权限。 它们是设置Photon as a Service的选项所需的。

注意托盘栏图标（默认右下角）。 单击白色/灰色图标打开控制Photon的菜单。 从光子实例（下面解释）和“作为应用程序启动”中选择LoadBalancing (MyCloud) 。 现在你已经启动了Photon！

它可能需要几秒钟，直到Photon准备使用，这取决于它运行的应用程序。 退出光子控制不会关闭服务器。

在您应用许可证文件之前，Photon将限制为20个并发连接。 请参阅许可证页面。

光子实例

Photon被设计为运行“应用程序”作为游戏逻辑。 他们定义了客户端可以做什么或不能做什么（例如，匹配）。 应用程序协同运行的不同任务。

安装即用，Photon有两种不同的应用配置：

• LoadBalancing（MyCloud）是首选的设置，并与Photon Cloud和PUN兼容。
• MMO Demo是一个暴露基于Photon的简单MMO解决方案的应用程序。

“LoadBalancing（MyCloud）”需要一些设置。 默认情况下，它仅适用于同一台计算机上的客户端。 见下面如何设置LoadBalancing。

LoadBalancing（MyCloud）和游戏服务器IP配置

启动LoadBalancing (MyCloud)是客户端通过PUN或“LoadBalancing Api”完成的方式。

实际上，此设置将启动两个单独的光子应用程序： Master Server和Game Server 。 创建新房间时，主服务器将选择游戏服务器并将客户端转发到该服务器。

默认情况下，只有同一台计算机上的客户端可以访问游戏服务器。 即使模拟的移动设备也不能创建房间，并且在没有先前的游戏服务器IP配置的情况下将失败。

在PhotonControl菜单中选择“游戏服务器IP配置”。 将列出主机的IP地址，标记为“public”或“local”。 选择一个。

“Autodetect public”条目使服务器在Photon启动时检测到公共互联网 IP。

使用本地IP意味着只有同一本地网络中的客户端可以连接。 你需要使用公共IP，如果来自互联网的玩家应该能够连接和加入游戏。

如果您的服务器在LAN中，但您的客户端使用WiFi，则它们可能位于不同的网络中。 如果您的客户端无法访问服务器，请检查您的路由器是否允许WiFi和LAN之间的连接。 检查所有设备是否在相同的IP范围内。

请记住，公共IP可能会更改，除非你有一个静态IP地址。

无论选择本地网络IP还是公共网络IP， 您还必须设置防火墙，路由器和交换机。 但是，我们不能在这里告诉您具体如何设置，因为不同的硬件和软件的数量过于庞大。 在最简单的环境设置中，多台测试机都应该只通过一台相同的交换机/路由器连接。

游戏服务器IP地址保存在名为“Photon.LoadBalancing.dll.config”的文件中。 它也可以手动编辑。

启动测试客户机

服务器SDK包括一个测试客户端，用于模拟多个客户端并生成一些负载。 您可以从PhotonControl菜单启动它。 它是您启动的应用程序设置的最后一个菜单项：“运行测试客户端”。

测试客户端是一个简单的控制台应用程序，将模拟客户端会话和游戏，并附带着几个玩家。

许可信息

PhotonControl将在开始时从您的.license文件读取一些值。 选择菜单中的“许可证信息”项目，从菜单中检查CCU，到期日期等。 如果替换.license文件，则应重新启动PhotonControl以获取新值。

中国区的Photon Server 许可文件，请联络光子中国代理动联无限的官网，并获取中国区的许可验证服务。

服务器日志还将包含许可证的基本值。

请参阅许可证页面。

The post 5分钟启动PhotonServer first appeared on 光子引擎photonengine中文站.]]> 254