更新记录

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

• 新增多量 Android SDK 的 uni-app x UTS 封装文档
• 补充 README 接口说明、接入步骤、常见问题与示例

平台兼容性

uni-app x(5.06)

ad-duoliang-sdk

多量 Android SDK 的 uni-app x UTS 封装插件。

当前插件面向 uni-app x 的 Android 平台，封装了多量任务墙相关能力，支持 SDK 初始化、打开任务列表、打开任务详情、打开个人中心以及查询当前 SDK 状态。

适用范围

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

对外接口

DLInitOptions

type DLInitOptions = {
  mediaId : string
  appSecret : string
  channel : string
  title : string
  titleBarColor : string
}

DLOpenListOptions

type DLOpenListOptions = {
  userId : string
  advertType : number
}

DLOpenDetailOptions

type DLOpenDetailOptions = {
  userId : string
  advertId : string
}

DLMineOptions

type DLMineOptions = {
  userId : string
}

DLSDKStatus

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

导出方法

• init(options)：初始化多量 SDK
• jumpAdList(options)：打开任务列表
• jumpAdDetail(options)：打开指定任务详情
• jumpMine(options)：打开个人中心
• getStatus()：获取当前状态

实现说明

插件当前通过 uts.sdk.modules.duoliangsdk 提供的原生管理器完成封装，主要流程如下：

1. 在应用启动时通过 DuoliangSdkAppHookProxy 注入 Application
2. 如果用户已同意隐私协议，则同步调用 onPrivacyAgree()
3. 调用 init(options) 时注入渠道参数
4. 调用 jumpAdList、jumpAdDetail、jumpMine 时拉起对应页面

为了降低接入方复杂度，插件内部已处理隐私同意后的同步调用逻辑，但前提仍然是宿主应用已经完成隐私授权流程。

Android 依赖

utssdk/app-android/config.json 当前声明：

• androidx.appcompat:appcompat:1.0.2

使用前准备

1. 使用自定义基座

本插件包含原生依赖，标准基座下不能保证运行成功。若控制台提示：

uni_module [ad-duoliang-sdk] (Android) 存在三方依赖或资源引用

请使用自定义基座或自定义包。

2. 先完成隐私授权

插件调用前，建议宿主应用先完成隐私协议授权，否则 SDK 的部分能力可能无法正确初始化。

3. 准备渠道参数

你需要从多量平台获取：

• mediaId
• appSecret
• channel

基本用法

// #ifdef APP-ANDROID
import { init, jumpAdList, jumpAdDetail, jumpMine, getStatus } from '@/uni_modules/ad-duoliang-sdk'
// #endif

function initDuoliang() : boolean {
  // #ifdef APP-ANDROID
  return init({
    mediaId: '你的mediaId',
    appSecret: '你的appSecret',
    channel: 'default',
    title: '任务大厅',
    titleBarColor: '#FE2C55'
  })
  // #endif
  return false
}

function openDuoliangList(userId : string) : boolean {
  // #ifdef APP-ANDROID
  return jumpAdList({
    userId: userId,
    advertType: 1
  })
  // #endif
  return false
}

常见问题

1. 初始化失败

请优先检查：

• mediaId、appSecret 是否为空
• 是否运行在 Android 自定义基座

2. 页面打不开

请检查：

• userId 是否为空
• advertId 是否为空
• SDK 是否已先成功初始化

3. 隐私未授权

若宿主应用未先同意隐私协议，部分 SDK 初始化逻辑可能不会正确生效。

更新记录

0.1.0

• 提供多量 Android SDK 的 uni-app x UTS 封装
• 支持初始化、任务列表、任务详情、个人中心和状态查询