@chiyou/minigame-framework 1.2.69 → 1.3.1

package/src/Framework/Utils/ObjectUtils.ts

@@ -23,4 +23,115 @@ export class ObjectUtils {
 
         return keysA.every(key => ObjectUtils.deepEqual(a[key], b[key]));
     }
+
+    // ======================== Base64 编解码 ========================
+
+    private static readonly BASE64_CHARS: string = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+
+    /**
+     * 将字符串转为 UTF-8 字节数组
+     */
+    private static utf8ToBytes(str: string): number[] {
+        const bytes: number[] = [];
+        for (let i = 0; i < str.length; i++) {
+            const code = str.charCodeAt(i);
+            if (code < 0x80) {
+                bytes.push(code);
+            } else if (code < 0x800) {
+                bytes.push(0xC0 | (code >> 6));
+                bytes.push(0x80 | (code & 0x3F));
+            } else if (code >= 0xD800 && code <= 0xDBFF) {
+                // 代理对（emoji 等）
+                const hi = code;
+                const lo = str.charCodeAt(++i);
+                const codePoint = ((hi - 0xD800) << 10) + (lo - 0xDC00) + 0x10000;
+                bytes.push(0xF0 | (codePoint >> 18));
+                bytes.push(0x80 | ((codePoint >> 12) & 0x3F));
+                bytes.push(0x80 | ((codePoint >> 6) & 0x3F));
+                bytes.push(0x80 | (codePoint & 0x3F));
+            } else {
+                bytes.push(0xE0 | (code >> 12));
+                bytes.push(0x80 | ((code >> 6) & 0x3F));
+                bytes.push(0x80 | (code & 0x3F));
+            }
+        }
+        return bytes;
+    }
+
+    /**
+     * 将 UTF-8 字节数组转为字符串
+     */
+    private static utf8FromBytes(bytes: number[]): string {
+        let result = "";
+        let i = 0;
+        while (i < bytes.length) {
+            const b1 = bytes[i++];
+            if (b1 < 0x80) {
+                result += String.fromCharCode(b1);
+            } else if (b1 < 0xE0) {
+                const b2 = bytes[i++];
+                result += String.fromCharCode(((b1 & 0x1F) << 6) | (b2 & 0x3F));
+            } else if (b1 < 0xF0) {
+                const b2 = bytes[i++];
+                const b3 = bytes[i++];
+                result += String.fromCharCode(((b1 & 0x0F) << 12) | ((b2 & 0x3F) << 6) | (b3 & 0x3F));
+            } else {
+                const b2 = bytes[i++];
+                const b3 = bytes[i++];
+                const b4 = bytes[i++];
+                const codePoint = ((b1 & 0x07) << 18) | ((b2 & 0x3F) << 12) | ((b3 & 0x3F) << 6) | (b4 & 0x3F);
+                // 转为代理对
+                const offset = codePoint - 0x10000;
+                result += String.fromCharCode(0xD800 + (offset >> 10), 0xDC00 + (offset & 0x3FF));
+            }
+        }
+        return result;
+    }
+
+    /**
+     * Base64 编码（纯 JS 实现，兼容所有小游戏/快应用平台，支持中文和 emoji）
+     * @param str 要编码的字符串
+     * @returns Base64 编码后的字符串
+     */
+    public static base64Encode(str: string): string {
+        const bytes = ObjectUtils.utf8ToBytes(str);
+        const chars = ObjectUtils.BASE64_CHARS;
+        let result = "";
+        for (let i = 0; i < bytes.length; i += 3) {
+            const a = bytes[i];
+            const b = i + 1 < bytes.length ? bytes[i + 1] : 0;
+            const c = i + 2 < bytes.length ? bytes[i + 2] : 0;
+            result += chars[(a >> 2) & 0x3F];
+            result += chars[((a << 4) | (b >> 4)) & 0x3F];
+            result += i + 1 < bytes.length ? chars[((b << 2) | (c >> 6)) & 0x3F] : "=";
+            result += i + 2 < bytes.length ? chars[c & 0x3F] : "=";
+        }
+        return result;
+    }
+
+    /**
+     * Base64 解码（纯 JS 实现，兼容所有小游戏/快应用平台，支持中文和 emoji）
+     * @param str Base64 编码的字符串
+     * @returns 解码后的原始字符串
+     */
+    public static base64Decode(str: string): string {
+        const chars = ObjectUtils.BASE64_CHARS;
+        const bytes: number[] = [];
+        // 去除空白字符
+        str = str.replace(/\s/g, "");
+        for (let i = 0; i < str.length; i += 4) {
+            const a = chars.indexOf(str[i]);
+            const b = chars.indexOf(str[i + 1]);
+            const c = str[i + 2] === "=" ? 0 : chars.indexOf(str[i + 2]);
+            const d = str[i + 3] === "=" ? 0 : chars.indexOf(str[i + 3]);
+            bytes.push((a << 2) | (b >> 4));
+            if (str[i + 2] !== "=") {
+                bytes.push(((b & 0xF) << 4) | (c >> 2));
+            }
+            if (str[i + 3] !== "=") {
+                bytes.push(((c & 0x3) << 6) | d);
+            }
+        }
+        return ObjectUtils.utf8FromBytes(bytes);
+    }
 }

package/src/index.ts

@@ -52,4 +52,6 @@ export * from './Framework/Definition/PrivacyDefinition';
 export * from './Framework/Definition/SocialDefinition';
 export * from './Framework/Definition/FwkErrorDefinition';
 export * from './Framework/Definition/UIDefinition';
+export * from './Framework/Definition/EventDefinition';
+export * from './Framework/Definition/TimerDefinition';
 export * from './Framework/Definition/FrameworkBase';