InputController (v3.0)

The InputController interface enables selecting and switching inputs on an Alexa-enabled product.

Capabilities API

To use version 3.0 of the InputController interface, it must be declared in your call to the Capabilities API. For additional details, see Capabilities API.


{
    "interface": "Alexa.InputController",  
    "type": "AlexaInterface",  
    "version": "3.0",  
    "configurations": {  
        "inputs": [  
            {  
                "name": "{{STRING}}",  
                "friendlyNames": ["{{STRING}}", ...]  
            },   
            {  
                "name": "{{STRING}}",  
                "friendlyNames": ["{{STRING}}", ...]  
            }  
        ]        
    }  
}  
  

Configuration Parameters

Parameter Description Type
inputs Contains information about the request. list
inputs.name Specifies the product's input name. For example, "HDMI 1". string
inputs.friendlyName[i] Provides a list of the input(s) friendly name(s). Each list item is a string. For example, "TV", "Generic Television". list

SelectInput Directive

Instructs a client to select an input.

Sample Message


{
  “directive”: {
      “header”: {
          “namespace”: “Alexa.InputController”,
          “name”: “SelectInput”,
          "messageId": "{{STRING}}",
          "dialogRequestId": "{{STRING}}"
      },
      “payload”: {
          "input": "{{STRING}}"
      }
  }
}

Payload Parameters

Parameter Description Type
input Identifies the selected input on the product. string