PhotoRobot 控制应用程序 - 向导模式和自助服务终端模式

‍

本用户手册提供了关于操作员步骤配置及其在 PhotoRobot Wizard 模式中使用的技术说明。在 PhotoRobot Controls App（以下简称“CAPP”）中，Wizard 模式利用一系列向导步骤来指导用户完成各种任务。这些步骤以类似 JavaScript 的语言格式定义，可由 PhotoRobot 顾问编写脚本以实现自定义功能。用户还可以为初始实验或简单设置编写基本功能脚本。

‍

‍

‍注意：以下信息提供了有关为自定义向导及其操作员步骤创建脚本的技术说明。这包括如何在CAPP中以自助服务终端模式的简化用户界面创建向导后访问和启动它们。有关促进对CAPP的普遍理解和首次使用的信息，请参阅PhotoRobot入门用户手册。

‍

‍

1 - PhotoRobot 引导模式概览

PhotoRobot 向导模式允许用户创建一系列步骤的配置，操作员稍后将遵循这些步骤来拍摄产品。配置向导后，PhotoRobot 即可在Kiosk模式下运行，该模式充当极其简化的用户界面。

向导和自助服务终端模式支持那些希望将复杂控件隐藏在后台的企业，使机器操作几乎万无一失。它们为操作员提供了传统控制界面的极其用户友好的替代方案。

在大多数情况下，这两种模式都在机器安装期间设置，或由摄影师或工作室经理自定义。这使得可以利用预编程的自动化功能，包括对机器操作员来说隐藏在后台的预设和向导。

‍

‍

2- 自助服务终端模式概述

实际上，自助服务终端模式会锁定用户界面，只向用户显示管理员明确允许他们访问的内容。例如，处于自助服务终端模式的用户通常只能拍照并进入下一步。 

操作员遵循的步骤取决于所使用的特定向导。同时，操作员将无法访问甚至无需担心任何可调整的设置。这有助于显著缩短学习曲线并降低入职要求。

甚至可以将机器操作简化到只有一个启动按钮，或者快速扫描条形码。因此，工作室可以雇用受过很少培训的仓库工人，包括外包人才、自由职业者和学生实习生等。

‍

‍

‍

3 - 如何访问 PhotoRobot 向导模式

要访问向导模式，请在本地应用程序中打开“设置”菜单。在此处，用户可以通过左侧菜单加载向导，或使用界面右上角的添加向导创建新向导：

‍

‍

用于创建、编辑或自定义向导的选项包括向导名称、项目名称、注释、预设、工作区和向导步骤：

‍

‍

注意： 为了启动向导，它必须包含有效的预设、所有工作区配置，最重要的是目录文件夹的数量和名称。然后，其中每个步骤都必须与向导中定义的步骤匹配，才能正常运行。

‍

‍

4 - 创建新向导

若要创建新的向导模式，请在本地应用程序中打开“设置”菜单，然后使用界面右上角的“ 添加向导 ”：

‍

‍

在此菜单中，有用于创建、编辑和自定义向导的选项： 

• 向导名称 
• 项目名称
• 笔记
• 预设
• 工作
• 向导步骤

‍

‍

注意： 为了启动向导，它必须包含有效的预设、所有工作区配置，最重要的是目录文件夹的数量和名称。然后，其中每个步骤都必须与向导中定义的步骤匹配，才能正常运行。

‍

‍

5 - 向导步骤

每个向导都包含一个步骤列表。可以使用以下步骤类型：

• 创建项
• 选择项目
• 捕获文件夹
• 导入图像
• 实时取景

‍

‍

6 - 详细步骤说明

创建项

描述

create-item 步骤使用户能够创建新项。用户按如下方式定义项目，并使用以下对象定义项目。

• 类型： “创建项目”
• 领域：此对象数组定义用于创建项的字段。字段可以包括“名称”、“条形码”、“跟踪代码”、“链接”、“注释”、“标签”、“工作区”。每个字段也可以标记为可选字段。‍
• 设计： 此对象指定设计方面，如 “bgImage ”（背景图像 URL）和 “bgColor” （背景色）。

‍

例

JavaScript的：

‍
{
   “类型”： “创建项目”，
   “字段”：[
       {
           “name”： “名称”
       }，
       {
           “name”： “注意”，
           “可选”： true
       }
   ]，
   “设计”：{
     “bgImage”： “https://hosting.photorobot.com/images/-ML2QkR2lrhwn5SVMaEu/-NMSZjM-bdArdYcaa9XJ/NORMAL/c3o4fsHCXth55bOAZZNk8A？w=1920”
   }
}

‍

‍

选择项目

描述

select-item 步骤使用户能够选择现有项。用户通常会在项目列表已创建时（例如从 CSV 导入后）启用此步骤。 

• 类型： “选择项目”
• 设计： 此对象指定设计方面，类似于 create-item。

‍

例

JavaScript的：

{
   “类型”： “选择项”，
   “设计”：{
     “bgImage”： “https://hosting.photorobot.com/images/-ML2QkR2lrhwn5SVMaEu/-NMSZjM-bdArdYcaa9XJ/NORMAL/c3o4fsHCXth55bOAZZNk8A？w=1920”
   }
}

‍

‍

捕获文件夹

描述

capture-folder 步骤允许用户捕获文件夹。

• 类型： “捕获文件夹”
• 标题： 步骤的标题
• 注意： 步骤的说明或说明。
• 目录名称： 将存储图像的目录的名称。
• 自选： 如果为 true，则此步骤是可选的，用户可以跳过它。
• copy （可选）：将捕获的图像复制到另一个文件夹中。‍
• 复制到目录： 目标文件夹
• 复制过滤器：可选过滤器，仅复制匹配“swingAbs”、“turnAbs”或“label”的图像。

