Skema Trait TransportControl Smart Home

action.devices.traits.TransportControl - Trait ini digunakan untuk perangkat yang dapat mengontrol pemutaran media (misalnya, melanjutkan musik saat dijeda).

ATTRIBUTE Perangkat

Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat Fulfillment intent.

Atribut Type Deskripsi
transportControlSupportedCommands Array

Wajib.

Daftar string yang menjelaskan perintah kontrol transportasi yang didukung pada perangkat ini.

[item, ...] String

Perintah yang didukung.

Nilai yang didukung:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Contoh

Perangkat yang mendukung perintah pemutaran

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

STATUS Perangkat

Tidak ada.

Perangkat COMMAND

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat Fulfillment intent.

action.devices.commands.mediaStop

Jeda pemutaran media.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaNext

Langsung ke item media berikutnya.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaPrevious

Langsung ke item media sebelumnya.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaPause

Jeda pemutaran media.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaResume

Melanjutkan pemutaran media.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaSeekRelative

Cari ke posisi relatif.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parameter

Parameter Type Deskripsi
relativePositionMs Bilangan Bulat

Wajib.

Milidetik jumlah maju (int positif) atau mundur (int negatif) yang harus dicari.

Contoh

Cari 10 detik ke depan

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

Mundur 10 detik

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

action.devices.commands.mediaSeekToPosition

Cari ke posisi absolut.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parameter

Parameter Type Deskripsi
absPositionMs Bilangan Bulat

Wajib.

Milidetik dari posisi absolut yang harus dicari.

Contoh

Lompat ke 30 dtk

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

action.devices.commands.mediaRepeatMode

Menyetel mode pemutaran berulang.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parameter

Parameter Type Deskripsi
isOn Boolean

Wajib.

True untuk mengaktifkan mode ulangi, salah untuk menonaktifkan mode berulang.

isSingle Boolean

(Default: false)

Jika ditentukan, true (benar) berarti mengaktifkan mode pengulangan item tunggal, false (salah) berarti mengaktifkan mode pengulangan normal (misalnya playlist).

Contoh

Ulangi pada

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

Ulangi nonaktif

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

Mengulangi satu lagu

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

action.devices.commands.mediaShuffle

Acak playlist saat ini.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaClosedCaptioningOn

Aktifkan teks.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameter

Parameter Type Deskripsi
closedCaptioningLanguage String

Bahasa atau lokal untuk pemberian teks tertutup.

userQueryLanguage String

Bahasa atau lokalitas untuk kueri pengguna.

Contoh

Mengaktifkan pemberian teks tertutup dalam bahasa Inggris

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

Mengaktifkan teks tertutup dalam bahasa Korea

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

Mengaktifkan teks tertutup dalam bahasa Korea dengan kueri pengguna dalam bahasa Inggris Amerika

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

action.devices.commands.mediaClosedCaptioningOff

Nonaktifkan teks.

Perintah ini memerlukan atribut berikut:
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Menonaktifkan pemberian teks tertutup

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.