Skema Fitur TransportControl Smart Home

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

ATRIBUT Perangkat

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

Atribut	Jenis	Deskripsi
transportControlSupportedCommands	Array	Wajib. Daftar string yang menjelaskan perintah kontrol transportasi yang didukung di 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.

COMMAND Perangkat

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	Jenis	Deskripsi
Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaNext

Lewati ke item media berikutnya.

Perintah ini memerlukan atribut berikut:

{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parameter

Parameter	Jenis	Deskripsi
Tidak ada properti

Contoh

Tidak ada parameter

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

action.devices.commands.mediaPrevious

Lewati ke item media sebelumnya.

Perintah ini memerlukan atribut berikut:

{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parameter

Parameter	Jenis	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	Jenis	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	Jenis	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	Jenis	Deskripsi
relativePositionMs	Integer	Wajib. Milidetik jumlah maju (int positif) atau mundur (int negatif) yang akan dicari.

Contoh

Majukan 10 detik

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

Mundur 10 detik

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

action.devices.commands.mediaSeekToPosition

Mencari posisi absolut.

Perintah ini memerlukan atribut berikut:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parameter

Parameter	Jenis	Deskripsi
absPositionMs	Integer	Wajib. Milidetik posisi absolut yang akan dicari.

Contoh

Upayakan hingga 30 detik

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

action.devices.commands.mediaRepeatMode

Setel mode pemutaran berulang.

Perintah ini memerlukan atribut berikut:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parameter

Parameter	Jenis	Deskripsi
isOn	Boolean	Wajib. Benar untuk mengaktifkan mode berulang, salah untuk menonaktifkan mode berulang.
isSingle	Boolean	(Default: false) Jika ditentukan, true berarti mengaktifkan mode pengulangan satu item, false berarti mengaktifkan mode berulang normal (misalnya playlist).

Contoh

Ulangi aktif

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

Mengacak playlist saat ini.

Perintah ini memerlukan atribut berikut:

{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parameter

Parameter	Jenis	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	Jenis	Deskripsi
closedCaptioningLanguage	String	Bahasa atau lokalitas untuk teks tertutup.
userQueryLanguage	String	Bahasa atau lokalitas untuk kueri pengguna.

Contoh

Aktifkan pemberian teks tertutup dalam bahasa Inggris

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

Mengaktifkan pemberian teks tertutup dalam bahasa Korea

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

Mengaktifkan pemberian 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	Jenis	Deskripsi
Tidak ada properti

Contoh

Menonaktifkan teks tertutup

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.