跳到主要内容

使用数据库API

微信小游戏数据库API

“小程序·云开发”是微信团队和腾讯云联合打造的“应用服务中台”。秉承高效、易用、安全、低成本的服务理念，为开发者提供稳定高性能的服务。“小程序·云开发”整合了微信公众平台和腾讯云的核心技术，提供云数据库、云存储、云函数、日志和监控等开发运维能力。通过“小程序·云开发”，开发者可无缝安全调用小程序的开放服务，提升开发效率，快速试错和落地产品。

“小程序·云开发”近期新推出的实时数据推送能力，可满足回合制游戏、聊天室、世界消息等小游戏场景需求，具备多端实时数据同步能力，让小游戏开发更高效便捷。

开发者可以在微信小游戏里直接调用API，就可以操作数据库的读写存储等功能，无需搭建服务器。提高开发效率，节约成本。 云开发介绍 数据库操作API

一.使用前准备：开通云开发功能​

  • 1.创建一个新的小游戏项目，勾选 小程序.云开发。 注意：不能使用测试号

  • 2.在左上方的工具栏里点击云开发

  • 3.在弹出的面板里点击开通,后续配置一些参数

  • 4.云开发功能开通完成后，在老项目的 project.config.json 中增加一个字段 "cloudfunctionRoot": "cloudfunction/"，指定云函数的本地目录

二.设置数据库​

  • 1.打开云开发控制台 -> 数据库 -> + 创建一个名为 logs 的集合名称。
  • 2.点击 添加记录，使用系统自动生成的 id 创建一条记录。这个 id 在代码中会使用到。
  • 3.点击 添加字段，字段名称为 content，类型为 array
  • 4.切换到 权限设置面板，把权限设置为 所有用户可读，仅创建者可读写

三.创建云函数​

因为数据库的权限问题，普通用户要想写入数据，必须使用云函数

  • 1.首先在微信小游戏项目中创建一个 cloudfunction 文件夹，就是我们刚才在 project.config.json 中配置的。然后在微信开发者工具中右键单击这个文件夹,选择 新建 Node.js 云函数，然后创建一个名为 addLog 的云函数文件夹

  • 2.将 addLog 文件夹内的 index.js 代码修改如下：
// 云函数入口文件
const cloud =  require("wx-server-sdk");
cloud.init();
// 云函数入口函数
exports.main  =  async  (event, context)  =>  {
  let newValue = event.value;
  //获取数据库的引用
  const db = cloud.database();
  //获取数据库中的数组
  let oldData =  await db.collection("logs").doc("9390f2ff-0318-4826-87d8-78bf31568cab").get();
  //获取内容的数组
  let content = oldData.data.content;
  //加入新的数据
  content.push(newValue);
  //更新服务器上的数据
  let newData =  await db.collection("logs").doc("9390f2ff-0318-4826-87d8-78bf31568cab").update({
    data:  {
        content: content
    }
  });
  return newData;
};
  • 3.右键在 addLog 文件夹上点击 上传并部署：云端安装依赖

四.代码调用​

  • 1.增加服务器上的数据，只要调用刚才创建的 addLog 云函数就可以了。
wx.cloud.callFunction({
    name:  "addLog",
    data:  {
    value:  "abc"  +  Math.floor(Math.random()  *  100)
  },
  success:  function  (res):  any  {
    console.log("增加信息成功", res.result);
  },
  fail:  function  (err):  any  {
    console.log("err", err);
  }
});
  • 2.获取服务器上的数据
const db = wx.cloud.database();
db.collection("logs").doc("9390f2ff-0318-4826-87d8-78bf31568cab").get().then(res  =>  {
  console.log("获取数据", res.data.content);
});

本示例演示了如何增加和查询数据，前端调用 API 即可，不需要后端的开发工作，简化了开发流程。

访问官网查询更多的数据库操作API

本示例Demo的下载地址 需要将里面的 appID 和数据库相关参数修改成您自己的才可以测试使用。