更新记录

1.0.0（2025-11-21） 下载此版本

feat: QuickTracking ABTest 新增支持uts插件

平台兼容性

uni-app(3.7.0)

uni-app x(3.7.0)

QT-ABTest

简介

使用 uts 开发，基于瓴羊ABTest SDK封装插件，支持iOS、Android 和鸿蒙Next平台

插件使用说明

在使用插件前您需要先集成QT-Analytics uts插件详情参考 QT-Analytics AB 实验SDK

初始化前置

将QT-ABTest插件导入HBuilderX中的工程。

import { initABTest } from '@/uni_modules/QT-ABTest';

初始化

import * as QtAnalytics from '@/uni_modules/QT-Analytics';
import { initABTest } from '@/uni_modules/QT-ABTest';

export default {
    data() {
        return {
            title: 'Hello'
        }
    },
    onLoad() {
        QtAnalytics.init()
        initABTest("您的收数域名/abtest_results?appkey=您的appkey", 5 * 60 * 1000)
    }
}

API与说明

接口相关

// AB实验请求回调
export type ABTestCallback = {
    onSuccess(ret : ABTestResult) : void
};
// AB返回结构
export type ABTestResult = string | boolean | number | object | UTSJSONObject;

// AB实验支持类型
export type ABValueType = "STRING" | "NUMBER" | "BOOLEAN" | "JSON" | "INTEGER";

// AB参数变更回调
export type ABPropertyCallback = {
    onSuccess(ret : Array<ABTestResult>) : void
};

API列表与说明

/**
 * 初始化 AB 测试配置
 * @param url - AB 测试服务器地址
 * @param timeInterval - 轮询间隔时间，默认为 10 分钟(600000 毫秒)
 */
export function initABTest(url : string, timeInterval : number = 10 * 60 * 1000) 

/**
 * 从缓存中获取 AB 测试结果
 * @param paramName - 参数名称
 * @param valueType - 值类型
 * @param defaultValue - 默认值
 * @returns AB 测试结果或默认值
 */
export function fetchABTestFromCache(paramName : string, valueType : ABValueType, defaultValue : ABTestResult)

/**
 * 先从缓存获取 AB 测试结果，如果缓存没有则从服务器获取
 * @param paramName - 参数名称
 * @param valueType - 值类型
 * @param timeOut - 超时时间，默认 3000 毫秒
 * @param defaultValue - 默认值
 * @param callback - 回调函数
 * @returns 默认值
 */
export function fetchABTestFromCacheThenServer(paramName : string, valueType : ABValueType, timeOut : number = 3000, defaultValue : ABTestResult, callback : ABTestCallback)
/**
 * 直接从服务器获取 AB 测试结果
 * @param paramName - 参数名称
 * @param valueType - 值类型
 * @param timeOut - 超时时间，默认 3000 毫秒
 * @param defaultValue - 默认值
 * @param callback - 回调函数
 */
export function fetchABTestFromServer(paramName : string, valueType : ABValueType, timeOut : number = 3000, defaultValue : ABTestResult, callback : ABTestCallback)