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