Skema Trait TransportControl Smart Home

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

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini mungkin melaporkan hal berikut sebagai bagian dari operasi SYNC. Untuk mempelajari selengkapnya tentang menangani intent SYNC, lihat Pemenuhan intent.

Atribut	Jenis	Deskripsi
transportControlSupportedCommands	Array	Wajib. Daftar string yang menjelaskan perintah kontrol transport 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"
  ]
}

NEGARA Perangkat

Tidak ada.

Perangkat COMMANDS

Perangkat dengan karakteristik ini dapat merespons hal berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari selengkapnya tentang menangani intent EXECUTE, lihat Pemenuhan 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

Langsung 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

Langsung 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

Lanjutkan 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 posisi relatif.

Perintah ini memerlukan atribut berikut:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parameter

Parameter	Jenis	Deskripsi
relativePositionMs	Bilangan Bulat	Wajib. Milidetik jumlah maju (int positif) atau mundur (int negatif) yang akan dicari.

Contoh

Lompat 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	Jenis	Deskripsi
absPositionMs	Bilangan Bulat	Wajib. Milidetik dari posisi absolut yang akan dituju.

Contoh

Cari 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	Jenis	Deskripsi
isOn	Boolean	Wajib. True untuk mengaktifkan mode ulangi, false untuk menonaktifkan mode ulangi.
isSingle	Boolean	(Default: false) Jika ditentukan, true berarti mengaktifkan mode pengulangan item tunggal, false 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 trek

{
  "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	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 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 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 pemberian teks tertutup

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.