KeplerPlayerClientTurboModule - Amazon Vega Docs

Amazon Developer

Console

as

Settings

Sign out

Notifications

Alexa

Amazon Appstore

Ring

AWS

Documentation

Support

Contact Us

My Cases

Console

as

Vega Developer Docs

Get Started

Design and Develop

Publish

Reference

Support

The Vega Player Client API provides client-side headless JavaScript media playback functionality for media app developers on Vega. This runs media playback on a separate JavaScript thread from the UI, providing up to 30% improvement in Time to First Video Frame (TTFVF) for apps with complex UIs.

Get started

Setup

Add the following library dependency to the dependencies section of your package.json file.

    "@amazon-devices/headless-task-manager": "~1.2.4",
    "@amazon-devices/kepler-player-server": "~2.2.3",
    "@amazon-devices/kepler-player-client": "~2.2.3",

Add following components and privileges in your manifest.toml.

    [[components.interactive]]
    id = "<your-app-package-name>.main"
    runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
    launch-type = "singleton"
    categories = ["com.amazon.category.main"]

    [[components.service]]
    id = "<your-app-package-name>.service"
    runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
    launch-type = "singleton"
    .
    .
    .

    [processes]
    # Ensure that the player UI and headless JS player components are in the same process group
    [[processes.group]]
    component-ids = ["<your-app-package-name>.main", "<your-app-package-name>.service"]

    .
    .
    .

    [wants]

    [[wants.service]]
    id = "<your-app-package-name>.service"

    .
    .
    .

    [offers]

    [[offers.service]]
    id = "<your-app-package-name>.service"

Classes

PlayerClientMediaControlHandler

Interfaces

Last modified on February 19, 2026