Skip to main content

Client Engine 快速入门 · Node.js

该文档帮助你快速了解如何创建一个 Client Engine 项目,该项目是一个简单的双人剪刀石头布游戏,游戏逻辑的开发依赖于多人在线对战 JavaScript SDK。

我们在这篇文档中先了解如何本地启动项目,简单试玩一下,然后部署项目到云端。之后在开发指南中会介绍详细的游戏逻辑以及如何开发自己的游戏。

启动项目

安装命令行工具

请查看命令行工具安装部分的文档,安装命令行工具,并执行登录命令登录。

创建项目

从 Github 获取示例项目,请将该项目作为你的项目基础:

git clone https://github.com/leancloud/client-engine-nodejs-getting-started
cd client-engine-nodejs-getting-started

添加应用 App ID 等信息到该项目:

lean switch

在第一步选择 App 中,选择您的游戏对应的 LeanCloud 应用。在第二步选择云引擎分组时,必须选择 _client-engine 分组,LeanCloud 仅对该分组提供专门针对 Client Engine 的优化维护及各种支持,如图所示:

image

本地运行

首先在当前项目的目录下安装必要的依赖,执行如下命令行:

npm install

如果同时会使用到数据存储服务,执行如下命令:

npm install leancloud-storage

启动应用时打开调试日志:

DEBUG=ClientEngine*,RPS*,Play lean up

如果您不需要调试日志,可以直接使用以下命令启动:

lean up

启动后在浏览器中打开 http://localhost:3000/ ,检测项目是否正常启动。

访问站点

感受游戏

服务端项目启动完成后,如果希望体验 Demo 游戏,需要额外同时打开两个客户端示例 Demo页面,在这两个页面中做如下配置:

点击 Configs,APP_ID 、APP_KEY 和 PLAY_SERVER 填入之前选择的应用的 App ID 、App Key 及服务器地址:

# 如果您的浏览器已经登录 LeanCloud,请在下方选择相关应用,复制粘贴相关信息到 Configs 中:
APP_ID: "your-app-id"
APP_KEY: "your-app-key"

接着在 Client Engine Server 中输入 http://localhost:3000。如图所示:

image

信息填写完成后,点击「Login to Play」就可以开始游戏了。

客户端代码

如果您希望查看详细的客户端代码,可以访问位于 github 的客户端示例代码

部署到云端

部署至预备环境,在根目录中运行:

lean deploy --staging

在浏览器中登录 LeanCloud 控制台,绑定云引擎域名stg- 开头的自定义域名会被自动地绑定到预备环境),然后访问相应网址可以看到 Client Engine 服务端正在运行的文本。

其他详细的部署方式请参考命令行工具文档中的部署

你的第一个 Client Engine 小游戏

接下来请查看文档你的第一个 Client Engine 小游戏,了解如何根据该初始项目一步一步开发出来一个剪刀石头布小游戏。