<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SensorKit",
  "identifier" : "/documentation/SensorKit/SRDeviceUsageReport",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "SensorKit"
    ],
    "preciseIdentifier" : "c:objc(cs)SRDeviceUsageReport"
  },
  "title" : "SRDeviceUsageReport"
}
-->

# SRDeviceUsageReport

The frequency and relative duration that the user uses their device, particular Apple apps, or websites.

```
class SRDeviceUsageReport
```

## Overview

The [`deviceUsageReport`](/documentation/SensorKit/SRSensor/deviceUsageReport) sensor provides this class as its [`sample`](/documentation/SensorKit/SRFetchResult/sample) type.

## Topics

### Summarizing Device Use

[`duration`](/documentation/SensorKit/SRDeviceUsageReport/duration)

The duration that the report spans.

[`totalScreenWakes`](/documentation/SensorKit/SRDeviceUsageReport/totalScreenWakes)

The total number of screen wakes for the device.

[`totalUnlocks`](/documentation/SensorKit/SRDeviceUsageReport/totalUnlocks)

The total number of unlocks for the device.

[`totalUnlockDuration`](/documentation/SensorKit/SRDeviceUsageReport/totalUnlockDuration)

The duration of time the device is in an unlocked state.

### Analyzing App Use

[`applicationUsageByCategory`](/documentation/SensorKit/SRDeviceUsageReport/applicationUsageByCategory)

The usage time of apps per category.

[`SRDeviceUsageReport.ApplicationUsage`](/documentation/SensorKit/SRDeviceUsageReport/ApplicationUsage)

An object that describes the user’s app activity over a period of time.

[`SRDeviceUsageReport.CategoryKey`](/documentation/SensorKit/SRDeviceUsageReport/CategoryKey)

Categories of apps or websites that the user uses.

### Analyzing Notification Use

[`notificationUsageByCategory`](/documentation/SensorKit/SRDeviceUsageReport/notificationUsageByCategory)

The frequency of notifications per category.

[`SRDeviceUsageReport.NotificationUsage`](/documentation/SensorKit/SRDeviceUsageReport/NotificationUsage)

An object that describes notification frequency and the manner in which the user interacts with notifications.

### Analyzing Web Use

[`webUsageByCategory`](/documentation/SensorKit/SRDeviceUsageReport/webUsageByCategory)

The amount of time the user accesses domains per category.

[`SRDeviceUsageReport.WebUsage`](/documentation/SensorKit/SRDeviceUsageReport/WebUsage)

An object that describes a user’s website usage.

### Getting algorithm information

[`version`](/documentation/SensorKit/SRDeviceUsageReport/version)

The version of the algorithm that the system uses to generate the report.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)