思迅Ai识别2.0指导手册

一、前言

    思迅Ai识别2.0，无感精准识别，并支持断网识别，具备快准稳广的特点。为帮助用户快速安装并使用产品，以小象5.7为例，特制定本手册。

1、商品无需传称，实时自动同步；
2、促销价格等自动生效，不需要处理生鲜条码；
3、断网也可以支持识别；
4、多台机器可支持一键同步学习；
5、不需要单独安装部署配置，产品自带功能；
6、市面上主流的秤均支持；

二、产品安装注册及使用

2.1 获取激活码

由由Ai识别行业版本与激活码绑定，请先联系思迅正规渠道购买获取激活码。版本选择参考如下：
产品行业分类：生鲜果蔬版、休闲食品版和三合一三个版本。
注: 后续如需切换行业版本，请联系思迅商务进行切换。

2.2 产品安装及注册

推荐摄像头要求：

1) 分辨率1920*1080，兼容720p(影响效果)。
2) 输出头像格式MJPEG
3) 帧率：60，最低支持30(影响效果)
4) 若镜头输出比例(Lens Size )为4:3，选择16:9分辨率时，禁止裁剪画面。
5) 推荐快门类型 ：全局快门。

启用Ai及注册。操作步骤如下：

1）启动前台 -> 输入账号/密码 -> 进入前台设置 -> PC秤；
2）点击“Ai程序下载/升级”，等待下载完成；（注：仅部分产品支持在线下载或升级，如产品未支持，请前往思迅社区进行下载）
3）点击“Ai设置”，勾选“启用Ai识别”设置项；
4）输入激活码进行激活；（注：激活码找思迅正规渠道购买获取）
5）保存设置。

2.3 产品使用

产品使用基本步骤为： Ai识别区域调整 -> 下载图片库 -> 商品学习 -> 商品识别。

1、Ai识别区域调整

    将秤台的识别区域调整到合适的范围，将增强识别的精准度。启动前台 -> 输入账号/密码 -> 进入前台设置 -> PC秤 -> Ai设置 -> 点击 调整识别区域 按钮，将识别区域调整为合适的范围。当识别区域调整未进行有效调整，如周边区域干扰严重时，将影响到识别准确度。

左图正确：拍摄范围在秤台上。
右图无效：拍摄到秤台外的干扰区域太多，影响到识别。

2、下载商品图片库

    Ai识别程序自带常见商品的图型库，可以直接点击 下载图片库 按钮下载相关的图片。当然，当商品无对应的图片设置时，系统将呈现默认的图片效果，不影响软件的使用。

1）若商品图型库中无对应图片，可手工增加。
   以货号命名(jpg格式)的图片文件，放到前台目录下的ItemImage文件夹中即可。

2）下载图片为联网操作，若网络不佳，可先在网络条件较好的POS机上下载，再将ItemImage文件夹拷贝过来。

3）也可以在【拍照学习】时，指定拍摄照片作为商品展示图片，操作详见【商品学习】部分的描述。

3、商品学习

    主要有未识别到商品及识别有误场景需要学习。学习成功后，产品对应的提示信息位置会有明显的“学习成功”提示字样。有 自动学习 和 拍照手动学习 两种操作模式。自动学习的操作类似于“前台销售时，输入商品的操作”，包含以下：

1. 点选商品：点选销售界面正确的商品。
2. 助记码查找：通过输入助记码进行商品搜索，点选正确的商品。
3. 输条码：直接输入正确商品对应的货号/条码。
4. 其它方式：如可以通过调出前台的商品查询功能，搜索并选择正确的商品进行学习。

• 场景一：使用商品识别功能前，进行自动学习
  商品放置秤台 -> 未识别到商品 -> 点击 进行学习 按钮 -> 选择商品 -> 学习成功

  

• 场景二：使用商品识别功能前，进行拍照学习（零食推荐此模式以提升识别率）
      销售界面录入称重商品后，选择该商品，点击其它->“Ai商品学习”进入手工学习。您可以通过对同种商品不同数量、不同形态、不同摆放拍照进行学习，以提高商品的识别准确度。拍照学习时需注意以下6点：

  1) 尽量拍摄 接近使用的场景 的图像；
  2) 拍照模糊不清的，可以点击右上角红色X直接删除；
  3) 最多支持50张学习拍照，形态复杂的商品多学习，形态单一的商品少学习，并确保一次性完成学习保存，同一商品后一次学习会覆盖前面的学习，不要分多次保存学习。比如：生鲜类等形态单一商品一般学习10张（包括带袋子和不带袋子），零食类等形态复杂的商品建议学习30张左右。
  4) 避免重复学习相同特征，即避免拍摄出来的图形一模一样；
  5) 避免无效学习，即避免拍摄因遮挡等出现商品不清晰的图片，避免拍摄无关物品到识别区域；
  6) 清除历史学习将该商品历史打称数据全部删除，请谨慎使用；

  点击"拍照学习"，打开手工学习操作窗口
  

  

  拍照学习，双击图片可设定为商品展示图片

