更新记录

0.1.1（2026-06-02） 下载此版本

开源

0.1.0（2026-06-02） 下载此版本

• 新增蘑菇星球 Android SDK 插件文档
• 补充 README 接口、依赖、接入要求和常见问题

平台兼容性

uni-app x(5.06)

ad-mogu-sdk

蘑菇星球 Android SDK 的 uni-app x UTS 封装插件。

插件提供统一的 start(options) 启动入口，并支持状态查询，适合任务变现、试玩变现等 Android 接入场景。

适用范围

• uni-app x
• Android
• 需要自定义基座或自定义打包环境

对外接口

MoguStartOptions

type MoguStartOptions = {
  userId : string
  appId : string
  appSecret : string
  oaid : string
  imei : string
  cutInType : number
  titleText : string
  titleColor : string
  statusBarColor : string
  tabIndicatorColor : string
  titleBackColor : string
  titleTextColor : string
  tabTextColor : string
  tabSelectedTextColor : string
  tabBackgroundColor : string
  additionalData : string
  checkUsage : boolean
}

MoguSDKStatus

type MoguSDKStatus = {
  initialized : boolean
  hasCredentials : boolean
  message : string
}

导出方法

• start(options)
• getStatus()

实现说明

插件通过 uts.sdk.modules.mogusdk 中的 MoguSdkManager 调起原生能力。

当前实现逻辑：

1. 先检查是否已同意隐私协议
2. 获取 Application Context 与当前 Activity
3. 调用原生 start(...) 拉起蘑菇星球页面
4. 支持通过大量颜色与文案字段自定义页面展示

如果用户未同意隐私协议，插件会直接返回 false，不会继续启动。

Android 依赖

当前声明依赖包括：

• androidx.appcompat:appcompat:1.4.1
• com.google.android.material:material:1.6.0
• androidx.constraintlayout:constraintlayout:2.1.4
• io.reactivex.rxjava2:rxandroid:2.1.1
• io.reactivex.rxjava2:rxjava:2.2.6
• com.jakewharton.rxrelay2:rxrelay:2.1.1
• com.squareup.retrofit2:retrofit:2.6.2
• com.squareup.retrofit2:adapter-rxjava2:2.6.2
• com.squareup.retrofit2:converter-scalars:2.6.2
• com.squareup.retrofit2:converter-gson:2.6.2
• com.squareup.okhttp3:okhttp:3.12.10
• com.squareup.okhttp3:logging-interceptor:3.12.10
• com.alibaba:fastjson:1.2.68
• com.github.bumptech.glide:glide:4.9.0
• com.tencent.mm.opensdk:wechat-sdk-android:6.8.24
• com.google.zxing:core:3.3.3
• com.journeyapps:zxing-android-embedded:3.6.0
• androidx.swiperefreshlayout:swiperefreshlayout:1.1.0

最低支持 Android 版本：23

使用前准备

1. 使用自定义基座

本插件依赖较多原生库和本地 AAR，必须使用自定义基座或自定义包。

2. 宿主应用先完成隐私授权

如果未同意隐私协议，插件会直接拒绝启动。

3. 准备渠道参数

至少需要：

• userId
• appId
• appSecret

基本用法

// #ifdef APP-ANDROID
import { start, getStatus } from '@/uni_modules/ad-mogu-sdk'
// #endif

function openMogu(userId : string, oaid : string) : boolean {
  // #ifdef APP-ANDROID
  return start({
    userId: userId,
    appId: '你的appId',
    appSecret: '你的appSecret',
    oaid: oaid,
    imei: '',
    cutInType: 1,
    titleText: '蘑菇星球',
    titleColor: '#FE2C55',
    statusBarColor: '#FFFFFF',
    tabIndicatorColor: '#FE2C55',
    titleBackColor: '#FFFFFF',
    titleTextColor: '#333333',
    tabTextColor: '#666666',
    tabSelectedTextColor: '#FE2C55',
    tabBackgroundColor: '#FFFFFF',
    additionalData: '',
    checkUsage: false
  })
  // #endif
  return false
}

常见问题

1. 提示用户未同意隐私协议

请确保宿主应用已完成隐私授权，并且调用时机在授权之后。

2. 启动失败

请优先检查：

• Activity 和 Application Context 是否可用
• 是否使用了最新自定义基座
• appId、appSecret、userId 是否有效

3. 页面样式不符合预期

请检查相关颜色和标题字段是否已按预期传值。

更新记录

0.1.0

• 提供蘑菇星球 Android SDK 的 uni-app x UTS 封装
• 支持 start(options) 启动与状态查询