Esquema do traço TransportControl de casa inteligente

action.devices.traits.TransportControl: essa característica é usada em dispositivos capazes de controlar a reprodução de mídia (por exemplo, retomar uma 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 gerenciamento 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 suportados no dispositivo.

[item, ...] String

Comandos compatíveis.

Os valores suportados são:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Exemplos

Comandos de reprodução no dispositivo

{
  "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 o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.mediaStop

Pausar a 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 a 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 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

Procure 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 (int positivo) ou de trás (int) negativo a ser buscado.

Exemplos

Avançar 10 segundos

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

Ir 10 segundos para trás

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

action.devices.commands.mediaSeekToPosition

Procure 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 até 30 segundos

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

action.devices.commands.mediaRepeatMode

Defina o modo de repetição de reprodução.

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, Falso para desativar o modo de repetição.

isSingle Booleano

Padrão: false.

Se especificado, "true" significa ativar o modo de repetição de item único, 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
  }
}

Repetição do vídeo

{
  "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 do closed caption.

userQueryLanguage String

Idioma ou localidade da consulta do usuário.

Exemplos

Ativar closed caption em inglês

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

Ativar closed caption em coreano

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

Ativar legendas em coreano com a consulta do 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 legendas

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

ERROS DO Dispositivo

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