Quick Start

for unity games, please refer to our unity tutorial https //developers2 airconsole com/airconsole unity plugin general idea create a new directory with two files screen html and controller html 2\ include the airconsole js api https //airconsole github io/airconsole api/airconsole 1 9 0 js and use it to communicate between devices 3\ host your files (local/remote) and call airconsole com/# http //your game url/ step by step guide create files create a new directory for your game (e g game) and create two files in it /game \<font color="#eb144c">screen html\</font> \<font color="#eb144c">controller html\</font> the screen html is for the gameconsole's screen the controller html are for the gameconsole's controllers (gamepads) make sure both files can be accessed by http //your local webserver/screen html http //your local webserver/screen html (or /controller html) if you don't want to create your own screen html and controller html right now and just play around, you can use our pong example (pong zip) https //github com/airconsole/games pong/archive/master zip from the classic pong walkthrough https //developers2 airconsole com/pong example include airconsole javascript api file include the airconsole javascript api in both files \<font color="#eb144c">/screen html\</font> and \<font color="#eb144c">/controller html\</font> send a message here is a simple example where the controller sends " how are you? " to the screen and the screen replies with " full of pixels! " \<font color="#eb144c">/controller html\</font> \<button id="btn msg">send message\</button> \<script type="text/javascript"> var airconsole = new airconsole(); // when we press our button, we send a message to the screen document getelementbyid('btn msg') addeventlistener("click", function() { airconsole message(airconsole screen, "how are you?"); }); // listen for messages airconsole onmessage = function(from, data) { // show message on device screen var info = document createelement('div'); info textcontent = data; document body appendchild(info); }; \</script> \<font color="#eb144c">/screen html\</font> \<script type="text/javascript"> var airconsole = new airconsole(); // listen for messages from other devices airconsole onmessage = function(from, data) { // we receive a message > send message back to the device airconsole message(from, "full of pixels!"); // show message on device screen var info = document createelement('div'); info textcontent = data; document body appendchild(info); }; \</script> test your game you need to start a local webserver in your /game folder to serve the \<font color="#eb144c">screen html\</font> and \<font color="#eb144c">controller html\</font> in this example we will host the two files on http //192 168 0 1 8080/screen html http //192 168 0 1 8080/controller html to run the game, go with the browser that should act as the screen to https //www airconsole com/#http //192 168 0 1 8080/ http //www airconsole com/#http //192 168 0 1 8080/ note there is no screen html at the end! there are problems with certain browsers like chrome not allowing access like this with http and https mixed alternatively you can use http //http airconsole com/?http=1\&#http //192 168 0 1 8080/ http //http airconsole com/?http=1\&#http //192 168 0 1 8080/ or use the simulator like desribed below game controllers (your smartphone) can join as usual over www airconsole com https //www airconsole com enter the code you see on the screen when accessing the game with a separate device make sure the content (controller html) is also accessible for that device under the url in the link ( in our example http //192 168 0 1 8080/controller html ) the devices should now exchange the messages simulator if you append /simulator in the url, then you will get a split view of the screen and two controllers http //http airconsole com/simulator/#http //192 168 0 1 8080/ http //www airconsole com/simulator/#http //192 168 0 1 8080/ this makes testing and developing a lot easier if you run into issue with https (mixed content issues), refer to the tunneling guide https //developers2 airconsole com/testing with your phone#0a3qq device ids important warning make sure you do not assume that the controllers have device ids 1, 2, 3 we strongly recommend you read the device ids and states https //developers2 airconsole com/device ids and state guide! next steps checkout the guide about our pong example https //developers2 airconsole com/pong example or the api https //airconsole github io/airconsole api/ to learn more about how to build games for airconsole to getting started with uploading your game to airconsole, you can log in here https //www airconsole com/developers https //www airconsole com/developers