Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
31468a0
rebranding callout
dcoffey3296 Apr 10, 2026
4cdbcc8
branding callout added to pages
dcoffey3296 Apr 10, 2026
6e9813d
naming updates
dcoffey3296 Apr 10, 2026
8c8c5cd
wording changes to getting started
dcoffey3296 Apr 10, 2026
3d37ca3
millicast to optiview real time callout
dcoffey3296 Apr 10, 2026
2c6dc49
ads branding updates from theo to optiview
dcoffey3296 Apr 10, 2026
ecad89e
language to unify millicast and dolby.io to OptiView Real-time
dcoffey3296 Apr 10, 2026
61bd773
updated openvideoui to optiview
dcoffey3296 Apr 10, 2026
4e03f32
theoplayer to optiview player (not package names)
dcoffey3296 Apr 10, 2026
d20b37c
removed top announcement bar... about time
dcoffey3296 Apr 10, 2026
7f24ff7
front page changes to product names
dcoffey3296 Apr 10, 2026
590cf88
rebranding callouts for ads
dcoffey3296 Apr 10, 2026
eec6992
format linting
dcoffey3296 Apr 10, 2026
7719136
Update millicast/broadcast/ndi.md
dcoffey3296 Apr 10, 2026
df7c4ec
Update millicast/capture/screensharing.mdx
dcoffey3296 Apr 10, 2026
736782b
restore announce bar for PR previews
dcoffey3296 Apr 13, 2026
849b28c
fix for PR top banner and remove from main site
dcoffey3296 Apr 13, 2026
afefe4c
fixed react native naming
dcoffey3296 Apr 13, 2026
98555b6
branding fix
dcoffey3296 Apr 13, 2026
d6f5c4a
Fix brand capitalization, grammar, spelling, dashboard naming, and an…
devin-ai-integration[bot] Apr 13, 2026
0fa5dd4
formatting
dcoffey3296 Apr 13, 2026
6a141a4
removed extra streaming word
dcoffey3296 Apr 14, 2026
849e072
removed extra mention of millicast
dcoffey3296 Apr 14, 2026
ff92545
added extra real-time for context
dcoffey3296 Apr 14, 2026
dbe8d3c
fixed broadcast section
dcoffey3296 Apr 14, 2026
e1d78f1
fixed duplicate mention of real-time
dcoffey3296 Apr 14, 2026
5c40db5
gramatical fix
dcoffey3296 Apr 14, 2026
4b1e592
dashboard.dolby.io -> streaming.dolby.io
dcoffey3296 Apr 14, 2026
2143b0a
descriptions updated
dcoffey3296 Apr 14, 2026
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
5 changes: 5 additions & 0 deletions ads/callouts/_rebranding_notice.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
:::info OptiView Rebranding

OptiView Ads is the new name for THEOads as part of the OptiView product suite. During the transition, you may still see references to THEOads. OptiView Ads and THEOads refer to the same product.

:::
8 changes: 4 additions & 4 deletions ads/getting-started/android.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,16 @@ sidebar_custom_props: { 'icon': 'android' }

# Getting started with OptiView Ads on Android

This guide will get you started to integrate OptiView Ads in your THEOplayer Android SDK: configure the license, update dependencies and set the source description.
This guide will get you started to integrate OptiView Ads in your OptiView Player Android SDK: configure the license, update dependencies and set the source description.

## Prerequisites

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