‍

示例 1 - 简单文件夹捕获

JavaScript的：

‍
{
   “type”： “捕获文件夹”，
   “title”： “捕获内部”，
   “note”： “用手持相机捕捉内部。”
   “dirName”： “详细信息”
}

‍

示例 2 - 捕获文件夹并将所选图像复制到另一个文件夹中

JavaScript的

‍
{
 “type”： “捕获文件夹”，
 “title”： “捕获旋转”，
 “dirName”： “旋转”，
 “复制”：{
   “toDir”： “剧照”，
   “过滤器”：[
     { “swingAbs”： 10， “turnAbs”： 0 }，
     { “swingAbs”： 10， “turnAbs”： 45 }，
     { “swingAbs”： 10， “turnAbs”： 180 }
   ]
 }
}

‍

‍

导入图像

描述

import-images 步骤允许用户从磁盘导入映像。此步骤中的对象包括以下内容。

‍

• 类型： “导入图像”
• 标题： 步骤的标题
• 注意： 步骤的说明或说明
• 目录名称：将存储图像的文件夹的名称
• 自选： 如果为 true，则此步骤是可选的，用户可以跳过它

‍

例

JavaScript的：

‍
{
   “type”： “捕获文件夹”，
   “title”： “捕获内部”，
   “note”： “导入使用手持相机拍摄的图像。”
   “dirName”： “内部”
}

‍

‍

实时取景

描述

实时取景步骤打开摄像机 实时取景 。用户通常会启用此功能来检查对象的位置。

‍

• 类型： “实时取景”
• 注意：步骤的说明或说明
• cameraAngle （可选）：指定用于实时查看的摄像机角度

‍

例

JavaScript的：

{
   “type”： “直播”，
   “title”： “检查位置”，
   “note”： “检查物体的位置，确保它居中。”
}

‍

‍

7 - 用法示例

以下示例使用名称和注释字段（可选）以及具有背景图像和颜色的设计创建用于创建项的向导步骤。

‍

JavaScript的：

[
 {
   “类型”： “选择项”，
   “字段”：[
     {
       “name”： “名称”
     }，
     {
       “name”： “注意”，
       “可选”： true
     }
   ]，
   “设计”：{
     “bgImage”： “https://hosting.photorobot.com/images/-ML2QkR2lrhwn5SVMaEu/-Nehz_ciyDihw90EgNuy/FINAL/tqZxrqbKZ4exH6y2LFPWUw？w=1200”
   }
 }，
 {
   “type”： “直播”，
   “title”： “检查仓位”，
   “note”： “检查该人是否在视野中。”
   “cameraAngle”：15
 }，
 {
   “type”： “捕获文件夹”，
   “title”： “捕获旋转”，
   “dirName”： “旋转”
 }，
 {
   “type”： “捕获文件夹”，
   “title”： “捕捉静止图像”，
   “dirName”： “剧照”
 }
]

‍

注意：这是一个通用代码，允许PhotoRobot用户进行初始实验和简单的脚本设置。使用它来测试向导功能，并运行用于试验的基本脚本。

‍

‍

8 - 启动向导

要启动向导，请先将其分配给一个项目，然后点击保存：

‍

‍

将向导分配给项目后，可以通过 2 种方式启动向导：

1. 在界面的右上角，单击 更多 和 Start 向导，或;
2. 单击用户帐户图标，然后单击 启动向导模式：

‍

‍

‍

9 - 自助服务终端模式下的向导引导操作员步骤

成功启动向导后，界面将以自助服务终端模式打开，并在顶部显示项目名称，下方显示向导名称。单击创建以在自助服务终端模式下启动向导：

‍

‍

在启动屏幕之后，简化的自助服务终端模式用户界面将显示预定义操作步骤中的第一阶段。从此时起，操作员必须完成每个捕获阶段的说明，然后单击自助服务终端模式界面底部的下一步以进入后续步骤：

‍

‍

通常，第一步将指示操作员配置将使用的一个或多个摄像机。在这里，操作员还会检查产品是否正确定位并在相机视野中。

后续步骤会根据预设指导操作员将给定角度的图像捕获到特定文件夹中。这些步骤还可能包括拍摄不同产品配置的说明，例如车门打开、关闭或从内部拍摄的汽车：

‍

‍

此外，自助服务终端模式可以显示向导步骤中的注释，以便更清楚地解释各个阶段。注释位于自助服务终端模式界面的左侧，步骤标题下方：

‍

‍

在某些情况下，引导自助服务终端模式的向导还可能指示操作员使用手持相机拍照，然后在下一步选项可用之前导入图像。

‍

‍

完成每个阶段后，单击界面底部的新建项目即可完成向导引导的自助服务终端模式：

‍

‍

单击“新建项目”后，用户将返回到向导启动页面。在这里，可以退出用于自助服务终端模式的向导，或继续到下一个项目。

要退出向导，请单击界面右上角的帐户图标，然后单击 退出向导：

‍

‍

如果继续处理系统中存在的另一个项目，也可以通过向导设置加载要捕获的项目，方法是将第一步更改为 “type”： “select-item”：

‍

‍

配置“type”: “select -item”后，用户可以通过在该向导的Kiosk模式启动屏幕上输入项目名称来选择项目：

‍

‍

最后，还可以为向导模式启用密码保护，或者指定一个项目，该项目将默认以向导引导的自助服务终端模式启动。通过导航到“设置”并单击“向导”，可以在CAPP启动时找到这些选项。

菜单选项顶部提供一个开关（开/关），用于在启动 CAPP 后自动进入向导/自助服务终端模式。在此下方，用户可以点击设置密码以启用密码保护。

‍

‍