Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 15 additions & 2 deletions theoplayer/how-to-guides/ios/theolive/00-getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,25 @@ sidebar_label: Getting started
### Add an OptiView Live source

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

```swift
theoplayer.source = SourceDescription(source: TheoLiveSource(channelId: "3aa5qylwwk7gijsobayq09yee"))
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:)`.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is no version 11.17.0 yet? The latest one is 11.16.0...

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, 11.17.0 isn't out yet. The src: initializer ships in 11.17.0 (it's not in 11.16.0), so the PR is open for review now but shouldn't be merged until 11.17.0 is released (see the PR description). Once it's out, I'll check that the note still matches the release notes before merging.

@MattiasBuelens MattiasBuelens Nov 19, 2026 •

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, I see it now. I'll move this PR into draft, so we don't accidentally merge it too early.

On older versions, use `TheoLiveSource(channelId:)` instead.

:::

## More information

- [API references](pathname:///theoplayer/v11/api-reference/ios/)