使用数据库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 和数据库相关参数修改成您自己的才可以测试使用。