完美验证码识别系统，验证码插件使用帮助文档

时间：2024-04-16 13:38:53

  该验证码插件为《完美验证码识别系统V3.2.1》的python封装，提供给UiBot实现需验证码识别的场景的解决方案。

载入识别库

LoadDat(datPath, password)

函数说明：
       从文件中载入识别库文件，成功返回True，否则返回False。

参数：

参数名类型说明
datPath 文本型 识别库文件所在全路径
password 文本型 识别库调用密码

返回值：

返回结果类型说明
True boolean型 载入识别库成功
False boolean型 载入识别库失败

示例：

import wmcode
// 识别库路径
Dim datPath = "d:\\demo\\辽宁-12345606.dat"
// 识别库密码
Dim password = "12345606"
// 字库标识
Dim flag
// 加载识别库
flag = wmcode.LoadDat(datPath,password)
If flag
   TracePrint("识别库加载成功")
else
   TracePrint("识别库加载失败")
end if

LoadDatEx(datPath, password)

函数说明：
       从文件中载入识别库文件，成功返回字库实例Id，失败返回-1。
                             该函数用于多个字库同时使用场景。根据字库id对不同的图片进行识别。

参数：

参数名类型说明
datPath 文本型 识别库文件所在全路径
password 文本型 识别库调用密码

返回值：

返回结果类型说明
字库id 整数型 载入识别库成功，返回字库id
-1 整数型 载入识别库失败

示例：

import wmcode
// 识别库路径
Dim datPath = "d:\\demo\\辽宁-12345606.dat"
// 识别库密码
Dim password = "12345606"
// 字库标识
Dim flag
// 加载识别库
flag = wmcode.LoadDatEx(datPath,password)
If flag > -1
   TracePrint("识别库加载成功,字库id为:" & flag)
else
   TracePrint("识别库加载失败")
end if

设定识别库选项

SetWmOption(OptionIndex, OptionValue)

函数说明：
       设定识别库选项。设定成功返回真，否则返回假。

参数：

参数名类型说明
OptionIndex 整数型 识别库文件所在全路径
OptionValue 整数型 识别库调用密码

参数取值范围：

  • [x] 返回方式
OptionIndexOptionValue默认值说明
1 0 0 直接返回验证码
1 1 0 返回验证码字符和矩形范围。例如：S,10,11,12,13\|A,1,2,3,4 表示识别到文本 S >>左边横坐标10,左边纵坐标11,右边横坐标,右边纵坐标12
1 2 0 返回验证码字符和总体信任度。例如:abcd\|98 表示识别结果abcd,总体信任度98
1 3 0 返回验证码字符和矩形范围形和总体信任度。例如：S,10,11,12,13\|A,1,2,3,4\|98 >>表示识别到文本 S 左边横坐标10,左边纵坐标11,右边横坐标,右边纵坐标12....总体信任度为98
  • [x] 识别方式

可以进行分割的验证码，建议优先使用分割识别，因为分割后不仅能提高识别率，而且还能提高识别速度

OptionIndexOptionValue默认值说明
2 0 0 整体识别
2 1 0 连通分割识别
2 2 0 纵分割识别
2 3 0 横分割识别
2 4 0 横纵分割识别
  • [x] 识别模式

识图模式指的是背景白色视为透明不进行对比，识字模式指的是白色不视为透明，也加入对比。
绝大多数我们都是使用识图模式，但是有少数部分验证码，使用识字模式更佳。

OptionIndexOptionValue默认值说明
3 0 0 识图模式
3 1 0 识字模式
  • [x] 识别加速

一般建议开启加速功能，开启后对识别率几乎不影响。而且能提高3-5倍识别速度。

OptionIndexOptionValue默认值说明
4 0 0 不加速
4 1 0 使用加速
  • [x] 加速返回

使用加速返回一般用在粗体字识别的时候，可以大大提高识别速度，但是使用后，会稍微影响识别率。识别率有所下降。一般不是粗体字比较耗时的验证码，一般不用开启

OptionIndexOptionValue默认值说明
5 0 0 不加速返回
5 1 0 使用加速返回
  • [x] 最小相似度
OptionIndexOptionValue默认值说明
6 0～100 90 相似度值，值越大越严格
  • [x] 字符间隙

如果字符重叠,根据实际情况填写。如：-3允许重叠3像素；如果不重叠的话,直接写0。
注意：重叠和粘连概念不一样，粘连的话，其实字符间隙为0。

OptionIndexOptionValue默认值说明
7 -10～0 0 字符重叠间隙

返回值：

返回结果类型说明
True boolean型 设置成功
False boolean型 设置失败

示例：

import wmcode
// 识别库路径
Dim datPath = "d:\\demo\\辽宁-12345606.dat"
// 识别库密码
Dim password = "12345606"
// 字库标识
Dim flag
// 加载识别库
flag = wmcode.LoadDat(datPath,password)
// 设置“返回方式”为：返回验证码字符和矩形范围
wmcode.SetWmOption(1,1)
// 设置“识别方式”为：纵分割识别
wmcode.SetWmOption(2,2)

If flag
   TracePrint("识别库加载成功")
else
   TracePrint("识别库加载失败")
end if

SetWmOptionEx(wmid, OptionIndex, OptionValue)

函数说明：
       设定指定id的识别库选项。设定成功返回真，否则返回假。

参数：

参数名类型说明
wmid 整数型 字库id（LoadDatEx返回的字库id）
OptionIndex 整数型 识别库文件所在全路径
OptionValue 整数型 识别库调用密码

参数取值范围：

  • [x] 返回方式
