Performance Hub 徽标Performance Hub
网站版块： 文档

Door & Gate Access 移动应用

本页内容

Door & Gate Access 是面向会员的移动应用：会员使用一次性验证码登录，查看自己在您的设施中可以通过的门，并轻点一下即可解锁。本页从头到尾介绍会员体验，以便管理员为会员提供支持，内容包括登录、仪表板、解锁、应用锁、历史记录和设置。

有关各个界面的截图导览，请参阅配套页面：iPhone 和 Android 应用、Apple Watch 和 Wear OS 以及 CarPlay。

获取应用

在 App Store 下载 在 Google Play 上获取

该应用适用于：

  • iPhone 和 iPad（iOS/iPadOS 18 或更高版本）
  • Android 手机
  • Apple Watch（watchOS 11 或更高版本）和 Wear OS 手表：在手腕上解锁，无需拿出手机
  • CarPlay：在车载屏幕上解锁闸门和车库门
  • 主屏幕小组件和控制中心控件（iOS）

iOS 和 Android 上的功能和用户界面完全相同，本文档中的截图均在 iOS 上截取，但同样适用于 Android 应用。从 Users 发送的邀请电子邮件中包含下载链接。

登录

无需密码，登录使用发送到会员 Users 记录中电话号码或电子邮箱的一次性验证码（OTP）。

  1. 首次启动时，应用会显示简短的引导界面，请求精确位置权限（地理围栏解锁需要）和通知权限。
  2. 在 Welcome 界面上，会员选择 Email 或 Phone，输入地址/号码，然后轻点 Send code。
  3. 输入 6 位验证码（30 秒后会出现 Resend code 选项）。
  4. 之后会保持登录状态，无需每次启动时都输入验证码。

会员可能反映的登录问题：

应用中的消息原因管理员解决方法
No record found："No record could be found matching the … you provided."该电话号码/电子邮箱与任何设施的 Users 记录都不匹配在 Users 中核对准确的电话号码/电子邮箱；更正拼写错误或添加缺失的标识
Too many attempts登录频率限制（网络级限制，或每个联系方式每小时 5 次验证码请求）请其等待，每个联系方式的限制是一项安全措施，无法解除
收到验证码但验证失败验证码输入错误或已过期重新发送新的验证码

登录仅用于证明身份。每扇门仍需由 Access Policies 和叠加授权进行授权。

选择设施

关联多个设施的会员（同一电话号码/电子邮箱存在于多个设施的 Users 中）可以通过仪表板顶部的设施名称进行切换（Switch Location）。当应用检测到会员位于其关联的另一个设施时，也可以建议切换；可选的 Auto-switch to nearest location 设置会在会员距离 250 m 以内时自动切换。

仪表板

Doors & Gates 选项卡列出会员在所选设施中可以看到的每扇门：

  • 门按位置分组（即管理门户中设置的 Door location 标签），顶部有一张大的主门卡片；拥有多扇门的会员可以用星标置顶自己最常用的门。
  • 每扇门显示管理员选择的图标、门的名称和实时状态标签。
  • 消息以卡片形式显示在顶部：先显示会员的个人消息，然后显示设施范围的消息，按严重程度着色（INFORMATION / NOTICE / URGENT）。请参阅应用消息。
  • 支持联系人（致电/发送电子邮件给该地点）的显示方式取决于 App Security 设置，默认在门离线或信息有限时显示。
  • 没有任何门的会员会看到："You don't have access to any doors at this location yet. Please contact the location or your site administrator and they'll get you set up."

门状态标签

标签含义
Unlock已就绪，轻点即可解锁
Unlocked / Re-locking刚刚解锁；正在对门重新上锁前的保持时间进行倒计时
Move closer to open / Not at site会员位于门的地理围栏之外（可能会显示“250 m away”之类的距离标记）
Door offline门控制器未上报状态，无法传送解锁指令
Under maintenance / Maintenance门处于 Force closed 维护模式
Open门保持打开状态（Force open 或自动解锁时间表）
Outside hours / Available {hours}正在等待未来的 Access Policy、授权或集成时间窗口；显示服务器提供的可用时间
No access没有任何 Access Policy、永久授权或管理员/集成时间窗口为该会员覆盖此门

