基于 Ubuntu 搭建微信小程序服务
目錄
準備域名和證書搭建小程序開發(fā)環(huán)境搭建 HTTP 服務搭建 HTTPS 服務小程序會話WebSocket 服務剪刀石頭布小游戲
準備域名和證書
任務時間:20min ~ 40min
小程序后臺服務需要通過 HTTPS 訪問,在實驗開始之前,我們要準備域名和 SSL 證書。
域名注冊
如果您還沒有域名,可以在騰訊云上選購,過程可以參考下面的視頻:
- 視頻 - 在騰訊云上購買域名
域名解析
域名購買完成后, 需要將域名解析到實驗云主機上,實驗云主機的 IP 為:
<您的 CVM IP 地址>在騰訊云購買的域名,可以到控制臺添加解析記錄,過程可參考下面的視頻:
- 視頻 - 如何在騰訊云上解析域名
域名設置解析后需要過一段時間才會生效,通過?ping?命令檢查域名是否生效?[?],如:
ping www.yourmpdomain.com如果 ping 命令返回的信息中含有你設置的解析的 IP 地址,說明解析成功。
注意替換下面命令中的?www.yourmpdomain.com?為您自己的注冊的域名
申請 SSL 證書
騰訊云提供了 SSL 證書的免費申請,申請方式可參考下面視頻:
- 視頻 - 在騰訊云上申請 SSL 證書
申請?zhí)峤缓?#xff0c;審批結果會以短信的形式通知。審批通過后,可以到?SSL 控制臺下載您的證書文件,可參考下面的視頻:
- 視頻 - 在騰訊云上下載 SSL 證書
搭建小程序開發(fā)環(huán)境
任務時間:15min ~ 30min
在開始搭建我們的小程序服務器之前,需要先完成客戶端小程序開發(fā)環(huán)境的搭建。
注冊開發(fā)者賬號
如果你還不是小程序開發(fā)者,請先在微信公眾平臺并注冊:
具體注冊流程可參考如下視頻:
- 視頻 - 注冊開發(fā)者賬號
若您已注冊,請點擊下一步。
配置小程序服務器信息
登錄微信公眾平臺后,依次進入?設置?-?開發(fā)設置?-?服務器域名?-?修改。
掃碼完成身份校驗后,request 合法域名和 socket 合法域名均填寫在上一步準備好的域名地址。
配置完成后,點擊?保存并提交。您可以點擊如下視頻查看如何進行配置:
- 視頻 - 配置小程序服務器信息
運行配套小程序代碼
要運行本實驗配套的小程序代碼,請下載下列資源:
- 實驗配套源碼
- 微信小程序開發(fā)工具
源碼下載后,請解壓到本地工作目錄。
開發(fā)工具下載后,請安裝并啟動,然后用微信掃碼登錄。
登錄后,選擇?本地小程序項目?-?添加項目,使用以下配置:
- AppID:填寫小程序的 AppID,請登錄公眾平臺后在?設置?-?開發(fā)設置?-?開發(fā)者 ID?中查看
- 項目名稱:填寫任意您喜歡的名稱
- 項目目錄:選擇剛才解壓的配套源碼目錄(目錄包含?app.js)
填寫完成后,點擊?添加項目。具體操作可查看如下視頻:
- 視頻 - 運行配套小程序代碼
設置實驗域名
在開發(fā)工具的?編輯?面板中,選中?app.js?進行編輯,需要修改小程序通信域名[?],請參考下面的配置:
App({config: {host: 'www.yourdomain.com' // 這個地方填寫你的域名},onLaunch () {console.log('App.onLaunch()');} });當然,這步操作也錄制了對應的視頻:
- 視頻 - 設置實驗域名
實驗配套源碼所用通信域名都會使用該設置,為了您順利進行實驗,請把域名修改為之前步驟準備的域名
搭建 HTTP 服務
任務時間:15min ~ 30min
下面的步驟,將帶大家在服務器上使用 Node 和 Express 搭建一個 HTTP 服務器
安裝 NodeJS
使用下面的命令安裝 NodeJS
sudo apt-get update sudo wget https://mc.qcloudimg.com/static/archive/262420521a966befe17dfa0070ddb272/node-v6.11.0.tar.gz sudo tar xvf node-v6.11.0.tar.gz cd node-v6.11.0 sudo ./configure sudo make sudo make install sudo cp /usr/local/bin/node /usr/sbin/安裝完成后,使用下面的命令測試安裝結果
node -v編寫 HTTP Server 源碼
使用下面的命令在服務器創(chuàng)建一個工作目錄:
sudo mkdir -p /data/release/webapp進入此工作目錄
cd /data/release/webapp在工作目錄創(chuàng)建 package.json 文件,并修改文件的訪問權限。
sudo touch package.json sudo chmod a+r+w package.json修改 package.json?添加我們服務器包的名稱和版本號,可參考下面的示例。
示例代碼:/data/release/webapp/package.json
{"name": "webapp","version": "1.0.0" }完成后,使用?Ctrl + S?保存文件
在工作目錄創(chuàng)建 app.js
cd /data/release/webapp sudo touch app.js sudo chmod a+rw app.js修改 app.js 文件,使用 Express.js 來監(jiān)聽?8765?端口[?],app.js文件可參考下面的示例代碼。
示例代碼:/data/release/webapp/app.js
// 引用 express 來支持 HTTP Server 的實現(xiàn) const express = require('express');// 創(chuàng)建一個 express 實例 const app = express();// 實現(xiàn)唯一的一個中間件,對于所有請求,都輸出 "Response from express" app.use((request, response, next) => {response.write('Response from express');response.end(); });// 監(jiān)聽端口,等待連接 const port = 8765; app.listen(port);// 輸出服務器啟動日志 console.log(`Server listening at http://127.0.0.1:${port}`);本實驗會以 8765 端口的打開作為實驗步驟完成的依據(jù),為了后面的實驗步驟順利進行,請不要使用其它端口號
運行 HTTP 服務
在開始之前,我們先來安裝?[PM2]
sudo apt-get install npm sudo npm install -g pm2PM2 安裝時間可能稍長,請耐心等候?[?]
我們的服務器源碼里使用到了 Express 模塊,下面的命令使用 NPM 來安裝 Express
cd /data/release/webapp sudo npm install express --save安裝完成后,使用 PM2 來啟動 HTTP 服務
cd /data/release/webapp pm2 start app.js現(xiàn)在,您的 HTTP 服務已經(jīng)在?http://<您的 CVM IP 地址>:8765?運行
要查看服務輸出的日志,可以使用下面的命令:
pm2 logs如果要重啟服務,可以使用下面的命令:
pm2 restart app我們使用 PM2 來進行 Node 進程的運行、監(jiān)控和管理
NPM 倉庫在國內訪問速度可能不太理想,如果實在太慢可以嘗試使用 CNPM 的 Registry 進行安裝:npm install pm2 -g --registry=https://r.cnpmjs.org/
搭建 HTTPS 服務
任務時間:15min ~ 30min
微信小程序要求和服務器的通信都通過 HTTPS 進行
安裝 Nginx
在 Ubuntu 上,可直接使用?apt-get?來安裝 Nginx
sudo apt-get install nginx -y安裝完成后,使用?nginx?命令啟動 Nginx:
sudo /etc/init.d/nginx start此時訪問?http://<您的域名>?可以看到 Nginx 測試頁面?[?]
如果你的機器同時安裝了其他軟件占用80端口,那上面的訪問方式就不能使用了,而且 Nginx 都可能啟動不了,你需要關閉該軟件再重新啟動 Nginx。
配置 HTTPS 反向代理
修改 /etc/nginx 目錄的讀寫權限
sudo chmod a+rw /etc/nginx將之前下載的 SSL 證書(解壓后 Nginx 目錄分別以 crt 和 key 作為后綴的文件)通過拖動到左側文件瀏覽器 /etc/nginx 目錄的方式來上傳文件到服務器上。
如何上傳 SSL 證書到 /etc/nginx 目錄
在 /etc/nginx/conf.d 目錄創(chuàng)建 ssl.conf 文件
cd /etc/nginx/conf.d sudo touch ssl.conf sudo chmod a+rw ssl.conf將?ssl.conf 文件修改為如下內容
示例代碼:/etc/nginx/conf.d/ssl.conf
server {listen 443;server_name www.example.com; # 改為綁定證書的域名# ssl 配置ssl on;ssl_certificate 1_www.example.com_bundle.crt; # 改為自己申請得到的 crt 文件的名稱ssl_certificate_key 2_www.example.com.key; # 改為自己申請得到的 key 文件的名稱ssl_session_timeout 5m;ssl_protocols TLSv1 TLSv1.1 TLSv1.2;ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;ssl_prefer_server_ciphers on;location / {proxy_pass http://127.0.0.1:8765;}}按?Ctrl + S?保存配置文件,讓 Nginx 重新加載配置使其生效:
sudo nginx -s reload在瀏覽器通過 https 的方式訪問你解析的域名來測試 HTTPS 是否成功啟動
在小程序中測試 HTTPS 訪問
打開配套的小程序,點擊?實驗一:HTTPS,點擊?發(fā)送請求?來測試訪問結果。
如果服務器響應成功,請點擊下一步。
小程序會話
任務時間:45min ~ 90min
小程序不支持 Cookie 存儲和跟蹤,服務器需要自行實現(xiàn)會話層
安裝 MongoDB
使用 apt-get 在機器上安裝?[MongoDB]?及其客戶端命令行工具:
sudo apt-get install mongodb-server mongodb -y安裝結束后,可以使用下面的命令查看安裝的版本:
sudo mongod --version sudo mongo --versionMongoDB 是一款 NoSQL 數(shù)據(jù)庫,支持 JSON 格式的結構化文檔存儲和查詢,對 JavaScript 有著友好的支持
啟動 MongoDB
創(chuàng)建目錄,用于 MongoDB 數(shù)據(jù)和日志存儲:
sudo mkdir -p /data/mongodb sudo mkdir -p /data/logs/mongodb創(chuàng)建后,使用下面的命令來啟動 MongoDB:[?]
sudo mongod --fork --dbpath /data/mongodb --logpath /data/logs/mongodb/webapp.log可以使用下面的命令來檢查是否啟動成功?[?]
netstat -ltp | grep 27017MongoDB 首次啟動可能會花費大概 1min 時間,請耐心等待
MongoDB 默認監(jiān)聽 27017 端口等待連接,下面的命令查看當前 27017 端口被哪個進程占用,如果是 MongoDB 的進程,則表示啟動成功。
添加 MongoDB 用戶
登錄本地 MongoDB 服務:
sudo mongo登錄后,創(chuàng)建一個用戶?webapp?[?]:
use webapp; db.createUser({ user: 'webapp', pwd: 'webapp-dev', roles: ['dbAdmin', 'readWrite']});創(chuàng)建完成后,使用?exit?退出命令行工具。
創(chuàng)建的用戶和密碼將用于下一步中連接數(shù)據(jù)庫時使用,如果使用不同的用戶或密碼,注意要保存好
安裝 Node 模塊
實現(xiàn)小程序的會話功能,我們需要安裝?[connect-mongo]?和?[wafer-node-session]
cd /data/release/webapp sudo npm install connect-mongo wafer-node-session --saveconnect-mongo?模塊通過連接到 MongoDB 為會話提供存儲
wafer-node-session?是由騰訊云提供的獨立小程序會話管理中間件
實現(xiàn)小程序會話
在工作目錄創(chuàng)建配置文件 config.js,用于保存我們服務所用的配置[?].
cd /data/release/webapp sudo touch config.js sudo chmod a+rw config.js修改配置文件 config.js,可參考下面的實現(xiàn)(注:請將參考配置文件中的 YORU_APP_ID 和 YOUR_APP_SECRET 替換為你申請的小程序對應的 AppID 和 AppSecret):
示例代碼:/data/release/webapp/config.js
module.exports = { serverPort: '8765', // 小程序 appId 和 appSecret // 請到 https://mp.weixin.qq.com 獲取 AppID 和 AppSecretappId: 'YORU_APP_ID', appSecret: 'YOUR_APP_SECRET', // mongodb 連接配置,生產(chǎn)環(huán)境請使用更復雜的用戶名密碼mongoHost: '127.0.0.1', mongoPort: '27017', mongoUser: 'webapp', mongoPass: 'webapp-dev', mongoDb: 'webapp' };編輯 app.js,添加會話實現(xiàn)邏輯,可參考下面的代碼:
示例代碼:/data/release/webapp/app.js
// 引用 express 來支持 HTTP Server 的實現(xiàn) const express = require('express'); // 引用 wafer-session 支持小程序會話 const waferSession = require('wafer-node-session'); // 使用 MongoDB 作為會話的存儲 const MongoStore = require('connect-mongo')(waferSession); // 引入配置文件 const config = require('./config'); // 創(chuàng)建一個 express 實例 const app = express();// 添加會話中間件,登錄地址是 /login app.use(waferSession({ appId: config.appId, appSecret: config.appSecret, loginPath: '/login',store: new MongoStore({ url: `mongodb://${config.mongoUser}:${config.mongoPass}@${config.mongoHost}:${config.mongoPort}/${config.mongoDb}` }) })); // 在路由 /me 下,輸出會話里包含的用戶信息 app.use('/me', (request, response, next) => { response.json(request.session ? request.session.userInfo : { noBody: true }); if (request.session) {console.log(`Wafer session success with openId=${request.session.userInfo.openId}`);} }); // 實現(xiàn)一個中間件,對于未處理的請求,都輸出 "Response from express" app.use((request, response, next) => {response.write('Response from express');response.end(); });// 監(jiān)聽端口,等待連接 app.listen(config.serverPort);// 輸出服務器啟動日志 console.log(`Server listening at http://127.0.0.1:${config.serverPort}`);源碼編寫完成后,重啟服務:
pm2 restart app重啟后,使用配套的小程序完成會話測試:打開配套小程序 - 點擊?實驗二:會話?-?獲取會話,如果您能看到您的微信頭像,那就表示會話已經(jīng)成功獲取了。
隨著服務變得復雜,我們可以把配置集中起來方便管理,比如目前我們需要保存:服務器運行端口、小程序配置、MongoDB 連接配置
WebSocket 服務
任務時間:45min ~ 90min
安裝 ws 模塊
本實驗使用?ws?模塊來在服務器上支持 WebSocket 協(xié)議,下面使用 NPM 來安裝:
cd /data/release/webapp sudo apt-get install npm -y sudo npm install --save ws實現(xiàn) WebSocket 服務器
創(chuàng)建 websocket.js 文件,實現(xiàn) WebSocket 服務
cd /data/release/webapp sudo touch websocket.js sudo chmod a+rw websocket.js修改 websocket.js 文件,可參考下面的代碼:
示例代碼:/data/release/webapp/websocket.js
// 引入 ws 支持 WebSocket 的實現(xiàn) const ws = require('ws');// 導出處理方法 exports.listen = listen;/*** 在 HTTP Server 上處理 WebSocket 請求* @param {http.Server} server* @param {wafer.SessionMiddleware} sessionMiddleware*/ function listen(server, sessionMiddleware) {// 使用 HTTP Server 創(chuàng)建 WebSocket 服務,使用 path 參數(shù)指定需要升級為 WebSocket 的路徑const wss = new ws.Server({ server, path: '/ws' });// 監(jiān)聽 WebSocket 連接建立wss.on('connection', (ws,request) => {// 要升級到 WebSocket 協(xié)議的 HTTP 連接// 被升級到 WebSocket 的請求不會被 express 處理,// 需要使用會話中間節(jié)獲取會話sessionMiddleware(request, null, () => {const session = request.session;if (!session) {// 沒有獲取到會話,強制斷開 WebSocket 連接ws.send(JSON.stringify(request.sessionError) || "No session avaliable");ws.close();return;}// 保留這個日志的輸出可讓實驗室能檢查到當前步驟是否完成console.log(`WebSocket client connected with openId=${session.userInfo.openId}`);serveMessage(ws, session.userInfo);});});// 監(jiān)聽 WebSocket 服務的錯誤wss.on('error', (err) => {console.log(err);}); }/*** 進行簡單的 WebSocket 服務,對于客戶端發(fā)來的所有消息都回復回去*/ function serveMessage(ws, userInfo) {// 監(jiān)聽客戶端發(fā)來的消息ws.on('message', (message) => {console.log(`WebSocket received: ${message}`);ws.send(`Server: Received(${message})`);});// 監(jiān)聽關閉事件ws.on('close', (code, message) => {console.log(`WebSocket client closed (code: ${code}, message: ${message || 'none'})`);});// 連接后馬上發(fā)送 hello 消息給會話對應的用戶ws.send(`Server: 恭喜,${userInfo.nickName}`); }編輯 app.js,調用 WebSocket 服務,可參考下面代碼:
示例代碼:/data/release/webapp/app.js
// HTTP 模塊同時支持 Express 和 WebSocket const http = require('http'); // 引用 express 來支持 HTTP Server 的實現(xiàn) const express = require('express'); // 引用 wafer-session 支持小程序會話 const waferSession = require('wafer-node-session'); // 使用 MongoDB 作為會話的存儲 const MongoStore = require('connect-mongo')(waferSession); // 引入配置文件 const config = require('./config'); // 引入 WebSocket 服務實現(xiàn) const websocket = require('./websocket');// 創(chuàng)建一個 express 實例 const app = express();// 獨立出會話中間件給 express 和 ws 使用 const sessionMiddleware = waferSession({appId: config.appId,appSecret: config.appSecret,loginPath: '/login',store: new MongoStore({url: `mongodb://${config.mongoUser}:${config.mongoPass}@${config.mongoHost}:${config.mongoPort}/${config.mongoDb}`}) }); app.use(sessionMiddleware);// 在路由 /me 下,輸出會話里包含的用戶信息 app.use('/me', (request, response, next) => { response.json(request.session ? request.session.userInfo : { noBody: true }); if (request.session) {console.log(`Wafer session success with openId=${request.session.userInfo.openId}`);} }); // 實現(xiàn)一個中間件,對于未處理的請求,都輸出 "Response from express" app.use((request, response, next) => {response.write('Response from express');response.end(); });// 創(chuàng)建 HTTP Server 而不是直接使用 express 監(jiān)聽 const server = http.createServer(app);// 讓 WebSocket 服務在創(chuàng)建的 HTTP 服務器上監(jiān)聽 websocket.listen(server, sessionMiddleware);// 啟動 HTTP 服務 server.listen(config.serverPort);// 輸出服務器啟動日志 console.log(`Server listening at http://127.0.0.1:${config.serverPort}`);修改完成后,按?Ctrl + S?保存文件,并重啟服務:
pm2 restart app更新 Nginx 代理
編輯 Nginx 配置 ssl.conf,添加 WebSocket 支持,可參考下面的配置(注:請將參考配置文件中的 www.example.com 替換為前面步驟申請的域名,將 1_www.example.com_bundle.crt 和 2_www.example.com.key 替換為前面步驟申請并上傳的 SSL 證書的名稱):
示例代碼:/etc/nginx/conf.d/ssl.conf
# WebSocket 配置 map $http_upgrade $connection_upgrade {default upgrade;'' close; }server {listen 443;server_name www.example.com; # 改為綁定證書的域名# ssl 配置ssl on;ssl_certificate 1_www.example.com_bundle.crt; # 改為自己申請得到的 crt 文件的名稱ssl_certificate_key 2_www.example.com.key; # 改為自己申請得到的 key 文件的名稱ssl_session_timeout 5m;ssl_protocols TLSv1 TLSv1.1 TLSv1.2;ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;ssl_prefer_server_ciphers on;# WebSocket 配置proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection $connection_upgrade;location / {proxy_pass http://127.0.0.1:8765;}}配置完成后,按?Ctrl + S?保存,并且通知 Nginx 進程重新加載配置:
sudo nginx -s reload測試 WebSocket
打開配套的小程序,點擊?實驗三:WebSocket。進入測試頁面后,點擊?連接?按鈕,如果出現(xiàn)連接成功的提示,表示 WebSocket 服務已經(jīng)正常運行,可以收發(fā)消息。
剪刀石頭布小游戲
任務時間:45min ~ 90min
實現(xiàn)游戲房間邏輯
創(chuàng)建 /data/release/webapp/game 目錄用于存放剪刀石頭布小游戲的代碼
sudo mkdir -p /data/release/webapp/game添加 game/Room.js 實現(xiàn)游戲房間邏輯[?]
cd /data/release/webapp/game sudo touch Room.js sudo chmod a+rw Room.js修改 game/Room.js,可參考下面的代碼:
示例代碼:/data/release/webapp/game/Room.js
/** enum GameChoice {// 剪刀Scissors = 1,// 石頭Rock = 2,// 布Paper = 3 } */ function judge(choice1, choice2) {// 和局if (choice1 == choice2) return 0;// Player 1 沒出,Player 2 勝出if (!choice1) return 1;// Player 2 沒出,Player 1 勝出if (!choice2) return -1;// 都出了就這么算return (choice1 - choice2 + 3) % 3 == 1 ? -1 : 1; }/** @type {Room[]} */ const globalRoomList = [];// 每個房間最多兩人 const MAX_ROOT_MEMBER = 2;// 游戲時間,單位秒 const GAME_TIME = 3;let nextRoomId = 0;/** 表示一個房間 */ module.exports = class Room {/** 獲取所有房間 */static all() {return globalRoomList.slice();}/** 獲取有座位的房間 */static findRoomWithSeat() {return globalRoomList.find(x => !x.isFull());}/** 創(chuàng)建新房間 */static create() {const room = new Room();globalRoomList.unshift(room);return room;}constructor() {this.id = `room${nextRoomId++}`;this.players = [];}/** 添加玩家 */addPlayer(player) {const { uid, uname } = player.user;console.log(`Player ${uid}(${uname}) enter ${this.id}`);this.players.push(player);if (this.isFull()) {this.startGame();}}/** 刪除玩家 */removePlayer(player) {const { uid, uname } = player.user;console.log(`Player ${uid}(${uname}) leave ${this.id}`);const playerIndex = this.players.indexOf(player);if (playerIndex != -1) {this.players.splice(playerIndex, 1);}if (this.players.length === 0) {console.log(`Room ${this.id} is empty now`);const roomIndex = globalRoomList.indexOf(this);if (roomIndex > -1) {globalRoomList.splice(roomIndex, 1);}}}/** 玩家已滿 */isFull() {return this.players.length == MAX_ROOT_MEMBER;}/** 開始游戲 */startGame() {// 保留這行日志輸出可以讓實驗室檢查到實驗的完成情況console.log('game started!');// 當局積分清零this.players.forEach(player => player.gameData.roundScore = 0);// 集合玩家用戶和游戲數(shù)據(jù)const players = this.players.map(player => Object.assign({}, player.user, player.gameData));// 通知所有玩家開始for (let player of this.players) {player.send('start', {gameTime: GAME_TIME,players});}// 計時結束setTimeout(() => this.finishGame(), GAME_TIME * 1000);}/** 結束游戲 */finishGame() {const players = this.players;// 兩兩對比算分for (let i = 0; i < MAX_ROOT_MEMBER; i++) {let p1 = players[i];if (!p1) break;for (let j = i + 1; j < MAX_ROOT_MEMBER; j++) {let p2 = players[j];const result = judge(p1.gameData.choice, p2.gameData.choice);p1.gameData.roundScore -= result;p2.gameData.roundScore += result;}}// 計算連勝獎勵for (let player of players) {const gameData = player.gameData;// 勝局積分if (gameData.roundScore > 0) {gameData.winStreak++;gameData.roundScore *= gameData.winStreak;}// 敗局清零else if (gameData.roundScore < 0) {gameData.roundScore = 0;gameData.winStreak = 0;}// 累積總分gameData.totalScore += gameData.roundScore;}// 計算結果const result = players.map(player => {const { uid } = player.user;const { roundScore, totalScore, winStreak, choice } = player.gameData;return { uid, roundScore, totalScore, winStreak, choice };});// 通知所有玩家游戲結果for (let player of players) {player.send('result', { result });}} }處理游戲開始、計算結果、積分等邏輯
實現(xiàn)玩家邏輯
添加 game/Player.js
cd /data/release/webapp/game sudo touch Player.js sudo chmod a+rw Player.js修改 game/Player.js,實現(xiàn)玩家邏輯[?],可參考下面的代碼:
示例代碼:/data/release/webapp/game/Player.js
const Room = require("./Room");/*** 表示一個玩家,處理玩家的公共游戲邏輯,消息處理部分需要具體的玩家實現(xiàn)(請參考 ComputerPlayer 和 HumanPlayer)*/ module.exports = class Player {constructor(user) {this.id = user.uid;this.user = user;this.room = null;this.gameData = {// 當前的選擇(剪刀/石頭/布)choice: null,// 局積分roundScore: 0,// 總積分totalScore: 0,// 連勝次數(shù)winStreak: 0};}/*** 上線當前玩家,并且異步返回給玩家分配的房間*/online(room) {// 處理玩家 'join' 消息// 為玩家尋找一個可用的房間,并且異步返回this.receive('join', () => {if (this.room) {this.room.removePlayer(this);}room = this.room = room || Room.findRoomWithSeat() || Room.create();room.addPlayer(this);});// 處理玩家 'choise' 消息// 需要記錄玩家當前的選擇,并且通知到房間里的其它玩家this.receive('choice', ({ choice }) => {this.gameData.choice = choice;this.broadcast('movement', {uid: this.user.uid,movement: "choice"});});// 處理玩家 'leave' 消息// 讓玩家下線this.receive('leave', () => this.offline);}/*** 下線當前玩家,從房間離開*/offline() {if (this.room) {this.room.removePlayer(this);this.room = null;}this.user = null;this.gameData = null;}/*** 發(fā)送指定消息給當前玩家,需要具體子類實現(xiàn)* @abstract* @param {string} message 消息類型* @param {*} data 消息數(shù)據(jù)*/send(message, data) {throw new Error('Not implement: AbstractPlayer.send()');}/*** 處理玩家發(fā)送的消息,需要具體子類實現(xiàn)* @abstract* @param {string} message 消息類型* @param {Function} handler*/receive(message, handler) {throw new Error('Not implement: AbstractPlayer.receive()');}/*** 給玩家所在房間里的其它玩家發(fā)送消息* @param {string} message 消息類型* @param {any} data 消息數(shù)據(jù)*/broadcast(message, data) {if (!this.room) return;this.others().forEach(neighbor => neighbor.send(message, data));}/*** 獲得玩家所在房間里的其他玩家*/others() {return this.room.players.filter(player => player != this);} }處理玩家加入游戲、選擇出拳、通知其他玩家等邏輯
實現(xiàn)電腦玩家
在實現(xiàn)人類玩家之前,我們先來創(chuàng)建 ComputerPlayer.js 來實現(xiàn)電腦玩家[?]
cd /data/release/webapp/game sudo touch ComputerPlayer.js sudo chmod a+rw ComputerPlayer.js修改 ComputerPlayer.js?實現(xiàn)電腦玩家
示例代碼:/data/release/webapp/game/ComputerPlayer.js
const EventEmitter = require('events'); const Player = require('./Player');let nextComputerId = 0;/*** 機器人玩家實現(xiàn),使用 EventEmitter 接收和發(fā)送消息*/ module.exports = class ComputerPlayer extends Player {constructor() {const computerId = `robot-${++nextComputerId}`;super({uid: computerId,uname: computerId,uavatar: 'http://www.scoutiegirl.com/wp-content/uploads/2015/06/Blue-Robot.png'});this.emitter = new EventEmitter();}/*** 模擬玩家行為*/simulate() {this.receive('start', () => this.play());this.receive('result', () => this.stop());this.send('join');}/*** 游戲開始后,隨機時間后隨機選擇*/play() {this.playing = true;const randomTime = () => Math.floor(100 + Math.random() * 2000);const randomChoice = () => {if (!this.playing) return;this.send("choice", {choice: Math.floor(Math.random() * 10000) % 3 + 1});setTimeout(randomChoice, randomTime());}setTimeout(randomChoice, 10);}/*** 游戲結束后,標記起來,阻止繼續(xù)隨機選擇*/stop() {this.playing = false;}/*** 發(fā)送消息給當前玩家,直接轉發(fā)到 emitter*/send(message, data) {this.emitter.emit(message, data);}/*** 從當前的 emitter 處理消息*/receive(message, handle) {this.emitter.on(message, handle);} }測試游戲邏輯的時候,可能沒有其它人可以一起參與,實現(xiàn)一個電腦玩家是不錯的選擇
實現(xiàn)人類玩家
人類玩家通過 WebSocket 信道來實現(xiàn)玩家的輸入輸出[?],我們需要添加 game/Tunnel.js 和 game/HumanPlayer.js 來實現(xiàn)人類玩家邏輯,可參考下面的代碼:
cd /data/release/webapp/game sudo touch Tunnel.js sudo touch HumanPlayer.js sudo chmod a+rw Tunnel.js sudo chmod a+rw HumanPlayer.js修改 game/Tunnel.js 文件
示例代碼:/data/release/webapp/game/Tunnel.js
const EventEmitter = require('events');/*** 封裝 WebSocket 信道*/ module.exports = class Tunnel {constructor(ws) {this.emitter = new EventEmitter();this.ws = ws;ws.on('message', packet => {try {// 約定每個數(shù)據(jù)包格式:{ message: 'type', data: any }const { message, data } = JSON.parse(packet);this.emitter.emit(message, data);} catch (err) {console.log('unknown packet: ' + packet);}});}on(message, handle) {this.emitter.on(message, handle);}emit(message, data) {this.ws.send(JSON.stringify({ message, data }));} }修改 game/HumanPlayer.js 文件
示例代碼:/data/release/webapp/game/HumanPlayer.js
const co = require('co'); const Player = require('./Player'); const ComputerPlayer = require('./ComputerPlayer'); const Tunnel = require('./Tunnel');/*** 人類玩家實現(xiàn),通過 WebSocket 信道接收和發(fā)送消息*/ module.exports = class HumanPlayer extends Player {constructor(user, ws) {super(user);this.ws = ws;this.tunnel = new Tunnel(ws);this.send('id', user);}/*** 人類玩家上線后,還需要監(jiān)聽信道關閉,讓玩家下線*/online(room) {super.online(room);this.ws.on('close', () => this.offline());// 人類玩家請求電腦玩家this.receive('requestComputer', () => {const room = this.room;while(room && !room.isFull()) {const computer = new ComputerPlayer();computer.online(room);computer.simulate();}});}/*** 下線后關閉信道*/offline() {super.offline();if (this.ws && this.ws.readyState == this.ws.OPEN) {this.ws.close();}this.ws = null;this.tunnel = null;if (this.room) {// 清理房間里面的電腦玩家for (let player of this.room.players) {if (player instanceof ComputerPlayer) {this.room.removePlayer(player);}}this.room = null;}}/*** 通過 WebSocket 信道發(fā)送消息給玩家*/send(message, data) {this.tunnel.emit(message, data);}/*** 從 WebSocket 信道接收玩家的消息*/receive(message, callback) {this.tunnel.on(message, callback);} }人類玩家和電腦玩家的邏輯是一致的,但是 IO 不同,人類玩家使用之前實現(xiàn)的 WebSocket 服務進行輸入輸出,而電腦玩家直接使用 EventEmiter 處理
添加游戲服務入口
游戲的實現(xiàn)已經(jīng)完成了,接下來,編輯 websocket.js?添加服務入口,可參考下面的代碼:
示例代碼:/data/release/webapp/websocket.js
// 引入 url 模塊用于解析 URL const url = require('url'); // 引入 ws 支持 WebSocket 的實現(xiàn) const ws = require('ws'); // 引入人類玩家 const HumanPlayer = require('./game/HumanPlayer');// 導出處理方法 exports.listen = listen;/*** 在 HTTP Server 上處理 WebSocket 請求* @param {http.Server} server* @param {wafer.SessionMiddleware} sessionMiddleware*/ function listen(server, sessionMiddleware) {// 使用 HTTP Server 創(chuàng)建 WebSocket 服務,使用 path 參數(shù)指定需要升級為 WebSocket 的路徑const wss = new ws.Server({ server });// 同時支持 /ws 和 /game 的 WebSocket 連接請求 wss.shouldHandle = (request) => { const path = url.parse(request.url).pathname; request.path = path; return ['/ws', '/game'].indexOf(path) > -1; }; // 監(jiān)聽 WebSocket 連接建立wss.on('connection', (ws, request) => {// request: 要升級到 WebSocket 協(xié)議的 HTTP 連接// 被升級到 WebSocket 的請求不會被 express 處理,// 需要使用會話中間節(jié)獲取會話sessionMiddleware(request, null, () => {const session = request.session;if (!session) {// 沒有獲取到會話,強制斷開 WebSocket 連接ws.send(JSON.stringify(request.sessionError) || "No session avaliable");ws.close();return;}console.log(`WebSocket client connected with openId=${session.userInfo.openId}`);// 根據(jù)請求的地址進行不同處理 switch (request.path) { case '/ws': return serveMessage(ws, session.userInfo); case '/game': return serveGame(ws, session.userInfo); default: return ws.close();}});});// 監(jiān)聽 WebSocket 服務的錯誤wss.on('error', (err) => {console.log(err);}); }/*** 進行簡單的 WebSocket 服務,對于客戶端發(fā)來的所有消息都回復回去*/ function serveMessage(ws, userInfo) {// 監(jiān)聽客戶端發(fā)來的消息ws.on('message', (message) => {console.log(`WebSocket received: ${message}`);ws.send(`Server: Received(${message})`);});// 監(jiān)聽關閉事件ws.on('close', (code, message) => {console.log(`WebSocket client closed (code: ${code}, message: ${message || 'none'})`);});// 連接后馬上發(fā)送 hello 消息給會話對應的用戶ws.send(`Server: 恭喜,${userInfo.nickName}`); }/*** 使用 WebSocket 進行游戲服務*/ function serveGame(ws, userInfo) {const user = { uid: userInfo.openId, uname: userInfo.nickName, uavatar: userInfo.avatarUrl }; // 創(chuàng)建玩家 const player = new HumanPlayer(user, ws); // 玩家上線player.online(); }安裝 co 模塊
我們的源碼中使用到了 co 進行協(xié)程管理,啟動游戲服務前,需要先安裝:
cd /data/release/webapp sudo npm install co --save測試游戲服務
重啟 Node 服務:
pm2 restart app打開配套的小程序,點擊?實驗四 - 剪刀石頭布小游戲,點擊?開始?按鈕進行游戲。
完成實驗
恭喜!您已經(jīng)完成了小程序服務的全部實驗內容!你可以選擇保留已經(jīng)運行的服務,繼續(xù)進行小程序的學習研究,建議留用機器。
總結
以上是生活随笔為你收集整理的基于 Ubuntu 搭建微信小程序服务的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: apache2 默认端口修改
- 下一篇: ubuntu18 安装 chrome