OptionIndexOptionValue默认值说明
1 0 0 直接返回验证码
1 1 0 返回验证码字符和矩形范围。例如：S,10,11,12,13\|A,1,2,3,4 表示识别到文本 S >>左边横坐标10,左边纵坐标11,右边横坐标,右边纵坐标12
1 2 0 返回验证码字符和总体信任度。例如:abcd\|98 表示识别结果abcd,总体信任度98
1 3 0 返回验证码字符和矩形范围形和总体信任度。例如：S,10,11,12,13\|A,1,2,3,4\|98 >>表示识别到文本 S 左边横坐标10,左边纵坐标11,右边横坐标,右边纵坐标12....总体信任度为98
  • [x] 识别方式

可以进行分割的验证码，建议优先使用分割识别，因为分割后不仅能提高识别率，而且还能提高识别速度

OptionIndexOptionValue默认值说明
2 0 0 整体识别
2 1 0 连通分割识别
2 2 0 纵分割识别
2 3 0 横分割识别
2 4 0 横纵分割识别
  • [x] 识别模式

识图模式指的是背景白色视为透明不进行对比，识字模式指的是白色不视为透明，也加入对比。
绝大多数我们都是使用识图模式，但是有少数部分验证码，使用识字模式更佳。

OptionIndexOptionValue默认值说明
3 0 0 识图模式
3 1 0 识字模式
  • [x] 识别加速

一般建议开启加速功能，开启后对识别率几乎不影响。而且能提高3-5倍识别速度。

OptionIndexOptionValue默认值说明
4 0 0 不加速
4 1 0 使用加速
  • [x] 加速返回

使用加速返回一般用在粗体字识别的时候，可以大大提高识别速度，但是使用后，会稍微影响识别率。识别率有所下降。一般不是粗体字比较耗时的验证码，一般不用开启

OptionIndexOptionValue默认值说明
5 0 0 不加速返回
5 1 0 使用加速返回
  • [x] 最小相似度
OptionIndexOptionValue默认值说明
6 0～100 90 相似度值，值越大越严格
  • [x] 字符间隙

如果字符重叠,根据实际情况填写。如：-3允许重叠3像素；如果不重叠的话,直接写0。
注意：重叠和粘连概念不一样，粘连的话，其实字符间隙为0。

OptionIndexOptionValue默认值说明
7 -10～0 0 字符重叠间隙

返回值：

返回结果类型说明
True boolean型 设置成功
False boolean型 设置失败

示例：

import wmcode
// 识别库路径
Dim datPath = "d:\\demo\\辽宁-12345606.dat"
// 识别库密码
Dim password = "12345606"
// 字库标识
Dim flag
// 加载识别库
flag = wmcode.LoadDatEx(datPath,password)
// 设置“返回方式”为：返回验证码字符和矩形范围
wmcode.SetWmOptionEx(flag,1,1)
// 设置“识别方式”为：纵分割识别
wmcode.SetWmOptionEx(flag,2,2)

If flag > -1
   TracePrint("识别库加载成功,字库id为:" & flag)
else
   TracePrint("识别库加载失败")
end if

识别验证码

getCodeFormFile(img)

函数说明：
       识别一个图像文件，返回识别的验证码。

参数：

参数名类型说明
img 文本型 图像文件所在全路径

返回值：

返回结果类型说明
验证码字符串 文本型 识别库成功，返回验证码文字
"" 文本型 识别失败

示例：

import wmcode
// 识别库路径
Dim datPath = "d:\\demo\\辽宁-12345606.dat"
// 识别库密码
Dim password = "12345606"
// 待识别验证码图片路径
dim imgPath = "d:\\demo\\ln.bmp"
// 字库标识
Dim flag, vcode
// 加载识别库
flag = wmcode.LoadDat(datPath,password)
If flag
   // 识别图片
   vcode = wmcode.getCodeFormFile(imgPath)
   TracePrint("识别库加载成功,验证码：" & vcode)
else
   TracePrint("识别库加载失败")
end if

getCodeFormFileEx(wmid, img)

函数说明：
       识别一个图像文件，返回识别的验证码。

参数：

参数名类型说明
wmid 整数型 字库id（LoadDatEx返回的字库id）
img 文本型 图像文件所在全路径

返回值：

返回结果类型说明
验证码字符串 文本型 识别库成功，返回验证码文字
"" 文本型 识别失败

示例：

import wmcode
// 识别库路径
Dim datPath = "d:\\demo\\辽宁-12345606.dat"
// 识别库密码
Dim password = "12345606"
// 待识别验证码图片路径
dim imgPath = "d:\\demo\\ln.bmp"
// 字库标识
Dim flag, vcode
// 加载识别库
flag = wmcode.LoadDatEx(datPath,password)
If flag > -1
   // 识别图片
   vcode = wmcode.getCodeFormFileEx(flag,imgPath)
   TracePrint("识别库加载成功,验证码：" & vcode)
else
   TracePrint("识别库加载失败")
end if

计算数学表达式

Calculator(Expression)

函数说明：
       计算数学表达式。功能简单，只是用来计算那些需要填写计算结果的验证码。

参数：

参数名类型说明
Expression 文本型 数学表达式，只能计算加，减，乘，除，次方运算，支持小括号，中括号，大括号运算，支持负数运算

返回值：

返回结果类型说明
表达式计算结果 文本型 计算成功，返回结算结果
"" 文本型 识别失败

示例：

import wmcode

TracePrint(wmcode.Calculator("1+2"))


作者：LCSan
链接：https://www.jianshu.com/p/ba1401d68ba9
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

相关文章