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 Atribut AppSelector Smart Home

action.devices.traits.AppSelector - Sifat ini digunakan untuk perangkat yang dapat beralih input.

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
availableApplications Array

Wajib.

Daftar aplikasi. Setiap aplikasi memiliki satu atau beberapa sinonim dalam setiap bahasa yang didukung. Sinonim pertama digunakan dalam respons.

[item, ...] Objek

Aplikasi yang dapat berinteraksi dengan pengguna perangkat ini.

key String

Wajib.

Kunci unik untuk aplikasi yang tidak diekspos kepada pengguna dalam ucapan atau respons.

names Array

Wajib.

Nama setiap aplikasi dan sinonim bahasa tertentunya.

[item, ...] Objek

Sinonim aplikasi.

name_synonym Array

Wajib.

Sinonim yang mudah digunakan bagi nama aplikasi untuk bahasa tertentu. Sinonim pertama digunakan dalam respons.

[item, ...] String

Nama aplikasi.

lang String

Wajib.

Kode bahasa.

Contoh

Perangkat dengan aplikasi YouTube

{
  "availableApplications": [
    {
      "key": "youtube",
      "names": [
        {
          "name_synonym": [
            "youtube",
            "YouTube US"
          ],
          "lang": "en"
        },
        {
          "name_synonym": [
            "youtube",
            "YouTube DE"
          ],
          "lang": "de"
        }
      ]
    }
  ]
}

STATUS Perangkat

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

Negara bagian Jenis Deskripsi
currentApplication String

Wajib.

Nilai kunci aplikasi saat ini yang aktif di latar depan.

Contoh

Perangkat dengan aplikasi YouTube yang saat ini aktif di latar depan.

{
  "currentApplication": "youtube"
}

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.appInstall

Menginstal aplikasi yang ditentukan.

Parameter

Parameter Jenis Deskripsi
newApplication String

Kunci aplikasi yang akan diinstal.

newApplicationName String

Nama aplikasi yang akan diinstal.

Contoh

Menginstal aplikasi YouTube berdasarkan kunci

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplication": "youtube"
  }
}

Instal aplikasi YouTube menurut nama

{
  "command": "action.devices.commands.appInstall",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSearch

Menelusuri aplikasi yang ditentukan.

Parameter

Parameter Jenis Deskripsi
newApplication String

Kunci aplikasi yang akan ditelusuri.

newApplicationName String

Nama aplikasi yang akan ditelusuri.

Contoh

Menelusuri aplikasi YouTube menurut kunci

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplication": "youtube"
  }
}

Menelusuri aplikasi YouTube menurut nama

{
  "command": "action.devices.commands.appSearch",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

action.devices.commands.appSelect

Pilih aplikasi yang ditentukan.

Parameter

Parameter Jenis Deskripsi
newApplication String

Kunci aplikasi untuk dipilih.

newApplicationName String

Nama aplikasi untuk dipilih.

Contoh

Pilih aplikasi YouTube berdasarkan kunci

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplication": "youtube"
  }
}

Pilih aplikasi YouTube berdasarkan nama

{
  "command": "action.devices.commands.appSelect",
  "params": {
    "newApplicationName": "YouTube US"
  }
}

Contoh ucapan

de-DE

  • Öffne Netflix auf dem Fernseher .

en-US

  • mulai menggunakan YouTube aplikasi di smart TV

es-ES

  • pon netflix en la tele del salón

fr-FR

  • Metrik Netflix sur la télé .

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.
  • noAvailableApp: Aplikasi tidak ada atau tidak tersedia.
  • appLaunchFailed: Aplikasi gagal diluncurkan.
  • alreadyInstalledApp: Aplikasi sudah diinstal.