egret-docs-master/Engine2D/minigame/cloudapi
guofei 4fe0162b34 fist commit 2024-06-19 13:32:32 +08:00
..
README.md fist commit 2024-06-19 13:32:32 +08:00
p1.png fist commit 2024-06-19 13:32:32 +08:00
p2.png fist commit 2024-06-19 13:32:32 +08:00
p3.png fist commit 2024-06-19 13:32:32 +08:00
p4.png fist commit 2024-06-19 13:32:32 +08:00
p5.png fist commit 2024-06-19 13:32:32 +08:00
p6.png fist commit 2024-06-19 13:32:32 +08:00

README.md

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