跳到主要内容

5 LUA语法说明

5.1 系统函数列表​

出于安全及性能原因，RTA SaaS禁用了大量不必要的 LUA功能。以下为支持的全局函数列表。

函数名功能
next对table进行遍历
print打印信息（注：在生产环境中该函数被设置为不输出）
tonumber转换为数字
tostring转换为文本
type获取变量类型
unpack将table 的元素解包为多值返回

5.2 内置模块time​

time为时间计算相关功能函数，系统使用uint32为基础格式，存放Unix Timestamp。

5.2.1 函数列表​

函数名功能
time.now获取当前时间
time.date获取日期，一次返回年月日
time.hour获取小时
time.minute获取分钟
time.second获取秒
time.weekday获取星期几，星期日为 0，星期一为 1，以此类推
time.truncate向下取整，第二参数可指定取整类型
time.addtime增减时间，可一次增减时分秒
time.adddate增减日期，可一次增减年月日
time.setdate设置日期，可一次设置年月日时分秒

5.2.2 time.now函数​

函数获取当前时间戳，返回值为uint32类型。

now = time.now()

5.2.3 time.date函数​

函数传入时间戳，一次返回年、月、日三个值。

now = time.now()
year, month, day = time.date(now)

5.2.4 time.hour函数​

函数传入时间戳，返回小时。

now = time.now()
hour = time.hour(now)

5.2.5 time.minute函数​

函数传入时间戳，返回分钟。

now = time.now()
minute = time.minute(now)

5.2.6 time.second函数​

函数传入时间戳，返回秒。

now = time.now()
second = time.second(now)

5.2.7 time.weekday函数​

函数传入时间戳，返回星期几。星期天为 0，星期一为 1，以此类推。

now = time.now()
weekday = time.weekday(now)

5.2.8 time.truncate函数​

函数传入时间戳，及截断精度，返回截断后的时间戳。

时间精度可以是以下值：month、day、hour、minute。

now = time.now()
month_start = time.truncate(now, "month") -- 本月开始时间戳
today_start = time.truncate(now, "day") -- 今天开始时间戳
hour_start = time.truncate(now, "hour") -- 本小时开始时间戳
minute_start = time.truncate(now, "minute") -- 本分钟开始时间戳

5.2.9 time.addtime函数​

函数传入时间戳，及增减时间（时分秒），时分秒可为 0 或 负值，返回增减后的时间戳。

now = time.now()
newstamp = time.addtime(now, -1, 1, 1) -- 前1小时，再增加1分1秒

5.2.10 time.adddate函数​

函数传入时间戳，及增减日期（年月日），年月日可为 0 或 负值，返回增减后的时间戳。

now = time.now()
newstamp = time.adddate(now, -1, 1, 1) -- 去年，再增加1月1天

5.2.11 time.setdate函数​

函数传入年月日时分秒，返回时间戳。

newstamp = time.setdate(2025, 6, 18, 12，13,14) -- 2025:06:18 12:13:14

5.3 内置模块srta​

5.3.1 常量​

服务内置了名为 srta 的模块，提供了访问数据的功能及相关常量。

5.3.1.1 数据区​

常量名称含义适用函数或变量
srta.DS_DID默认设备数据空间编号srta.get_dsdata()
srta.DS_WUID默认 WUID数据空间编号srta.get_dsdata()

5.3.1.2 字段区​

常量名称含义适用函数或变量
srta.U8UINT8字段区dsdata
srta.U32UINT32字段区dsdata
srta.FLAGFLAG字段区dsdata

5.3.1.3 操作系统​

常量名称含义适用函数或变量
srta.OS_UNKNOWN未知操作系统srta.get_os()
srta.OS_IOSiOSsrta.get_os()
srta.OS_ANDROIDAndroidsrta.get_os()
srta.OS_OTHER其它操作系统srta.get_os()

5.3.1.4 策略参数​

常量名称含义适用函数或变量
srta.TARGETINFO_ENABLE策略参竞target_info
srta.TARGETINFO_CPC_PRICECPC出价target_info
srta.TARGETINFO_CPA_PRICECPA出价target_info
srta.TARGETINFO_USER_WEIGHT_FACTOR用户权重系数 target_info
srta.TARGETINFO_CPC_FACTORCPC出价系统target_info

5.3.2 函数列表​

函数名功能
srta.get_dsdata获取数据空间数据
srta.get_targets获取需决策的策略ID列表
srta.get_apps获取App安装态(需授权)
srta.get_scores获取模型分(需授权)
srta.get_os获取终端操作系统

5.3.2.1 srta.get_dsdata函数​

返回的数据以 LUA Table 结构存在，定义如下

didData = srta.get_dsdata(srta.DS_DID) -- 获取设备数据

