# Getting started

## Usage

1. Follow [our Getting Started guide](https://docs-preview.optiview.dolby.com/pr-984/theoplayer/getting-started/sdks/ios/getting-started.md) to set up THEOplayer in your iOS app.
2. Add an OptiView Live source to your player's source.

### Add an OptiView Live source

After setting up your THEOplayer in your app, set its source to a `SourceDescription` containing a `TheoLiveSource`. Pass the identifier of your OptiView Live distribution as `src`:

```swift
theoplayer.source = SourceDescription(source: TheoLiveSource(src: "3aa5qylwwk7gijsobayq09yee"))
```

The `src` parameter accepts any of these formats:

* A V1 channel ID, e.g. `2jENbm22UH5PobDm0Dqjtmkrx2E`
* A V2/V3 distribution ID, e.g. `1f17631a-861d-42c2-9105-d97de0ab9c07`
* A V3 organization ID and distribution name separated by `/`, e.g. `1f17631a-861d-42c2-9105-d97de0ab9c06/my-distribution`

> **Note**
>
> `TheoLiveSource(src:)` was introduced in THEOplayer 11.17.0, replacing the deprecated `TheoLiveSource(channelId:)`. On older versions, use `TheoLiveSource(channelId:)` instead.

## More information

* [API references](https://docs-preview.optiview.dolby.com/pr-984/theoplayer/v11/api-reference/ios)
