AirConsole Games Features
Connect to your game

Testing with your Phone

5min

If you are on a public wi-fi such as at a university, library or game jam site, you may run into trouble connecting your phone, getting stuck on the loading screen instead. You can work around this by using tool like Cloudflare Tunnels or the paid version of ngrok, which lets you expose local servers to the public internet over secure tunnels.

When is this guide relevant to you?

This will help you if you can open and play your game with virtual controllers in Unity, but are not able to connect an actual phone. Most likely, your phone will remain stuck on the Loading screen with the AirConsole logo and three dots visible.

This workaround can also be used if your phone and your computer cannot be connected to the same WiFi for any reason, for example because your computer is connected to a hotspot coming from your phone itself.

Using Local IP Override to test easily

To configure the public HTTPS address using the Local IP Override of your AirConsole component, you need at least v2.14 of the AirConsole Unity Plugin

  1. Setup and run cloudflared to match your needs following the Install and run cloudflared guide below.
  2. Select your AirConsole game object and set your Browser Start Mode to Normal or Debug.
  3. Copy your public https URL into the Local IP Override field.
Document image

Document image


Start the play mode using Edit > Play or press Ctrl/Cmd + P.

Install and run cloudflared

If you only need access to your Unity playmode:

  • Follow the installation instructions for the Cloudflared Quick Tunnel.
  • Start it using cloudflared tunnel --url http://localhost:7842 (the webserver port configured in your AirConsole settings)
  • When running the cloudflared quick tunnel, you will receive a randomized URL like the one shown below to copy into the Local IP Override:
Document image

Every time you run cloudflared tunnel --url http://localhost:7842 the resulting URL will change and need to be copied into the Local IP Override again.

If you need access to multiple ports including Unity playmode for your testing

  • Follow the installation instructions at Create CloudFlare Local Tunnels
    • In the config.yaml, replace url: http://localhost:8000 with url: http://localhost:7842
  • Insert the url you configured in config.yaml into the Local IP Override field. This will not change between executions of cloudflared.