Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esquema de características de transporte inteligente de casa inteligente

action.devices.traits.TransportControl: esta 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 como processar intents SYNC, consulte fulfillment de intent.

Atributos Tipo Descrição
transportControlSupportedCommands Array

Obrigatório.

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

[item, ...] String

Comandos suportados.

Os valores suportados são:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Exemplos

Dispositivo com suporte a comandos de reprodução

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

STATES do dispositivo

Nenhuma.

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como processar intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.mediaStop

Pausar reprodução de mídia.

Esse 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.

Esse 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

Pular para o item de mídia anterior.

Esse 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 reprodução de mídia.

Esse 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.

Esse 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.

Esse 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 (positivo) ou reverso (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.

Esse 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 s

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

action.devices.commands.mediaRepeatMode

Defina o modo de reprodução repetida.

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

Parâmetros

Parâmetros Tipo Descrição
isOn Booleano

Obrigatório.

Verdadeiro para ativar o modo de repetição e "Falso" para desativar o modo de repetição.

isSingle Booleano

Padrão: false.

Se especificado, verdadeiro significa ativar o modo de repetição de item único e falso significa ativar o modo de repetição normal (por exemplo, uma playlist).

Exemplos

Repetir em

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

Repetir desativado

{
  "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.

Esse 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.

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

Parâmetros

Parâmetros Tipo Descrição
closedCaptioningLanguage String

Idioma ou localidade para legenda.

userQueryLanguage String

Idioma ou localidade da consulta do usuário.

Exemplos

Ativar as closed captions em inglês

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

Ativar closed captions em coreano

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

Ativar as closed captions em coreano com consulta de usuário em inglês americano

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

action.devices.commands.mediaClosedCaptioningOff

Desative as legendas.

Esse 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": {}
}

Dispositivo ERRORS

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