Home > Alexa > Alexa Skills Kit

Alexa.InputController Interface

intro

The InputController Interface describes messages for changing the input of an entertainment device.

Directives

The following table shows the directive support depending on the type of skill you are implementing.

Directive Skill Type
SelectInput Smart Home

SelectInput

Request to change to the input or input device.

Example Request:

{
  "directive": {
    "header": {
      "namespace": "Alexa.InputController",
      "name": "SelectInput",
      "messageId": "c8d53423-b49b-48ee-9181-f50acedf2870",
      "payloadVersion": "3"
    },
    "endpoint": {
      "scope": {
        "type": "BearerToken",
        "token":"some-access-token"
      },
      "endpointId": "device-001",
      "cookie": {     }
    },
    "payload": {
      "input": "HDMI1"
    }
  }
}


Payload Details

Property Description Type Required
input The identifier for the input device the customer requested string Yes

Events

Reportable Properties

When the input state changes, send a state report containing an input property.

Property Name Property Type Description
input Input String identifying the new input device such as “HDMI1”.

Alexa.Response

Send an Alexa.Response when you successfully handle a SelectInput directive.

Example Response

The following example shows an Alexa response.

{
  "context": {
    "properties": [
      {
        "namespace": "Alexa.InputController",
        "name": "input",
        "value": "HDMI 1",
        "timeOfSample": "2017-02-03T16:20:50.52Z",
        "uncertaintyInMilliseconds": 0
      }
    ]
  },
  "event": {
    "header": {
      "messageId": "30d2cd1a-ce4f-4542-aa5e-04bd0a6492d5",
      "namespace": "Alexa",
      "name": "Response",
      "payloadVersion": "3"
    },
    "payload": {
    }
  }
}