APICloud在Unity中的使用

[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 Headers
    {
        get
        {
            Dictionary header = new Dictionary();
            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 header = new Dictionary();
        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 header = new Dictionary();
        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 header = new Dictionary();
        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记录在官网项目->概览->项目图标下拉按钮里头