• 场景三：商品识别有误时，进行自动学习
  商品放置秤台 -> 识别到商品，但无正确商品 -> 点击 进行学习 按钮 -> 选择商品 -> 学习成功

  

• 零食正确的学习示例

    1. 学习时的拍照区域与初始设置的识别区域一致；
    2. 拿取商品对不同形态，如不同数量(指多个数量)、包装正反摆放、包装横竖随机摆放等，一次性拍照完成并保存；(不可以分多次)

  

4、Ai学习同步与共享

    当连锁企业有多台Ai秤时，可以实现Ai学习同步，减少POS机重复学习的问题。也可以是新增加Ai秤使用时，通过同步其它机器的学习结果快速上线使用。操作流程：正常使用Ai的POS机上上传学习数据 -> 待同步的POS机下载学习数据 -> 使用Ai识别功能。（在前台设置->销售功能设置->外接功能中启用）

• 上传学习数据
  登陆前台 -> 其它 -> Ai学习同步 -> 上传本机学习数据。
  （注：小象20221116及以上版本，可在后台零售模块POS机登记中，设置POS机是否允许上传Ai学习数据。可通过指定POS机做为标准学习机器并上传数据，防止学习数据管理混乱。）

• 下载学习数据 (不包含图片，学习数据和图片是分开下载的)
  登陆前台 -> 其它 -> Ai学习同步 -> 选择学习数据 -> 覆盖/合并下载学习数据
  覆盖方式：本机原有的Ai学习数据作废，完全使用下载过来的学习数据。
  合并方式：与本机原有的Ai学习数据合并。

• 学习数据自动共享
  支持产品：小象。其操作步骤如下：

    1. 在后台“POS机登记”中，设置“下载Ai数据POS机号”；
    2. 前台在自动登陆时，将根据POS机号的信息，合并模式自动下载Ai数据；（POS版本号最低20230425）
    注：如果学习文件太大，也可以手动复制matching文件夹完成学习数据覆盖同步。

5、商品矫正

    当商品识别有误时，则需要对错误的信息进行矫正处理。其步骤为：点击 立即矫正 按钮 -> 点击错误的商品 -> 点击 保存矫正结果 按钮 -> 矫正完成。此功能零食识别不推荐使用。

6、商品识别数设置

    商品识别数，即Ai识别返回的商品数。系统默认为6，允许用户调整此参数（最大值为10）。因返回的商品数越大，意味着Ai识别算法运算更为耗时，因此建议用户根据实际情况设置合适的值，设置值并不是越大越好。我们建议如下：

7、语音播报功能

    Ai识别支持语音播报功能，即在点选商品时，语音播报商品品名信息，您也可以在前台Ai设置中关闭此功能（注意：AiVer版本不低于20221114）。如果语音播报异常，可进行tts语音修复（下载地址：思迅社区 –> 产品下载 –> 支付&O2O –> 思迅Pay插件 –> 思迅支付 –> tts语音修复包）

三、常见问题解决方法

    关于Ai使用识别出现的各种异常及错误，可以通过日志文件定位分析来解决。日志文件查看方式有两种：

1) 前台设置 -> PC秤 -> Ai设置 -> 查看日志
2) 手工打开前台安装目录下的目志文件查看，路径示例：
    D:\Program Files (x86)\siss\eWeight5\logs
    D:\Program Files (x86)\siss\eWeight5\logs\AiLog

3.1 SDK运行错误

    如果商品放到称台上，POS程序能取到重量而没有识别，可能是SDK加载失败，可查看日志D:\Program Files (x86)\siss\eWeight5\logs\yutooaisdk.2022-10-17.001.log判断是否为SDK运行错误。

• 出现此情况可按以下步骤处理：

1. 前台POS程序根目录下的lib文件夹下的三个文件（libmaprule.dll、libwin_mnn.dll、MNN.dll）在其他位置也存在。
   
2. 缺少vc环境。在其他位置也存在的lib文件夹下的三个文件（libmaprule.dll、libwin_mnn.dll、MNN.dll）进行删除，如依旧报错，请安装vc库。
   
3. 如以上方案均不可，需重新刷一下标准的系统。
   点击下载vc库

3.2 商品识别不出或出错