解锁门

  1. 轻点门的解锁按钮。
  2. 对于启用了地理围栏的门，应用会先重新获取精确的 GPS 定位。
  3. 请求会发送到服务器，由服务器做出完整的访问决策。
  4. 解锁成功时：门会解锁，应用会显示 Unlocked，以及按门的保持时间进行的 Re-locking 倒计时。

当解锁被拒绝时，应用会说明原因：

服务器原因会员看到的消息
位于地理围栏之外"Move closer — you're outside the location's geofence."（另有一个说明地理围栏及其与场所距离的面板）
GPS 精度不足"Couldn't pin down your location accurately. Try again outdoors."
位置不可用"Couldn't read your location. Make sure Location is enabled and set to Precise, then try again."
门离线"Door is offline. Please contact the facility."
没有匹配的策略或授权"You don't have access to this door."
访问权限已停用"Your access has been suspended — please contact the facility."
不在 Access Time Window 内门保持禁用状态，并在有相关信息时显示其下次可用时间
缺少定位权限显示 "Location is needed" 面板，并带有 Open Settings 快捷方式；启用了地理围栏的门要求将 Location 设为 Precise

每一次尝试（无论被允许还是被拒绝）都会连同原因显示在管理端的访问日志中。

Access Policy 时间表可用性

对于未来生效的定时策略，受支持的客户端会使用服务器提供的结构化开始/结束时间、标签、类型和时区，使门保持可见并显示访问权限何时可用。精确时间点使用 [from, to) 边界。Weekly 可用性由服务器根据策略时间窗口的 IANA 时区和夏令时规则计算；应用只负责格式化显示该时段。

为保持兼容，旧版客户端可能会收到 outside_access_hours，而新版使用方会收到 outside_access_time_window 详细信息和结构化的可用时间。

Access Policies 仅用于允许，且相互之间为“或”关系，但单项策略仍要求 Who、Where 和 When 全部匹配。永久授权和管理员/集成时间窗口保持独立且叠加。blockAllAccess、用户停用、维护和地理围栏仍然优先。

应用锁

如果设施强制启用了应用锁（或会员自己在 Profile → App Lock 下启用），应用会在使用前要求进行设备验证：

  • 在可用时使用 Face ID / Touch ID / 设备密码；两者都不具备的设备会引导用户创建 4 位 PIN（"Required by {facility} — managed by your site administrator."）。
  • 重新提示遵循配置的宽限期；冷启动和较长时间离开后始终会重新提示。
  • 登录了多个设施的会员会采用其中最严格的策略。
  • PIN 输入错误 5 次后，应用会锁定，需要清除数据并重新登录。

历史记录

History 选项卡显示会员本人在所选设施的访问活动，按日期分组，并可按门筛选。轻点某个条目会打开 Access Details 面板，其中显示日期、时间、门、设备、IP 以及解锁位置的地图。这与管理员在访问日志中看到的内容一致，但仅限于会员本人的事件。

个人资料和设置

会员可以在 Profile 选项卡中：

  • 编辑其名字/姓氏（电子邮箱和电话号码为只读："To change your email or phone number, please contact your location or site administrator — these details are managed centrally for security." 管理员可在 Users 中更改）。
  • 查看其关联的地点。
  • 配置 App Lock（除非由管理员强制启用）、到达通知、自动切换地点以及外观（浅色/深色/自动）。
  • Get Support：支持由该地点的管理员提供，而不是由中央服务台提供。
  • Sign Out from App，或提交 Delete Account & Data 请求，该请求会通知地点管理员并清除设备上的数据。

其他功能

  • 主屏幕小组件和控制中心控件（iOS）：一键解锁主门。
  • Apple Watch / Wear OS 应用：在手腕上解锁；需要先在手机上登录，请参阅 Apple Watch 和 Wear OS。
  • CarPlay：在车载屏幕上解锁闸门和车库门，便于车辆出入。请参阅 CarPlay。
  • 到达通知：启用后台定位后，应用可以在会员到达设施时发送通知 "You've arrived. Tap to unlock a door."