<!--
{
  "availability" : [
    "iOS: 4.0.0 - 9.0.0",
    "iPadOS: 4.0.0 - 9.0.0",
    "macCatalyst: 13.1.0 - 13.1.0"
  ],
  "documentType" : "symbol",
  "framework" : "MediaPlayer",
  "identifier" : "/documentation/MediaPlayer/MPTimedMetadata",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Media Player"
    ],
    "preciseIdentifier" : "c:objc(cs)MPTimedMetadata"
  },
  "title" : "MPTimedMetadata"
}
-->

# MPTimedMetadata

A *timed metadata object that* carries time-based information within HTTP streamed media.

```
class MPTimedMetadata
```

## Overview

Content providers can embed these objects when creating a stream. The properties and constants in this class let you extract the metadata as you play the stream using an [`MPMoviePlayerController`](/documentation/MediaPlayer/MPMoviePlayerController) object. For example, the provider of a live sports video stream could use `MPTimedMetadata` instances to embed game scores, with timestamps, in the stream. On the client side—that is, on the user’s device—their application could employ the properties of this class to update their app’s user interface in real time during the game.

A Javascript implementation of this class is also available for use by web-based applications.

## Topics

### Extracting timed metadata from a stream

[`allMetadata`](/documentation/MediaPlayer/MPTimedMetadata/allMetadata)

A dictionary containing all the metadata in the object.

[`key`](/documentation/MediaPlayer/MPTimedMetadata/key)

A key that identifies a piece of timed metadata.

[`keyspace`](/documentation/MediaPlayer/MPTimedMetadata/keyspace)

The namespace of the identifying key.

[`timestamp`](/documentation/MediaPlayer/MPTimedMetadata/timestamp)

The timestamp of the metadata, in the timebase of the media stream.

[`value`](/documentation/MediaPlayer/MPTimedMetadata/value)

The timed metadata.

### Constants

[Timed metadata dictionary keys](/documentation/MediaPlayer/timed-metadata-dictionary-keys)

Dictionary keys for use with the [`allMetadata`](/documentation/MediaPlayer/MPTimedMetadata/allMetadata) property. All keys are optional.

### Notifications

[`MPMoviePlayerTimedMetadataUpdatedNotification`](/documentation/MediaPlayer/MPMoviePlayerTimedMetadataUpdatedNotification)

Posted when new timed metadata arrives.

[`MPMoviePlayerTimedMetadataUserInfoKey`](/documentation/MediaPlayer/MPMoviePlayerTimedMetadataUserInfoKey)

An NSDictionary object containing the most recent `MPTimedMetadata` objects.

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

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)