更新记录

1.0.0（2026-04-03）

v1.0.0 初次上传测试

平台兼容性

uni-app(4.87)

uni-app x(5.06)

etalya-wmpfmodules

前置条件

• 仅支持 Android；iOS 目前为不支持占位实现
• 设备需安装并运行 WMPF Service APK（2.1+），部分能力（如推送事件新接口/设备激活失效监听）要求 2.2+
• 本插件已内置本地依赖：utssdk/app-android/libs/wmpf-cli-2.2.0.aar

两种模式

1) 快速验证（Quick）

适合 Demo/联调，直接用 ticket + wxaAppId + hostAppId 去拉取演示设备信息并初始化。

• quickInitByTicket：只初始化（可选自动激活）
• quickLaunchMiniProgram：初始化 + 启动小程序（一步到位）

import {
  quickLaunchMiniProgram,
  onPushMessage,
} from '@/uni_modules/etalya-wmpfmodules'

quickLaunchMiniProgram({
  ticket: 'YOUR_TICKET',
  wxaAppId: 'YOUR_WXA_APPID',
  hostAppId: 'YOUR_HOST_APPID',
  appId: 'YOUR_WXA_APPID',
  path: '',
  appType: 'RELEASE',
  activate: true,
  success: () => {
    console.log('wmpf ready')
  },
  fail: (e) => {
    console.error('wmpf failed', e)
  },
})

onPushMessage({
  listener: (msg) => {
    console.log('push msg', msg)
  },
})

2) 正式使用（Production）

适合生产环境：设备信息（签名/密钥版本/设备号等）应由你的服务端按安全流程下发，客户端只负责初始化与调用 WMPF API。

import {
  init,
  activateDevice,
  preload,
  launchMiniProgram,
  login,
  isLogin,
  logout,
  getPushToken,
} from '@/uni_modules/etalya-wmpfmodules'

init({
  device: {
    hostAppId: 'YOUR_HOST_APPID',
    productId: 0,
    keyVersion: 0,
    deviceId: 'YOUR_DEVICE_ID',
    signature: 'YOUR_SIGNATURE',
  },
  activate: false,
  success: () => {
    console.log('init ok')
  },
})

activateDevice({
  success: () => console.log('activated'),
})

preload({ success: () => console.log('preload ok') })

launchMiniProgram({
  appId: 'YOUR_WXA_APPID',
  path: '',
  appType: 'RELEASE',
  landscapeMode: 'NORMAL',
})

login({
  style: 'FULLSCREEN',
  success: (res) => console.log('oauthCode', res.oauthCode),
})

isLogin({ success: (res) => console.log('isLogin', res.isLogin) })
logout({})

getPushToken({
  appId: 'YOUR_WXA_APPID',
  success: (res) => console.log('pushToken', res.pushToken),
})

错误码（errCode）

• 9010001 参数错误
• 9010002 未初始化
• 9010003 当前平台/版本不支持
• 9010004 网络错误（仅快速验证使用）
• 9010005 WMPF API 错误（nativeErrCode/nativeErrMsg 透出原生信息）
• 9010006 未知错误