Guides

Getting Started

Integrate StreamLayer into VIZIO SmartCast TV apps using the @streamlayer/web-os React SDK with installation, quick start, and platform-specific notes.

VIZIO SmartCast Integration

StreamLayer supports VIZIO SmartCast TV applications through the @streamlayer/web-os React SDK. VIZIO SmartCast apps are HTML5 apps that run in an embedded Chromium engine, so they use the same SDK and APIs as the other TV platforms. The SDK provides interactive StreamLayer Elements, pause ads, and real-time engagement features on VIZIO Smart TVs.

Start with your AI coding assistant

Connect your assistant to StreamLayer docs before changing code, then use this prompt. The connection lets it search the current guides and read the platform integration skill as it works.

Help me integrate StreamLayer into my existing VIZIO SmartCast TV app using @streamlayer/web-os.
Use the streamlayer-docs MCP to search for and fetch the matching integration
guide and the streamlayer-web-integration skill page before editing code.
If search does not return the skill, read https://docs.streamlayer.io/docs/web-sdk-integration-skill
or ask me to copy that page into this session.
Cite the sources, confirm my SDK version and prerequisites, and make the smallest
documented change while preserving my player and app structure. Keep the build
compatible with the VIZIO SmartCast Chromium range (Chrome 72 to 108).
Report missing or conflicting guidance instead of guessing. Use placeholder keys in examples.
Finish with the checks run and the remaining platform/device validation steps.

Review the diff and follow the platform setup and testing guidance linked below.

Getting Started

The VIZIO SmartCast integration uses the same SDK and APIs as the other TV platforms. Please refer to our unified TV SDK documentation:

DocumentationDescription
Integration GuideStep-by-step installation and setup
Exposed Pause AdVAST-compliant pause ad implementation

System Requirements

  • VIZIO SmartCast TV with a Chromium engine between Chrome 72 and Chrome 108 (the version depends on the TV firmware)
  • VIZIO partner access, and a TV that VIZIO has whitelisted for developer mode, or a SmartCast device in a cloud device farm such as TV Labs
  • React-based application
  • Node.js 18+ with a JavaScript or TypeScript build that targets Chrome 72

Quick Installation

npm install @streamlayer/web-os
import { StreamLayerProvider, StreamLayerSDKTv } from '@streamlayer/web-os'
import '@streamlayer/web-os/style.css'

export const Main = () => (
  <StreamLayerProvider sdkKey="your-sdk-key" event="your-event-id">
    <StreamLayerSDKTv>
      <video />
    </StreamLayerSDKTv>
  </StreamLayerProvider>
)

Replace your-sdk-key with the SDK API Key from StreamLayer Studio, and your-event-id with your event ID. After the app loads on the TV, the StreamLayer Element renders over the video, and units for the event appear as they are triggered.

VIZIO-Specific Notes

  • Engine: VIZIO SmartCast renders apps in Chromium. The version depends on the firmware, not the TV model: much of the installed fleet runs Chrome 72 or Chrome 87, and the newest firmware runs Chrome 108. Build your Host App for a Chrome 72 floor:
    • Bundle the SDK's CJS build (ES2015). The ESM build targets esnext and does not parse on older engines. See Module Formats.
    • Transpile your own code to the same floor, for example with a browserslist target of chrome >= 72 for @babel/preset-env.
    • Import @streamlayer/web-os/polyfills once, before any SDK imports, unless your app already polyfills those APIs.
  • Remote Control: The SDK handles arrow and OK keys through spatial navigation, so viewers can move between units in the StreamLayer Element and activate them. The Host App is responsible for platform behavior outside the SDK: integrate VIZIO's companion library for remote-key handling and app exit, and use it to return the viewer to the VIZIO home screen when Back is pressed with no StreamLayer Element open.
  • Testing: VIZIO does not provide an emulator or simulator. Test on a SmartCast device in a cloud device farm such as TV Labs, or on a TV that VIZIO has whitelisted for developer mode. Both expose Chrome DevTools remote debugging on port 9555 and app sideloading through the Conjure Launcher on port 7345. Test on both an older (Chrome 72) and a newer (Chrome 108) firmware when possible.
  • Distribution: Apps reach VIZIO TVs only through the VIZIO partner program. VIZIO does not offer an open app store or consumer sideloading. Contact VIZIO's partner team to get developer access, device whitelisting, and app submission.

Support

For VIZIO SmartCast-specific issues or questions:

Related

Updated 9 days ago