更新记录

1.0.0（2026-02-13）

Changelog

1.0.0

• Initial release: AppLovin MAX rewarded ads (iOS/Android)

平台兼容性

uni-app(4.21)

uni-app x(4.21)

gao-applovin-max

开发文档

UTS 语法 UTS API插件 Hello UTS

AppLovin MAX 激励广告 UTS 插件，支持 iOS 和 Android。 Rewarded Ads。

API

// 初始化
export declare function initMax(sdkKey : string, options ?: HYApplovinInitOptions) : void
export declare function initMaxAsync(sdkKey : string, options ?: HYApplovinInitOptions) : Promise<void>

// 隐私合规
export declare function setHasUserConsent(value : boolean) : void
export declare function setIsAgeRestrictedUser(value : boolean) : void
export declare function setDoNotSell(value : boolean) : void
export declare function setUserIdentifier(id : string) : void

// Rewarded
export declare function loadRewarded(adUnitId : string) : void
export declare function loadRewardedAsync(adUnitId : string) : Promise<void>
export declare function showRewarded(adUnitId : string, placement ?: string) : void
export declare function isRewardedReady(adUnitId : string) : boolean
export declare function setRewardedListener(listener : HYRewardedListener) : void
export declare function clearRewardedListener() : void

使用说明

import * as MaxAds from '@/uni_modules/gao-applovin-max'

// 建议在 App.vue 的 onLaunch 中调用
await MaxAds.initMaxAsync('YOUR_SDK_KEY', {
  userIdentifier: 'USER_123',
  // 可选：没有测试设备ID时可以不传或传空数组
  testDeviceIds: []
})

// 页面加载时启用监听
MaxAds.setRewardedListener((event) => {
  if (event.type === 'loaded') {
    console.log('rewarded loaded')
  }
  if (event.type === 'rewarded') {
    console.log('rewarded user', event.reward)
  }
  if (event.type === 'failed') {
    console.log('rewarded failed', event.error)
  }
})

// 页面卸载时取消监听
onUnmounted(() => {
  MaxAds.clearRewardedListener()
})

// 先加载广告，在播放广告
await MaxAds.loadRewardedAsync('YOUR_REWARDED_AD_UNIT_ID')

// 业务页面按钮点击时展示
if (MaxAds.isRewardedReady('YOUR_REWARDED_AD_UNIT_ID')) {
  MaxAds.showRewarded('YOUR_REWARDED_AD_UNIT_ID', 'placement_1')
} else {
  // 这里有可能是后台广告list没有了（admob 等平台为了防止机器人，会有广告数量，时间间隔等，一直刷会被封号）
  console.log('rewarded not ready')
}
// 可选：加载失败时捕获错误
try {
  await MaxAds.loadRewardedAsync('YOUR_REWARDED_AD_UNIT_ID')
} catch (err) {
  console.log('load failed', err)
}

注意事项

• Android 依赖 com.applovin:applovin-sdk:13.5.1
• iOS 依赖 pod 'AppLovinSDK'
• 奖励发放以客户端回调为准

联系

• 有任何问题联系球球号: 209817279