Skip to content

输入法相关函数

1. 检查输入法服务状态 (imeLib.isReady)

说明: 检查输入法服务是否就绪

函数: imeLib.isReady()

参数: 无

返回值:

返回值类型说明
booleantrue表示输入法服务就绪,false表示服务不可用

示例:

lua
--说明:使用自带的输入法输入的时候需要先打开输入法,具体操作如下
--1.打开 "设置" 
--2.找到"通用"打开
--3.找到"键盘"打开
--4.点击添加新键盘
--5.找到自己打包的脚本的app名称添加
--6.点击自己app键盘那一项进去后打开"允许完全访问"
--7.随便打开一个输入框,这个时候会弹出一个键盘,需要长按"地球"图标去切换到自己app的键盘就能激活了

function waitForIME(timeout)
    timeout = timeout or 10  -- 默认10秒超时
    local start_time = os.time()
    
    while timeout > (os.time() - start_time)  do
        if imeLib.isReady() then
            return true
        end
        -- 等待一段时间再检查
        sleep(200)
    end
    return false
end

-- 等待输入法服务
if waitForIME(5) then
    print("输入法服务已就绪,可以开始输入")
	imeLib.inputText("hello")
else
    print("输入法服务启动超时")
end

2. 输入文本 (imeLib.inputText)

说明: 使用输入法输入文本内容

函数: imeLib.inputText(text)

参数:

参数名类型说明
text字符串要输入的文本内容

返回值:

返回值类型说明
booleantrue表示输入成功,false表示输入失败

注意:这是异步方法,需要在协程中使用

示例:

lua
--说明:使用自带的输入法输入的时候需要先打开输入法,具体操作如下
--1.打开 "设置" 
--2.找到"通用"打开
--3.找到"键盘"打开
--4.点击添加新键盘
--5.找到自己打包的脚本的app名称添加
--6.点击自己app键盘那一项进去后打开"允许完全访问"
--7.随便打开一个输入框,这个时候会弹出一个键盘,需要长按"地球"图标去切换到自己app的键盘就能激活了

function waitForIME(timeout)
    timeout = timeout or 10  -- 默认10秒超时
    local start_time = os.time()
    
    while timeout > (os.time() - start_time)  do
        if imeLib.isReady() then
            return true
        end
        -- 等待一段时间再检查
        sleep(200)
    end
    return false
end

-- 等待输入法服务
if waitForIME(5) then
    print("输入法服务已就绪,可以开始输入")
	local ret = imeLib.inputText("hello")
	if ret then
		print("输入成功")
	else
		print("输入失败")
	end
else
    print("输入法服务启动超时")
end

3. 删除字符 (imeLib.delete)

说明: 删除指定数量的字符

函数: imeLib.delete(count)

参数:

参数名类型说明
count整数要删除的字符数量,默认为1

返回值:

返回值类型说明
booleantrue表示删除成功,false表示删除失败

注意:这是异步方法,需要在协程中使用

示例:

lua
--说明:使用自带的输入法输入的时候需要先打开输入法,具体操作如下
--1.打开 "设置"
--2.找到"通用"打开
--3.找到"键盘"打开
--4.点击添加新键盘
--5.找到自己打包的脚本的app名称添加
--6.点击自己app键盘那一项进去后打开"允许完全访问"
--7.随便打开一个输入框,这个时候会弹出一个键盘,需要长按"地球"图标去切换到自己app的键盘就能激活了

function waitForIME(timeout)
	timeout = timeout or 10 -- 默认10秒超时
	local start_time = os.time()
	
	while timeout > (os.time() - start_time) do
		if imeLib.isReady() then
			return true
		end
		-- 等待一段时间再检查
		sleep(200)
	end
	return false
end

-- 等待输入法服务
if waitForIME(5) then
	local ret = imeLib.delete(10)
	if ret then
		print("删除10次完成")
	else
		print("操作失败")
	end
else
	print("输入法服务启动超时")
end

4. 输入完成隐藏键盘 (imeLib.done)

说明: 完成输入并隐藏键盘

函数: imeLib.done()

参数: 无

返回值:

返回值类型说明
booleantrue表示操作成功,false表示操作失败

注意:这是异步方法,需要在协程中使用

示例:

lua
--说明:使用自带的输入法输入的时候需要先打开输入法,具体操作如下
--1.打开 "设置" 
--2.找到"通用"打开
--3.找到"键盘"打开
--4.点击添加新键盘
--5.找到自己打包的脚本的app名称添加
--6.点击自己app键盘那一项进去后打开"允许完全访问"
--7.随便打开一个输入框,这个时候会弹出一个键盘,需要长按"地球"图标去切换到自己app的键盘就能激活了
function waitForIME(timeout)
    timeout = timeout or 10  -- 默认10秒超时
    local start_time = os.time()
    
    while timeout > (os.time() - start_time)  do
        if imeLib.isReady() then
            return true
        end
        -- 等待一段时间再检查
        sleep(200)
    end
    return false
end

-- 等待输入法服务
if waitForIME(5) then
    print("输入法服务已就绪,可以开始输入")
	local ret = imeLib.inputText("hello")
	if ret then
		print("输入成功")
		sleep(1000)
		imeLib.done()
	else
		print("输入失败")
	end
else
    print("输入法服务启动超时")
end

5. 粘贴操作 (imeLib.paste)

说明: 执行粘贴操作

函数: imeLib.paste()

参数: 无

返回值:

返回值类型说明
booleantrue表示操作成功,false表示操作失败

注意:这是异步方法,需要在协程中使用

示例:

lua
--说明:使用自带的输入法输入的时候需要先打开输入法,具体操作如下
--1.打开 "设置" 
--2.找到"通用"打开
--3.找到"键盘"打开
--4.点击添加新键盘
--5.找到自己打包的脚本的app名称添加
--6.点击自己app键盘那一项进去后打开"允许完全访问"
--7.随便打开一个输入框,这个时候会弹出一个键盘,需要长按"地球"图标去切换到自己app的键盘就能激活了
function waitForIME(timeout)
    timeout = timeout or 10  -- 默认10秒超时
    local start_time = os.time()
    
    while timeout > (os.time() - start_time)  do
        if imeLib.isReady() then
            return true
        end
        -- 等待一段时间再检查
        sleep(200)
    end
    return false
end

-- 等待输入法服务
if waitForIME(5) then
    print("输入法服务已就绪,可以开始输入")
	local ret = imeLib.paste()
	if ret then
		print("粘贴成功")
	else
		print("粘贴失败")
	end
else
    print("输入法服务启动超时")
end