更新记录

1.0.8（2026-11-02） 下载此版本

优化

1.0.7（2026-11-02） 下载此版本

优化

1.0.6（2026-11-02） 下载此版本

ios调试

平台兼容性

uni-app(4.71)

极准广告SDK · 非标服务广告（UTS 插件）

极准广告 SDK（Jizhun Ad）的 uni-app UTS 插件，提供 SDK 初始化 + 非标服务广告：

支持 uni-app（vue2 / vue3）、uni-app x（需关闭蒸汽模式）。

一、环境要求

二、安装

1. 插件市场导入本插件（或把 uni_modules/jz-ad/ 拷入项目根目录）
2. Android 项目设置最低版本：

   "app-android": { "distribute": { "minSdkVersion": 24 } }

   （uni-app 项目为 app-plus.distribute.android.minSdkVersion）

3. uni-app x 项目：manifest.json → uni-app-x 设置 "vapor": false
4. 运行 → 制作自定义调试基座，选择自定义基座运行

三、初始化

// App.vue onLaunch（全项目唯一一次 import）
import { initJZ, setConfig } from '@/uni_modules/jz-ad/js_sdk/index.js'

setConfig({ appid: '极准APPID' })
initJZ({}, (res) => console.log('[JZAD]', res.event, res.msg))

也可以直接调用 UTS API：

import { initSDK } from '@/uni_modules/jz-ad'
initSDK({ appId: '极准APPID', requestDomain: 'https://admin.hzjizhun.cn' }, (code, message) => {
  console.log(code === 0 ? '初始化成功' : message)
})

四、用法一：页面内组件（Android + iOS）

组件是原生组件，只能放在 nvue / uvue 页面：

<jz-service-ad
  v-if="show"
  style="width:320rpx;height:300rpx"
  :posId="posId"
  :showCloseView="true"
  :refershTime="30"
  @onReceived="onAd"
  @onFail="onAd"
  @onClicked="onAd"
  @onClose="onAd"
  @onExposure="onAd"
  @onExposureReport="onAd"
  @onClickedReport="onAd"
  @onCloseLandingPage="onAd" />

属性

事件

事件载荷（两端格式不同，建议兼容写法）：

onAd(e) {
  let d = e.detail
  if (typeof d === 'string') d = JSON.parse(d) // iOS 载荷为 JSON 字符串
  d = d || e
  // Android: { event, posId, code?, msg?, message? }
  // iOS:     JSON.parse 后 { event, posId }；onFail -> +code/message；onClicked -> +loadingPageURL
}

五、用法二：浮层 API（仅 Android）

不占页面布局，直接浮在屏幕上，可自定义位置、尺寸、坐标：

// 右上角 320x250（dp）
uni.$jzad.showServiceAd({
  adid: '非标位ID',
  position: 'top-right',
  width: 320,
  height: 250
}, res => console.log(res.event))

// 按左上角坐标定位（dp）
uni.$jzad.showServiceAd({
  adid: '非标位ID',
  width: 320,
  height: 250,
  x: 30,
  y: 100
})

// 全屏（默认）
uni.$jzad.showServiceAd({ adid: '非标位ID' })

失败事件会 reject Promise：

uni.$jzad.showServiceAd({ adid: 'xxx' }).catch(e => console.warn(e.code, e.msg))

六、平台差异

七、常见问题

八、UTS 开发注意（改插件源码时）

1. 局部函数必须先声明后使用（编译成 Kotlin，无提升）
2. 不要用 push/pop/map 等内置方法名做函数名
3. 不要用交叉类型：type A = B & { ... } 会报 UTS110111101
4. 不要把数值参数直接传给 Java 的 int/long；本插件统一用 String 传数值，Java 侧解析
5. charCodeAt() 返回 Number?，不能直接参与算术
6. 未声明类型的对象字面量变量（const cfg = { a: 'x' }）属性会退化为 Any?，请用显式类型常量

九、版本