@lzpenguin/server 1.1.10 → 1.1.11

package/README.md

@@ -23,8 +23,8 @@ const server = new RiffleServer({
 // 1. 监听数据推送（init 成功后每 0.2 秒自动推送，调用 init/update 后立即推送）
 server.onData((data) => {
   console.log('World:', data.world);      // 世界数据
-  console.log('Self:', data.self);        // 自己的公开数据（包含 name 字段）
-  console.log('Players:', data.players);  // 其他玩家的公开数据（包含 name 字段）
+  console.log('Self:', data.self);        // 自己的公开数据（包含 name / avatar / online 字段）
+  console.log('Players:', data.players);  // 其他玩家的公开数据（包含 name / avatar / online 字段）
   // 注意：self 和 players[i] 结构相同，都只包含公开数据
 });
 
@@ -51,17 +51,19 @@ server.update({
 ```json
 {
   "world": { "score": 0, "level": 1 },
-  "self": { "name": "Player1", "x": 100, "y": 100 },
+  "self": { "name": "Player1", "avatar": "https://...", "online": true, "x": 100, "y": 100 },
   "players": [
-    { "name": "Player2", "x": 10, "y": 20 },
-    { "name": "Player3", "x": 30, "y": 40 }
+    { "name": "Player2", "avatar": "https://...", "online": true, "x": 10, "y": 20 },
+    { "name": "Player3", "avatar": "https://...", "online": false, "x": 30, "y": 40 }
   ]
 }
 ```
 
-**关于 name 字段：**
+**关于 name / avatar / online 字段：**
 - `self.name` 和 `players[i].name` 字段**一定会存在**，包含用户的昵称或用户名
-- 你不需要在 `init()` 或 `update()` 时设置 name 字段，服务器会直接返回
+- `self.avatar` 和 `players[i].avatar` 字段由服务器根据用户头像覆盖
+- `self.online` 和 `players[i].online` 字段存储在玩家数据中，`/api/v1/server/ws` 连接建立时自动为 true，断开时自动为 false
+- 你不需要在 `init()` 或 `update()` 时设置 name / avatar / online 字段，服务器会直接返回
 
 ## API 说明
 

package/index.js

@@ -204,6 +204,28 @@ export class RiffleServer {
 
           // 检查是否是数据消息（包含 world、self、players 字段）
           if (message.world !== undefined && message.self !== undefined && message.players !== undefined) {
+            if (message.self && typeof message.self === 'object') {
+              if (message.self.online === undefined) {
+                message.self.online = false;
+              }
+              if (message.self.avatar === undefined) {
+                message.self.avatar = '';
+              }
+            }
+            if (Array.isArray(message.players)) {
+              message.players = message.players.map((player) => {
+                if (player && typeof player === 'object') {
+                  if (player.online === undefined) {
+                    player.online = false;
+                  }
+                  if (player.avatar === undefined) {
+                    player.avatar = '';
+                  }
+                }
+                return player;
+              });
+            }
+
             // 如果还未初始化，这可能是 init 响应
             if (!this.isInitialized && message.self) {
               this.isInitialized = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lzpenguin/server",
-  "version": "1.1.10",
+  "version": "1.1.11",
   "description": "Riffle 游戏服务器 WebSocket 客户端 SDK",
   "license": "ISC",
   "author": "lzpenguin",