Connect an Entertainment Device to Alexa

The following shows an example of how to use the capability interfaces to connect an entertainment device to Alexa.

Capabilities

The entertainment device declares the following capabilities.

Capability Purpose Example utterance

PowerController

Allows a customer to turn the device on or off.

"Turn on the Entertainment System"

Speaker

Allows a customer to set, adjust, or mute/unmute the volume of the device.

"Set the volume of the Entertainment System to 25"

PlaybackController

Allows a customer to play, stop, and pause the device.

"Pause Entertainment System"

InputController

Allows a customer to change the input of a device.

"Change the input to HDMI on the Entertainment System"

ChannelController

Allows a customer to change the channel of a device.

"Change channel to 12 on Entertainment System"

Alexa

Contains directives and events related to state and error reporting. Make sure to explicitly include this interface and the supported version in the discovery response.

Not applicable.

Discovery

The entertainment device provides the following AddOrUpdateReport.

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "AddOrUpdateReport",
      "payloadVersion": "3",
      "messageId": "00000000-0000-0000-0000-000000000000"
    },
    "payload": {
      "endpoints": [
        {
          "endpointId": "appliance-001",
          "friendlyName": "Entertainment System",
          "description": "BrandName by Sample Manufacturer",
          "manufacturerName": "Sample Manufacturer",
          "displayCategories": [
            "TV"
          ],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.Speaker",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "volume"
                  },
                  {
                    "name": "muted"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PlaybackController",
              "version": "3",
              "properties": {},
              "supportedOperations": [
                "Play",
                "Pause",
                "Stop"
              ],
              "proactivelyReported": true,
              "retrievable": true
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.InputController",
              "version": "3",
              "inputs": [
                {
                  "name": "HDMI1"
                },
                {
                  "name": "HDMI2"
                }
              ],
              "proactivelyReported": true,
              "retrievable": true
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.ChannelController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "channel"
                  }
                ]
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa.EndpointHealth",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "connectivity"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}

For information about building a smart home skill for entertainment devices, see Build Smart Home Skills for Entertainment Devices.

For more details on state reporting, see Understand State Reporting for a Smart Home Skill.

If the device has additional capabilities, you can add other capability interfaces.