Alexa Smart Screen SDK

Announcement

The new Alexa Voice Service (AVS) Device SDK version 3.0 and the Alexa Smart Screen Web Components version 1.0 are now available!

If you’re new: The AVS Device SDK version 3.0 and the Alexa Smart Screen Web Components have replaced the Alexa Smart Screen SDK.

For current users of the Alexa Smart Screen SDK: Please consider upgrading to the AVS Device SDK version 3.0 and Alexa Smart Screen Web components.

The AVS Device SDK version 3.0 combines the Alexa Smart Screen SDK and the AVS Device SDK into one. It also adds several new features including Video Device Control for integrating Video Skill Kit capabilities into your device. To begin, see Get Started with Alexa Voice Service Device SDK.

The Alexa Smart Screen Web Components library is a separate Node.js library for smart screen device makers who build web apps that interact with the AVS Device SDK. For an overview, see About Alexa Smart Screen Web Components.

The Alexa Smart Screen SDK extends the AVS Device SDK to support development for screen-based Alexa Built-in products. This SDK enables device makers to build screen-based products that complement Alexa voice responses with rich visual experiences.

The Alexa Smart Screen SDK package in this GitHub repo includes:

The Alexa Smart Screen SDK
A sample app that demonstrates end-to-end Alexa Smart Screen SDK functionality
A GUI web app that handles presentation of Alexa visual responses

The Alexa Smart Screen SDK depends on the following additional GitHub repos:

Note on APL Client Library

When building the Alexa Smart Screen SDK, the npm registry may alert you to a security vulnerability with the package apl-client.

The apl-client package for which this alert is raised is unrelated to the APL Client Library package that is part of the Alexa Smart Screen SDK.

Get Started

You can set up the Alexa Smart Screen SDK by using the following Quick Start Guides:

You can also create your device prototype by using an Amazon-qualified development kit that supports the Smart Screen SDK, such as:

SDK Architecture

This diagram illustrates the data flows between components that comprise the Alexa Smart Screen SDK.

AVS Device SDK: The SDK for Alexa Voice Service, which implements Alexa intelligent voice control functionality.

Capability Agents (CAs): Handle Alexa-driven interactions; specifically directives and events. Each capability agent corresponds to a specific interface exposed by the Alexa Smart Screen API. These interfaces include:

AlexaPresentation - The interface for rendering Alexa Presentation Language (APL) documents.
TemplateRuntime - The interface for PlayerInfo and Template cards (such as music cards and other static cards).
VisualCharacteristics - The interface for reporting the physical properties of visual display devices (such as screen resolution, window size, and supported interaction modes).

Smart Screen Sample Application: This is the Alexa Smart Screen SDK's sample app. It has two components: a sample app and a Javascript-based GUI client app.

GUIManager: Interface between the capability agents and the GUI
GUIClient: Manages messages between the GUI and the rest of the sample app
WebSocketServer: Reference implementation of a WebSocket-based messaging interface

APL Client: An Inter-process Communication (IPC) based APL Runtime which implements the APL Core Engine and the IPC APL Web ViewHost to render APL payloads.

HTML Rendering Engine: A Javascript-based GUI client app and APL view host that render the visual experience on the device.

WebSocket: Reference implementation of a WebSocket client
APL Web ViewHost: Renders the APL document generated by the APL Core Library
Alexa GUI: Reference GUI implementation

Security Requirements

All Alexa products must meet the AVS Security Requirements. In addition, when building the AVS Device SDK, you are required to adhere to the following security principles.

Important Considerations

Review the Alexa Smart Screen License.
Review the Alexa Smart Screen Notice about Third-Party Components.

Optional Configurations

Add voice chrome

The default implementation provides information on Alexa state, which you can use to create voice chrome. Be sure to follow the AVS Voice Chrome guidelines.

Run the GUI client with predefined device visual characteristics and GUI client configurations

We provide four different sample configuration files containing predefined device visual characteristics and GUI client configurations. These can be found under modules/GUI/config/guiConfigSamples. You can pass any of them as an extra config file argument after the main Smart Screen SDK config file argument when running the Sample App, for example:

    cd <pathTo>/ss-build
    ./modules/Alexa/SampleApp/src/SampleApp
        -C <pathTo>/sdk-build/Integration/AlexaClientSDKConfig.json
        -C <pathTo>/alexa-smart-screen-sdk/modules/GUI/config/SmartScreenSDKConfig.json
        -C <pathTo>/alexa-smart-screen-sdk/modules/GUI/config/guiConfigSamples/GuiConfigSample_TvOverlayPortrait.json 
        -L INFO

Remote control support

Functionality for Exit and Back buttons (as found on a device's physical remote control) is minimally supported by the Smart Screen SDK. The following behaviors are expected to occur on execution of either a BACK or EXIT navigationEvent:

Clear the rendering screen - Exit fully out of the Alexa-presented display so that no static image or layout is left.
Release the focus management - Release any focus management that might be held.

Using the default gui client configuration's device keys, Esc and B are mapped to EXIT and BACK respectively.

MuniSakkuru/alexa-smart-screen-sdk