更新记录

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

• 新增闲玩 Android SDK 插件文档
• 补充 README 接口、依赖、接入说明与示例

平台兼容性

uni-app x(5.06)

ad-xiaowan-sdk

闲玩 Android SDK 的 uni-app x UTS 封装插件。

插件支持 SDK 初始化、拉起不同业务页面以及状态查询，适用于 uni-app x Android 任务变现场景。

适用范围

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

对外接口

XWInitOptions

type XWInitOptions = {
  appId : string
  appSecret : string
  debug : boolean
}

XWOpenPageOptions

type XWOpenPageOptions = {
  userId : string
  pageType : number
  advertID : string
  actionBarBgColor : string
  actionBarTitleColor : string
  actionBarTitle : string
  msaOAID : string
  cnOAID : string
  showFloatMenu : boolean
  noBottomTab : boolean
  openLink : string
  openNow : boolean
}

XWSDKStatus

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

导出方法

• init(options)
• start(options)
• getStatus()

实现说明

插件通过 uts.sdk.modules.xwsdk 中的 XWSDKManager 与 XWSDKApplicationInitializer 完成原生调用。

当前特性包括：

1. 应用启动时同步注入 Application
2. 初始化时需要 appId 和 appSecret
3. 拉起页面时支持配置标题、颜色、页面类型、浮动菜单、底部栏以及跳转链接
4. 同时支持 msaOAID 和 cnOAID 两种设备标识参数

Android 依赖

当前声明依赖：

• androidx.appcompat:appcompat:1.7.0
• androidx.swiperefreshlayout:swiperefreshlayout:1.1.0
• com.google.code.gson:gson:2.10.1
• com.liulishuo.filedownloader:library:1.7.7

最低支持 Android 版本：21

使用前准备

1. 使用自定义基座

插件依赖原生实现和 Android 依赖，建议通过自定义基座或自定义包运行。

2. 准备业务参数

请先准备：

• appId
• appSecret
• userId

3. 准备页面拉起参数

你可以按业务需要传入：

• pageType
• advertID
• msaOAID
• cnOAID
• actionBarTitle
• openLink

基本用法

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

function initXiaowan() : boolean {
  // #ifdef APP-ANDROID
  return init({
    appId: '你的appId',
    appSecret: '你的appSecret',
    debug: true
  })
  // #endif
  return false
}

function openXiaowan(userId : string, oaid : string) : boolean {
  // #ifdef APP-ANDROID
  return start({
    userId: userId,
    pageType: 1,
    advertID: '',
    actionBarBgColor: '#FFFFFF',
    actionBarTitleColor: '#333333',
    actionBarTitle: '闲玩任务',
    msaOAID: oaid,
    cnOAID: oaid,
    showFloatMenu: true,
    noBottomTab: false,
    openLink: '',
    openNow: true
  })
  // #endif
  return false
}

常见问题

1. 初始化失败

请检查：

• appId 或 appSecret 是否为空
• 当前是否能获取到 Application Context

2. 页面无法拉起

请检查：

• userId 是否为空
• SDK 是否已完成初始化
• pageType 和相关参数是否符合业务预期

3. 设备标识为空

建议业务侧先准备好 OAID，再分别传给 msaOAID 与 cnOAID。

更新记录

0.1.0

• 提供闲玩 Android SDK 的 uni-app x UTS 封装
• 支持初始化、页面拉起与状态查询