1. You need to have a THEOplayer license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
1. You need to have an OptiView Player license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
2. You need a correctly deployed [OptiView Ads signaling service](signaling-service.mdx).
3. Add the THEOplayer Android SDK to your project by following our [Getting started](/theoplayer/getting-started/sdks/android/getting-started) guide. Make sure to [set up a OptiView Ads-compatible license](/theoplayer/getting-started/sdks/android/getting-started/#setting-up-the-license) in your app.
3. Add the OptiView Player Android SDK to your project by following our [Getting started](/theoplayer/getting-started/sdks/android/getting-started) guide. Make sure to [set up an OptiView Ads-compatible license](/theoplayer/getting-started/sdks/android/getting-started/#setting-up-the-license) in your app.
4. Add the OptiView Ads integration as a dependency in your module-level `build.gradle` file:
<Tabs queryString="lang">
<!-- prettier-ignore-start -->
Expand Down Expand Up @@ -92,7 +92,7 @@ theoPlayerView.player.source = SourceDescription.Builder(

## Integrating with Open Video UI

When using the [Open Video UI for Android](/open-video-ui/android/), you need to create and add the `TheoAdsIntegration` before creating your `DefaultUI` or `UIController`. You can then create a OptiView Ads-enabled source and set it as `player.source`:
When using the [Open Video UI for Android](/open-video-ui/android/), you need to create and add the `TheoAdsIntegration` before creating your `DefaultUI` or `UIController`. You can then create an OptiView Ads-enabled source and set it as `player.source`:

```kotlin
import androidx.activity.compose.setContent
Expand Down
8 changes: 4 additions & 4 deletions ads/getting-started/chromecast.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,16 @@ sidebar_custom_props: { 'icon': 'web' }

# Getting started with OptiView Ads on Chromecast CAF

This guide will get you started with OptiView Ads using the THEOplayer Chromecast CAF SDK.
This guide will get you started with OptiView Ads using the OptiView Player Chromecast CAF SDK.
! NOTE: Currently the Chromecast CAF SDK only supports image overlays from OptiView Ads.

## Prerequisites

1. You need to have a THEOplayer license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
1. You need to have an OptiView Player license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
2. You need a correctly deployed [OptiView Ads signaling service](signaling-service.mdx).
3. Your THEOplayer SDK needs to have the `theoads` feature enabled.

As of THEOplayer version 8.2.0, this feature is enabled by default in the main `theoplayer` package so we recommend to use at least this version, preferable the latest available version.
As of OptiView Player version 8.2.0, this feature is enabled by default in the main `theoplayer` package so we recommend to use at least this version, preferably the latest available version.
You can install this package with the following command:

```bash
Expand All @@ -29,7 +29,7 @@ This guide will get you started with OptiView Ads using the THEOplayer Chromecas
### Configuring the Chromecast receiver

OptiView Ads is supported using the default Chromecast Shaka player for HLS on Chromecast CAF. To enable this, before starting the Chromecast application, configure it to use Shaka.
Also, you need to load the THEOplayer Chromecast CAF SDK.
Also, you need to load the OptiView Player Chromecast CAF SDK.

Here is an example of a bare-bones CAF receiver app you can use as a starting point for basic playback without any custom UI:

Expand Down
6 changes: 5 additions & 1 deletion ads/getting-started/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,11 @@ sidebar_label: Getting Started

# Getting started with OptiView Ads

These guides provide the steps required to get started with OptiView Ads (SGAI). They cover the deployment and API integration of the Signaling Service into your existing workflow, as well as the integration of OptiView Ads into your application using various OptiView Player SDKs.
import RebrandingNotice from '../callouts/_rebranding_notice.md';

<RebrandingNotice />

These guides provide the steps required to get started with OptiView Ads. They cover the deployment and API integration of the Signaling Service into your existing workflow, as well as the integration of OptiView Ads into your application using various OptiView Player SDKs.

import DocCardList from '@theme/DocCardList';

Expand Down
6 changes: 3 additions & 3 deletions ads/getting-started/ios.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,16 @@ sidebar_custom_props: { 'icon': 'apple' }

# Getting started with OptiView Ads on iOS

This guide will get you started to integrate OptiView Ads in your THEOplayer iOS SDK: configure the license, update dependencies and set the source description.
This guide will get you started to integrate OptiView Ads in your OptiView Player iOS SDK: configure the license, update dependencies and set the source description.

## Prerequisites

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

1. You need to have a THEOplayer license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
1. You need to have an OptiView Player license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
2. You need a correctly deployed [OptiView Ads signaling service](signaling-service.mdx).
3. Add the THEOplayer iOS SDK to your project by following our [Getting started](/theoplayer/getting-started/sdks/ios/getting-started) guide. Make sure to [set up a OptiView Ads-compatible license](/theoplayer/getting-started/sdks/ios/getting-started/#theoplayer-license) in your app.
3. Add the OptiView Player iOS SDK to your project by following our [Getting started](/theoplayer/getting-started/sdks/ios/getting-started) guide. Make sure to [set up an OptiView Ads-compatible license](/theoplayer/getting-started/sdks/ios/getting-started/#theoplayer-license) in your app.
4. Add the OptiView Ads integration as a dependency to your project:
<Tabs queryString="lang">
<!-- prettier-ignore-start -->
Expand Down
10 changes: 5 additions & 5 deletions ads/getting-started/react-native.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@ sidebar_custom_props: { 'icon': 'react' }

# Getting started with OptiView Ads on React Native

This guide will get you started with OptiView Ads in your THEOplayer React Native SDK: configure the license, update dependencies and set the source description.
This guide will get you started with OptiView Ads in your OptiView Player React Native SDK: configure the license, update dependencies and set the source description.

## Prerequisites

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

1. You need to have a THEOplayer license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
1. You need to have an OptiView Player license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
2. You need a correctly deployed [OptiView Ads signaling service](signaling-service.mdx).
3. Enable the OptiView Ads integration based on the target platform:
<Tabs queryString="platform">
Expand All @@ -29,7 +29,7 @@ import TabItem from '@theme/TabItem';
To enable OptiView Ads you can add the "THEOADS" feature flag to react-native-theoplayer.json (or theoplayer-config.json)
</TabItem>
<TabItem value="web" label="Web">
Add a dependency to a OptiView ads-enabled THEOplayer package:
Add a dependency to an OptiView Ads-enabled THEOplayer package:
```bash
$ npm i theoplayer@npm:@theoplayer/theoads
```
Expand All @@ -46,8 +46,8 @@ import TabItem from '@theme/TabItem';

## Integration

This guide assumes you know how to set up React Native with THEOplayer.
For more information regarding this check out the [THEOplayer getting started](/theoplayer/getting-started/frameworks/react-native/getting-started/).
This guide assumes you know how to set up React Native with OptiView Player.
For more information regarding this check out the [OptiView Player getting started](/theoplayer/getting-started/frameworks/react-native/getting-started/).

### Player configuration

Expand Down
10 changes: 5 additions & 5 deletions ads/getting-started/web.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,15 @@ sidebar_custom_props: { 'icon': 'web' }

# Getting started with OptiView Ads on Web

This guide will get you started with OptiView Ads in your THEOplayer Web SDK: configure the license, update dependencies and set the source description.
This guide will get you started with OptiView Ads in your OptiView Player Web SDK: configure the license, update dependencies and set the source description.

## Prerequisites

1. You need to have a THEOplayer license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
1. You need to have an OptiView Player license which is compatible with OptiView Ads. This can be done through the [player portal](https://portal.theoplayer.com).
2. You need a correctly deployed [OptiView Ads signaling service](signaling-service.mdx).
3. Your THEOplayer SDK needs to have the `theoads` feature enabled.

As of THEOplayer version 8.2.0, this feature is enabled by default in the main `theoplayer` package so we recommend to use at least this version, preferable the latest available version.
As of OptiView Player version 8.2.0, this feature is enabled by default in the main `theoplayer` package so we recommend to use at least this version, preferably the latest available version.
You can install this package with the following command:

```bash
Expand All @@ -23,7 +23,7 @@ This guide will get you started with OptiView Ads in your THEOplayer Web SDK: co

## Integration

This guide assumes you know how to set up THEOplayer. For more information regarding this, check out the [THEOplayer getting started](/theoplayer/getting-started/sdks/web/getting-started/).
This guide assumes you know how to set up OptiView Player. For more information regarding this, check out the [OptiView Player getting started](/theoplayer/getting-started/sdks/web/getting-started/).

### Google DAI library

Expand Down Expand Up @@ -104,7 +104,7 @@ OptiView Ads works seamlessly together with [Open Video UI for Web](/open-video-

It should look something like this:

![Screenshot of Open Video UI playing a OptiView Ads stream](../assets/img/web-ui.png)
![Screenshot of Open Video UI playing an OptiView Ads stream](../assets/img/web-ui.png)

## More information

Expand Down
4 changes: 2 additions & 2 deletions ads/how-to-guides/ad-impressions.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,11 @@ The ad impression is beaconed simultaneously with the firing of the player's `ad

## Information tracked

The information passed only contains an identifier of the THEOplayer license build so the impressions are linked to the customer. It also includes the ad experience type.
The information passed only contains an identifier of the OptiView Player license build so the impressions are linked to the customer. It also includes the ad experience type.
No information about the viewers is passed along.

## View my impression usage

You can view your ad impressions on the portal dashboard underneath the THEOplayer license impressions.
You can view your ad impressions on the portal dashboard underneath the OptiView Player license impressions.

![Portal dashboard](../assets/img/impressions.png)
7 changes: 5 additions & 2 deletions ads/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,12 @@ sidebar_label: Introduction
# Dolby OptiView Ads Introduction

import SidebarDocCardList from '@site/src/components/SidebarDocCardList';
import RebrandingNotice from './callouts/_rebranding_notice.md';
import ThemedImage from '@theme/ThemedImage';
import useBaseUrl from '@docusaurus/useBaseUrl';

<RebrandingNotice />

OptiView Ads is an ad insertion service for LIVE content (VoD support coming soon), utilizing Server-Guided Ad Insertion (SGAI). On these pages, you'll learn how to get started with OptiView Ads, how to configure the player and integrate the signaling service APIs.

By logically redistributing responsibilities in the advertisement workflow, OptiView Ads:
Expand Down Expand Up @@ -39,14 +42,14 @@ To ensure high availability, we recommend maintaining the original origin stream

OptiView Ads is tightly integrated with [Google Ad Manager](https://developers.google.com/ad-manager/dynamic-ad-insertion 'Google DAI') for ad decisioning, transcoding, and serving, ensuring a streamlined process for ad delivery and management.

OptiView Ads enables innovative ad formats through THEOplayer, providing new ways to monetize content in a less intrusive manner. The out-of-the-box formats include, but are not limited to:
OptiView Ads enables innovative ad formats through OptiView Player, providing new ways to monetize content in a less intrusive manner. The out-of-the-box formats include, but are not limited to:

- **Default Full Screen Ad Insertion**: Replaces the content with an advertisement.
- **Double Box**: Allows content to continue playing side-by-side with an advertisement and its companion background.
- **L-shape**: Displays content or advertisements in a scaled window alongside a companion background.

![OptiView Ads experiences](./assets/img/ads_formats.svg)

**Note**: Every OptiView Player comes with the functionality to enable OptiView Ads by default. However, a OptiView ads-enabled OptiView Player license is required to activate this functionality.
**Note**: Every OptiView Player comes with the functionality to enable OptiView Ads by default. However, an OptiView Ads-enabled OptiView Player license is required to activate this functionality.

<SidebarDocCardList />
25 changes: 10 additions & 15 deletions docusaurus.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -96,8 +96,7 @@ function removeDocIndexItems(items) {

const config: Config = {
title: 'Dolby OptiView Documentation',
tagline:
'Discover the latest developer documentation and samples for OptiView products including: Player, Streaming, Ads, Ad Engine, and Open Video UI',
tagline: 'Discover the latest developer documentation and samples for OptiView products',
favicon: 'img/favicon.ico',

// Set the production url of your site here
Expand Down Expand Up @@ -491,7 +490,7 @@ const config: Config = {
if (docPluginId === 'open-video-ui') {
frontMatter.description = "Find out what's new in Open Video UI.";
} else if (docPluginId === 'theoplayer' && !docPath.includes('connector')) {
frontMatter.description = "Find out what's new in THEOplayer.";
frontMatter.description = "Find out what's new in the OptiView Player.";
} else {
frontMatter.description = "Find out what's new.";
}
Expand All @@ -511,7 +510,7 @@ const config: Config = {
} else if (docPath.includes('connector')) {
frontMatter.description = 'Set up your connector in just a few minutes!';
} else {
frontMatter.description = 'Set up your first THEOplayer in just a few minutes!';
frontMatter.description = 'Set up your first OptiView Player in just a few minutes!';
}
}
frontMatter.sidebar_custom_props ??= { icon: '🚀 ' };
Expand All @@ -525,6 +524,8 @@ const config: Config = {
themeConfig: {
// TODO OpenGraph image for OptiView?
// image: 'img/opengraph.png',

// announcement bar for PR preview only
announcementBar: process.env.DOCUSAURUS_PR_NUMBER
? {
id: 'pr_preview',
Expand All @@ -533,14 +534,8 @@ const config: Config = {
textColor: '#344a5e',
isCloseable: false,
}
: {
id: 'dolby_optiview_new_name',
content:
'Dolby OptiView is the new home for everything Dolby.io and THEOplayer. <a target="_blank" rel="noopener" href="https://dolby.io/blog/introducing-dolby-optiview-redefining-immersive-streaming-experiences/">Learn more.</a>',
backgroundColor: '#4800c4',
textColor: '#fff',
isCloseable: true,
},
: undefined,

navbar: {
title: null,
logo: {
Expand All @@ -557,7 +552,7 @@ const config: Config = {
{
type: 'custom-platformSidebar',
docsPluginId: 'theoplayer',
label: 'THEOplayer',
label: 'OptiView Player',
href: '/theoplayer',
activeBasePath: '/theoplayer',
} satisfies PlatformSidebarNavbarItemProps,
Expand Down Expand Up @@ -600,14 +595,14 @@ const config: Config = {
type: 'docSidebar',
docsPluginId: 'theolive',
sidebarId: 'theolive',
label: 'Live (THEOlive)',
label: 'Live',
activeBasePath: '/theolive',
},
{
type: 'docSidebar',
docsPluginId: 'millicast',
sidebarId: 'millicast',
label: 'Real-time (Millicast)',
label: 'Real-time',
activeBasePath: '/millicast',
},
],
Expand Down
Loading