@lzpenguin/server 1.0.5 → 1.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.d.ts +2 -72
- package/package.json +1 -1
package/index.d.ts
CHANGED
|
@@ -54,10 +54,6 @@ export interface UpdateData {
|
|
|
54
54
|
* 服务器推送的数据
|
|
55
55
|
*/
|
|
56
56
|
export interface ServerData {
|
|
57
|
-
/** 服务器时间戳(毫秒) */
|
|
58
|
-
timestamp?: number;
|
|
59
|
-
/** 消息序列号 */
|
|
60
|
-
sequence?: number;
|
|
61
57
|
/** 世界数据 */
|
|
62
58
|
world: Record<string, any>;
|
|
63
59
|
/** 当前玩家数据 */
|
|
@@ -66,43 +62,6 @@ export interface ServerData {
|
|
|
66
62
|
players: Array<Record<string, any>>;
|
|
67
63
|
}
|
|
68
64
|
|
|
69
|
-
/**
|
|
70
|
-
* 增量更新数据
|
|
71
|
-
*/
|
|
72
|
-
export interface DeltaData {
|
|
73
|
-
/** 世界数据(支持 $append 等特殊操作) */
|
|
74
|
-
world?: Record<string, any>;
|
|
75
|
-
/** 玩家数据 */
|
|
76
|
-
self?: PlayerSelfData;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
/**
|
|
80
|
-
* 统计信息
|
|
81
|
-
*/
|
|
82
|
-
export interface Stats {
|
|
83
|
-
/** 是否已连接 */
|
|
84
|
-
connected: boolean;
|
|
85
|
-
/** 是否已初始化 */
|
|
86
|
-
initialized: boolean;
|
|
87
|
-
/** 本地发送的序列号 */
|
|
88
|
-
localSequence: number;
|
|
89
|
-
/** 最后接收的序列号 */
|
|
90
|
-
lastReceivedSequence: number;
|
|
91
|
-
/** 最后接收的时间戳 */
|
|
92
|
-
lastReceivedTimestamp: number;
|
|
93
|
-
/** 待确认的操作数量 */
|
|
94
|
-
pendingOperations: number;
|
|
95
|
-
/** 总更新次数 */
|
|
96
|
-
updateCount: number;
|
|
97
|
-
/** 最后更新时间 */
|
|
98
|
-
lastUpdateTime: number;
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
/**
|
|
102
|
-
* 确认回调函数
|
|
103
|
-
*/
|
|
104
|
-
export type ConfirmCallback = (error: Error | null, result: { confirmed: boolean } | null) => void;
|
|
105
|
-
|
|
106
65
|
/**
|
|
107
66
|
* RiffleServer - 游戏服务器 WebSocket 客户端
|
|
108
67
|
*/
|
|
@@ -123,43 +82,14 @@ export class RiffleServer {
|
|
|
123
82
|
/**
|
|
124
83
|
* 初始化服务器(必需,连接后必须先调用)
|
|
125
84
|
* @param initData 初始化数据
|
|
126
|
-
* @param callback 确认回调函数(可选)
|
|
127
|
-
* @returns 操作ID(如果已连接)
|
|
128
85
|
*/
|
|
129
|
-
init(initData: InitData
|
|
86
|
+
init(initData: InitData): void;
|
|
130
87
|
|
|
131
88
|
/**
|
|
132
89
|
* 更新数据(部分更新,合并到现有数据)
|
|
133
90
|
* @param updateData 更新数据
|
|
134
|
-
* @param callback 确认回调函数(可选)
|
|
135
|
-
* @returns 操作ID
|
|
136
|
-
*/
|
|
137
|
-
update(updateData: UpdateData, callback?: ConfirmCallback): string | null;
|
|
138
|
-
|
|
139
|
-
/**
|
|
140
|
-
* 增量更新(只发送变化的数据)
|
|
141
|
-
* @param delta 增量数据
|
|
142
|
-
* @param callback 确认回调函数(可选)
|
|
143
|
-
* @returns 操作ID
|
|
144
|
-
* @example
|
|
145
|
-
* ```typescript
|
|
146
|
-
* // 只追加新笔画,而不是发送整个数组
|
|
147
|
-
* server.updateDelta({
|
|
148
|
-
* world: {
|
|
149
|
-
* strokes: {
|
|
150
|
-
* $append: [newStroke]
|
|
151
|
-
* }
|
|
152
|
-
* }
|
|
153
|
-
* });
|
|
154
|
-
* ```
|
|
155
|
-
*/
|
|
156
|
-
updateDelta(delta: DeltaData, callback?: ConfirmCallback): string | null;
|
|
157
|
-
|
|
158
|
-
/**
|
|
159
|
-
* 获取同步统计信息
|
|
160
|
-
* @returns 统计信息对象
|
|
161
91
|
*/
|
|
162
|
-
|
|
92
|
+
update(updateData: UpdateData): void;
|
|
163
93
|
|
|
164
94
|
/**
|
|
165
95
|
* 监听服务器推送的最新数据
|