Events

An event is something a camera detected — motion, a person, a vehicle, a familiar face. Events carry a time range, the camera that produced them, AI classification tags and recorded media.

Event calls live on Factory.spaceService, because the feed belongs to a space rather than to a single camera.

Factory.spaceService.events(
    spaceId: spaceId,
    queryItems: [
        QueryItem(key: .deviceId, value: .equal(value: deviceId)),
        QueryItem(key: .limit,    value: .equal(value: "50"))
    ],
    sortItem: SortItem(descending: [.startTime])
)

In this section

Page Covers
Event Retrieval Listing, filtering, paging and fetching a single event
Event Deletion Deleting events and syncing deletions across devices
Event Download Building the command that renders an event to a local file
Event Playback Turning an event’s media URL into something a player can open
Daily Summaries Per-camera, per-day recaps with a clip and event counts by tag

Filtering and paging

Filters are expressed with QueryItem and ordering with SortItem. Always pair skip/limit with a stable sortItem, or records can appear twice or be skipped as new events arrive.

Footage still on the camera’s card is covered in SD Card Playback.

Event tags by product

EventTag is the AI classification on an event. The generic tags — motion, person, vehicle, animal, alarm — apply to every camera; the rest belong to a product line:

Tag Product
doorbellRing, face Home Security
cry, highTemperature, lowTemperature, highHumidity, lowHumidity Baby
pet Pet
bird Bird
wildlife Trail

Table of contents