@lzpenguin/server 1.1.9 → 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

@@ -83,10 +83,6 @@ export class RiffleServer {
       }
     }
 
-    if (!baseUrl) {
-      throw new Error('Base URL not found');
-    }
-
     // 从全局变量或 URL 参数中读取 post_id 和 token
     let postId;
     let token;
@@ -97,11 +93,27 @@ export class RiffleServer {
       token = window.__RIFFLE_TOKEN__ || new URLSearchParams(location.search).get('token');
     }
 
-    if (!postId) {
-      throw new Error('Post ID not found');
-    }
-    if (!token) {
-      throw new Error('Token not found');
+    // 设置降级模式标志
+    this.isDisabled = false;
+    
+    if (!baseUrl || !postId || !token) {
+      console.warn('[RiffleServer] Configuration not found (base_url, post_id or token missing), running in disabled mode');
+      this.isDisabled = true;
+      this.url = null;
+      this.postId = null;
+      this.token = null;
+      this.timestamp = timestamp;
+      this.autoReconnect = false;
+      this.reconnectInterval = reconnectInterval;
+      this.ws = null;
+      this.isConnected = false;
+      this.isConnecting = false;
+      this.isInitialized = false;
+      this.reconnectTimer = null;
+      this.dataCallbacks = [];
+      this.pendingInit = null;
+      this.currentData = null;
+      return;
     }
 
     this.url = baseUrl;
@@ -133,6 +145,12 @@ export class RiffleServer {
    * @private
    */
   async connect() {
+    // 如果处于降级模式，不进行连接
+    if (this.isDisabled) {
+      console.warn('[RiffleServer] Service is disabled, skipping connection');
+      return;
+    }
+    
     if (this.isConnecting || (this.isConnected && this.ws?.readyState === (WebSocketImpl?.OPEN ?? 1))) {
       return;
     }
@@ -186,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;
@@ -261,6 +301,11 @@ export class RiffleServer {
    * @param {Object} updateData - 更新数据
    */
   sendUpdate(updateData) {
+    // 如果处于降级模式，不发送更新
+    if (this.isDisabled) {
+      return;
+    }
+    
     if (!this.isConnected || this.ws?.readyState !== WebSocketImpl.OPEN) {
       console.warn('[RiffleServer] Not connected, cannot send update');
       return;
@@ -304,6 +349,11 @@ export class RiffleServer {
    * });
    */
   init(initData = {}) {
+    // 如果处于降级模式，不执行初始化
+    if (this.isDisabled) {
+      return;
+    }
+    
     // 如果还未连接，保存 init 请求，连接建立后自动执行
     if (!this.isConnected || this.ws?.readyState !== WebSocketImpl.OPEN) {
       console.log('[RiffleServer] Not connected yet, will init after connection');

package/package.json

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