Smart Home TransportControl Trait Schema

action.devices.traits.TransportControl - This trait is used for devices which are able to control media playback (for example, resuming music while it is paused).

Device ATTRIBUTES

Devices with this trait may report the following attributes as part of the SYNC operation. To learn more about handling SYNC intents, see Intent fulfillment.

Attributes	Type	Description
transportControlSupportedCommands	Array	Required. A list of strings describing supported transport control commands on this device.
[item, ...]	String	Supported commands. Supported values: CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

Examples

Device supporting playback commands

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

Device STATES

None.

Device COMMANDS

Devices with this trait may respond to the following commands as part of the EXECUTE operation. To learn more about handling EXECUTE intents, see Intent fulfillment.

action.devices.commands.mediaStop

Pause media playback.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

No parameters

{
  "command": "action.devices.commands.mediaStop",
  "params": {}
}

action.devices.commands.mediaNext

Skip to next media item.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

No parameters

{
  "command": "action.devices.commands.mediaNext",
  "params": {}
}

action.devices.commands.mediaPrevious

Skip to previous media item.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

No parameters

{
  "command": "action.devices.commands.mediaPrevious",
  "params": {}
}

action.devices.commands.mediaPause

Pause media playback.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

No parameters

{
  "command": "action.devices.commands.mediaPause",
  "params": {}
}

action.devices.commands.mediaResume

Resume media playback.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

No parameters

{
  "command": "action.devices.commands.mediaResume",
  "params": {}
}

action.devices.commands.mediaSeekRelative

Seek to a relative position.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parameters

Parameters	Type	Description
relativePositionMs	Integer	Required. Milliseconds of the forward (positive int) or backward (negative int) amount to seek.

Examples

Seek 10s forward

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

Seek 10s backward

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

Seek to an absolute position.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parameters

Parameters	Type	Description
absPositionMs	Integer	Required. Millisecond of the absolute position to seek to.

Examples

Seek to 30s

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

Set repeat playback mode.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parameters

Parameters	Type	Description
isOn	Boolean	Required. True to turn on repeat mode, false to turn off repeat mode.
isSingle	Boolean	(Default: false) If specified, true means turning on single-item repeat mode, false means turning on normal repeat mode (for example a playlist).

Examples

Repeat on

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

Repeat off

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": false
  }
}

Repeat a single track

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true,
    "isSingle": true
  }
}

action.devices.commands.mediaShuffle

Shuffle the current playlist.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

No parameters

{
  "command": "action.devices.commands.mediaShuffle",
  "params": {}
}

action.devices.commands.mediaClosedCaptioningOn

Turn captions on.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameters

Parameters	Type	Description
closedCaptioningLanguage	String	Language or locale for closed captioning.
userQueryLanguage	String	Language or locale for user query.

Examples

Turn on closed captioning in English

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Turn on closed captioning in Korean

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

Turn on closed captioning in Korean with user query in American English

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

Turn captions off.

This command requires the following attributes:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameters

Parameters	Type	Description
No properties

Examples

Turn off closed captioning

{
  "command": "action.devices.commands.mediaClosedCaptioningOff",
  "params": {}
}

Device ERRORS

See the full list of errors and exceptions.