注册Bmob帐号

在网址栏输入 www.bmob.cn 或者在百度输入“Bmob后端云”进行搜索，打开Bmob官网后，点击右上角的“注册”，在跳转页面填入你的姓名、邮箱、设置密码，确认后到你的邮箱激活Bmob账户，你就可以用Bmob轻松开发应用了。

网站后台创建应用

登录账号进入bmob后台后，点击后台界面左上角“创建应用”，在弹出框输入你应用的名称，然后确认，你就拥有了一个等待开发的应用。

数据服务 C# SDK 快速入门 - 图1

获取应用密钥

选择你要开发的应用，点击该应用下方对应的“应用密钥”

数据服务 C# SDK 快速入门 - 图2

在跳转页面，获取Application ID和REST API key，此IDs将会在初始化SDK中使用到。

数据服务 C# SDK 快速入门 - 图3

下载安装SDK

Bmob C# SDK下载地址：https://github.com/bmob/BmobSharp/releases

  • Windows

下载后解压，将Windows文件夹下的Bmob-Windows.dll文件引用到你的项目工程中，如下图所示。

数据服务 C# SDK 快速入门 - 图4

demo：bmob-desktop-demo

  • Unity

下载后解压，将Unity文件夹下的Bmob-Unity.dll文件放置到你的项目工程的 Assets/libs/ 目录下。

demo：bmob-unity-demo
开发环境(调试)搭建：请查询BmobSharp的README文档。

新建模型类

要想对Bmob云端的数据进行操作，需要创建和数据表对应的模型类。在Bmob中，模型类需要继承自BmobTable，类的实现如下。

  1. //Game表对应的模型类
  2. class GameObject : BmobTable
  3. {
  5.     private String fTable;
  6.     //以下对应云端字段名称
  7.     public BmobInt score { get; set; }
  8.     public String playerName { get; set; }
  9.     public BmobBoolean cheatMode { get; set; }
  11.     //构造函数
  12.     public GameObject() { }
  14.     //构造函数
  15.     public GameObject(String tableName)
  16.     {
  17.         this.fTable = tableName;
  18.     }
  20.     public override string table
  21.     {
  22.         get
  23.         {
  24.             if (fTable != null)
  25.             {
  26.                 return fTable;
  27.             }
  28.             return base.table;
  29.         }
  30.     }
  32.     //读字段信息
  33.     public override void readFields(BmobInput input)
  34.     {
  35.         base.readFields(input);
  37.         this.score = input.getInt("score");
  38.         this.cheatMode = input.getBoolean("cheatMode");
  39.         this.playerName = input.getString("playerName");
  40.     }
  42.     //写字段信息
  43.     public override void write(BmobOutput output, bool all)
  44.     {
  45.         base.write(output, all);
  47.         output.Put("score", this.score);
  48.         output.Put("cheatMode", this.cheatMode);
  49.         output.Put("playerName", this.playerName);
  50.     }
  51. }

初始化AppKey

  • Windows

在正式对Bmob后端云进行操作之前，需要先初始化AppKey/RestKey信息，也就是初始化之前获取的Application ID/RestKey信息，实现代码如下。

  1.         //创建Bmob实例
  2.         private BmobWindows bmob;
  4.         public BmobBaseForm()
  5.             : base()
  6.         {
  7.             bmob = new BmobWindows();
  9.             //初始化，这个ApplicationId/RestKey需要更改为你自己的ApplicationId/RestKey（ http://www.bmob.cn 上注册登录之后，创建应用可获取到ApplicationId/RestKey）
  10.             Bmob.initialize("4414150cb439afdf684d37dc184e0f9f", "e1deb317442129c125b228ddf78e5f22");
  12.             //注册调试工具
  13.             BmobDebug.Register(msg => { Debug.WriteLine(msg); });
  14.         }
  16.         public BmobWindows Bmob
  17.         {
  18.             get { return bmob; }
  19.         }
  • Unity

选中摄像机，把BmobUnity对象拖拽到摄像机上，然后再Properties选项卡中设置 ApplicationId 和 RestKey 。

数据服务 C# SDK 快速入门 - 图5

在脚本中启动方法中获取BmobUntiy：

  1.         private static BmobUnity Bmob;
  3.         // Use this for initialization
  4.         void Start ()
  5.         {
  6.                 BmobDebug.Register (print);
  7.                 BmobDebug.level = BmobDebug.Level.TRACE;
  8.                 Bmob = gameObject.GetComponent<BmobUnity> ();
  9.         }

添加一行数据

初始化AppKey之后，我们就可以对Bmob云数据库进行操作了。下面以添加一行数据为例进行说明，实现代码如下:

  1. //对应要操作的数据表
  2. public const String TABLE_NAME = "Game";
  3. //接下来要操作的数据的数据
  4. private GameObject gameObject = new GameObject(TABLE_NAME);
  6. private void createData_Click(object sender, EventArgs e)
  7. {
  8.     //设置值    
  9.     System.Random rnd = new System.Random();
  10.     gameObject.score = rnd.Next(-50, 170);
  11.     gameObject.playerName = "123";
  12.     gameObject.cheatMode = false;
  14.     //保存数据
  15.     var future = Bmob.CreateTaskAsync(gameObject);
  16.     //异步显示返回的数据
  17.     FinishedCallback(future.Result, resultText);
  18. }

更多例子

大家可详细查看示例源码和 SDK项目源码，了解更多的Bmob C# SDK for Windows的操作。