[TOC]
0.APICloud简介
- 可以利用它简单的搭建弱联网服务器,存储一些基本资料和
制作推送. - APICloud服务器:APICloud利用了又拍云和七牛云,制作了一个通用的Web服务器,并且开放了一些API让开发者使用.
- APICloud客户端:使用她提供的Html5 API制作跨平台客户端;这点我们暂时是用不到.
- APICloud官网: http://www.apicloud.com/
1.在Unity中使用APICloud
由于APICloud官方的C#的SDK使用了高版本的.net; mono的.net很多没有实现,所以在Unity中不能使用官方的SDK.
需要自己重新写,好再官网的文档还是很齐全的.
其中用到了LitJson,具体的使用可以看我的另一篇文章:在Unity中解析和封装Json
a.制作一个ApiCloudKey类用于生成验证Key
把其中的AppID和AppKey替换成你自己的就可以了
using UnityEngine;
using System.Collections;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text;
using LitJson;
public class ApiCloudKey {
public static string AppID = "A12345667890";
public static string AppKey = "AAAAAA01111-XXXX-XXXX-XXXX-XXXXXX";
public static string UrlPush = "https://p.apicloud.com/api/push/message";
public static string UrlMcm = "https://d.apicloud.com/mcm/api";
public static string X_APICloud_AppKey
{
get
{
long amp = (long)(System.DateTime.Now - new System.DateTime(1970, 01, 01)).TotalMilliseconds;
string value = AppID + "UZ" + AppKey + "UZ" + amp;
byte[] buffer = SHA1.Create().ComputeHash(Encoding.UTF8.GetBytes(value));
StringBuilder builder = new StringBuilder();
foreach (byte num in buffer)
{
builder.AppendFormat("{0:x2}", num);
}
return builder.ToString() + "." + amp;
}
}
public static Dictionary<string, string> Headers
{
get
{
Dictionary<string, string> header = new Dictionary<string, string>();
header["Content-Type"] = "application/json";
header["X-APICloud-AppId"] = AppID;
header["X-APICloud-AppKey"] = X_APICloud_AppKey;
return header;
}
}
}
b.制作一个ApiCloudMcm连接ApiCloud的Mcm服务(用户数据库)
using UnityEngine;
using System.Collections;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text;
using LitJson;
public class ApiCloudMcm {
//1 向服务器发送一个json以创建一个例，如果className=user,就会创建一个用户,如果是user，就必须有账号密码
public static WWW CreateNewInstance(string ClassName, string Body)
{
string url = ApiCloudKey.UrlMcm + "/" + ClassName;
byte[] postData = Encoding.UTF8.GetBytes(Body);
WWW www = new WWW(url, postData, ApiCloudKey.Headers);
return www;
}
//2 更新一个ID下的内容
public static WWW UpdateAttributeOfAinstanceByID(string ClassName, string Body, string ID)
{
string url = ApiCloudKey.UrlMcm + "/" + ClassName + "/" + ID;
byte[] postData = Encoding.UTF8.GetBytes(Body);
Dictionary<string, string> header = new Dictionary<string, string>();
header["X-HTTP-Method-Override"] = "PUT"; //(or PATCH, DELETE, GET, POST, etc)
header["Content-Type"] = "application/json";
header["X-APICloud-AppId"] = ApiCloudKey.AppID;
header["X-APICloud-AppKey"] = ApiCloudKey.X_APICloud_AppKey;
WWW www = new WWW(url, postData, header);
return www;
}
//4 检查某个ID是否存在
public static WWW CheckWhetherInstanceExist(string ClassName, string ID)
{
string url = ApiCloudKey.UrlMcm + "/" + ClassName + "/" + ID + "/exists";
WWW www = new WWW(url, null, ApiCloudKey.Headers);
return www;
}
//6获取一个实例的内容，用id获取
public static WWW FindInstanceByID(string ClassName, string ID)
{
string url = ApiCloudKey.UrlMcm + "/" + ClassName+"/"+ ID;
WWW www = new WWW(url, null, ApiCloudKey.Headers);
return www;
}
//7删除一个实例的内容，用id删除
public static WWW DeleteInstanceByID(string ClassName, string ID)
{
string url = ApiCloudKey.UrlMcm + "/" + ClassName + "/" + ID;
var data = new { _method = "DELETE"};
string strData = JsonMapper.ToJson(data);
byte[] postData = Encoding.UTF8.GetBytes(strData);
WWW www = new WWW(url, postData, ApiCloudKey.Headers);
return www;
}
//8 user登录
public static WWW LoginUser(string name, string word)
{
string url = ApiCloudKey.UrlMcm + "/user/login";
var data = new { username = name, password = word};
string strData = JsonMapper.ToJson(data);
byte[] postData = Encoding.UTF8.GetBytes(strData);
Dictionary<string, string> header = new Dictionary<string, string>();
header["X-HTTP-Method-Override"] = "POST"; //(or PATCH, DELETE, GET, POST, etc)
header["Content-Type"] = "application/json";
header["X-APICloud-AppId"] = ApiCloudKey.AppID;
header["X-APICloud-AppKey"] = ApiCloudKey.X_APICloud_AppKey;
WWW www = new WWW(url, postData, header);
return www;
}
//9 user登出/注销
public static WWW LogoutUser(string ID)
{
string url = ApiCloudKey.UrlMcm + "/user/logout";
Dictionary<string, string> header = new Dictionary<string, string>();
header["Content-Type"] = "application/json";
header["authorization"] = ID;
header["X-APICloud-AppId"] = ApiCloudKey.AppID;
header["X-APICloud-AppKey"] = ApiCloudKey.X_APICloud_AppKey;
WWW www = new WWW(url, null, ApiCloudKey.Headers);
return www;
}
}
c.使用ApiCloudMcm中的方法和服务器进行交互
void Start () {
WWW www = ApiCloudMcm.CreateNewInstance("user", jsobj.userDataString);
StartCoroutine(CallBack(www));
}
IEnumerator CallBack(WWW www){
yield return www;
Debug.Log (www.text);
//自行解析www.text做各种数据判断和处理
}
2.可能会遇到的坑
- 如果访问不了云上user类的内容,很可能是user类的一些权限没打开(默认是每个用户需要登录才能使用),去官网项目中暂时开启权限,方便调试.
- 如果user类无法注册新用户,而官网的测试API却可以,很可能是官网项目中->云开发->云设置 开启注册用户邮箱验证,关闭它.
- AppID和AppKey记录在官网项目->概览->项目图标下拉按钮里头
