---
title: AVCaption
framework: avfoundation
role: symbol
role_heading: Class
path: avfoundation/avcaption
---

# AVCaption

An object that represents text to present over a time range.

## Declaration

```swift
class AVCaption
```

## Overview

Overview A caption contains a cue, which is a single sentence or paragraph of text for a time range in the video timeline. Within the active range, the caption may animate (for example, Karaoke lyrics) by rolling-up, changing visibility, or using other dynamic styling.

## Topics

### Creating a caption

- [init(_:timeRange:)](avfoundation/avcaption/init(_:timerange:).md)

### Accessing text and timing

- [text](avfoundation/avcaption/text.md)
- [timeRange](avfoundation/avcaption/timerange.md)

### Accessing the region

- [region](avfoundation/avcaption/region.md)

### Accessing font styles

- [fontStyle(at:)](avfoundation/avcaption/fontstyle(at:).md)
- [AVCaption.FontStyle](avfoundation/avcaption/fontstyle.md)
- [fontWeight(at:)](avfoundation/avcaption/fontweight(at:).md)
- [AVCaption.FontWeight](avfoundation/avcaption/fontweight.md)
- [decoration(at:)](avfoundation/avcaption/decoration(at:).md)
- [AVCaption.Decoration](avfoundation/avcaption/decoration.md)

### Accessing colors

- [textColor(at:)](avfoundation/avcaption/textcolor(at:).md)
- [backgroundColor(at:)](avfoundation/avcaption/backgroundcolor(at:).md)

### Accessing alignment

- [textAlignment](avfoundation/avcaption/textalignment-swift.property.md)
- [AVCaption.TextAlignment](avfoundation/avcaption/textalignment-swift.enum.md)

### Accessing animation

- [animation](avfoundation/avcaption/animation-swift.property.md)
- [AVCaption.Animation](avfoundation/avcaption/animation-swift.enum.md)

### Accessing advanced typography

- [ruby(at:)](avfoundation/avcaption/ruby(at:).md)
- [AVCaption.Ruby](avfoundation/avcaption/ruby.md)
- [textCombine(at:)](avfoundation/avcaption/textcombine(at:).md)
- [AVCaption.TextCombine](avfoundation/avcaption/textcombine.md)

### Initializers

- [init(coder:)](avfoundation/avcaption/init(coder:).md)
- [init(text:timeRange:)](avfoundation/avcaption/init(text:timerange:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Inherited By

- [AVMutableCaption](avfoundation/avmutablecaption.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSMutableCopying](foundation/nsmutablecopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Captions

- [AVMutableCaption](avfoundation/avmutablecaption.md)