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 Fitur SmartControl NetworkControl

action.devices.traits.NetworkControl - Sifat ini termasuk perangkat yang mendukung pelaporan data jaringan dan melakukan operasi khusus jaringan.

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
supportsEnablingGuestNetwork Boolean

(Default: false)

Tetapkan ke true jika jaringan tamu dapat diaktifkan.

supportsDisablingGuestNetwork Boolean

(Default: false)

Tetapkan ke true jika jaringan tamu dapat dinonaktifkan.

supportsGettingGuestNetworkPassword Boolean

(Default: false)

Tetapkan ke true jika sandi jaringan tamu dapat diperoleh melalui perintah GetGuestNetworkPassword.

networkProfiles Array

Menunjukkan nama profil jaringan yang didukung.

[item, ...] String

Nama profil jaringan yang mewakili grup perangkat terkait.

supportsEnablingNetworkProfile Boolean

(Default: "false")

Tetapkan ke true jika profil jaringan dapat diaktifkan.

supportsDisablingNetworkProfile Boolean

(Default: "false")

Tetapkan ke true jika profil jaringan dapat dinonaktifkan.

supportsNetworkDownloadSpeedTest Boolean

(Default: false)

Tetapkan ke true jika uji kecepatan download dapat dijalankan.

supportsNetworkUploadSpeedTest Boolean

(Default: false)

Tetapkan ke true jika uji kecepatan upload dapat dijalankan.

Contoh

Perangkat jaringan yang mendukung jaringan tamu, profil, dan uji kecepatan.

{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true,
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true,
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true,
  "supportsGettingGuestNetworkPassword": true,
  "networkProfiles": [
    "Kids"
  ]
}

STATUS Perangkat

Entitas 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
networkEnabled Boolean

Apakah jaringan utama diaktifkan atau tidak.

networkSettings Objek

Berisi SSID jaringan utama.

ssid String

Wajib.

SSID Jaringan.

guestNetworkEnabled Boolean

Apakah jaringan tamu diaktifkan atau tidak.

guestNetworkSettings Objek

Berisi SSID jaringan tamu.

ssid String

Wajib.

SSID Jaringan.

numConnectedDevices Integer

Jumlah perangkat yang terhubung ke jaringan.

networkUsageMB Number

Penggunaan jaringan dalam MB (megabyte). Penggunaan jaringan berada dalam periode penagihan saat ini, yang dapat berguna untuk memantau sehubungan dengan batas penggunaan jaringan periode penagihan.

networkUsageLimitMB Number

Batas penggunaan jaringan dalam MB (megabyte). Batas penggunaan jaringan berada dalam periode penagihan saat ini.

networkUsageUnlimited Boolean

Apakah penggunaan jaringan tidak terbatas. Status penggunaan networkUsageLimitMB perangkat akan diabaikan jika disetel ke true.

lastNetworkDownloadSpeedTest Objek

Berisi hasil uji kecepatan download jaringan terbaru.

downloadSpeedMbps Number

Kecepatan download dalam Mbps (megabit per detik) dari pengujian kecepatan jaringan terakhir.

unixTimestampSec Integer

Stempel waktu Unix (jumlah detik sejak Unix Epoch) saat pengujian kecepatan download jaringan terakhir dijalankan.

status String

Menunjukkan apakah uji kecepatan download jaringan terakhir berhasil atau gagal.

Nilai yang didukung:

SUCCESS
FAILURE
lastNetworkUploadSpeedTest Objek

Berisi hasil uji kecepatan upload jaringan terbaru.

uploadSpeedMbps Number

Kecepatan upload dalam Mbps (megabit per detik) dari pengujian kecepatan jaringan terakhir.

unixTimestampSec Integer

Stempel waktu Unix (jumlah detik sejak Unix Epoch) saat pengujian kecepatan upload jaringan terakhir dijalankan.

status String

Menunjukkan apakah uji kecepatan upload jaringan terakhir berhasil atau gagal.

Nilai yang didukung:

SUCCESS
FAILURE
networkSpeedTestInProgress Boolean

(Default: false)

Apakah tes kecepatan sedang dijalankan.

networkProfilesState Objek

Status untuk profil jaringan. Objek level teratas ini harus berisi key-value pair dengan kunci tersebut adalah nama salah satu profil jaringan yang tercantum di atribut networkProfiles dan nilainya harus berupa status profil yang sesuai.

<string> Objek

Objek yang menyimpan status profil jaringan individual. Nilai kunci harus berupa nama salah satu profil jaringan di atribut networkProfiles.

enabled Boolean

Status profil jaringan yang diaktifkan/dinonaktifkan saat ini.

Contoh

Perangkat dengan jaringan aktif.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8
}

Perangkat dengan jaringan aktif dan hasil pengujian kecepatan.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "lastNetworkDownloadSpeedTest": {
    "downloadSpeedMbps": 159.8,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  },
  "lastNetworkUploadSpeedTest": {
    "uploadSpeedMbps": 64.1,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  }
}

Perangkat dengan jaringan aktif dan pengujian kecepatan sedang berlangsung.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "networkSpeedTestInProgress": true
}

Perangkat dengan networknetwork "kids" dinonaktifkan.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "networkProfilesState": {
    "parents": {
      "enabled": true
    },
    "kids": {
      "enabled": false
    }
  }
}

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