1. 未调整识别区域就进行了自动学习或手动学习，导致默认的识别区域有问题。请参考前面小节关于Ai识别区域调整的处理。
   
   
2. 使用产品中带有的矫正/识别功能进行相关操作，增加识别的准确度。如果是休闲食品(零食)识别，请使用“拍照学习”，以提升识别准确度。
   
   
3. 在前台Ai设置处，设置最大识别的商品数。但超出的识别数量，则推荐使用助记码等搜索功能配合使用。（注意：Ai动态库版本不低于20221012版本。但不推荐设置过大的识别数，会影响识别效率。）
   
   
4. 识别算法中采用了根据品名预识别的处理，首次初始化前，请确保品名命名规范，并去除不规范的重名商品。
   
   
5. Ai识别要求.NET Framework 4.0及以上版本，但可能会出现部分机器在.NET Framework 4.0版本上无法正常识别，可尝试更换为更高版本(如.NET Framework 4.8)
   
   
6. 2022/11/11社区更新了休闲食品识别模型库，可按需下载最新的Ai识别休闲食品版本，更新前台程序模型库，以提高识别准确度。对已上线有学习数据的客户，请务必备份好matching文件夹提交工单处理学习数据，否则需要重新对商品进行学习。
   
   
7. 识别时，手有遮挡，导致识别错误。
   
   识别时，手有遮挡，导致识别错误。可点击重新识别。
   
8. 商品识别过程中商品摆放位置超出了识别区域，需要将商品放置在识别区域中央位置；
   
   商品摆放超出了识别区域，导致识别错误。将商品移到中间位置，重新识别。
   
9. 带容器识别时，容器位置与学习时有较大的偏移。可将容器固定或者保持与学习时接近的位置。；
   
   商品识别窗口框的位置(左图)与商品学习时的窗口框的位置(右图)偏差较大，导致识别错误。
   
10. 其它特定的环境因素影响。
    
    特定环境影响：学习时无阳光干扰，识别时阳光带来黑色阴影，干扰了识别结果。

3.3 调整识别区域出错(OpenGL错误)

    可能是显卡驱动问题，用360驱动重新安装一下驱动，重启操作系统生效。报错截图：

3.4 Ai识别选商品不播报品名

    20221021版本开始支持语音播报功能，语音播报的功能属于操作系统自带的，请确保操作系统支持该功能并已启用。win7和win10都自带，部分win7阉割版系统没有这项功能会导致运行报错。高版本Ai程序(注意：AiVer不低于20221114版本)语音播报功能调整为与思迅Pay一致的播报方式，可尝试进行tts语音包修复解决。

3.5 Ai激活失败(PCI网卡已被禁用)

    Ai支持断网识别，但激活操作需要联网，确保网卡为启用状态。通过日志查看到的错误信息如下图：

3.6 客户原来使用由由插件，后期改为思迅Ai识别2.0，怎么把原来插件中的学习数据拷贝到思迅Ai识别2.0中？

    插件版本3.5.0.0版本以上，拷贝matching文件夹到小象前台POS目录即可，
    3.5.0.0版本以下拷贝的文件是plu.map_dict 4.0 这个文件替换到matching文件夹中

3.7 前台重装后，Ai识别激活提示“激活失败：激活码已使用，激活码存在已激活设备”

解决办法：

1. 联系渠道经理解绑该激活码。
2. 重装POS前先备份aibalance.ini 、yutooaisdk_app.conf、yutooaisdk_device.conf这三个文件，装好后再把这三个文件复制到新的目录下即可。

3.8 Ai识别速度慢

    Ai识别由取重触发，如果取重速度过慢（比如小象可以查看取重区域的重量变化快慢），可以尝试更换秤的协议，以提高取重和识别速度。

3.9 Ai调整识别区域时无法打开摄像头

    由于硬件问题，可以使用YuTooAiSDKPlugin小工具进行调整。可在思迅社区 –> 产品下载 –> 通用 –>Ai识别软件中下载此工具安装。安装后的操作步骤如下：

1. 登陆产品前台(如小牛)，并最小化；
2. 运行YuTooAiSDKPlugin.exe插件工具；
3. 在YuTooAiSDKPlugin.exe中调整好识别区域；
4. 退出YuTooAiSDKPlugin.exe；
5. 退出小象前台，重新登陆后使用直接使用Ai；

3.10 Ai前台激活时报网络错误

需要增加证书，先下载附件中的由由证书，然后按下图方法增加证书

3.11 商品同步为0 无法识别

因拷贝其他产品或者类别设置导致更新商品数为0
aibalance.ini 配置文件中的 ai_clsrange= 要为空

四、部分产品功能支持情况