注册Bmob帐号

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

网站后台创建应用

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

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

获取应用密钥

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

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

在跳转页面,获取Application IDREST 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. {
  4. private String fTable;
  5. //以下对应云端字段名称
  6. public BmobInt score { get; set; }
  7. public String playerName { get; set; }
  8. public BmobBoolean cheatMode { get; set; }
  9. //构造函数
  10. public GameObject() { }
  11. //构造函数
  12. public GameObject(String tableName)
  13. {
  14. this.fTable = tableName;
  15. }
  16. public override string table
  17. {
  18. get
  19. {
  20. if (fTable != null)
  21. {
  22. return fTable;
  23. }
  24. return base.table;
  25. }
  26. }
  27. //读字段信息
  28. public override void readFields(BmobInput input)
  29. {
  30. base.readFields(input);
  31. this.score = input.getInt("score");
  32. this.cheatMode = input.getBoolean("cheatMode");
  33. this.playerName = input.getString("playerName");
  34. }
  35. //写字段信息
  36. public override void write(BmobOutput output, bool all)
  37. {
  38. base.write(output, all);
  39. output.Put("score", this.score);
  40. output.Put("cheatMode", this.cheatMode);
  41. output.Put("playerName", this.playerName);
  42. }
  43. }

初始化AppKey

  • Windows

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

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

选中摄像机,把BmobUnity对象拖拽到摄像机上,然后再Properties选项卡中设置 ApplicationIdRestKey

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

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

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

添加一行数据

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

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

更多例子

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