跳转到主要内容

适用场景

Calendar Event QR 码会提示扫描设备将一个事件直接保存到其日历应用中——名称、时间、地点和描述均已预先填好。它是一种 Quick Code——一种没有落地页的直接动作型 QR。在应用中,其卡片上的文案是 “Prompt the scanner to save an event to their calendar.”(提示扫描者将事件保存到日历),该卡片标记为 Event Calendar(底层类别名称为 “Calendar Event”——两者指的是同一种类型)。
Calendar Event 仅支持 Static——此类型没有 Dynamic 选项。一旦发布,编码后的事件将无法编辑或追踪;如需更改,请创建一个新的 QR 码。

创建一个 Calendar Event QR 码

1

打开 Create QR Code 并选择 Quick Code

在侧边栏中,进入 QR Codes,然后点击 Create QR Code(或前往 /qr/create)。点击 Quick Code 卡片。
2

选择 Event Calendar

在 Quick Code 类型网格中,点击 Static Only 分区下 Event Calendar 下方的 Configure。这会打开 /qr/quick/calendar 处的表单。
3

输入事件详情

填写以下字段:
  • Event name —— 必填。
  • Start date & time —— 必填。
  • End date & time —— 可选;如果设置,必须晚于或等于开始日期,否则会出现内联错误,阻止发布。
  • Location(占位符 “1 Infinite Loop, Cupertino, CA”)—— 可选。
  • Description —— 可选,多行文本。
  • Time zone —— 可选,默认值为 “None (device default)“(无——使用扫描设备自身的时区)。
Event Calendar Quick Code 表单,已填写事件名称、开始和结束日期/时间、地点和描述,右侧带有实时 QR 预览

已填写事件名称、开始/结束时间、地点和描述的 Event Calendar Quick Code 表单

4

发布

点击 Publish。会弹出一个面板,用于确认或重命名 QR 码(默认使用事件名称)、分配文件夹或标签,并在确认前调整 QR 码设计。发布后,您可以在确认界面通过 Edit Design 重新访问设计(颜色、边框)。

通过 API 创建

若要通过 API 而非界面创建 Calendar Event QR 码,请使用类别 ID 12(标记为 Calendar Event,allowed_qr_types: "st"——qr_type 只能取 "st"),其 info 负载结构如下:
后端模式只要求 name 和 startDate 为必填项;两个日期字段都是不限制格式的自由字符串——仪表盘表单会发送其 datetime-local 输入控件的原始值(YYYY-MM-DDTHH:mm),如上所示。
类别 ID 12(“Calendar Event”)与类别 ID 20(“Event”)是不同的类别,后者是另一个基于 Page Builder 的类别——请勿混淆两者。
完整的请求结构请参见 Create QR Code。
Category List 参考表目前尚未列出 Calendar Event(以及本页其他仅限 Quick Code 的类别)——上述 ID 是直接对照实际的 /qr/category/ 端点确认得到的。

相关内容