Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Jalur 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 Penjelasan 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.

PERMINTAAN Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat Penjelasan 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

Mencari ke posisi relatif.

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

Parameter

Parameter Jenis Deskripsi
relativePositionMs Integer

Wajib.

Milidetik dari maju (int positif) atau int mundur (int negatif) yang akan dicari.

Contoh

Mencari maju 10 detik

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

Mencari mundur 10 detik

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

action.devices.commands.mediaSeekToPosition

Mencari ke posisi absolut.

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

Parameter

Parameter Jenis Deskripsi
absPositionMs Integer

Wajib.

Milidetik dari posisi absolut yang akan dicari.

Contoh

Lompat ke 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.

True untuk mengaktifkan mode berulang, false untuk menonaktifkan mode berulang.

isSingle Boolean

(Default: false)

Jika ditentukan, true berarti mengaktifkan mode pengulangan satu item, false berarti mengaktifkan mode pengulangan 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 lokal untuk teks tertutup.

userQueryLanguage String

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

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.