Known Issues

On this page, we will list known issues with Photon on the various platforms. The focus here is on issues which we can't fix or workaround. In some cases, this means we will simply list broken versions per platform and guide you to other versions.

Mobile Background Apps

On mobile platforms, if the app moves to background it pauses the main message loop which is responsible for keeping the client connected among other things.

Typical causes of this are:

  • Player hits "home button".
  • Phone call received.
  • Video ads.
  • Third party plugin that introduces an overlay view in the app (e.g. facebook, Google, etc.).

If the app stays paused for more than the client disconnect timeout (which should be 10 seconds by default) the client will be disconnected and you need to reconnect as soon as the app is "unpaused". A "timeout disconnect" callback will be triggered only when the app is no longer in the background.

Windows 8

There is a known issue in Windows 8 (maybe 8.1), which has the system search for new Wifi networks, even though it connected to one. This can affect a game with realtime networking with frequent gaps of incoming messages and a spike in ping times.

In order to fix it change ScanWhenAssociated field in system register

[HKEY\_LOCAL\_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4d36e972-e325-11ce-bfc1-08002be10318}\0002]

from 0x00000001 to 0x00000000.

Unity

RunInBackground

Unity's Application.runInBackground is not supported on mobile platforms. Instead, the OnApplicationPause method is called whenever the app moves to or back from background:

void OnApplicationPause( bool pauseStatus )
{
    if (pauseStatus) 
    {
        // app moved to background
    } else 
    {
        // app is foreground again
    }
}

Windows Store Capabilities

If you target Windows Store and you are having exceptions when you try to connect or you have this error:

A network capability is required to access this network resource

Make sure to enable the required capability from Unity's "Player Settings" -> "Publisher Settings" -> "Capabilities -> "InternetClient"

Photon PUN: Required Capability for Windows Store Apps
Photon PUN: Required Capability for Windows Store Apps. You don't need 'Microphone' if you don't use Photon Voice.

UWP

If you want to export your Unity application to UWP you can either use .NET or IL2CPP as scripting backend. Photon PUN is already configured to choose the correct library in order to successfully export the application from Unity. If however something goes wrong while exporting please check and make sure that you are using the correct library for the certain scripting backend:

If you are using .NET as scripting backend make sure that Photon3Unity3D.dll is used from /Assets/Plugins/Metro/ directory

If you are using IL2CPP as scripting backend make sure that Photon3Unity3D.dll is used from /Assets/Plugins/ directory

iOS

Some Unity 4.3.3 and 4.3.4 exports will not read received room- and player-properties correctly. Some cases might also crash with out-of-memory exceptions.

In this case, the AOT (Ahead Of Time) compilation is not working correctly and some of the methods that work on Hashtables break. We could not find a proper cause for this but are testing the upcoming releases of Unity 4.x for a fix.

Keep in mind: Not all exports are automatically broken but some project will always break, others won't.

IPv6

Some Unity versions do support IPv6 or has broken this feature previously available (like 5.4). Some of the supported versions are: 4.7.2, 5.1.5, 5.2.5, 5.3.4p4, 5.4.0p1 and newer (see Unity blog post).

 To Document Top