Skip to content

UI交互方法

函数列表

1. 显示一个toast消息 (showToast)

说明: 显示一个toast消息

函数: showToast(message)

参数:

参数名类型说明
message字符串字符串类型

使用说明:由于ios限制无法全局弹窗,所以该toast消息只能在当前进程所在的app界面上显示

返回值:

返回值类型说明
布尔布尔类型

示例:

lua
showToast("我是懒人精灵")

2. 显示一个全局toast消息 (showSysToast)

说明: 全局显示一个toast消息

函数: showSysToast(message,x,y,fontsize)

参数:

参数名类型说明
message字符串字符串类型
x整数指定坐标显示
y整数指定坐标显示
fontsize整数字体大小

使用说明:当x,y都小于0 表示默认水平居中显示在底部,这个函数只能在NXService图色引擎模式下使用

返回值:

返回值类型说明
布尔布尔类型

示例:

lua
for i = 1, 100, 1 do
	showSysToast("你好我是懒人精灵",-1,-1,20)
	sleep(1000)
end

3. 隐藏一个正在全局显示的toast (hideSysToast)

说明: 隐藏一个正在全局显示的toast

函数: hideSysToast()

参数: 无

使用说明:这个函数只能在NXService图色引擎模式下使用

返回值:

返回值类型说明
布尔布尔类型

示例:

lua
for i = 1, 5, 1 do
	showSysToast("你好我是懒人精灵",-1,-1,20)
	sleep(1000)
end
hideSysToast()
sleep(10000)

4. 显示一个弹窗UI (showXmlUI)

说明: 显示一个弹窗UI

函数: showXmlUI(xmlname,config,countdown)

参数:

参数名类型说明
xmlname字符串xml界面文件的名称
config字符串界面配置字符串
countdown整数倒计时(单位是秒)如果小于0就不显示倒计时

使用说明:由于ios限制无法全局弹窗,只能在app打开的时候才能正常显示,而且该函数是阻塞的,直到界面被关闭才会返回

返回值:

返回值类型说明
字符串返回一个json字符串

示例:

lua
local ret = isBackgroundRun()
if not ret then
	local dict = QDictionary.open("data")
	local cfg = dict:get("uicfg")
	setOnUIEvent(function (e)
		print(e)
		showToast(e)
	end)
	local ret = showXmlUI("test.ui",cfg,5)
	if ret ~= nil then
		local tb = jsonLib.decode(ret)
		if tb.type == "continue" then
			print(tb.configData)
			local val = jsonLib.encode(tb.configData)
			
			print(dict:put("uicfg" , val))
			dict:commit()
		end
	end
end
keyPress("home")
while true do
	sleep(1000)
end

5. 设置一个UI事件回调 (setOnUIEvent)

说明: 设置一个UI事件回调

函数: setOnUIEvent(callback)

参数: 无

返回值: 无

示例:

lua
--请参考showXmlUI的例子

6. 发送一个系统通知消息 (sendNotify)

说明: 发送一个系统通知消息

函数: sendNotify(title,message,submessage)

参数: 无

返回值: 无

示例:

lua
sendNotify("this is new","hello","hello submessage")
sleep(10000)