@cloudcare/cocos-sdk 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/creator3/creator3/capture.js

@@ -1,6 +1,8 @@
 import { Camera, Director, EditBox, RenderTexture, UITransform, Vec3, director, native, sys, view } from 'cc';
 import { frameFingerprint } from '../core/replay.js';
+import { persistReplayFrame, disposeReplayFrame } from '../core/replay-file.js';
 import { projectPrivacyBounds } from '../core/replay-privacy.js';
+import { collectReplayPrivacyNodes } from '../core/replay-privacy-nodes.js';
 import { waitForRenderTextureReadback } from './replay-render-cycle.js';
 export class FTCreator3CanvasCapture {
     constructor() {
@@ -64,23 +66,14 @@ export class FTCreator3CanvasCapture {
         };
     }
     async persist(frame, fingerprint = frameFingerprint(frame.rgba)) {
-        const path = `${native.fileUtils.getWritablePath()}cocos-sdk-replay-${fingerprint}.rgba`;
-        if (!native.fileUtils.writeDataToFile(frame.rgba, path)) {
-            throw new Error(`Unable to persist replay frame: ${path}`);
-        }
-        return { path, width: frame.width, height: frame.height, timestamp: frame.timestamp, fingerprint };
+        return persistReplayFrame(frame, fingerprint, native.fileUtils.getWritablePath());
     }
     disposeStoredFrame(frame) {
-        if (native.fileUtils.isFileExist(frame.path))
-            native.fileUtils.removeFile(frame.path);
+        return disposeReplayFrame(frame);
     }
     collectPrivacyRegions(camera, width, height) {
-        var _a, _b;
-        const nodes = new Map(this.privacy);
-        (_b = (_a = director.getScene()) === null || _a === void 0 ? void 0 : _a.getComponentsInChildren(EditBox)) === null || _b === void 0 ? void 0 : _b.forEach((editBox) => {
-            if (!nodes.has(editBox.node))
-                nodes.set(editBox.node, 'mask');
-        });
+        const scene = director.getScene();
+        const nodes = collectReplayPrivacyNodes(this.privacy, (scene === null || scene === void 0 ? void 0 : scene.getComponentsInChildren('ReplayPrivacy')) || [], (scene === null || scene === void 0 ? void 0 : scene.getComponentsInChildren(EditBox)) || []);
         const regions = [];
         nodes.forEach((mode, node) => {
             var _a, _b, _c, _d;

package/dist/creator3/creator3/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../../../src/creator3/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,OAAO,uBAAuB;IAApC;QAEU,YAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IA4F5D,CAAC;IA1FC,SAAS,CAAC,MAAe;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,UAAU,CAAC,IAAa,EAAE,IAAyB;QACjD,IAAI,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,eAAe;;QACb,MAAM,OAAO,GAAG,CAAA,MAAA,IAAI,CAAC,qBAAqB,oDAAI,KAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxE,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,iBAAyB;;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAI,MAAA,QAAQ,CAAC,QAAQ,EAAE,0CAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA,CAAC;QAClF,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC;QACtC,IAAI,MAA8B,CAAC;QACnC,IAAI,cAAc,GAAsB,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC;YAC/B,MAAM,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;YACtD,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACjD,mEAAmE;YACnE,uEAAuE;YACvE,IAAI,MAAM;gBAAE,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACjF,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,aAAa,GAAG,QAAQ,CAAC;YAChC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,oEAAoE;QACpE,yEAAyE;QACzE,IAAI,GAAG,CAAC,EAAE,MAAK,MAAA,GAAG,CAAC,EAAE,0CAAE,GAAG,CAAA;YAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5D,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,KAAK;YACL,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,cAAc;SACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAsB,EAAE,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;QAC9E,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,oBAAoB,WAAW,OAAO,CAAC;QACzF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IACrG,CAAC;IAED,kBAAkB,CAAC,KAAoB;QACrC,IAAI,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxF,CAAC;IAEO,qBAAqB,CAC3B,MAAW,EACX,KAAa,EACb,MAAc;;QAEd,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,MAAA,MAAA,QAAQ,CAAC,QAAQ,EAAE,0CAAE,uBAAuB,CAAC,OAAO,CAAC,0CAAE,OAAO,CAAC,CAAC,OAAY,EAAE,EAAE;YAC9E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAS,EAAE,EAAE;;YAChC,MAAM,MAAM,GAAG,MAAA,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,YAAY,qDAAG,WAAW,CAAC,0CAAE,qBAAqB,kDAAI,CAAC;YAC5E,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAM,MAAM,GAAG,CAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,CAAC,KAAI,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,oBAAoB,CACpC,MAAM,EACN,KAAK,EACL,MAAM,EACN,KAAK,EACL,MAAM,EACN,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,WAAC,OAAA,MAAA,MAAM,CAAC,aAAa,uDAAG,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA,EAAA,CACzD,CAAC;YACF,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC3E,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,KAAK,UAAU,iBAAiB;IAC9B,4EAA4E;IAC5E,4EAA4E;IAC5E,0EAA0E;IAC1E,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;IACzF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB,EAAE,KAAa,EAAE,MAAc;IAChE,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,SAAS,GAAG,GAAG,GAAG,OAAO,CAAC;QAChC,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC;QAClE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../../../src/creator3/capture.ts"],"names":[],"mappings":"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"}

package/dist/creator3/creator3/transport.d.ts

@@ -2,6 +2,7 @@ import { type FTNativeTransport } from '../core/transport.js';
 import type { FTValue } from '../core/types.js';
 export declare class FTCreator3Transport implements FTNativeTransport {
     readonly platform: 'android' | 'ios' | 'unsupported';
+    invokeAsync<T = FTValue>(method: string, payload?: unknown): Promise<T | undefined>;
     constructor();
     invoke<T = FTValue>(method: string, payload?: unknown): T | undefined;
 }

package/dist/creator3/creator3/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;;IAYrD,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;CActE"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;IAErD,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;;IAcnF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;CActE"}

package/dist/creator3/creator3/transport.js

@@ -1,7 +1,11 @@
 import { native, sys } from 'cc';
 import { NATIVE } from 'cc/env';
 import { parseTransportResponse } from '../core/transport.js';
+import { invokeReplayAsync } from '../core/replay-async-transport.js';
 export class FTCreator3Transport {
+    invokeAsync(method, payload) {
+        return invokeReplayAsync(this, method, payload);
+    }
     constructor() {
         this.platform = !NATIVE
             ? 'unsupported'

package/dist/creator3/creator3/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,sBAAsB,CAAC;AAGtF,MAAM,OAAO,mBAAmB;IAG9B;QACE,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM;YACrB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,OAAO;gBACzB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG;oBACrB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,aAAa,CAAC;IACxB,CAAC;IAED,MAAM,CAAc,MAAc,EAAE,OAAiB;QACnD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAChC,gCAAgC,EAChC,QAAQ,EACR,0DAA0D,EAC1D,MAAM,EACN,IAAI,CACL;YACH,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzF,OAAO,sBAAsB,CAAI,GAAG,CAAC,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../src/creator3/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAA0B,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,OAAO,mBAAmB;IAG9B,WAAW,CAAc,MAAc,EAAE,OAAiB;QACxD,OAAO,iBAAiB,CAAI,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;QACE,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM;YACrB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,OAAO;gBACzB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG;oBACrB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,aAAa,CAAC;IACxB,CAAC;IAED,MAAM,CAAc,MAAc,EAAE,OAAiB;QACnD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,SAAS,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,KAAK,SAAS;YACrC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAChC,gCAAgC,EAChC,QAAQ,EACR,0DAA0D,EAC1D,MAAM,EACN,IAAI,CACL;YACH,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzF,OAAO,sBAAsB,CAAI,GAAG,CAAC,CAAC;IACxC,CAAC;CACF"}

package/extensions/creator2/install-native.cjs

@@ -30,6 +30,11 @@ function installNative(buildRoot, extensionRoot, logger = console) {
   const buildNative = path.join(buildRoot, 'cocos-sdk-native');
   copyDirectory(nativeSource, buildNative);
   const files = findFiles(buildRoot, 7);
+  const replayHeader = path.join(buildNative, 'shared', 'FTReplayFileBridge.h');
+  if (fs.existsSync(replayHeader)) {
+    findReplayEntryFiles(files)
+      .forEach((file) => patchReplayFileBridge(file, replayHeader));
+  }
   const gradlePropertiesFiles = files.filter((file) => path.basename(file) === 'gradle.properties');
   const gradleFiles = uniqueFiles([
     ...files.filter((file) => /(?:^|\/)app\/build\.gradle$/.test(normalize(file))),
@@ -61,6 +66,53 @@ function installNative(buildRoot, extensionRoot, logger = console) {
   );
 }
 
+function patchReplayFileBridge(file, header) {
+  const original = fs.readFileSync(file, 'utf8');
+  const includeBegin = '// COCOS_SDK_REPLAY_INCLUDE_BEGIN';
+  const includeEnd = '// COCOS_SDK_REPLAY_INCLUDE_END';
+  const initBegin = '// COCOS_SDK_REPLAY_INIT_BEGIN';
+  const initEnd = '// COCOS_SDK_REPLAY_INIT_END';
+  // Creator 3 shares Game.cpp across iOS/Android builds. Keep its include stable
+  // when another platform's build directory is cleaned or regenerated.
+  const sharedDirectory = path.join(path.dirname(file), 'cocos-sdk-replay');
+  const include = `${includeBegin}\n#include "cocos-sdk-replay/FTReplayFileBridge.h"\n${includeEnd}`;
+  const init = `${initBegin}\n    ft_cocos::installReplayFileBridge();\n    ${initEnd}\n    `;
+  let next = original;
+  if (markedPattern(initBegin, initEnd).test(next)) {
+    next = next.replace(markedPattern(initBegin, initEnd), init.trimEnd());
+  } else {
+    const anchor = path.basename(file) === 'Game.cpp'
+      ? /\b(?:return\s+)?BaseGame::init\(\);/
+      : /\b(?:return\s+)?se->start\(\);/;
+    if (!anchor.test(next)) return;
+    next = next.replace(anchor, (value) => init + value);
+  }
+  next = markedPattern(includeBegin, includeEnd).test(next)
+    ? next.replace(markedPattern(includeBegin, includeEnd), include)
+    : `${include}\n${next}`;
+  copyDirectory(path.dirname(header), sharedDirectory);
+  if (next !== original) fs.writeFileSync(file, next);
+}
+
+function findReplayEntryFiles(files) {
+  const entries = files.filter((file) => ['AppDelegate.cpp', 'Game.cpp'].includes(path.basename(file)));
+  for (const file of files) {
+    let nativeDirectory;
+    if (path.basename(file) === 'gradle.properties') {
+      const value = readProperty(fs.readFileSync(file, 'utf8'), 'NATIVE_DIR');
+      if (value) nativeDirectory = path.resolve(path.dirname(file), value);
+    } else if (path.basename(file) === 'CMakeCache.txt') {
+      const match = fs.readFileSync(file, 'utf8').match(/^CMAKE_HOME_DIRECTORY:INTERNAL=(.+)$/m);
+      if (match) nativeDirectory = match[1].trim();
+    }
+    if (nativeDirectory) {
+      const game = path.resolve(nativeDirectory, '..', 'common', 'Classes', 'Game.cpp');
+      if (fs.existsSync(game)) entries.push(game);
+    }
+  }
+  return uniqueFiles(entries);
+}
+
 function patchCocos2IosConfiguration(projectFile, target) {
   const projectDirectory = path.dirname(path.dirname(projectFile));
   const iosDirectory = path.join(projectDirectory, 'ios');
@@ -202,7 +254,7 @@ function patchGradle(file, nativeRoot) {
     'dependencies {',
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:1.7.6-alpha02'",
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-native:1.1.3'",
-    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-session-replay:0.1.9-alpha02'",
+    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-session-replay:0.1.9-alpha03'",
     "    implementation 'com.google.code.gson:gson:2.10.1'",
     "    implementation platform('org.jetbrains.kotlin:kotlin-bom:1.8.22')",
     "    implementation 'androidx.appcompat:appcompat:1.1.0'",

package/extensions/creator3/install-native.cjs

@@ -30,6 +30,11 @@ function installNative(buildRoot, extensionRoot, logger = console) {
   const buildNative = path.join(buildRoot, 'cocos-sdk-native');
   copyDirectory(nativeSource, buildNative);
   const files = findFiles(buildRoot, 7);
+  const replayHeader = path.join(buildNative, 'shared', 'FTReplayFileBridge.h');
+  if (fs.existsSync(replayHeader)) {
+    findReplayEntryFiles(files)
+      .forEach((file) => patchReplayFileBridge(file, replayHeader));
+  }
   const gradlePropertiesFiles = files.filter((file) => path.basename(file) === 'gradle.properties');
   const gradleFiles = uniqueFiles([
     ...files.filter((file) => /(?:^|\/)app\/build\.gradle$/.test(normalize(file))),
@@ -61,6 +66,53 @@ function installNative(buildRoot, extensionRoot, logger = console) {
   );
 }
 
+function patchReplayFileBridge(file, header) {
+  const original = fs.readFileSync(file, 'utf8');
+  const includeBegin = '// COCOS_SDK_REPLAY_INCLUDE_BEGIN';
+  const includeEnd = '// COCOS_SDK_REPLAY_INCLUDE_END';
+  const initBegin = '// COCOS_SDK_REPLAY_INIT_BEGIN';
+  const initEnd = '// COCOS_SDK_REPLAY_INIT_END';
+  // Creator 3 shares Game.cpp across iOS/Android builds. Keep its include stable
+  // when another platform's build directory is cleaned or regenerated.
+  const sharedDirectory = path.join(path.dirname(file), 'cocos-sdk-replay');
+  const include = `${includeBegin}\n#include "cocos-sdk-replay/FTReplayFileBridge.h"\n${includeEnd}`;
+  const init = `${initBegin}\n    ft_cocos::installReplayFileBridge();\n    ${initEnd}\n    `;
+  let next = original;
+  if (markedPattern(initBegin, initEnd).test(next)) {
+    next = next.replace(markedPattern(initBegin, initEnd), init.trimEnd());
+  } else {
+    const anchor = path.basename(file) === 'Game.cpp'
+      ? /\b(?:return\s+)?BaseGame::init\(\);/
+      : /\b(?:return\s+)?se->start\(\);/;
+    if (!anchor.test(next)) return;
+    next = next.replace(anchor, (value) => init + value);
+  }
+  next = markedPattern(includeBegin, includeEnd).test(next)
+    ? next.replace(markedPattern(includeBegin, includeEnd), include)
+    : `${include}\n${next}`;
+  copyDirectory(path.dirname(header), sharedDirectory);
+  if (next !== original) fs.writeFileSync(file, next);
+}
+
+function findReplayEntryFiles(files) {
+  const entries = files.filter((file) => ['AppDelegate.cpp', 'Game.cpp'].includes(path.basename(file)));
+  for (const file of files) {
+    let nativeDirectory;
+    if (path.basename(file) === 'gradle.properties') {
+      const value = readProperty(fs.readFileSync(file, 'utf8'), 'NATIVE_DIR');
+      if (value) nativeDirectory = path.resolve(path.dirname(file), value);
+    } else if (path.basename(file) === 'CMakeCache.txt') {
+      const match = fs.readFileSync(file, 'utf8').match(/^CMAKE_HOME_DIRECTORY:INTERNAL=(.+)$/m);
+      if (match) nativeDirectory = match[1].trim();
+    }
+    if (nativeDirectory) {
+      const game = path.resolve(nativeDirectory, '..', 'common', 'Classes', 'Game.cpp');
+      if (fs.existsSync(game)) entries.push(game);
+    }
+  }
+  return uniqueFiles(entries);
+}
+
 function patchCocos2IosConfiguration(projectFile, target) {
   const projectDirectory = path.dirname(path.dirname(projectFile));
   const iosDirectory = path.join(projectDirectory, 'ios');
@@ -202,7 +254,7 @@ function patchGradle(file, nativeRoot) {
     'dependencies {',
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:1.7.6-alpha02'",
     "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-native:1.1.3'",
-    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-session-replay:0.1.9-alpha02'",
+    "    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-session-replay:0.1.9-alpha03'",
     "    implementation 'com.google.code.gson:gson:2.10.1'",
     "    implementation platform('org.jetbrains.kotlin:kotlin-bom:1.8.22')",
     "    implementation 'androidx.appcompat:appcompat:1.1.0'",

package/native/android/src/main/java/com/ft/sdk/cocos/FTCocosBridge.java

@@ -124,6 +124,10 @@ public final class FTCocosBridge {
 
     private static Object dispatch(String method, JSONObject payload) throws Exception {
         switch (method) {
+            case "replay.beginSaveImage":
+                return FTCocosReplayImageJobs.begin(payload);
+            case "replay.pollSaveImage":
+                return FTCocosReplayImageJobs.poll(payload.getString("job"));
             case "hybrid.attach":
                 attachHybrid(payload);
                 return null;

package/native/android/src/main/java/com/ft/sdk/cocos/FTCocosReplayImageJobs.java

@@ -0,0 +1,55 @@
+package com.ft.sdk.cocos;
+
+import org.json.JSONObject;
+import java.util.UUID;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/** One image in flight across JS runtimes; the caller polls without waiting on disk/encoding. */
+final class FTCocosReplayImageJobs {
+    private static final ExecutorService worker = Executors.newSingleThreadExecutor(runnable -> {
+        Thread thread = new Thread(runnable, "cocos-replay-image");
+        thread.setDaemon(true);
+        return thread;
+    });
+    private static Job current;
+
+    private static final class Job {
+        final String id = UUID.randomUUID().toString();
+        String response;
+    }
+
+    static synchronized String begin(JSONObject arguments) throws Exception {
+        final String method = arguments.getString("method");
+        if (!"replay.saveImage".equals(method) && !"replay.saveImageV2".equals(method)) {
+            throw new IllegalArgumentException("Unsupported asynchronous Replay method");
+        }
+        final String payload = arguments.getJSONObject("arguments").toString();
+        if (current != null && current.response == null) throw new IllegalStateException("Replay encoder is busy");
+        final Job job = new Job();
+        current = job;
+        try {
+            worker.execute(() -> {
+                String response = FTCocosBridge.invokeLocal(method, payload);
+                synchronized (FTCocosReplayImageJobs.class) {
+                    job.response = response;
+                }
+            });
+        } catch (RuntimeException error) {
+            current = null;
+            throw error;
+        }
+        return job.id;
+    }
+
+    static synchronized JSONObject poll(String id) throws Exception {
+        if (current == null || !current.id.equals(id)) throw new IllegalArgumentException("Replay encoding job is unavailable");
+        JSONObject result = new JSONObject();
+        result.put("pending", current.response == null);
+        if (current.response != null) {
+            result.put("response", current.response);
+            current = null;
+        }
+        return result;
+    }
+}

package/native/ios/FTCocosBridge.m

@@ -1,4 +1,5 @@
 #import "FTCocosBridge.h"
+#import "FTCocosReplayImageJobs.h"
 
 #import "FTMobileSDK.h"
 #import "FTSessionReplay.h"
@@ -24,6 +25,10 @@
 }
 
 + (id)dispatch:(NSString *)method arguments:(NSDictionary *)arguments {
+    if ([method isEqualToString:@"replay.beginSaveImage"]) return [self beginSaveImage:arguments];
+    if ([method isEqualToString:@"replay.pollSaveImage"]) {
+        return [FTCocosReplayImageJobs poll:[self requiredText:arguments key:@"job"]];
+    }
     FTExternalDataManager *rum = [FTExternalDataManager sharedManager];
     if ([method isEqualToString:@"hybrid.attach"]) {
         [self ensureNativeHostInitialized];
@@ -254,6 +259,18 @@
     return nil;
 }
 
++ (NSString *)beginSaveImage:(NSDictionary *)arguments {
+    NSString *method = [self requiredText:arguments key:@"method"];
+    if (![method isEqualToString:@"replay.saveImage"] && ![method isEqualToString:@"replay.saveImageV2"]) {
+        [self fail:@"Unsupported asynchronous Replay method"];
+    }
+    NSDictionary *payload = [[self dictionary:arguments[@"arguments"]] copy];
+    if (!payload) [self fail:@"Replay image arguments are required"];
+    return [FTCocosReplayImageJobs beginWithWork:^NSString *{
+        return [self responseWithValue:[self dispatch:method arguments:payload] error:nil];
+    }];
+}
+
 + (void)ensureNativeHostInitialized {
     @try {
         if (![FTMobileAgent sharedInstance]) {

package/native/ios/FTCocosBridge.podspec

@@ -1,13 +1,13 @@
 Pod::Spec.new do |s|
   s.name             = 'FTCocosBridge'
-  s.version          = '0.1.0-alpha.3'
+  s.version          = '0.1.0-alpha.4'
   s.summary          = 'CloudCare Mobile SDK native bridge for Cocos Creator.'
   s.homepage         = 'https://github.com/GuanceCloud/datakit-cocos'
   s.license          = { :type => 'Apache-2.0' }
   s.author           = { 'Guance Cloud' => 'support@guance.com' }
   s.source           = { :path => '.' }
   s.platform         = :ios, '12.0'
-  s.source_files     = 'FTCocosBridge.{h,m}'
+  s.source_files     = 'FTCocosBridge.{h,m}', 'FTCocosReplayImageJobs.{h,m}'
   s.public_header_files = 'FTCocosBridge.h'
   s.requires_arc     = true
   # Cocos resolves FTCocosBridge by class name at runtime, so no direct symbol

package/native/ios/FTCocosReplayImageJobs.h

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/** One background image operation, with nonblocking result retrieval from JSB. */
+@interface FTCocosReplayImageJobs : NSObject
++ (NSString *)beginWithWork:(NSString *(^)(void))work;
++ (NSDictionary *)poll:(NSString *)identifier;
+@end
+
+NS_ASSUME_NONNULL_END

package/native/ios/FTCocosReplayImageJobs.m

@@ -0,0 +1,54 @@
+#import "FTCocosReplayImageJobs.h"
+
+@interface FTCocosReplayImageJob : NSObject
+@property (nonatomic, copy) NSString *identifier;
+@property (nonatomic, copy) NSString *response;
+@end
+@implementation FTCocosReplayImageJob
+@end
+
+static FTCocosReplayImageJob *currentJob;
+
+@implementation FTCocosReplayImageJobs
+
++ (NSString *)beginWithWork:(NSString *(^)(void))work {
+    FTCocosReplayImageJob *job = [FTCocosReplayImageJob new];
+    job.identifier = NSUUID.UUID.UUIDString;
+    @synchronized (self) {
+        if (currentJob && !currentJob.response) {
+            [NSException raise:NSInternalInconsistencyException format:@"Replay encoder is busy"];
+        }
+        currentJob = job;
+    }
+    dispatch_async(dispatch_get_global_queue(QOS_CLASS_UTILITY, 0), ^{
+        @autoreleasepool {
+            NSString *response;
+            @try {
+                response = work();
+            } @catch (NSException *exception) {
+                NSData *data = [NSJSONSerialization dataWithJSONObject:@{
+                    @"ok": @NO, @"error": exception.reason ?: @"Replay encoding failed"
+                } options:0 error:nil];
+                response = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+            }
+            @synchronized (self) {
+                job.response = response ?: @"{\"ok\":false,\"error\":\"Empty Replay encoding result\"}";
+            }
+        }
+    });
+    return job.identifier;
+}
+
++ (NSDictionary *)poll:(NSString *)identifier {
+    @synchronized (self) {
+        if (![currentJob.identifier isEqualToString:identifier]) {
+            [NSException raise:NSInvalidArgumentException format:@"Replay encoding job is unavailable"];
+        }
+        if (!currentJob.response) return @{ @"pending": @YES };
+        NSDictionary *result = @{ @"pending": @NO, @"response": currentJob.response };
+        currentJob = nil;
+        return result;
+    }
+}
+
+@end

package/native/shared/FTReplayFileBridge.h

@@ -0,0 +1,62 @@
+#pragma once
+
+#if __has_include("bindings/jswrapper/SeApi.h")
+#define FT_COCOS_CREATOR3 1
+#include "bindings/jswrapper/SeApi.h"
+#else
+#include "cocos/scripting/js-bindings/jswrapper/SeApi.h"
+#endif
+#include "FTReplayFileWorker.h"
+
+namespace ft_cocos {
+
+static ReplayFileWorker replayFiles;
+
+static bool writeReplayFile(se::State& state) {
+    const auto& args = state.args();
+    if (args.size() != 2 || !args[0].isObject() || !args[1].isString()) return false;
+    auto* object = args[0].toObject();
+    if (!object->isTypedArray()) return false;
+    uint8_t* bytes = nullptr;
+    size_t size = 0;
+    if (!object->getTypedArrayData(&bytes, &size)) return false;
+    state.rval().setBoolean(replayFiles.write(bytes, size, args[1].toString()));
+    return true;
+}
+SE_BIND_FUNC(writeReplayFile)
+
+static bool pollReplayFile(se::State& state) {
+    state.rval().setString(replayFiles.poll());
+    return true;
+}
+SE_BIND_FUNC(pollReplayFile)
+
+static bool removeReplayFile(se::State& state) {
+    const auto& args = state.args();
+    if (args.size() != 1 || !args[0].isString()) return false;
+    state.rval().setBoolean(replayFiles.remove(args[0].toString()));
+    return true;
+}
+SE_BIND_FUNC(removeReplayFile)
+
+static bool registerReplayFileBridge(se::Object* global) {
+    replayFiles.cancel();
+    const se::HandleObject bridge(se::Object::createPlainObject());
+    bridge->defineFunction("write", _SE(writeReplayFile));
+    bridge->defineFunction("poll", _SE(pollReplayFile));
+    bridge->defineFunction("remove", _SE(removeReplayFile));
+    global->setProperty("__ftCocosReplayFile", se::Value(bridge));
+    se::ScriptEngine::getInstance()->addBeforeCleanupHook([]() { replayFiles.cancel(); });
+    return true;
+}
+
+static void installReplayFileBridge() {
+#if FT_COCOS_CREATOR3
+    se::ScriptEngine::getInstance()->addPermanentRegisterCallback(registerReplayFileBridge);
+#else
+    // Creator 2 calls AppDelegate again when restarting its script VM.
+    se::ScriptEngine::getInstance()->addRegisterCallback(registerReplayFileBridge);
+#endif
+}
+
+} // namespace ft_cocos

package/native/shared/FTReplayFileWorker.h

@@ -0,0 +1,88 @@
+#pragma once
+
+#include <atomic>
+#include <cerrno>
+#include <cstdio>
+#include <memory>
+#include <string>
+#include <thread>
+#include <vector>
+
+namespace ft_cocos {
+
+// Accessed only by the script thread. Workers own their buffers and never touch JS.
+class ReplayFileWorker {
+    enum Status { Pending, Written, Removed, Error };
+    struct Job {
+        std::string path;
+        std::atomic<Status> status{Pending};
+        std::atomic<bool> cancelled{false};
+    };
+    std::shared_ptr<Job> current;
+
+public:
+    bool write(const unsigned char* bytes, size_t size, const std::string& path) {
+        if (current && current->cancelled.load() && current->status.load() != Pending) current.reset();
+        if (current || !bytes || size == 0 || size > 2048U * 2048U * 4U || path.empty()) return false;
+        try {
+            auto job = std::make_shared<Job>();
+            job->path = path;
+            // This bounded copy is necessary because the JS buffer can be collected/reused.
+            std::vector<unsigned char> pixels(bytes, bytes + size);
+            current = job;
+            std::thread([job](std::vector<unsigned char> data) {
+                FILE* file = std::fopen(job->path.c_str(), "wb");
+                bool ok = false;
+                if (file) {
+                    const bool written = std::fwrite(data.data(), 1, data.size(), file) == data.size();
+                    ok = std::fclose(file) == 0 && written;
+                }
+                if (!ok || job->cancelled.load()) std::remove(job->path.c_str());
+                job->status.store(ok ? Written : Error);
+                // Covers cleanup racing with the final status transition.
+                if (job->cancelled.load()) std::remove(job->path.c_str());
+            }, std::move(pixels)).detach();
+        } catch (...) {
+            current.reset();
+            return false;
+        }
+        return true;
+    }
+
+    bool remove(const std::string& path) {
+        if (!current || current->path != path || current->status.load() != Written) return false;
+        auto job = current;
+        job->status.store(Pending);
+        try {
+            std::thread([job]() {
+                const bool ok = std::remove(job->path.c_str()) == 0 || errno == ENOENT;
+                job->status.store(ok ? Removed : Error);
+            }).detach();
+        } catch (...) {
+            job->status.store(Written);
+            return false;
+        }
+        return true;
+    }
+
+    const char* poll() {
+        if (!current) return "error";
+        switch (current->status.load()) {
+            case Pending: return "pending";
+            case Written: return "written";
+            case Removed: current.reset(); return "removed";
+            case Error: current.reset(); return "error";
+        }
+        return "error";
+    }
+
+    void cancel() {
+        if (!current) return;
+        auto job = current;
+        job->cancelled.store(true);
+        if (job->status.load() == Written) remove(job->path);
+        // Keep the slot occupied until its worker exits, including across VM restarts.
+    }
+};
+
+} // namespace ft_cocos

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcare/cocos-sdk",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "Observability SDK integration for Cocos Creator 2.4 and 3.x",
   "license": "Apache-2.0",
   "author": "Guance Cloud",
@@ -37,6 +37,7 @@
     "creator2",
     "creator3",
     "dist",
+    "components",
     "extensions",
     "native",
     "bin",