Share your Unity game’s URL every build!

As a game developer I want to share my current game quickly with friends and testers. As going to the build page, clicking the share-link and then updating a webpage is a lot of work, I went looking for other ways.

Luckily Unity Build has an API. It also has a webhook to notify when the build is completed. Putting these all together, my website buttons now automatically link to the latest build on the Unity Build platform. Unfortunately I spent a lot of item trying to figure out what parameters were the correct ones, which took more time than which I had hoped. For that reason, please find the references in step 4.

Requirements

• A webserver with php installed (MySQL optional)
• A Unity cloud build project with automated builds set-up

1. Go to your webserver and create 2 files: webhook.php and index.php
2. Open webhook.php and paste in the following code (explanation will follow)
   
   PHP

   <?php $val = json_decode($HTTP_RAW_POST_DATA, true); $url = 'https://build-api.cloud.unity3d.com/api/v1/orgs/{orgid}/projects/{projectid}/buildtargets/{targetid}/builds/'. $val["buildNumber"] .'/share'; // use key 'http' even if you send the request to https://... $options = array( 'http' => array( 'header' => "Authorization: Basic {apiKey}", 'method' => 'POST' ) ); $context = stream_context_create($options); $result = file_get_contents($url, false, $context); if ($result === FALSE) { /* Handle error */ } $val = json_decode($result, true); $shareLink = "https://build.cloud.unity3d.com/share/"; $shareLink = $shareLink.$val["shareid"]."/webgl"; file_put_contents('shareUrl.txt', $shareLink); ?>

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

   <?php $val = json_decode($HTTP_RAW_POST_DATA, true);   $url = 'https://build-api.cloud.unity3d.com/api/v1/orgs/{orgid}/projects/{projectid}/buildtargets/{targetid}/builds/'. $val["buildNumber"] .'/share';   // use key 'http' even if you send the request to https://... $options = array( 'http' => array( 'header' => "Authorization: Basic {apiKey}", 'method' => 'POST' ) );   $context = stream_context_create($options); $result = file_get_contents($url, false, $context); if ($result === FALSE) { /* Handle error */ }   $val = json_decode($result, true);   $shareLink = "https://build.cloud.unity3d.com/share/"; $shareLink = $shareLink.$val["shareid"]."/webgl";   file_put_contents('shareUrl.txt', $shareLink);   ?>

   
    
3. Paste the following code in index.php
   
   PHP

   <?php $myfile = fopen("shareUrl.txt", "r") or die("Unable to open file!"); $url = fread($myfile,filesize("shareUrl.txt")); fclose($myfile); exit(header("Location: " . $url)); ?>

   1 2 3 4 5 6 7 8

   <?php $myfile = fopen("shareUrl.txt", "r") or die("Unable to open file!"); $url = fread($myfile,filesize("shareUrl.txt")); fclose($myfile); exit(header("Location: " . $url)); ?>

4. Now we can look up the required information:
   1. Your api-key can be found in your cloud build > Preferences > API-key
      
   2. Your organisation, project and build id’s can be found by making the following API get-request
      
      https://build-api.cloud.unity3d.com/api/v1/projects

      1	https://build-api.cloud.unity3d.com/api/v1/projects

      
      From there you can find all the required ids from above (per project).
   3. Your build target is the name of your target system in small letters (eg. webgl)
5. Now it is time to set up the actual webhooks. Go to the notifications tab of your cloud build project and choose “Add new”. Fill in the URL of your php script on your web server and keep the json content type.  Click the check boxes so only “ProjectBuildSuccess” remains and use SSL only if your site has https.
   

After filling everything in, start a new build (or commit a change). The cloud should send a post message to your website and the URL in the text file will be updated. When you go to your index.php page, you will be redirected to the build of your game’s latest commit!