场地编辑器
Editor 用户指南
跟随 Seatmap.pro Editor 用户指南创建场地和座位图,绘制区域、排与桌子,调整形状和编号,导入 SVG 底图并设置视图框。学习保存与发布座位图,为多个活动的座位、桌子和通用入场区分配价格,结合截图和视频掌握日常编辑操作、价格区域、曲线图稿及色盲友好显示设置。
iframe 通信
使用 postMessage 在宿主应用与嵌入的 Seatmap Editor 之间双向通信,请求保存、导出 SVG 和切换语言,接收座位图、票价及发布状态通知。参考消息类型、载荷、完整集成和自动保存示例,处理错误、超时及未保存更改,并验证消息来源和目标来源,建立可靠的 iframe 交互流程。
Webhook 目标
为 Seatmap.pro 配置接收场地、座位图及保存事件通知的 Webhook 端点,了解公共 HTTPS 目标和地址解析要求。查看自托管内部接收器的配置条件、超时与指数退避重试参数,以及不允许目标的处理方式;利用投递记录、响应片段和敏感响应头脱敏信息,诊断通知投递失败的原因。
按排设置座位间距
在 Seatmap.pro 场地编辑器中为直线区域的每一排分别设置座位水平间距。选中座位后使用侧栏滑块或输入数值,实时查看画布变化,制作交错或宽度不同的布局。了解多排选择时平均间距的显示方式、曲线区域的限制,以及向已有自定义间距的排添加座位时自动继承间距的行为。
场地库
使用 Seatmap.pro 场地库浏览并复制其他组织发布的场地座位图,将现有布局作为新项目的起点。了解发布者和浏览组织的职责、复制时快照的独立性、来源追踪及审计记录,并查看自托管实例之间的场地库联合功能、素材存储限制和不同角色的权限,规划跨组织复用场地布局的方式。
多租户集成与单点登录
将票务平台与 Seatmap.pro 的多租户工作空间连接起来,通过 Booking 管理 API 同步组织并请求自动登录会话。了解租户令牌、组织管理员账户匹配和角色限制,使用六十秒内有效的一次性代码在 iframe 中打开 Editor,并参考旧版令牌响应的兼容方式和具体嵌入示例。
防止孤立空座
为组织或单个活动启用 Seatmap.pro 孤立空座防护,避免选座后在一排中留下无法成组出售的单个空座。了解配置继承、过道判断、自动补选和回调控制,向 Booking API 传递购物车座位 ID,并根据 v1 与 v2 的不同响应正确处理锁定、销售、释放及直接销售操作。
访问管理
配置 Seatmap.pro Editor 的用户角色、组织权限和访问范围,创建组织并添加团队成员。了解普通用户、组织管理员、租户管理员与全局管理员的职责,处理已有邮箱账户,查看组织公共及私密 API 密钥和租户令牌,并按步骤切换组织、修改设置和管理用户,确保团队进入正确的工作空间。
管理员模拟用户
全局管理员可在 Seatmap.pro 编辑器中以目标用户的身份复现问题,无需共享密码。了解模拟会话的启动确认、目标账户限制、权限范围、三十分钟不可续期时限和停止方式,查看会话审计记录包含的信息,并在排查组织或权限相关问题时还原用户实际操作环境,追踪每次请求的真实操作者。
画布与图层
使用座位图编辑器画布底部的切换栏,在座位和图稿图层之间切换,分别选择并编辑区域、排、桌子、底图及标签。了解各图层如何保留选择和锁定状态,使用场地形状、裁剪参考框和网格调整布局,并掌握拖动时工具栏淡出及适应屏幕的显示方式,让复杂场地的编辑过程更加清晰。
活动中心
在 Seatmap.pro 活动中心集中查看组织内的活动,按状态和场地筛选列表,发布草稿、归档已发布活动并恢复归档内容。了解 API 与编辑器创建活动时的默认状态,使用座位图内的活动弹窗直接管理和预览活动,并通过专用链接进入已选定活动的编辑页面,查看对应座位状态及价格。
键盘快捷键
使用 Seatmap.pro 场地编辑器的键盘快捷键,快速保存和导出座位图、撤销或重做操作、缩放画布、切换图层及定价模式。掌握旋转吸附、多选、平移和对象层叠顺序的按键,了解输入文本或打开弹窗时的禁用规则,以及 macOS 与 Windows、Linux 之间的快捷键差异。
界面元素可见性控制
通过 Seatmap.pro Editor URL 的 hidden 参数显示或隐藏模式、工具和面板,使用简写或完整标识符控制定价、选座、形状、底图、检查器及活动入口。了解 shortToFullMap 映射、可见性判断函数和参数读取方式,参考混合标识符示例,并在集成时验证输入和处理未知元素。
全局搜索
在 Seatmap.pro 编辑器的任意位置搜索场地、座位图和活动,通过名称、数字 ID、GUID 或外部 ID 快速定位目标。使用键盘选择结果、在新标签页打开内容,或直接进入已选定活动的编辑视图;了解当前组织的搜索范围,以及跨组织管理员打开结果时自动切换组织的行为。
行标签对齐与样式
在 Seatmap.pro 场地编辑器中选择逐排对齐或整列对齐,让不同宽度的座位排保持清晰易读的标签。为整张座位图设置标签颜色、大小、字体和粗细,或按区域覆盖指定字段。了解默认值、重置操作、Booking Renderer 的字体替代方式,以及自动区域轮廓如何为较大的标签留出空间。
圆桌与椭圆桌
在 Seatmap.pro 场地编辑器中创建圆桌和椭圆桌,让座位沿桌边均匀分布。设置座位数量、起始位置、编号方向和桌子名称,拖动尺寸手柄调整形状,旋转桌子并保持座位布局一致;使用桌子编辑模式配置单个座位,并选择圆形、矩形或仅显示座位的显示方式,以适应不同场地布局。
桌子编辑模式
在 Seatmap.pro 座位图编辑器中双击桌子,进入桌子编辑模式,逐个或批量选择桌边座位并调整属性。了解 Hidden、Accessible 和 Marked 控件的作用,查看隐藏座位对预订 API、渲染器及桌子轮廓的影响,并通过点击桌子外的空白画布返回常规编辑模式。
座位名称冲突检测
使用 Seatmap.pro 场地编辑器的实时校验,发现同一排中的重复座位名称。通过画布红色标记和虚线弧、Inspector 面板中的区域及座位提示,以及状态栏的受影响排数定位问题。按步骤为冲突座位重命名,或使用 Number Seats 为整个区域重新编号,同时继续正常编辑和保存。
座位图编辑器 iframe 集成指南
使用 iframe 将 Seatmap.pro 座位图编辑器嵌入您的应用或弹窗,通过 URL 参数隐藏工具和导航栏、显示定价功能并保留草稿保存状态。参考完整代码实现和消息处理示例,了解各模式及工具标识符、自动布局调整、只读展示与创建向导场景,并为自定义命令添加对应的接收处理器。