更新记录

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

• 新增闪游 Android SDK 插件文档
• 补充 README 接口说明、接入要求、示例与常见问题

平台兼容性

uni-app x(5.06)

ad-shanyou-sdk

闪游 Android SDK 的 uni-app x UTS 封装插件。

插件支持初始化、打开任务大厅、查看任务详情、查看个人中心、快捷区和排行榜，并支持状态查询。

适用范围

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

对外接口

SYInitOptions

type SYInitOptions = {
  channelId : string
  secretKey : string
}

SYOpenOptions

type SYOpenOptions = {
  userId : string
}

SYTaskDetailOptions

type SYTaskDetailOptions = {
  userId : string
  taskId : number
}

SYSDKStatus

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

导出方法

• init(options)
• open(options)
• showTaskDetail(options)
• showMine(options)
• showFastArea(options)
• showRankingList(options)
• getStatus()

实现说明

插件通过 uts.sdk.modules.shanyousdk 中的 ShanyouSdkManager 完成原生调用。

当前实现流程：

1. 应用启动时通过 ShanyouSdkAppHookProxy 注入 Application
2. 如果用户已同意隐私协议，则同步执行 onPrivacyAccepted()
3. 初始化时传入 channelId 和 secretKey
4. 打开各业务页面时要求传入 userId
5. 打开任务详情时还需要 taskId

Android 依赖

当前 config.json 中未额外声明 Maven 依赖，但插件仍然属于原生 SDK 接入场景，依然建议通过自定义基座运行。

最低支持 Android 版本：21

使用前准备

1. 先完成隐私授权

为保证 SDK 能正常同步隐私状态，建议在调用插件前先由宿主应用完成隐私协议授权。

2. 使用自定义基座

插件虽然未声明额外 Maven 依赖，但仍依赖原生实现，建议使用自定义基座或自定义包运行。

3. 准备业务参数

你需要准备：

• channelId
• secretKey
• userId

基本用法

// #ifdef APP-ANDROID
import { init, open, showTaskDetail, showMine, showFastArea, showRankingList } from '@/uni_modules/ad-shanyou-sdk'
// #endif

function initShanyou() : boolean {
  // #ifdef APP-ANDROID
  return init({
    channelId: '你的channelId',
    secretKey: '你的secretKey'
  })
  // #endif
  return false
}

function openShanyouHome(userId : string) : boolean {
  // #ifdef APP-ANDROID
  return open({ userId })
  // #endif
  return false
}

常见问题

1. 初始化失败

请检查：

• channelId 是否为空
• secretKey 是否为空

2. 页面打开失败

请检查：

• userId 是否为空
• 当前是否能够获取到 Activity

3. 任务详情打不开

请确认 taskId 大于 0。

更新记录

0.1.0

• 提供闪游 Android SDK 的 uni-app x UTS 封装
• 支持初始化、首页、任务详情、我的、快捷区、排行榜和状态查询