Updated to app services to resolve #26. Also added readme documentation to resolve #14

deadlyfingers · deadlyfingers · commit 05b928b6fbdf · 2016-08-27T15:25:16.000+01:00
diff --git a/Assets/AppServices/LICENSE b/Assets/AppServices/LICENSE
diff --git a/Assets/AppServices/README.md b/Assets/AppServices/README.md
@@ -1,15 +1,17 @@
-# Azure Mobile Services for Unity3d
-For game developers looking to use Azure Mobile Services or Azure App Services in their Unity3D project.
+# Azure App Services for Unity3d
+For game developers looking to use Azure App Services (previously Mobile Services) in their Unity project.
 
-Also available as a [MobileServices Demo Project](https://github.com/Unity3dAzure/MobileServicesDemo) which will run inside UnityEditor and on iOS, Android and Windows. The demo project has got everything bundled in and does not require any additional assets to work. If you want to integrate with an existing Unity3d project then follow instructions below:
-
-## How to add MobileServices into Unity3d project
+## How to setup App Services with a new Unity project
 1. [Download UnityRestClient](https://github.com/ProjectStratus/UnityRestClient/archive/master.zip)
  	* Copy JsonFx 'plugins' and the UnityRestClient 'Source' into project `Assets` folder
-2. [Download MobileServices](https://github.com/Unity3dAzure/MobileServices/archive/master.zip)  
-	* Copy 'MobileServices' into project `Assets` folder.
-3. Create an [Azure Mobile Service](https://manage.windowsazure.com) or an [Azure App Service](https://portal.azure.com)
-	* Create a table for app data.
+2. [Download AppServices](https://github.com/Unity3dAzure/AppServices/archive/master.zip)  
+	* Copy 'AppServices' into project `Assets` folder.
+3. Create an Azure App Service [Mobile App](https://portal.azure.com)
+	* Create a Table (using Easy Tables) for app data.
+
+## Unity 5 leaderboard demo
+[App Services Demo project](https://github.com/Unity3dAzure/AppServicesDemo) will run inside UnityEditor on Mac or Windows. (The demo project has got everything bundled in and does not require any additional assets to work.)
+Read developer guide on [using Azure App Services to create Unity highscores leaderboard](http://www.deadlyfingers.net/azure/azure-app-services-for-unity3d/) for detailed instructions.
 
 ## Supported Features
 ### MobileServiceClient
@@ -49,7 +51,7 @@ using System.Net;
 using System.Collections.Generic;
 using RestSharp;
 using Pathfinding.Serialization.JsonFx;
-using Unity3dAzure.MobileServices;
+using Unity3dAzure.AppServices;
 
 ```
 
@@ -60,7 +62,7 @@ private MobileServiceTable<TodoItem> _table;
 
 ```
 void Start () {
-	_client = new MobileServiceClient(appUrl, appKey); // <- add your app connection strings here.
+	_client = new MobileServiceClient(appUrl); // <- add your app url here.
 	_table = _client.GetTable<TodoItem>("TodoItem");
 }
 ```
@@ -84,4 +86,9 @@ private void OnReadItemsCompleted(IRestResponse<List<TodoItem>> response) {
 ## Dependencies
 The REST service implements [UnityRestClient](https://github.com/ProjectStratus/UnityRestClient) which uses [JsonFx](https://bitbucket.org/TowerOfBricks/jsonfx-for-unity3d-git/) to parse JSON data.
 
+## Supports
+* iOS
+* Android
+* Windows
+
 Questions or tweet #Azure #GameDev [@deadlyfingers](https://twitter.com/deadlyfingers)
diff --git a/Assets/AppServices/authentication/MobileServiceAuthenticationProvider.cs b/Assets/AppServices/authentication/MobileServiceAuthenticationProvider.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public enum MobileServiceAuthenticationProvider
     {
diff --git a/Assets/AppServices/client/IAzureMobileServiceClient.cs b/Assets/AppServices/client/IAzureMobileServiceClient.cs
@@ -3,7 +3,7 @@
 using System;
 using RestSharp;
 
-namespace Unity3dAzure.MobileServices
+namespace Unity3dAzure.AppServices
 {
     public interface IAzureMobileServiceClient
     {
diff --git a/Assets/AppServices/client/MobileServiceClient.cs b/Assets/AppServices/client/MobileServiceClient.cs
@@ -9,7 +9,7 @@
 using System.Net.Security;
 #endif
 
-namespace Unity3dAzure.MobileServices
+namespace Unity3dAzure.AppServices
 {
     public class MobileServiceClient : RestClient, IAzureMobileServiceClient
     {
@@ -22,6 +22,7 @@ public class MobileServiceClient : RestClient, IAzureMobileServiceClient
 
         /// <summary>
         /// Creates a new RestClient using Azure Mobile Service's Application Url and App Key
+        /// NB: Mobile Services should be migrated to use Azure App Service with constructor below.
         /// </summary>
         public MobileServiceClient(string appUrl, string appKey) : base(appUrl)
         {
@@ -31,7 +32,7 @@ public MobileServiceClient(string appUrl, string appKey) : base(appUrl)
             // required for running in Windows and Android
             #if !NETFX_CORE || UNITY_ANDROID
             Debug.Log("ServerCertificateValidation");
-            ServicePointManager.ServerCertificateValidationCallback = RemoteCertificateValidationCallback;    
+            ServicePointManager.ServerCertificateValidationCallback = RemoteCertificateValidationCallback;
             #endif
         }
 
@@ -117,4 +118,4 @@ private bool RemoteCertificateValidationCallback(System.Object sender, X509Certi
         #endif
 
     }
-}
+}
diff --git a/Assets/AppServices/http/ZumoRequest.cs b/Assets/AppServices/http/ZumoRequest.cs
@@ -2,7 +2,7 @@
 using System.Collections;
 using RestSharp;
 
-namespace Unity3dAzure.MobileServices
+namespace Unity3dAzure.AppServices
 {
     public class ZumoRequest : RestRequest
     {
diff --git a/Assets/AppServices/model/AccessToken.cs b/Assets/AppServices/model/AccessToken.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public class AccessToken
     {
diff --git a/Assets/AppServices/model/MobileServiceUser.cs b/Assets/AppServices/model/MobileServiceUser.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public class MobileServiceUser
     {
diff --git a/Assets/AppServices/model/ResponseError.cs b/Assets/AppServices/model/ResponseError.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public class ResponseError
     {
diff --git a/Assets/AppServices/model/User.cs b/Assets/AppServices/model/User.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public class User
     {
diff --git a/Assets/AppServices/model/optional/AzureDataModel.cs b/Assets/AppServices/model/optional/AzureDataModel.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public class AzureDataModel : IAzureDataModel
     {
diff --git a/Assets/AppServices/model/optional/IAzureDataModel.cs b/Assets/AppServices/model/optional/IAzureDataModel.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public interface IAzureDataModel
     {
diff --git a/Assets/AppServices/table/IAzureMobileServiceTable.cs b/Assets/AppServices/table/IAzureMobileServiceTable.cs
@@ -3,7 +3,7 @@
 using System;
 using RestSharp;
 
-namespace Unity3dAzure.MobileServices
+namespace Unity3dAzure.AppServices
 {
     /// <remarks>
     /// NB: Interface uses callbacks as Unity does not support async methods right now. 
diff --git a/Assets/AppServices/table/MobileServiceTable.cs b/Assets/AppServices/table/MobileServiceTable.cs
@@ -7,7 +7,7 @@
 using RestSharp.Deserializers;
 using System.Reflection;
 
-namespace Unity3dAzure.MobileServices
+namespace Unity3dAzure.AppServices
 {
     public class MobileServiceTable<E> : IAzureMobileServiceTable
     {
diff --git a/Assets/AppServices/table/query/CustomQuery.cs b/Assets/AppServices/table/query/CustomQuery.cs
@@ -1,4 +1,4 @@
-﻿namespace Unity3dAzure.MobileServices
+﻿namespace Unity3dAzure.AppServices
 {
     public class CustomQuery
     {
diff --git a/Assets/Scripts/AppServicesDemo.cs b/Assets/Scripts/AppServicesDemo.cs
@@ -4,7 +4,7 @@
 using System.Collections.Generic;
 using RestSharp;
 using Pathfinding.Serialization.JsonFx;
-using Unity3dAzure.MobileServices;
+using Unity3dAzure.AppServices;
 
 [CLSCompliant(false)]
 public class AppServicesDemo : MonoBehaviour
diff --git a/Assets/Scripts/MobileServicesDemo.cs b/Assets/Scripts/MobileServicesDemo.cs
@@ -4,7 +4,7 @@
 using System.Collections.Generic;
 using RestSharp;
 using Pathfinding.Serialization.JsonFx;
-using Unity3dAzure.MobileServices;
+using Unity3dAzure.AppServices;
 
 [CLSCompliant(false)]
 public class MobileServicesDemo : MonoBehaviour 
diff --git a/README.md b/README.md
@@ -1,5 +1,5 @@
-# MobileServicesDemo and AppServicesDemo for Unity3d
-Sample Unity 5 project demoing Azure Mobile Services or Azure App Service for Unity3d.
+# AppServicesDemo for Unity3d
+Sample highscore leaderboard project demoing Azure App Services (previously Mobile Services) for Unity 5.
 
 ## Highscore demo features
 * Client-directed login with Facebook
@@ -9,32 +9,8 @@ Sample Unity 5 project demoing Azure Mobile Services or Azure App Service for Un
 * Query for scores > 999 (leaderboard)
 * Query for username (user's scores)
 
-## Setup Azure Mobile Services for Unity
-1. Create an [Azure Mobile Service](https://manage.windowsazure.com/)
-	* Create 'Highscores' table for app data
-	* Modify 'Highscores' table Insert node script to save userId
-	* Create a custom API called 'hello'
-2. In Unity3d **open scene** `Scenes/MobileServicesDemo.unity`
-	* Check the script `Scripts/MobileServicesDemo.cs` is attached to a game object in the Unity Hierarchy window.
-3. Paste Azure Mobile Service app's connection strings into Unity Editor Inspector fields
-	![alt Unity Editor Mobile Services config](https://cloud.githubusercontent.com/assets/1880480/14404803/c8287754-fe76-11e5-8b0c-7ba729a8c19d.png)
-	* Mobile Service URL
-	* Mobile Service Application Key
-4. If you want to save score with userId then [create Facebook app](https://developers.facebook.com/apps/)
-	* Fill in Azure Mobile Service's Identity > Facebook settings (App Id & App Secret)
-	* Paste [Facebook access user token](https://developers.facebook.com/tools/accesstoken/) into Unity Editor Inspector field
-	* Play in UnityEditor
-
-### Azure Mobile Services
-#### Highscores Table **Insert** script
-```node
-function insert(item, user, request) {
-  if (user.userId) {
-    item.userId = user.userId;
-  }
-  request.execute();
-}
-```
+## Developer guide
+Read developer guide on [using Azure App Services to create Unity highscores leaderboard](http://www.deadlyfingers.net/azure/azure-app-services-for-unity3d/) for detailed instructions.
 
 ## Setup Azure App Services for Unity
 1. Create an [Azure Mobile App](https://portal.azure.com/)

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-namespace Unity3dAzure.MobileServices`
	`1`	`+namespace Unity3dAzure.AppServices`
`2`	`2`	`{`
`3`	`3`	`public enum MobileServiceAuthenticationProvider`
`4`	`4`	`{`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`using System;`
`4`	`4`	`using RestSharp;`
`5`	`5`
`6`		`-namespace Unity3dAzure.MobileServices`
	`6`	`+namespace Unity3dAzure.AppServices`
`7`	`7`	`{`
`8`	`8`	`public interface IAzureMobileServiceClient`
`9`	`9`	`{`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@`
`9`	`9`	`using System.Net.Security;`
`10`	`10`	`#endif`
`11`	`11`
`12`		`-namespace Unity3dAzure.MobileServices`
	`12`	`+namespace Unity3dAzure.AppServices`
`13`	`13`	`{`
`14`	`14`	`public class MobileServiceClient : RestClient, IAzureMobileServiceClient`
`15`	`15`	`{`
`@@ -22,6 +22,7 @@ public class MobileServiceClient : RestClient, IAzureMobileServiceClient`
`22`	`22`
`23`	`23`	`/// <summary>`
`24`	`24`	`/// Creates a new RestClient using Azure Mobile Service's Application Url and App Key`
	`25`	`+ /// NB: Mobile Services should be migrated to use Azure App Service with constructor below.`
`25`	`26`	`/// </summary>`
`26`	`27`	`public MobileServiceClient(string appUrl, string appKey) : base(appUrl)`
`27`	`28`	`{`
`@@ -31,7 +32,7 @@ public MobileServiceClient(string appUrl, string appKey) : base(appUrl)`
`31`	`32`	`// required for running in Windows and Android`
`32`	`33`	`#if !NETFX_CORE \|\| UNITY_ANDROID`
`33`	`34`	`Debug.Log("ServerCertificateValidation");`
`34`		`- ServicePointManager.ServerCertificateValidationCallback = RemoteCertificateValidationCallback;`
	`35`	`+ ServicePointManager.ServerCertificateValidationCallback = RemoteCertificateValidationCallback;`
`35`	`36`	`#endif`
`36`	`37`	`}`
`37`	`38`
`@@ -117,4 +118,4 @@ private bool RemoteCertificateValidationCallback(System.Object sender, X509Certi`
`117`	`118`	`#endif`
`118`	`119`
`119`	`120`	`}`
`120`		`-}`
	`121`	`+}`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`	`using System.Collections;`
`3`	`3`	`using RestSharp;`
`4`	`4`
`5`		`-namespace Unity3dAzure.MobileServices`
	`5`	`+namespace Unity3dAzure.AppServices`
`6`	`6`	`{`
`7`	`7`	`public class ZumoRequest : RestRequest`
`8`	`8`	`{`