sys - sys库#

sys.wait(timeout)#

Task协程等待指定时长

参数

传入值类型

解释

int

等待时长,单位毫秒,必须大于0,否则无效

返回值

返回值类型

解释

any

通常为nil,除非主动被唤醒(通常不会)

例子

sys.taskInit(function()
    while 1 do
        sys.wait(500)
    end
end)

sys.waitUntil(topic, timeout)#

Task协程等待指定时长或者特定的topic

参数

传入值类型

解释

string

事件topic

int

等待时长,单位毫秒,必须大于0,否则无效

返回值

返回值类型

解释

boolean

如果是超时,返回false,否则返回true

any

对应topic的内容

例子

sys.taskInit(function()
    // do something
    local result, data = sys.waitUntil("NET_READY", 30000)
    // do something else
end)

sys.taskInit(func, arg1, arg2, argN)#

创建一个Task协程

参数

传入值类型

解释

function

待执行的函数,可以是匿名函数, 也可以是local或全局函数

any

需要传递的参数1,可选

any

需要传递的参数2,可选

any

需要传递的参数N,可选

返回值

返回值类型

解释

task

协程对象

例子

sys.taskInit(function(a, b, c)
    log.info("task", a, b, c) -- 打印 task A B C
end, "A", "B", "N")

sys.timerStart(func, timeout, arg1, arg2, argN)#

创建一个定时器.非Task,函数里不能直接sys.waitXXX

参数

传入值类型

解释

function

待执行的函数,可以是匿名函数, 也可以是local或全局函数

int

延时时长,单位毫秒

any

需要传递的参数1,可选

any

需要传递的参数2,可选

any

需要传递的参数N,可选

返回值

返回值类型

解释

int

定时器id

例子

sys.timerStart(function(a, b, c)
    log.info("task", a, b, c) -- 1000毫秒后才会执行, 打印 task A B C
end, 1000, "A", "B", "N")

sys.timerLoopStart(func, timeout, arg1, arg2, argN)#

创建一个循环定时器.非Task,函数里不能直接sys.waitXXX

参数

传入值类型

解释

function

待执行的函数,可以是匿名函数, 也可以是local或全局函数

int

延时时长,单位毫秒

any

需要传递的参数1,可选

any

需要传递的参数2,可选

any

需要传递的参数N,可选

返回值

返回值类型

解释

int

定时器id

例子

sys.timerLoopStart(function(a, b, c)
    log.info("task", a, b, c) -- 1000毫秒后才会执行, 打印 task A B C
end, 1000, "A", "B", "N")

sys.timerStop(id)#

关闭一个定时器.

参数

传入值类型

解释

int

定时器id

返回值

返回值类型

解释

nil

无返回值

例子

local tcount = 0
local tid 
tid = sys.timerLoopStart(function(a, b, c)
    log.info("task", a, b, c) -- 1000毫秒后才会执行, 打印 task A B C
    if tcount > 10 then
        sys.timerStop(tid)
    end
    tcount = tcount + 1
end, 1000, "A", "B", "N")

sys.timerStopAll(fnc)#

关闭同一回调函数的所有定时器.

参数

传入值类型

解释

function

fnc回调的函数

返回值

返回值类型

解释

nil

无返回值

例子

-- 关闭回调函数为publicTimerCbFnc的所有定时器
local function publicTimerCbFnc(tag)
log.info("publicTimerCbFnc",tag)
end
sys.timerStart(publicTimerCbFnc,8000,"first")
sys.timerStart(publicTimerCbFnc,8000,"second")
sys.timerStart(publicTimerCbFnc,8000,"third")
sys.timerStopAll(publicTimerCbFnc)

sys.publish(topic, arg1, agr2, argN)#

往特定topic通道发布一个消息

参数

传入值类型

解释

string

topic的值

any

附带的参数1

any

附带的参数2

any

附带的参数N

返回值

返回值类型

解释

nil

无返回值

例子

sys.publish("BT_READY", false)

sys.subscribe(topic, func)#

订阅一个topic通道

参数

传入值类型

解释

string

topic的值

function

回调函数, 注意, 不能直接使用sys.waitXXX

返回值

返回值类型

解释

nil

无返回值

例子

local function bt_cb(state)
    log.info("bt", state)
end
sys.subscribe("BT_READY", bt_cb)
sys.subscribe("BT_READY", function(state)
    log.info("sys", "Got BT_READY", state)
end)

sys.unsubscribe(topic, func)#

取消订阅topic通道

参数

传入值类型

解释

string

topic的值

function

回调函数, 注意, 不能直接使用sys.waitXXX

返回值

返回值类型

解释

nil

无返回值

例子

local function bt_cb(state)
    log.info("bt", state)
end
sys.unsubscribe("BT_READY", bt_cb)

sys.run()#

sys库主循环方法,仅允许在main.lua的末尾调用

参数

返回值

返回值类型

解释

nil

无返回值. 这个方法几乎不可能返回.

例子

-- 总是main.lua的结尾一句,将来也许会简化掉
sys.run()
-- 之后的代码不会被执行

sys.waitMsg(taskName, target, timeout)#

等待接收一个目标消息

参数

传入值类型

解释

string

任务名称,用于唤醒任务的id

string

目标消息,如果为nil,则表示接收到任意消息都会退出

int

超时时间,如果为nil,则表示无超时,永远等待

返回值

返回值类型

解释

table

成功返回table型的msg,超时返回false

例子

-- 等待任务
sys.waitMsg('a', 'b', 1000)
-- 注意, 本函数会自动注册成全局函数 sys_wait

sys.sendMsg(taskName, target, arg2, arg3, arg4)#

向目标任务发送一个消息

参数

传入值类型

解释

string

任务名称,用于唤醒任务的id

any

消息中的参数1,同时也是waitMsg里的target

any

消息中的参数2

any

消息中的参数3

any

消息中的参数4

返回值

返回值类型

解释

bool

成功返回true, 否则返回false

例子

-- 向任务a,目标b发送消息
sys.sendMsg('a', 'b')
-- 注意, 本函数会自动注册成全局函数 sys_send

sys.taskInitEx(fun, taskName, cbFun, …)#

创建一个任务线程,在模块最末行调用该函数并注册模块中的任务函数,main.lua导入该模块即可

参数

传入值类型

解释

function

任务函数名,用于resume唤醒时调用

string

任务名称,用于唤醒任务的id

function

接收到非目标消息时的回调函数

any

… 任务函数fun的可变参数

返回值

返回值类型

解释

number

返回该任务的线程号

例子

sys.taskInitEx(task1,'a',callback)

sys.taskDel(taskName)#

删除由taskInitEx创建的任务线程

参数

传入值类型

解释

string

任务名称,用于唤醒任务的id

返回值

例子

sys.taskDel('a')

sys.cleanMsg(taskName)#

清除指定task的消息队列

参数

传入值类型

解释

string

任务名称

返回值

例子

sys.cleanMsg('a')