-- 以下为字段返回值示例
didData = {
    [1]: {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, .... 0, 0, 0, 0, 0, 0, 0, 0},
    [2]: {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0},
    [3]: {false, false, false, false,false, false, false, false}
}

5.3.2.2 srta.get_targets函数​

返回的数据以 LUA Table 结构存在，定义如下

targets = srta.get_targets() -- 获取策略列表

-- 以下为字段返回值示例
targets = {"news", "music", "video_for_new"}

5.3.2.3 srta.get_apps函数​

一次可以获得多个App安装态，每个返回值为 true(已安装)/false(未安装)/nil(无权限或不可靠)中的一个状态

app1, app2, app3 = srta.get_apps(app1hash, app2hash, app3hash) -- 获取App安装态，可支持多个。

-- 以下为字段返回值示例
app1 = true
app2 = false
app3 = nil

5.3.2.3 srta.get_scores函数​

一次可以获得多个模型安装态，每个返回值为数字/nil(无权限或不可靠)中的一个状态

score1, score2, score3 = srta.get_apps(model1, model2, model1) -- 获取模型分，可支持多个。
-- 以下为字段返回值示例
score1 = 0
score2 = 80
score3 = nil

5.3.2.3 srta.get_os函数​

获取终端的操作系统。返回值参考系统常量

os = srta.get_os() -- 获取终端操作系统

-- 以下为字段返回值示例
1 -- 代表iOS，可以用srta常量进行判断

5.4 内置模块string​

string为字符串计算相关功能函数。

5.4.1 函数列表​

函数名功能
string.split切割字符串

5.4.2 string.split函数​

使用指定的分割符(sep)对字符串进行分割，并返回分割后的字符串数组。

str = "test,a,b"
strs = string.split(str, ",")
print("strs len" , #strs)
for i, item in ipairs(strs) do
    print(i, item)
end
-- 以下为字段返回示例
3
1   test
2   a
3   b

5.5 主函数​

5.5.1 入口​

业务逻辑由使用方实现，为便于系统调用，约定使用main函数名。该函数无入口参数，后续所需数据通过调用内置函数获取

function main()
    didData = srta.get_dsdata(srta.DS_DID) -- 获取DID数据
    
    -- 客户逻辑
    
end

较为完整的使用示例

-- 客户自定义变量，便于理解
IDXU8_NEWS = 1
IDXU8_MUISIC = 2
IDXU8_VIDEO = 3

IDXFLAG_NEWS = 1
IDXFLAG_MUSIC = 2

function main()
    didData = srta.get_dsdata(srta.DS_DID) -- 获取DID数据
    targets = srta.get_targets()
    local results = {} -- 返回结果
    
    for i, targetid in ipairs(targets) do -- 遍历待决策策略ID
        if targetid == "news" then -- 新闻拉活策略
            local is_news_installed = didData[srta.U8][IDXU8_NEWS] == 1 -- 是否新闻已安装
            local is_news_touched = didData[srta.U8][IDXFLAG_NEWS] -- 是否新闻已完成当天唤起
            if is_news_installed and is_news_touched then
                result[targetid] = { [srta.TARGETINFO_ENABLE] = true } -- 已安装未拉活，可出拉活广告
            end
        end

        if targetid == "music" then -- 音乐拉活策略
            local is_music_installed = didData[srta.U8][IDXU8_MUSIC] == 1 -- 是否音乐已安装
            local is_music_touched = didData[srta.U8][IDXFLAG_MUSIC] -- 是否音乐已完成当天唤起
            if is_music_installed and is_music_touched then
                result[targetid] = { [srta.TARGETINFO_ENABLE] = true } -- 已安装未拉活，可出拉活广告
            end
        end
    
        if targetid == "video_for_new" then -- 视频拉新策略
            local is_video_not_installed = didData[srta.U8][IDXU8_VIDEO] == 0 -- 是否视频未安装
            if is_video_not_installed then
                result[targetid] = { [srta.TARGETINFO_ENABLE] = true } -- 未安装，可出拉新广告
            end
        end
    end
end

5.5.2 返回​

主函数返回一个结果，为table格式并可引用srta常量以设置以下成员编号

成员类型功能
srta.TARGETINFO_ENABLEbool策略是否参竞
srta.TARGETINFO_CPC_PRICEint策略CPC出价
srta.TARGETINFO_CPA_PRICEint策略CPA出价
srta.TARGETINFO_USER_WEIGHT_FACTORfloat策略用户权重系数
srta.TARGETINFO_CPC_FACTORfloat策略CPC出价系数

5.6 实验分桶​

TODO

5.7 上报统计​

TODO

5.8 自助联调​

TODO