@lzpenguin/server 1.1.8 → 1.1.10

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);        // 自己的公开数据
-  console.log('Players:', data.players);  // 其他玩家的公开数据
+  console.log('Self:', data.self);        // 自己的公开数据（包含 name 字段）
+  console.log('Players:', data.players);  // 其他玩家的公开数据（包含 name 字段）
   // 注意：self 和 players[i] 结构相同，都只包含公开数据
 });
 
@@ -32,7 +32,8 @@ server.onData((data) => {
 server.init({
   world: { score: 0, level: 1 },
   self: {
-    public: { name: 'Player1', x: 100, y: 100 }
+    public: { x: 100, y: 100 }
+    // name 字段不需要设置，服务器返回数据会包含
   }
 });
 
@@ -58,6 +59,10 @@ server.update({
 }
 ```
 
+**关于 name 字段：**
+- `self.name` 和 `players[i].name` 字段**一定会存在**，包含用户的昵称或用户名
+- 你不需要在 `init()` 或 `update()` 时设置 name 字段，服务器会直接返回
+
 ## API 说明
 
 ### init(data) - 初始化服务器
@@ -68,7 +73,8 @@ server.update({
 server.init({
   world: { score: 0, level: 1 },   // 可选：世界初始数据
   self: {
-    public: { name: 'Player1', x: 100, y: 100 }  // 可选：玩家公开数据
+    public: { x: 100, y: 100 }  // 可选：玩家公开数据
+    // 注意：name 字段不需要设置，服务器返回的数据会包含该字段
   }
 });
 ```
@@ -125,6 +131,9 @@ const server = new RiffleServer({
 
 // 监听推送
 server.onData((data) => {
+  // data.self.name 和 data.players[i].name 一定会存在
+  console.log('我的名字:', data.self.name);
+  
   const myPosition = { x: data.self.x, y: data.self.y };
   const otherPlayers = data.players || [];
   renderPlayers(myPosition, otherPlayers);
@@ -137,7 +146,8 @@ server.onData((data) => {
 // 初始化
 server.init({
   world: { score: 0, level: 1 },
-  self: { public: { name: 'Player1', x: 0, y: 0 } }
+  self: { public: { x: 0, y: 0 } }
+  // name 字段不需要设置，返回的数据会包含
 });
 
 // 更新玩家位置

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;
     }
@@ -261,6 +279,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 +327,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.8",
+  "version": "1.1.10",
   "description": "Riffle 游戏服务器 WebSocket 客户端 SDK",
   "license": "ISC",
   "author": "lzpenguin",