Esquema de atributo TransportControl da casa inteligente

action.devices.traits.TransportControl: essa característica é usada para dispositivos que podem controlar a reprodução de mídia (por exemplo, retomar a música enquanto ela está pausada).

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
transportControlSupportedCommands Array

Obrigatório.

Uma lista de strings que descrevem os comandos de controle de transporte compatíveis com o dispositivo.

[item, ...] String

Comandos compatíveis.

Valores aceitos:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Exemplos

Dispositivos com suporte a comandos de reprodução

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

ESTADOS DO DISPOSITIVO

Nenhum.

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.mediaStop

Pausar a reprodução de mídia.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaNext

Pular para o próximo item de mídia.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaPrevious

Voltar para o item de mídia anterior.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaPause

Pausar a reprodução de mídia.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaResume

Retomar a reprodução de mídia.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaSeekRelative

Procurar uma posição relativa.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
relativePositionMs Número inteiro

Obrigatório.

Milissegundos do valor de avanço (int positivo) ou de recuo (int negativo) a ser buscado.

Exemplos

Avançar 10 segundos

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

Voltar 10 segundos

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

action.devices.commands.mediaSeekToPosition

Procurar uma posição absoluta.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
absPositionMs Número inteiro

Obrigatório.

Milissegundos da posição absoluta a ser buscada.

Exemplos

Procurar 30 segundos

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

action.devices.commands.mediaRepeatMode

Definir o modo de repetição.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
isOn Booleano

Obrigatório.

"True" para ativar o modo de repetição ou "false" para desativar.

isSingle Booleano

Padrão: false.

Se especificado, "true" significa ativar o modo de repetição de um item, e "false" significa ativar o modo de repetição normal (por exemplo, uma playlist).

Exemplos

Repetir em

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

Repetir

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

Repetir uma única faixa

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

action.devices.commands.mediaShuffle

Tocar a playlist atual em ordem aleatória.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaClosedCaptioningOn

Ative as legendas.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
closedCaptioningLanguage String

Idioma ou localidade para legendas descritivas.

userQueryLanguage String

Idioma ou localidade da consulta do usuário.

Exemplos

Ativar legendas em inglês

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

Ativar legendas em coreano

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

Ativar legendas em coreano com consulta do usuário em inglês americano

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

action.devices.commands.mediaClosedCaptioningOff

Desativar as legendas.

Este comando requer os seguintes atributos:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Desativar closed captions

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

ERROS do dispositivo

Confira a lista completa de erros e exceções.