---
title: MusicUnderstandingSession.RangedValue
framework: musicunderstanding
role: symbol
role_heading: Structure
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+, watchOS 27.0+]
path: musicunderstanding/musicunderstandingsession/rangedvalue
---

# MusicUnderstandingSession.RangedValue

A structure that pairs a value over a time range.

## Declaration

```swift
struct RangedValue<Value> where Value : Decodable, Value : Encodable, Value : Equatable, Value : Sendable
```

## Overview

Overview The RangedValue is a container pairing an analysis value with a CMTimeRange segment of media time. Music properties like key and pace change over a track. The results are expressed as a sequence of contiguous segments covering the full timeline.

## Topics

### Getting the time range

- [range](musicunderstanding/musicunderstandingsession/rangedvalue/range.md)

### Getting the value

- [value](musicunderstanding/musicunderstandingsession/rangedvalue/value.md)

### Initializers

- [init(from:)](musicunderstanding/musicunderstandingsession/rangedvalue/init(from:).md)

### Instance Methods

- [encode(to:)](musicunderstanding/musicunderstandingsession/rangedvalue/encode(to:).md)

## Relationships

### Conforms To

- [Decodable](swift/decodable.md)
- [Encodable](swift/encodable.md)
- [Equatable](swift/equatable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Support types

- [MusicUnderstandingSession.TimedValue](musicunderstanding/musicunderstandingsession/timedvalue.md)
- [AnalysisType](musicunderstanding/analysistype.md)
