更新记录

1.0.3（2026-10-10） 下载此版本

更新价格

1.0.2（2026-10-10） 下载此版本

更新日志价格

1.0.1（2026-10-10） 下载此版本

日志更新

平台兼容性

uni-app x(5.31)

其他

uni-drama（短剧插件）

UTS 短剧插件：提供 uni.createDramaAd（API 模式，自建聚合页）与 ad-drama 组件（组件模式，内嵌短剧首页），创建实例即自动加载短剧模块。仅支持 App-Android（HBuilderX 5.31+）。

完整接入文档：docs/ad-drama.md——组件属性/事件表、API 全量方法、错误码表、完整示例。

使用前提

1. 在 uni-ad 后台开通短剧广告位，获取 adpid；
2. 从穿山甲后台下载 SDK 配置文件，重命名为 gm_SDK_Setting.json 放到项目根目录 nativeResources/android/assets/ 下；
3. 必须使用自定义基座（标准基座不含短剧运行时，报 -5020）：HBuilderX 菜单【发行 → 原生App-云打包】→ 勾选"制作自定义调试基座"。

本插件独立运行，无需安装其他插件，也无需手动导入任何 AAR——原生库由云打包按 manifest.json 的 uni-ad 模块配置自动引入。

快速使用（API 模式）

import { CreateDramaAdOptions, DramaListOptions, DramaListResult, IUniDramaError } from "@/uni_modules/uni-drama"

// 创建即自动加载模块；注册监听后等 onLoad 再查询（避免 -5012）
const dramaAd = uni.createDramaAd({ adpid: '你的短剧广告位 ID' } as CreateDramaAdOptions)
dramaAd.onError((err: IUniDramaError) => console.error(err.errMsg))
dramaAd.onLoad((res: any) => {
  // 模块就绪（res["providerType"] 为渠道类型），可发起查询
})
dramaAd.getRecommendedList({
  page: 1,
  pageSize: 20,
  success: (res: DramaListResult) => { /* 渲染列表 */ },
  fail: (err: IUniDramaError) => { /* 错误处理 */ }
} as DramaListOptions)

快速使用（组件模式）

<template>
  <ad-drama
    :adpid="'1158231135'"
    :free="2"
    :lock="2"
    :url-callback="{ userId: 'u001', extra: 'order-001' }"
    @load="onLoad"
    @error="onError"
    @click="onClick"
    @close="onClose"
  ></ad-drama>
</template>

注意事项

• 类型统一从 @/uni_modules/uni-drama 导入，勿 import 编译产物包名 uts.sdk.modules.DCloudUniDrama（云打包服务器无此包，会导致云打包失败）。
• 短剧解锁的激励视频由 SDK 内部完成，无需接入广告插件；urlCallback（userId/extra）用于激励发放的服务器回调校验。
• API 模式请在页面 onUnmounted 时调用 destroy() 释放实例。

更新日志

见 changelog.md。