目录— 个文件
⌕
目录加载中…
…/core/data/DataManager.ts
1import { sys } from "cc";
2import { Framework } from "../../Framework";
3import { frameworkManager } from "../base/FrameworkClassRegistry";
4import { IFrameworkManager } from "../base/IFrameworkManager";
5import { Singleton } from "../base/Singleton";
6import { EventFrameCode } from "../event/EventFrameCode";
7import { DataDefine, DataModel, DataSource, DataValue } from "./DataDefine";
8import { DataFrameKey } from "./DataFrameKey";
9
10/**
11 * 完整玩家数据管理器。
12 *
13 * 核心规则:
14 * 1. 本地和服务器保存同一份完整数据;本地序列化为 JSON,服务器直接收发对象;
15 * 2. STR_VERSION 只在业务数据成功落盘后递增,是存档新旧的唯一判断依据;
16 * 3. 业务直接读取内存数据,修改对象或数组后必须调用 SaveData 持久化;
17 * 4. 在线修改会合并延迟上传,离线会话绝不上传。
18 */
19@frameworkManager()
20export class DataManager extends Singleton<DataManager> implements IFrameworkManager {
21 public Name: string = "DataManager";
22 /** 当前使用的存档来源;Local 禁止上传,Server 允许延迟上传。 */
23 private source: DataSource = DataSource.Local;
24 /** 当前已确认并成功写入本地的完整数据。 */
25 private data: DataModel = {};
26 /** 最终存档确认后才允许业务写入,避免初始化期间覆盖已有存档。 */
27 private isDataReady: boolean = false;
28 /** 记录原始存档是否为空,不能用引导状态或合并后的默认数据判断实验资格。 */
29 private isNewPlayerForAB: boolean = false;
30
31 public get IsNewPlayerForAB(): boolean {
32 return this.isDataReady && this.isNewPlayerForAB;
33 }
34 /** 尚未上传的业务字段;同时用于判断待上传状态和定位合并上传的来源。 */
35 private pendingUploadKeys: Set<string> = new Set();
36 /** 保证任意时刻最多只有一个存档上传请求。 */
37 private uploading: boolean = false;
38 /** 延迟合并上传使用的框架定时器 ID。 */
39 private uploadTimer: number = -1;
40
41 /** 当前业务使用本地存档还是已与服务器校对的存档。 */
42 public get Source(): DataSource { return this.source; }
43
44 /** 数据由登录完成后的 PrepareData 统一加载,这里无需提前初始化。 */
45 public async Init(): Promise<void> {
46 // 记录管理器初始化入口,便于排查启动顺序。
47 Framework.Log.Log(this.Name, "Init", "初始化数据管理器");
48 }
49
50 /** 释放上传定时器并清空当前存档运行状态。 */
51 public DeInit(): void {
52 this.isDataReady = false;
53 this.isNewPlayerForAB = false;
54 this.UpdateDataSource(DataSource.Local);
55 this.data = {};
56 this.pendingUploadKeys.clear();
57 }
58
59 /** DataManager 没有逐帧任务,保留该方法以实现框架管理器接口。 */
60 public Update(deltaTime: number): void { }
61
62 /**
63 * 仅由 FrameworkEntry 固定启动流程在登录完成后调用;运行中需要重新校对时重启游戏。
64 * 固定先加载本地存档;登录成功时再拉取服务器存档校对,失败时直接进入本地模式。
65 * 返回本次准备是否成功;请求校对服务器但失败时返回 false,本地存档仍可使用。
66 */
67 public async PrepareData(canUseServer: boolean): Promise<boolean> {
68 this.isDataReady = false;
69 this.LoadLocalData();
70 let success = true;
71 if (canUseServer) {
72 success = await this.LoadServerData();
73 }
74 // 离线及拉档/校对失败不确认新用户,继续使用正常玩法但排除新实验。
75 if (!canUseServer || !success) this.isNewPlayerForAB = false;
76
77 // 本地或云端最终存档已确定;先允许保存,再通知依赖存档的模块。
78 this.isDataReady = true;
79 Framework.Event.SendEvent(EventFrameCode.PLAYER_DATA_READY);
80 return success;
81 }
82
83 /** 读取本地完整存档;无有效存档时创建新的基础数据。 */
84 private LoadLocalData(): void {
85 this.UpdateDataSource(DataSource.Local);
86 const localData = this.GetLocalData();
87 // 必须在创建默认档之前固定资格,已有本地旧档的玩家不参加新实验。
88 this.isNewPlayerForAB = localData === null;
89 if (localData) {
90 this.data = localData;
91 return;
92 }
93
94 // 没有可用的本地存档时,创建并落盘基础存档。
95 const initialData: DataModel = {
96 [DataFrameKey.STR_VERSION]: 0,
97 [DataFrameKey.UPDATE_TIME]: Date.now(),
98 };
99 this.SetLocalData(initialData);
100 this.data = initialData;
101 }
102
103 /**
104 * 登录成功后的完整存档校对:先 GetPlayerData,再根据 STR_VERSION 整份二选一。
105 * 本地更新或云端无可用存档时,PushPlayerData 上传本地;否则采用云端并写入本地。
106 * 校对不合并业务字段,也不递增版本;只有校对成功才开启后续自动上传。
107 */
108 private async LoadServerData(): Promise<boolean> {
109 // 拉取失败不能当作空存档,否则可能用本地旧进度覆盖尚未读到的云端数据。
110 let serverData: DataModel | null;
111 try {
112 serverData = await this.GetServerData();
113 } catch (error) {
114 Framework.Log.Error("[DataManager]", "服务器存档拉取失败,继续使用本地存档", { error });
115 return false;
116 }
117 // 只有本地和云端都没有旧档才允许入组;云端空档不能覆盖本地的老用户判定。
118 this.isNewPlayerForAB = this.isNewPlayerForAB && serverData === null;
119 // 只比较存档版本,不用 UPDATE_TIME 判断新旧;无可用云端存档以 -1 表示。
120 const localVersion = this.GetStrVersion(this.data);
121 const serverVersion = serverData ? this.GetStrVersion(serverData) : -1;
122 // 仅记录版本摘要,不输出玩家完整存档;-1 表示云端没有可用存档。
123 Framework.Log.Log("[DataManager]", "开始存档版本比对", { localVersion, serverVersion });
124
125 // 云端为空或本地版本更高:上传本地完整存档。
126 // 因此启动时可能连续出现 GetPlayerData 和 PushPlayerData,并非每次拉取都会上传。
127 if (!serverData || localVersion > serverVersion) {
128 const message = serverData ? "本地版本更高,上传本地存档" : "云端无可用存档,上传本地存档";
129 Framework.Log.Log("[DataManager]", message, { localVersion, serverVersion });
130 const success = await this.SetServerData(this.data);
131 // 上传失败仍保留本地模式,不把未完成的校对当作同步成功。
132 if (success) this.EnableServerSync();
133 // 区分尝试上传与真正完成校对,失败详情由上传边界记录。
134 Framework.Log.Log("[DataManager]", "本地存档校对结束", { success, source: this.Source });
135 return success;
136 }
137
138 // 版本相同时比较完整内容仅用于记录冲突;无论内容是否相同,都按约定采用云端。
139 if (localVersion === serverVersion && !this.IsSameValue(this.data, serverData)) {
140 Framework.Log.Error("[DataManager]", "STR_VERSION 相同但存档内容不同,服务器数据优先", {
141 strVersion: serverVersion,
142 });
143 }
144
145 // 云端版本更高或与本地相同:整份写入本地后替换当前数据,无需再上传。
146 this.SetLocalData(serverData);
147 this.data = serverData;
148 this.EnableServerSync();
149 Framework.Log.Log("[DataManager]", "已采用云端存档并写入本地,无需上传", { localVersion, serverVersion });
150 return true;
151 }
152
153 /** 完成本地与服务器校对,开启本次会话的后续存档上传。 */
154 private EnableServerSync(): void {
155 this.UpdateDataSource(DataSource.Server);
156 this.pendingUploadKeys.clear();
157 }
158
159 /** 更新当前存档来源;切换到本地来源时停止所有待执行的上传。 */
160 private UpdateDataSource(source: DataSource): void {
161 this.source = source;
162 if (source === DataSource.Local) this.ClearUploadTimer();
163 }
164
165 /** 将本地存档字符串解析为数据对象。 */
166 private ParseData(strData: string): DataModel | null {
167 try {
168 return JSON.parse(strData) as DataModel;
169 } catch {
170 return null;
171 }
172 }
173
174 /** 获取当前项目的本地完整存档,并在存储层内部完成字符串解析。 */
175 private GetLocalData(): DataModel | null {
176 const strData = sys.localStorage.getItem(this.GetDataKey());
177 if (!strData) return null;
178
179 const data = this.ParseData(strData);
180 if (!data) Framework.Log.Error("[DataManager]", "本地存档解析失败,将创建新的基础存档");
181 return data;
182 }
183
184 /** 设置当前项目的本地完整存档,并在存储层内部完成字符串转换。 */
185 private SetLocalData(data: DataModel): void {
186 sys.localStorage.setItem(this.GetDataKey(), JSON.stringify(data));
187 }
188
189 /** 直接读取服务器存档对象;请求失败抛出异常,新玩家空存档返回 null。 */
190 private async GetServerData(): Promise<DataModel | null> {
191 const response = await Framework.Server.GetPlayerData();
192 if (!response) throw new Error("服务器未成功返回玩家存档");
193 const data: DataModel = response.data;
194 if (!data || Object.keys(data).length === 0) return null;
195 return data;
196 }
197
198 /** 上传服务器完整存档对象,并在服务器数据边界处理结果。 */
199 private async SetServerData(data: DataModel, changedKeys: string[] | null = null): Promise<boolean> {
200 // 上传前固定版本和字段摘要,等待回包期间的新修改不属于本次请求。
201 const version: number = this.GetStrVersion(data);
202 let keySummary: string;
203 if (changedKeys) {
204 const savedKeys = changedKeys.filter(key => Object.prototype.hasOwnProperty.call(data, key));
205 const removedKeys = changedKeys.filter(key => !Object.prototype.hasOwnProperty.call(data, key));
206 keySummary = `修改 DataKey=[${savedKeys.join(", ")}],删除 DataKey=[${removedKeys.join(", ")}]`;
207 } else {
208 // 启动校对直接上传完整本地存档,没有本次会话的字段修改记录。
209 keySummary = `启动校对,全量 DataKey=[${Object.keys(data).join(", ")}]`;
210 }
211 const summary = `version=${version},${keySummary}`;
212 Framework.Log.Log("[DataManager][PushPlayerData]", `开始上传完整存档,${summary}`);
213 const response = await Framework.Server.PushPlayerData(data);
214 if (response.Success) {
215 Framework.Log.Log("[DataManager][PushPlayerData]", `完整存档上传成功,${summary}`);
216 return true;
217 }
218
219 Framework.Log.Error("[DataManager][PushPlayerData]", `完整存档上传失败,${summary},原因:${response.Message}`);
220 if (response.Unauthorized) {
221 this.UpdateDataSource(DataSource.Local);
222 return false;
223 }
224 // 时间戳错误已由 ServerManager 统一校时并重试,此处只处理最终失败。
225 return false;
226 }
227
228 /** 整份本地存档只使用当前 PackageDefine.ProjectName 作为 localStorage Key。 */
229 private GetDataKey(): string {
230 const projectName = Framework.Package.GetCurrentPackageData().ProjectName;
231 if (!projectName) throw new Error("[DataManager] PackageDefine.ProjectName 不能为空");
232 return projectName;
233 }
234
235 /** 读取指定完整存档的 STR_VERSION。 */
236 private GetStrVersion(data: DataModel): number {
237 return data[DataFrameKey.STR_VERSION] as number;
238 }
239
240 /** 比较本地和服务器完整存档内容,用于发现同版本数据异常。 */
241 private IsSameValue(left: unknown, right: unknown): boolean {
242 return JSON.stringify(left) === JSON.stringify(right);
243 }
244
245 /** 系统字段只能由 DataManager 维护,业务层不能直接保存或删除。 */
246 private IsSystemKey(key: string): boolean {
247 return key === DataFrameKey.STR_VERSION || key === DataFrameKey.UPDATE_TIME;
248 }
249
250 /** 直接读取内存数据;业务修改对象或数组后必须调用 SaveData 完成持久化。 */
251 public GetData<T>(key: string, defaultValue: T): T {
252 if (!key) {
253 Framework.Log.Error("[DataManager]", "读取数据失败:key 为空");
254 return defaultValue;
255 }
256 const value = this.data[key];
257 return value === undefined ? defaultValue : value as T;
258 }
259
260 /** 本地落盘成功后才提交内存,并在在线模式下安排延迟上传。 */
261 public SaveData<T>(key: string, value: T): void {
262 if (!this.CanWriteData("SaveData", key)) return;
263 if (!key || this.IsSystemKey(key)) {
264 Framework.Log.Error("[DataManager]", "保存数据失败:key 非法或属于系统字段", { key });
265 return;
266 }
267
268 // GetData 返回权威对象引用,显式 SaveData 即表示业务数据已经发生修改。
269 const nextVersion = this.GetStrVersion(this.data) + 1;
270 const nextData: DataModel = {
271 ...this.data,
272 [key]: value as DataValue,
273 [DataFrameKey.STR_VERSION]: nextVersion,
274 [DataFrameKey.UPDATE_TIME]: Date.now(),
275 };
276 this.CommitBusinessData(nextData, key);
277 }
278
279 /** 删除一个业务字段;删除行为同样递增版本并遵守先落盘后提交。 */
280 public RemoveData(key: string): void {
281 if (!this.CanWriteData("RemoveData", key)) return;
282 if (!key || this.IsSystemKey(key)) return;
283 if (!Object.prototype.hasOwnProperty.call(this.data, key)) return;
284
285 const nextVersion = this.GetStrVersion(this.data) + 1;
286 const nextData: DataModel = { ...this.data };
287 delete nextData[key];
288 nextData[DataFrameKey.STR_VERSION] = nextVersion;
289 nextData[DataFrameKey.UPDATE_TIME] = Date.now();
290 this.CommitBusinessData(nextData, key);
291 }
292
293 /** 测试入口:只删除当前项目的本地持久化存档,不重置运行数据或删除云端存档。 */
294 public RemoveAllLocalData(): void {
295 if (!this.CanWriteData("RemoveAllLocalData")) return;
296 // 停止后续上传;运行数据保留,后续显式保存仍可正常递增版本并重新落盘。
297 this.UpdateDataSource(DataSource.Local);
298 sys.localStorage.removeItem(this.GetDataKey());
299 this.pendingUploadKeys.clear();
300 }
301
302
303 /**
304 * 业务保存的事务提交点。
305 * 先写入 localStorage,再替换内存并安排服务器上传。
306 */
307 private CommitBusinessData(nextData: DataModel, key: string): void {
308 this.SetLocalData(nextData);
309 this.data = nextData;
310 // 仅在本地落盘完成后记录发生修改的业务字段。
311 this.pendingUploadKeys.add(key);
312 if (this.Source === DataSource.Server) this.ScheduleUpload(DataDefine.UploadDelaySeconds);
313 }
314
315 /** 合并短时间内的连续修改,并在指定延迟后触发一次上传。 */
316 private ScheduleUpload(delaySeconds: number): void {
317 this.ClearUploadTimer();
318 this.uploadTimer = Framework.Timer.Delay(delaySeconds, () => {
319 this.uploadTimer = -1;
320 this.Flush();
321 }, this);
322 }
323
324 /** 串行上传当前完整数据;失败时保留待上传标记,等待后续修改再次上传。 */
325 private async UploadLatestData(): Promise<boolean> {
326 // 取出本批字段后清空集合;上传期间同一字段再次保存也会进入下一批。
327 const changedKeys: string[] = Array.from(this.pendingUploadKeys);
328 this.pendingUploadKeys.clear();
329 this.uploading = true;
330 const success = await this.SetServerData(this.data, changedKeys);
331 this.uploading = false;
332
333 if (!success) {
334 // 失败的字段合回待上传集合,不丢失等待期间新增的修改。
335 for (const key of changedKeys) this.pendingUploadKeys.add(key);
336 return false;
337 }
338
339 if (this.pendingUploadKeys.size > 0) {
340 this.ScheduleUpload(DataDefine.UploadDelaySeconds);
341 }
342 return true;
343 }
344
345 /** 立即提交最新完整存档对象;没有脏数据时直接成功。 */
346 public async Flush(): Promise<boolean> {
347 if (!this.CanWriteData("Flush")) return false;
348 this.ClearUploadTimer();
349 if (this.Source === DataSource.Local || this.uploading) return false;
350 if (this.pendingUploadKeys.size === 0) return true;
351 return this.UploadLatestData();
352 }
353
354
355 /** 集中拦截准备前的业务写入;准备流程内部的落盘和校对不经过此入口。 */
356 private CanWriteData(operation: string, key?: string): boolean {
357 if (this.isDataReady) return true;
358 Framework.Log.Error("[DataManager]", "玩家存档尚未准备完成,拒绝数据写入", { operation, key });
359 return false;
360 }
361
362 /** 取消尚未执行的延迟上传任务。 */
363 private ClearUploadTimer(): void {
364 if (this.uploadTimer < 0) return;
365 Framework.Timer.CancelTimer(this.uploadTimer);
366 this.uploadTimer = -1;
367 }
368
369}
讲解370 行
玩家存档管理器人工通读
DataManager.ts
掌管完整玩家数据的唯一入口。启动先读本地存档,登录成功后与服务器存档按版本号整份二选一,在线会话把 SaveData 合并到 0.4 秒窗口后串行上传;其他模块要等 PLAYER_DATA_READY 之后才允许读写。
先读 PrepareData 看双源启动链,再读 LoadLocalData 与 LoadServerData 的版本分支,然后看 SaveData、CommitBusinessData、ScheduleUpload、UploadLatestData 的上传链路,最后看 Flush 与 RemoveAllLocalData。
特殊处理与易错点
- 初始化顺序依赖AB 新玩家资格必须在创建默认档之前按原始本地存档是否为 null 固定,默认档一旦写入就不能再用来判断新老玩家。L88
- 特殊处理云端无档或本地版本更高时上传本地并转服务器模式,否则整份采用云端写入本地;版本相同但内容不同只打错误日志,仍以服务器为准。L127
- 异步竞态上传前固定版本号与本次字段摘要,回包期间产生的新修改不属于本次请求,不会混进日志也不会被误判为已上传。L199
- 缓存与销毁时机提交顺序固定为先写 localStorage、再替换内存、最后登记脏字段并排上传,保证内存永远不领先于本地存储。L307
- 异常兜底上传失败时把本批字段合回待上传集合,避免丢掉等待期间新增的修改;成功后若集合仍非空会再排一次上传。L335
- 渠道差异服务端返回 Unauthorized 时立即切回本地来源并取消后续上传定时器,但内存和本地数据保持原样。L220
19注释完整玩家数据管理器。 核心规则: 1. 本地和服务器保存同一份完整数据;本地序列化为 JSON,服务器直接收发对象; 2. STR_VERSION 只在业务数据成功落盘后递增,是存档新旧的唯一判断依据; 3. 业务直接读取内存数据,修改对象或数组后必须调用 SaveData 持久化; 4. 在线修改会合并延迟上传,离线会话绝不上传。
20注释DataManager:完整玩家存档管理器:本地/云端版本校对、字段级写入、延迟合并上传、前后台 Flush、401
21属性名称(string):模块/组件名称,用于日志、缓存 Key 或资源查找。
23属性当前存档来源,LoadLocalData、EnableServerSync、UpdateDataSource 写
25属性内存中的完整存档对象;PrepareData 确定后由 GetData 直接返回引用,SaveData 生成新对
27属性准备完成标记,PrepareData 置 true、DeInit 置 false,CanWriteData 用它
29属性原始存档是否为空的判定结果,LoadLocalData 与 LoadServerData 写入,IsNewPla
31方法仅当数据已就绪且原始存档为空时返回 true,供 AB 实验分桶使用。
35属性已落盘但尚未上传的业务字段集合,CommitBusinessData 添加、UploadLatestData 取
37属性上传进行中的标记,防止重入,Flush 见到它为 true 时直接返回 false。
39属性延迟合并上传的框架定时器 id,ScheduleUpload 设置、ClearUploadTimer 取消,-1
42方法返回本次会话当前使用的存档来源,Local 表示禁止上传服务器。
45方法只写一条初始化日志,不读取存档也不创建定时器,真正的加载留给 PrepareData。
47注释记录管理器初始化入口,便于排查启动顺序。
51方法复位就绪与 AB 资格标记,切回本地来源顺带取消上传定时器,再清空存档与待上传集合。
60方法空实现,存档只有事件驱动的读写和延时上传,没有逐帧任务。
67方法先读本地存档,允许时再拉服务器校对,最终置就绪并广播 PLAYER_DATA_READY 事件。
75注释离线及拉档/校对失败不确认新用户,继续使用正常玩法但排除新实验。
78注释本地或云端最终存档已确定;先允许保存,再通知依赖存档的模块。
84方法切到本地来源后读 localStorage,没有有效存档就新建只含版本与时间的空档并立即落盘。
88注释必须在创建默认档之前固定资格,已有本地旧档的玩家不参加新实验。
95注释没有可用的本地存档时,创建并落盘基础存档。
108方法拉取云端存档,按 STR_VERSION 与本地整份二选一,上传本地或采用云端并写回本地。
110注释拉取失败不能当作空存档,否则可能用本地旧进度覆盖尚未读到的云端数据。
118注释只有本地和云端都没有旧档才允许入组;云端空档不能覆盖本地的老用户判定。
120注释只比较存档版本,不用 UPDATE_TIME 判断新旧;无可用云端存档以 -1 表示。
123注释仅记录版本摘要,不输出玩家完整存档;-1 表示云端没有可用存档。
127注释云端为空或本地版本更高:上传本地完整存档。 因此启动时可能连续出现 GetPlayerData 和 PushPlayerData,并非每次拉取都会上传。
132注释上传失败仍保留本地模式,不把未完成的校对当作同步成功。
134注释区分尝试上传与真正完成校对,失败详情由上传边界记录。
139注释版本相同时比较完整内容仅用于记录冲突;无论内容是否相同,都按约定采用云端。
146注释云端版本更高或与本地相同:整份写入本地后替换当前数据,无需再上传。
154方法把来源切到 Server 并清空待上传集合,此后 SaveData 才会安排延迟上传。
160方法写入当前来源,切到 Local 时同时取消尚未执行的延迟上传定时器。
166方法把 localStorage 读出的字符串解析成对象,解析异常时吞掉错误返回 null。
175方法按当前项目名作为键读 localStorage 并解析,解析失败只记日志仍返回 null。
185方法把完整存档序列化后写入以当前项目名为键的 localStorage,不检查容量与异常。
190方法调用服务器接口取云端存档,响应为空抛错,返回空对象则当作新玩家。
199方法上传完整存档并记录本次版本与字段摘要,返回鉴权失败时把来源切回本地。
201注释上传前固定版本和字段摘要,等待回包期间的新修改不属于本次请求。
209注释启动校对直接上传完整本地存档,没有本次会话的字段修改记录。
225注释时间戳错误已由 ServerManager 统一校时并重试,此处只处理最终失败。
229方法取当前马甲包的 ProjectName 作为本地存储键,为空时直接抛错。
236方法读存档里的 STR_VERSION 字段并当作数字返回,字段缺失时得到 undefined。
241方法把两份完整存档序列化成字符串逐字比较,只用于发现同版本的内容冲突。
246方法判断键是否为版本号或更新时间,这两个字段禁止业务写入和删除。
251方法只读内存存档并返回原对象引用,键未设置时返回传入的默认值。
261方法递增版本、刷新时间后把新字段合进完整存档,再走先落盘后替换的提交。
269注释GetData 返回权威对象引用,显式 SaveData 即表示业务数据已经发生修改。
280方法存在该业务字段时从存档删除,同时递增版本与更新时间后提交。
294方法切回本地来源停掉上传,删除当前项目名的本地存档,但保留内存数据和云端存档。
297注释停止后续上传;运行数据保留,后续显式保存仍可正常递增版本并重新落盘。
307方法先把新存档写入 localStorage,再替换内存引用,登记脏字段并在在线时按合并窗口排上传。
311注释仅在本地落盘完成后记录发生修改的业务字段。
316方法取消已有定时器后新建一个延迟任务,到期清空 id 并调用 Flush 提交。
325方法取出并清空待上传集合,串行上传当前完整存档,失败时把本批字段合回集合。
327注释取出本批字段后清空集合;上传期间同一字段再次保存也会进入下一批。
335注释失败的字段合回待上传集合,不丢失等待期间新增的修改。
346方法取消延迟任务,本地来源或正在上传时返回 false,无脏数据返回 true,否则立即上传。
356方法存档已就绪时放行,否则打错误日志并拒绝本次写入操作。
363方法定时器 id 小于零时什么都不做,否则调用框架取消接口并复位为负一。