Mengaktifkan atau menonaktifkan jaringan tamu. Verifikasi pengguna sekunder dengan PIN harus digunakan. Keamanan rumah pengguna dapat dianggap terpengaruh jika perangkat keamanan lain dinonaktifkan melalui perintah ini.

Perintah ini memerlukan atribut berikut:
{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true
}

Parameter

Parameter Jenis Deskripsi
enable Boolean

Wajib.

True untuk mengaktifkan jaringan tamu, false untuk menonaktifkan jaringan tamu.

Contoh

Aktifkan jaringan tamu.

{
  "command": "action.devices.commands.EnableDisableGuestNetwork",
  "params": {
    "enable": true
  }
}

action.devices.commands.EnableDisableNetworkProfile

Mengaktifkan atau menonaktifkan profil jaringan. Verifikasi pengguna sekunder dengan PIN harus digunakan. Keamanan rumah pengguna dapat dianggap terpengaruh jika perangkat keamanan lain dinonaktifkan melalui perintah ini.

Perintah ini memerlukan atribut berikut:
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

Parameter

Parameter Jenis Deskripsi
profile String

Wajib.

Nama profil dari atribut networkProfiles.

enable Boolean

Wajib.

Benar untuk mengaktifkan profil, salah untuk menonaktifkan profil.

Contoh

Nonaktifkan internet untuk anak-anak.

{
  "command": "action.devices.commands.EnableDisableNetworkProfile",
  "params": {
    "profile": "Kids",
    "enable": false
  }
}

Terjadi error saat mencoba mengontrol profil jaringan yang diberikan.

Nilai yang didukung:

networkProfileNotRecognized

action.devices.commands.GetGuestNetworkPassword

Dapatkan sandi jaringan tamu. Verifikasi pengguna sekunder dengan PIN harus digunakan. Keamanan rumah pengguna dapat dianggap terpengaruh jika perangkat keamanan lain dinonaktifkan melalui perintah ini.

Perintah ini memerlukan atribut berikut:
{
  "supportsGettingGuestNetworkPassword": true
}

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Tampilkan sandi Wi-Fi tamu saya.

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

Hasil

Hasil Jenis Deskripsi
guestNetworkPassword String

Wajib.

Sandi untuk jaringan tamu.

Contoh

Tampilkan sandi Wi-Fi tamu saya.

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

Uji kecepatan download dan upload jaringan.

Perintah ini memerlukan atribut berikut:
{
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true
}

Parameter

Parameter Jenis Deskripsi
testDownloadSpeed Boolean

Wajib.

Menunjukkan apakah kecepatan download harus diuji.

testUploadSpeed Boolean

Wajib.

Menunjukkan apakah kecepatan upload harus diuji.

followUpToken String

Wajib.

Token yang disediakan Google untuk respons tindak lanjut.

Contoh

Berapa kecepatan Wi-Finya?

{
  "command": "action.devices.commands.TestNetworkSpeed",
  "params": {
    "testDownloadSpeed": true,
    "testUploadSpeed": true,
    "followUpToken": "123"
  }
}

Terjadi error saat mencoba meminta uji kecepatan.

Nilai yang didukung:

networkSpeedTestInProgress

Respons tindak lanjut

Perangkat dengan karakteristik ini dapat menampilkan payload respons tindak lanjut berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari cara menerapkan respons tindak lanjut lebih lanjut, lihat Notifikasi untuk Action smart home.

Payload berisi salah satu dari hal berikut:

Berhasil: networkDownloadSpeedMbps

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token disediakan dalam permintaan EXECUTE asli.

status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

SUCCESS
networkDownloadSpeedMbps Number

Wajib.

Kecepatan download jaringan diukur dalam megabit per detik.

Berhasil: networkUploadSpeedMbps

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token disediakan dalam permintaan EXECUTE asli.

status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

SUCCESS
networkUploadSpeedMbps Number

Wajib.

Kecepatan upload jaringan diukur dalam megabit per detik.

Berhasil: networkDownloadSpeedMbps dan networkUploadSpeedMbps

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token disediakan dalam permintaan EXECUTE asli.

status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

SUCCESS
networkDownloadSpeedMbps Number

Wajib.

Kecepatan download jaringan diukur dalam megabit per detik.

networkUploadSpeedMbps Number

Wajib.

Kecepatan upload jaringan diukur dalam megabit per detik.

Kegagalan

Kolom Jenis Deskripsi
followUpToken String

Wajib.

Token disediakan dalam permintaan EXECUTE asli.

status String

Wajib.

Hasil permintaan.

Nilai yang didukung:

FAILURE
errorCode String

Wajib.

Nilainya dapat berupa kode error untuk sifat ini, misalnya, transientError.

Contoh

Berapa kecepatan Wi-Finya? (tindak lanjut)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "networkDownloadSpeedMbps": 23.3,
      "networkUploadSpeedMbps": 10.2,
      "followUpToken": "1234"
    }
  }
}

Berapa kecepatan Wi-Finya? (tindak lanjut akan gagal)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "transientError",
      "followUpToken": "1234"
    }
  }
}

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.

Terjadi error saat mencoba mengontrol profil jaringan yang diberikan.

Nilai yang didukung:

networkProfileNotRecognized

Terjadi error saat mencoba meminta uji kecepatan.

Nilai yang didukung:

networkSpeedTestInProgress