feat: complete huihui square avatar workflows

2026-07-24 14:04:21 +08:00
parent 2ef58a44b8
commit e3bda469bb
68 changed files with 8062 additions and 132 deletions
@@ -0,0 +1,65 @@
+// 会会数字分身 H5 ↔ uniapp 原生壳 桥接工具
+// 协议详见 uniapp-avatar/README.md
+//
+// 引入方式：在 index.html 中加载 uniapp web-view bridge：
+//   <script src="https://unpkg.com/@dcloudio/uni-webview-js@0.0.10/index.js"></script>
+// 引入后全局会出现 window.uni.webView，H5 即可用 postMessage 与原生通信。
+
+const BRIDGE_HANDLER = '__uniBridgeHandle__'
+
+export interface UniLaunchParams {
+  token?: string
+  userId?: string
+  nickname?: string
+  avatar?: string
+  ts?: string
+}
+
+// 是否运行在 uniapp web-view 环境中
+export function isInUniWebView(): boolean {
+  return !!(window as any).uni?.webView
+}
+
+// 解析 web-view 加载 URL 时原生注入的参数（token / 会会用户）
+export function getLaunchParams(): UniLaunchParams {
+  const sp = new URLSearchParams(window.location.search)
+  const params: UniLaunchParams = {}
+  const token = sp.get('token')
+  const userId = sp.get('userId')
+  const nickname = sp.get('nickname')
+  const avatar = sp.get('avatar')
+  const ts = sp.get('ts')
+  if (token) params.token = token
+  if (userId) params.userId = userId
+  if (nickname) params.nickname = decodeURIComponent(nickname)
+  if (avatar) params.avatar = decodeURIComponent(avatar)
+  if (ts) params.ts = ts
+  return params
+}
+
+// H5 → 原生：发送事件（需引入 uniapp web-view bridge）
+export function postToNative(message: Record<string, any>): boolean {
+  if (!isInUniWebView()) return false
+  ;(window as any).uni.webView.postMessage({ data: message })
+  return true
+}
+
+// 原生 → H5：注册消息处理（原生通过 web-view.evalJS 调用 window.__uniBridgeHandle__）
+export function onNativeMessage(handler: (message: any) => void): void {
+  ;(window as any)[BRIDGE_HANDLER] = (message: any) => {
+    try {
+      handler(message)
+    } catch (e) {
+      console.error('[uniBridge] handler error', e)
+    }
+  }
+}
+
+// 便捷事件
+export const UniEvents = {
+  ready: () => postToNative({ type: 'ready' }),
+  needLogin: () => postToNative({ type: 'needLogin' }),
+  setTitle: (title: string) => postToNative({ type: 'setTitle', title }),
+  navigate: (path: string) => postToNative({ type: 'navigate', path }),
+  back: () => postToNative({ type: 'back' })
+}